Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- software:frontends:frontend [2020/05/16 11:11] – äöü boenki
+++ software:frontends:frontend [2024/02/10 08:40] (aktuell) – jau
@@ Zeile 1: / Zeile 1: @@
 ===== Das Volkszaehler standard-Frontend =====
 Das Standard-Frontend wird zusammen mit der [[/software/middleware|Middleware]] installiert, und kann mit einem Javascript-fähigen Browser aufgerufen werden (PC, Handy, Tablet).
@@ Zeile 5: / Zeile 4: @@
 Demo: [[http://demo.volkszaehler.org/?uuid=6836dd20-00d5-11e0-bab1-856ed5f959ae]]
-Um im Frontend Daten sehen zu können, müssen die jeweiligen Kanäle) mittels ihrer UUID (beispielsweise ''550e8400-e29b-11d4-a716-44665512562'') hinzugefügt werden.
+==== Darstellung ====
+Bei Volkszähler ist die X-Achse stets die Zeit. Daraus folgt für eine mathematisch korrekte Darstellung der y-Achse, dass aus Zählerständen Leistung wird. Die Energie entspricht dabei der Fläche unterhalb der Linie. Betrachtet man die Einheiten wird das recht deutlich: Nimmt man aus Energie (Wh) die Zeit (h) bleibt Leistung (W).
+{{:howto:vz2014-06-01.jpg?400|}}
+In der Tabelle unter dem Graphen wird der absolute Zählerstand mit angezeigt wenn in den Kanaleigenschaften der Initialwert eingetragen ist (Zählerstand bei Inbetriebnahme des Volkszähler). Die hinterste Spalte wird allerdings erst erstellt wenn die Daten mindestes einen Datumswechsel umfassen. Bei Erstinbetriebnahme ist daher etwas Geduld gefragt.
+Möchte man Energie über gleich lange Zeiträume vergleichen hat man am Frontend oben rechts, über die Drop-Down-Liste ''Current'', die Möglichkeit vorbereitete Gruppierungen zur Darstellung als Balkendiagramm auszuwählen.
+{{:software:frontends:frontend:frontend_monthbyday.jpg?400|}}
+==== Voraussetzungen ====
+Um im Frontend Daten sehen zu können, müssen die jeweiligen Kanäle mittels ihrer UUID (beispielsweise ''550e8400-e29b-11d4-a716-44665512562'') hinzugefügt werden.
 Wer die UUID nicht kennt, kann zwar das Frontend aufrufen, aber die Daten nicht sehen. (siehe: [[/software/middleware/zugriff]])
@@ Zeile 17: / Zeile 30: @@
   * Öffentlichen Kanal hinzufügen
-Das Frontend bietet auch die Option, per middleware-aufruf neue Kanäle des anzulegen:
+Das Frontend bietet auch die Option, per middleware-Aufruf neue Kanäle des anzulegen:
 Dazu wählt Ihr die Schaltfläche "Kanal hinzufügen" aus.
 Nachdem ein Kanal angelegt ist, können mit einem geeigneten controller ([[/hardware/controllers]],[[/software/controller]]) Daten eingetragen werden.
@@ Zeile 88: / Zeile 101: @@
 Diese Funktionen findet man in der Software unter `volkszaehler.org/lib/volkszaehler/View`.
-Wenn man den **Timestamp [ms]** in Datum/Uhrzeit umrechnen will geht das mit einem Einzeiler:
+Wenn man den **Timestamp [ms]** in Datum/Uhrzeit umrechnen will geht das online z.B. bei [[https://www.epochconverter.com]] oder an der Kommandozeile mit einem Einzeiler:
 <code>
 $ date -d @$(echo "<Timestamp>/1000" | bc) +"%Y-%m-%d %H:%M:%S"
 </code>
-wobei man den Timestamp sinnvollerweise über die Zwischenablage einkopiert. Man kann dafür aber auch einen Shell Script aufsetzen:
+wobei man den Timestamp sinnvollerweise über die Zwischenablage einkopiert.
-<code>
-$ cat ms2time.sh
-#!/bin/sh
-# convert unix ms time to date/time
-# use: ms2time.sh <Timestamp>
-date -d @$(echo "$1/1000" | bc) +"%Y-%m-%d %H:%M:%S"
-# Beispiel:
+umgekehrt von Datum/Uhrzeit zu Sekunden geht es so:
-$ ./ms2time.sh 1399346245967
+<code>
--05-06 05:17:25
-# umgekehrt von Datum/Uhrzeit zu Sekunden geht es so:
 $ date -d "2014-05-06 05:17:25" +%s
 1399346245
-# um Millisekunden zu bekommen, hängt man noch "000" an.
 </code>
--05-07 10:53, Rudolf
+um Millisekunden zu bekommen, hängt man noch "000" an.
+</code>
 ===== Weitere URL-Parameter =====
-* hide
+=== uuid ===
+Dient dazu um direkt Kanäle oder auszuwählen.
-Um einige Elemente des Frontends nicht darzustellen, kann der hide-URL-Parameter genutzt werden. Er erlaubt es, zum Beispiel die Liste der Kanäle auszublenden. Das DIV in dem diese Liste ist, heißt accordion, dementsprechend kann man mit hide=#accordion die Kanalliste verbergen.
+Beispiel Gruppe:
+''
+https://demo.volkszaehler.org/?uuid=6836dd20-00d5-11e0-bab1-856ed5f959ae
+''
-Weitere Beispiele für Anwendungen sind #header und #footer.
+Beispiel zwei Kanäle:
+''
+https://demo.volkszaehler.org/?uuid[]=fb2ba830-3cd9-11eb-9ba5-e175b667bff9&uuid[]=12345678-1234-1234-1234-123456789012
+''
-Mehrere zu verbergende Elemente listet man Komma-getrennt auf:
+=== active ==
+Um zu steuern ob Känale aber ins besondere Gruppen als aktiv oder inaktiv und zugeklappt anzuzeigen.
+''
+https://demo.volkszaehler.org/?uuid=6836dd20-00d5-11e0-bab1-856ed5f959ae&active=0
+''
-...?hide=#accordion, #footer
+=== hide ===
+Um einige Elemente des Frontends nicht darzustellen, kann der hide-URL-Parameter genutzt werden. Er erlaubt es, zum Beispiel die Liste der Kanäle auszublenden. Das DIV in dem diese Liste ist, heißt accordion, dementsprechend kann man mit ''&hide=#accordion'' die Kanalliste verbergen [[https://demo.volkszaehler.org/?uuid=6836dd20-00d5-11e0-bab1-856ed5f959ae&hide=#accordion|Beispiel]].
+Weitere Beispiele für Anwendungen sind [[https://demo.volkszaehler.org/?uuid=6836dd20-00d5-11e0-bab1-856ed5f959ae&hide=#header|#header]] und [[https://demo.volkszaehler.org/?uuid=6836dd20-00d5-11e0-bab1-856ed5f959ae&hide=#footer|#footer]].
+Mehrere zu verbergende Elemente listet man Komma-getrennt auf: ''...?hide=#accordion,#header,#controls,#footer''
 Der besondere Nutzen entsteht bei der Verwendung des Frontends in iFrames, in denen man NUR das Chart oder NUR einige Kanäle sehen möchte.
-Der hide-URL-Parameter kann leicht mit anderen URL -Parametern kombiniert werden. Dazu muss vor dem ersten Parameter ein ? stehen, vor jedem weiteren Parameter ein &.
+Der hide-URL-Parameter kann leicht mit anderen URL -Parametern kombiniert werden. Dazu muss vor dem ersten Parameter ein ''?'' stehen, vor jedem weiteren Parameter ein ''&''.
+=== reset ===
+Löscht alle Kanäle aus dem Cookie.
+Beispiel:
+''https://demo.volkszaehler.org/?reset=1
+''
 {{indexmenu_n>1}}