Wizard Framework Elemente

Navigation Bar

Die Navigation Bar wird verwendet, um Wizard Navigationspunkte dynamisch anzuzeigen. Diese Navigationspunkte können im Wizard Konfigurationspanel konfiguriert werden. Außerdem ist es möglich, jedem Navigationselement ein eigenes Icon zuzuweisen.

Abbildung 1. Navigation Bar - CNS Wizard
Anmerkung: Es wird empfohlen, für die Icons Grafiken vom Typ portable network graphic (.png) und mit einer Auflösung von 32x32 Pixel zu wählen.

Abhängig von der Konfiguration des Wizard Datenpunktes wird ein Panel innerhalb des Panelbereichs geöffnet, wenn auf das entsprechende Navigationselement geklickt wird.

Notification Bar

Die Notification Bar dient der Anzeige von wichtigen Informationen wie Warnungen und Fehlern.

  • Beim Auftreten eines Fehlers oder einer Warnung wird die Notification Bar für die Anzeige der Meldung unterhalb der Navigation Bar aufgeklappt.

  • Die Meldung innerhalb der Notification Bar wird zwischen 2 und 6 Sekunden angezeigt (siehe wichtige Variablen und Konstanten) bis die Notification Bar wieder geschlossen wird.

  • Je nach Priorität des Fehlers wird die Notification Bar in einer entsprechenden Farbe angezeigt. Folgende Farben sind vorgegeben: Grün (INFO), Gelb (WARNING), Rot (SEVERE).

  • Es wird immer die aktuellste Nachricht mit der höchsten Priorität angezeigt. Eine Meldung mit höherer Priorität überschreibt eine Meldung mit geringerer Priorität. Eine Meldung mit niedrigerer Priorität kann nie eine Meldung höherer Priorität überschreiben.

  • Wichtige Meldungen werden auch im Logvier ausgegeben. Es können verschiedene Texte für die Notification Bar und den Logviewer definiert werden. Texte die im Logviewer ausgegeben werden sollen, müssen im Message-Katalog mit dem Postfix "_Logview" enden.

  • Wenn eine Meldung für die Anzeige innerhalb der Notification Bar zu lang ist, wird diese automatisch mit den Symbolen "..." abgekürzt.

Abbildung 2. Notification Bar Beispiele

Verwendung als Referenz

Die Notification Bar kann auch als Referenz außerhalb des Wizard Frameworks verwendet werden. Das Referenzpanel "NOTIFICATION_BAR.pnl" befindet sich unter < wincc_oa_path >/panels/objects_parts/STD_OBJECTS.

Folgende Dollarparameter müssen gesetzt werden um die Notification Bar in eigenen Panels zu initialisieren:

$ Parameter Typ Default Bereich Beschreibung
$bExpandable bool 0 Definiert ob die Notification Bar erweiterbar ist (die letzten 3 Meldungen werden angezeigt) oder nicht.
$bFitToPanel bool Definiert ob die Notification Bar an das Panel angepasst wird.
$bRootPanel bool => showinallpanels root auch logviewer.
Zusätzliche Datenpunkte welche ebenfalls auf Meldungen, die in der Notification Bar angezeigt werden sollen, überprüft werden sollen.

Für die weitere Konfigurationen müssen entsprechende Notification Bar Control-Funktionen verwendet werden.

Panel Area

In der Panel Area werden definierte Panels innerhalb des Wizards angezeigt. Um Panels zum entsprechenden Navigationselement des Wizards hinzuzufügen, kann das Wizard Konfigurationspanel verwendet werden. Alternativ kann auch der Panelpfad auf den internen Datenpunkt des Wizards geschrieben werden.

Bottom Bar

Die Bottom Bar wird vom Wizard Framework verwendet um dynamisch die benötigten Schaltflächen an den vorgesehenen Positionen anzuzeigen. Die horizontale Position der Schaltflächen wird automatisch errechnet. Die Texte oder Tooltiptexte der Schaltflächen werden im Message-Katalog "wfShapes.cat" festgelegt.

Im Wizard Framework beziehen sich die Bottom Bar Elemente immer auf das momentan angezeigte Panel. Wird ein anderes Menüelement (Navigationspunkt) geöffnet, wird die Bottom Bar aktualisiert um die für dieses Element definierten Schaltflächen anzuzeigen.

Es ist möglich, die Bottom Bar als Referenz außerhalb des Wizard Frameworks zu verwenden. Das Referenzpanel "BtnBottomBar.pnl" befindet sich unter < wincc_oa_path >/panels/vision/wf/objects.

Abbildung 3. Bottom Bar reference panel

Verwendung als Referenz

Die folgenden Dollarparameter müssen gesetzt werden um die Botom Bar in eigenen Panels zu initialisieren.

$Parameter Beschreibung
$dsButtons

Liste der Buttons die angezeigt werden sollen. Folgende Keys sind verfügbar:

  • „btn_BottomBar_help“: Hilfe-Button (shortcut key F1)

  • "btn_BottomBar_save“: Speichern-Button (shortcut key ctrl + s)

  • „btn_BottomBar_cancel“: Zurücksetzen-Button (shortcut key Esc)

  • „btn_BottomBar_close“: Schließen-Button

  • „btn_BottomBar_ok“: OK-Button

  • „btn_BottomBar_yes“: Ja-Button

  • „btn_BottomBar_no“: Nein-Button
$dsVisibleFunc Liste mit Funktionen bzw. Scripten die zur Sichtbarkeit der Buttons verwendet werden. Z.B. Berechtigungsüberprüfung, Lizenzüberprüfung usw. Wenn der jeweilige Button immer sichtbar sein soll, muss das Keyword "wf_alwaysTrue" verwendet werden.
$dsEnabledFunc Liste mit Funktionen bzw. Scripten die zur Bedienbarkeit (aktiv, inaktiv) der Buttons dienen. Z.B. Berechtigungsüberprüfung, Lizenzüberprüfung usw. Wenn der jeweilige Button immer bedienbar sein soll, muss das Keyword "wf_alwaysTrue" verwendet werden.
$dsExecFunc Liste mit Funktionen und Scripten die beim Click-Event vom jeweiligen Button aufgerufen werden.
$dsIcons Liste mit Icon-Pfaden (relativer Pfad) die statt dem Buttontext angezeigt werden sollen.
$sReferenceName Referenzname der Bottom Bar - Referenz. Damit können die Shapes in der Referenz einfacher mit setValue und getValue angesprochen werden.
Anmerkung:

Falls die oben genannten Parameter nicht übergeben werden, oder die Länge der Parameter nicht übereinstimmt, werden keine Buttons angezeigt. Das bedeutet, wenn beispielsweise zwei Buttons definiert werden, müssen auch zwei Einträge bei jedem anderen Dollarparameter angegeben werden. Um mehrere Einträge bei einem Dollarparameter anzugeben, müssen diese durch eine Pipe " | " getrennt werden. Beachten Sie, dass Leerzeichen vor und nach der Pipe verwendet werden müssen.

Für die weitere Konfiguration müssen die entsprechenden Bottom Bar Control-Funktionen verwendet werden.