Dashboard - Erste Schritte

[Ferengi-Master]

Da immer wieder die gleichen Fragen zum Dashboard auftauchen möchte ich in diesem Thread nach und nach Beispiele aufzeigen damit Ihr einen leichteren Einstieg für Euere eigenen Projekte findet.

Was ist das Dashboard?

• Baukastensystem zur Steuerung und Visualisierung des IPS Systems
• benötigt die IPS Konsole in der Laufzeitumgebung
• läuft nicht in einem Browser
• im Gegensatz zum Webfront muß die Oberfläche erst erstellt werden, bietet aber umfangreichere Gestaltungsmöglichkeiten

[Ferengi-Master]

Voraussetzung: erstelltes PageConrol Element mit Tabsheets (rechte Maustaste auf dem PageControl => neuer Tab)

1. Image (dieses soll sichtbar sein)
2. darüber ein Label zur Beschriftung
3. darüber wiederum das transparente und damit unsichtbare ExecImage

In den Eigenschaften des ExecImage folgendes eintragen:

4. ExecType: etSetTab
5. Executeable: Name des PageControl (meist Hauptpage)
6. Parameters: Nummer des anzuspringenden Tab

Ein OnClick-Event mit Script ist für ein Tab-Wechsel nicht notwendig.

Tabsheetvariable:
Welches Tabsheet ist aktiv?

Möglichkeit Schaltflächen zu erstellen: glassy buttons

[Ferengi-Master]

1. eine Grundlage zur Aufnahme der Schalt- und Visu- Objekte wählen, z.B. Panel erstellen (ermöglicht später ein leichtes verschieben und kopieren von mehreren Objekten)
2. 1 x Image für an / 1 x Image für aus / 1 x Image für Zustand erstellen
3. Das Image für an mit einem On Click Event auf ein Script verknüpfen
4. Einen IPSYMID Wert eintragen der später im Script abgefragt wird (dies kann ein einfacher String(Text) sein - hier Lampe_an)
5. Das Image für aus mit einem On Click Event auf ein Script verknüpfen
6. Einen IPSYMID Wert eintragen der später im Script abgefragt wird (dies kann ein einfacher String(Text) sein - hier Lampe_aus)
7. Das Image für den Zustand mit einer Bool Variablen verknüpfen (hier der Status der Lampe), dem Wert true und false jeweils das passende Bild zuweisen
8. Script anlegen das den Schaltvorgang erledigt

PHP-Code:

     $ID_Lampe = 12345; //hier ID des zu schaltenden Gerätes eintragen
     switch($IPS_COMPONENT)
     {
       case 'Lampe_an':
       FS20_SwitchMode($ID_Lampe, true);
       break;

       case 'Lampe_aus':
       FS20_SwitchMode($ID_Lampe, false);
       break;
    }; 


[Ferengi-Master]

1. eine Grundlage zur Aufnahme der Schalt- und Visu- Objekte wählen, z.B. Panel erstellen (ermöglicht später ein leichtes verschieben und kopieren von mehreren Objekten)
2. 1 x Image für an/aus
3. Das Image mit einem On Click Event auf ein Script verknüpfen
4. Das Image für den Zustand mit einer Bool Variablen verknüpfen, dem Wert true und false jeweils das passende Bild zuweisen
5. Script anlegen das den Schaltvorgang erledigt

PHP-Code:

$id_weihnachtsbeleuchtung           = 12345; //hier ID des zu schaltenden Gerätes eintragen 
$id_weihnachtsbeleuchtung_status    = 12345; //hier Status ID des zu schaltenden Gerätes eintragen (im Bildanhang sz_weihnacht)
$weihnachtsbeleuchtung_status       = GetValueBoolean($id_weihnachtsbeleuchtung_status);

if($weihnachtsbeleuchtung_status)
{
   FS20_SwitchMode($id_weihnachtsbeleuchtung, false);
}
else
{
   FS20_SwitchMode($id_weihnachtsbeleuchtung, true);
} 


[Ferengi-Master]

1. Editor von Windows starten
2. Befehlszeile siehe Anhang eingeben
3. Datei z.B. als dash.bat speichern

Eine Weitere Möglichkeit ist eine Verküpfung anzulegen (siehe zweites Bild)

P.S. Unterdrücken des DOS-Fensters beim Ausführen einer Batchdatei => start vor die Pfadangabe setzen

[Ferengi-Master]

Voraussetzung: geloggte Variable!

Anzeigen von Graphen ohne Menü im Dashboard:

1. Grundlage für Webbrowser wählen, z.B. TabSheet
2. Webbrowserelement einfügen
3. Im Objektinspektor des Webbrowser unter URL den Link eintragen
(http://IP:Port Webfront/dashboard.php)

Anzeigen von Graphen mit Menü im Dashboard:

1. Grundlage für Webbrowser wählen, z.B. TabSheet
2. Webbrowserelement einfügen
3. dem WebBrowserelement einen String bei der Eigenschaft URL zuweisen
4. eine Menüstruktur anlegen mittels der die Graphen URL geändert wird

PHP-Code:

//---------------------------- Graphen anzeigen --------------------------

$id_graph_url = 12345; //ID der Stringvariable mit der URL

switch($IPS_COMPONENT)
{
   case 'gr1':
       
   SetValueString($id_graph_url, "http://192.168.2.25:82/dashboard.php?VariableID=44853&tsStart=1265739376& showExtrema=false&showControls=false&timeName=week");
   break;

   case 'gr2':
       
   SetValueString($id_graph_url, "http://192.168.2.25:82/dashboard.php?VariableID=30893&tsStart=1265739376& showExtrema=false&showControls=false&timeName=week");
   break;
} 


Anpassungen in der Darstellung durch Angabe von Parametern hinter der dashboard.php:
dashboard.php?VariableID=12345&tsStart=1265739376& showExtrema=false&showControls=false&timeName=week

VariableID: Integer; gültige ID einer geloggten Variable
timeName: String; angezeigtes Zeitintervall; gültige Werte: hour / day / week / month / year
tsStart: Integer; Unix-Timestamp, ab deren Zeitblock angezeigt werden soll; Wert 0: automatisch aktuelle Zeit
refreshInterval: Integer; Aktualisierungsintervall in Sekunden; Wertebereich: 31 - n, Standard: 300
showExtrema: Boolean; Anzeige der Extremwertkurven; gültige Werte true / false, Standardwert: true
showControls: Boolean; Anzeige der Kontrollelemente; gültige Werte true / false, Standardwert: true

Achtung: Bei 'dojo' Fehlermeldungen den Cache des Internet Explorers löschen!

[Ferengi-Master]

1. bei der zu visualisierenden Variable ein Variablenprofil anlegen
2. ein Label einfügen
3. dem Label unter Caption im Komponenten Editor die Variable zuordnen
4. Haken - benutze Variablenprofil setzen

[Ferengi-Master]

1. Dezimalstellen
2. Schrittweite
3. Variablentyp