Diese Dokumentation beschreibt immer die neueste Version des Moduls, aktuell 3.0.3 im Kanal Beta. Im Kanal Stable liegt noch die Version 2.0.3. Dort können Funktionen fehlen, die hier beschrieben sind.
Energierechner Kachel
Reine Anzeige-Instanz für die Kachel-Visualisierung (experimentell). Sie zeigt einen festen Zeitraum eines Energierechner 2 und rechnet nichts selbst. So legst du aus einem Energierechner mehrere Kacheln an, zum Beispiel je eine für Heute, Diesen Monat und Dieses Jahr nebeneinander.
Voraussetzung ist eine Instanz Energierechner 2, in der der gewünschte Zeitraum aktiviert ist.
Inhaltsverzeichnis
1. Konfiguration
| Feld | Beschreibung |
|---|---|
| Energierechner 2 | Die Instanz, deren Werte angezeigt werden. |
| Zeitraum | Heute, Gestern, Diese Woche, Letzte Woche, Dieser Monat, Letzter Monat, Dieses Jahr oder Letztes Jahr, danach die weiteren Zeiträume des Energierechners 2 (Tarifzeiträume, Summe und eigene Zeiträume mit ihrem Namen). Die Liste wird beim Wählen des Energierechners 2 und beim Öffnen des Formulars aufgebaut; hat der Energierechner noch nicht gerechnet, enthält sie nur die acht Standardzeiträume. Der Zeitraum muss im Energierechner 2 aktiviert sein, sonst zeigt die Kachel „Keine Zeiträume aktiviert". Ein Zeitraum, den der Energierechner nicht mehr kennt (zum Beispiel eine gelöschte Zeile bei den eigenen Zeiträumen), steht weiter in der Liste, mit dem Zusatz „nicht verfügbar". |
| Darstellung | Automatisch (kompakt bei kleinen Kacheln, sonst Standard), Immer kompakt oder Immer Standard. |
| Titel | Eigener Titel. Leer: der Name des Energierechner 2. |
2. Funktionen
void ERK_Refresh(integer $InstanzID);
Holt die Daten der Quelle sofort neu. Sonst geschieht das bei jeder Berechnung der Quelle, spätestens nach einer Minute.
string ERK_GetTileData(integer $InstanzID);
Liefert die Kacheldaten als JSON.
3. Hinweise
- Die Anzeige sieht aus wie die Kachel des Energierechner 2, aber ohne Chips und Pfeile, weil der Zeitraum fest ist. Ein Tippen auf den Hauptwert öffnet in der Standard-Darstellung die Details. In der kompakten Darstellung gibt es keine Details.
- Vorjahresvergleich und teuerster Tag stehen nur dann in der Anzeige, wenn die Quelle sie berechnet. Das tut sie, wenn ihre Einstellung Zusatzwerte eingeschaltet ist.
- Die Anzeige rechnet nie selbst und stößt auch keine Berechnung der Quelle an. Hat die Quelle noch nichts berechnet oder ist der gewählte Zeitraum dort nicht aktiviert, zeigt die Kachel einen Hinweis. Dann in der Quelle den Zeitraum aktivieren oder eine Berechnung starten.
4. Spenden
Dieses Modul ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert:
