Wenn Sie an mehreren Projekten gleichzeitig arbeiten und diese im Wechsel auf den Homebzw. FacilityServer übertragen, sollten Sie unbedingt folgendes tun:

Da Sie bei verschiedenen Projekten gleiche Dateinamen verwenden, die Inhalte dieser Dateien aber unterschiedlich sein können, kann es zu falschen Anzeigen im Browser führen, wenn der Browser, anstatt die aktuelle Seite anzuzeigen, auf den Cache zurückgreift und die gleichnamige Seite eines anderen Projekts anzuzeigen versucht.

Voraussetzung zur Nutzung von HSAjaxFramework ist Microsoft dotNET Framework 2.0.

HSAjaxFramework ist unter tools\hsav zu finden.

Alle einstellbaren Parameter werden in der Definitions-Datei list.hs (XML-Format) angelegt.
Verwenden Sie dazu einen Text-Editor.

Quellcode list.hs:

<?xml version="1.0" encoding="ISO-8859-1"?>
<devices>
   <device>
      <key>Gira</key>
      <text>Gira sample project</text>
      <url>http://192.168.0.11/opt/hsav-gira/startgast.htm</url>
      <windowstate>1</windowstate>
      <border>1</border>
   </device>
</devices>

Das Programm kann auch per Parameterübergabe gestartet werden.

Beispiel: HSAjaxFramework.exe Gira

Gira ist der oben beschriebene <Key>.

Wird kein Parameter übergeben, erscheint eine Auswahlmaske.


Bild 2.1: Auswahlmaske zur Parameterübergabe

Um die HomeServer AjaxVisu verwenden zu können, muss in der Experten-Software den betroffenen Benutzern unter

Benutzer / Benutzerrechte / Oberfläche / Client-Programm

Zugriff gewährt werden.

Möchte man die Fläche einer Standard-Visuseite begrenzen, ist dies mit dem Symbol XXPAGE möglich. Setzt man dieses Symbol auf eine Visu-Seite, so definiert man damit die untere rechte Ecke. Alle Informationen, die außerhalb der begrenzten Fläche liegen, werden nicht angezeigt.


Bild 2.3: Beispiel für die Einstellung der Seitengröße

Legen Sie wie oben beschrieben das Symbol an:

Bild-ID: XXPAGE

Bezeichnung (Name): "Ajax_Seitengröße".

Das Symbol kann optional verwendet werden. Wird dieses Symbol nicht verwendet, zeigt der Browser die gesamte Fläche der Visu-Seite an.

Es empfiehlt sich, ein kleines, quadratisches Symbol zu verwenden. Die obere linke Ecke des Symbols definiert die Seitengröße. Die Größe und Farbe des XXPAGE-Symbols haben keine Bedeutung, da es ja außerhalb der definierten Anzeige-Fläche liegt.

Die größte dem Musterprojekt beiliegende HTML-Maske ist 331 Pixel breit und 240 Pixel hoch.

Wenn Sie die Größe der Visu-Fläche mittels XXPAGE-Symbol kleiner als die Größe der HTML-Masken definieren, können die HTML-Masken nicht komplett angezeigt werden.

Die HomeServer AjaxVisu bietet die Möglichkeit von PopUp-Visu-Seiten.

Möchte man eine Visu-Seite über die aufrufende Visu-Seite legen (PopUp), so ist dies mit dem Symbol XXPOPUP möglich. Setzt man dieses Symbol auf eine Visu-Seite, so definiert man damit die untere rechte Ecke und gleichzeitig diese Seite als PopUp. Alle Informationen, die außerhalb der begrenzten Fläche liegen, werden nicht angezeigt. Die Seite wird bei Aufruf zentriert über die bestehende Seite gelegt.


Bild 2.4: Anlegen eines Symbols für ein PopUp.
Links: PopUp-Seite im Entwurf. Rechts: Aufgerufenes PopUp in der Visu.

Legen Sie wie oben beschrieben das Symbol an:

Bild-ID: XXPOPUP

Bezeichnung (Name): "Ajax_PopUp".

Es empfiehlt sich, ein kleines, quadratisches Symbol zu verwenden. Die obere linke Ecke des Symbols definiert die Seitengrösse.

Außerdem sollte die PopUp-Seite mit einem transparenten Rahmen umgeben werden, damit der Rand um das PopUp nicht mehr sichtbar ist.

Eine Maske (z.B. Meldungsarchiv) kann von einer PopUp-Seite aus aufgerufen werden, der Aufruf einer weiteren Visu- oder PopUp-Seite ist innerhalb einer PopUp-Seite nicht möglich.

Daher müssen Sie auf jeder PopUp-Seite ein Navigations-Element definieren (z.B.: "Navigation: Zurück" oder "Navigation: Startpunkt"). Im linken Bild (siehe Bild 2.4) ist das spätere PopUp im Entwurf zusammen mit dem kleinen roten XXPOPUP-Symbol zu sehen, das die darzustellende Fläche abgrenzt. Rechts ist das Ergebnis, das dann als PopUp in der Home-Server AjaxVisu zu sehen ist, abgebildet.

Mit einer PopUp-Seite kann man beispielsweise gerätespezifische PopUp's realisieren, wie z.B. ein PopUp zur Jalousie-Steuerung.

Das Projekt muss immer komplett (Bilder+Daten+Ansagen) auf den HomeServer oder FacilityServer übertragen werden.

Bei Nutzung der Variante A müssen die Parameter in einfache Hochkommata gestellt und durch Kommata voneinander getrennt angegeben werden. Zeile 41 im Code-Listing.

Hier ein Beispiel für Aufruf-Variante A mit fest eingetragenen Parametern in Zeile 41:

startClientEx('admin','Alpha.123','D1024V','R1',1);

Sind alle Angaben korrekt, startet die HomeServer AjaxVisu mit der festgelegten Visu-Seite. Ansonsten wird die Login-Maske aufgerufen.

Bei Nutzung der Variante B wird dem Dateinamen ein Fragezeichen (?) angehängt, dem dann die einzelnen Parameter (mit Kürzeln) jeweils durch ein kaufmännisches 'und' (&) getrennt folgen. Hier ein Beispiel für Aufruf-Variante B mit Aufruf-Parametern:

https://192.168.0.51/opt/hsav-gira/startgast.htm?pw=admin&user=admin&cl=D1024V&ref=R1

Sind alle Angaben korrekt, startet die HomeServer AjaxVisu mit der festgelegten Visu-Seite, ansonsten wird die Login-Maske aufgerufen.

Bei Nutzung der Variante C wird die Datei startgast.htm, wie im Kapitel Start-Dateien beschrieben, verwendet und es werden auch keine Parameter an den Aufruf angehängt.

Die HomeServer AjaxVisu startet mit der Login-Maske.

Sie können auch die verschiedenen Varianten kombinieren. Tragen Sie beispielsweise nur das Design und die Refresh-Rate fest in der Startdatei ein, können Sie Benutzer und/oder Passwort als Aufruf-Parameter mitgeben.

Sie können auch alle Angaben, wie in Variante A beschrieben, fest eintragen. Wenn Sie dann einzelne (oder alle) Parameter zusätzlich als Aufruf-Parameter mitgeben, werden die fest eingetragenen durch die Aufruf-Parameter überschrieben!

Haben Sie in der einen oder anderen Form alle Parameter angegeben, startet die HomeServer AjaxVisu mit der festgelegten Seite, ansonsten wird die Login-Maske aufgerufen, in der alle bekannten Felder (außer dem Passwort) bereits ausgefüllt angezeigt werden.

Werden nicht alle Parameter, wie in Variante A beschrieben, fest eingetragen, werden die Eingaben vom Login gespeichert und beim nächsten Aufruf der Login-Maske werden die Felder automatisch wieder mit diesen Angaben vorbelegt.

Da bei der A-Variante die Anmeldedaten unverschlüsselt gespeichert werden, empfehlen wir, diese Variante nur für Benutzer, die eine ausschließlich interne Zugriffsberechtigung haben, zu nutzen. Ansonsten kann nicht ausgeschlossen werden, dass sich jemand Zugriff auf diese Datei verschafft und die Daten missbraucht.

Generell empfiehlt es sich, zumindest das Passwort nicht fest in die Startdatei einzutragen, damit es nicht in ungeschützten Bereichen gespeichert, sondern bei jeder Anmeldung und bei jedem Reconnect abgefragt wird.

Für Inbetriebnehmer empfiehlt es sich, die Variante B zu benutzen.

Im QuadConfig wird ein Eintrag in der "Navigationstaste - URL" so gestaltet, dass dort eine URL mit Aufruf-Parametern (wie in Variante B beschrieben) hinterlegt wird. Damit sind keine kritischen Daten in der Startdatei eingetragen; der Benutzer des QuadClient kann sich jedoch trotzdem ohne zusätzliche Login-Prozedur auf diesem Weg in die Visu einloggen.

Bei einem Abbruch der Verbindung zum HS/FS, z.B. wegen eines Neustarts des HS/FS, wird ein rötlich eingefärbtes Info-Fenster mit der Überschrift "HomeServer AjaxVisu" und dem Hinweis, dass gerade versucht wird, die abgebrochene Verbindung wieder herzustellen, angezeigt. Dieser Reconnect-Versuch wird in Abständen, die durch die Refreshzeit bestimmt werden, wiederholt.

Im Info-Fenster wird eine Reihe von Sternchen angezeigt, von denen jedes für einen bereits erfolgten Reconnect-Versuch steht.

Sowie die Verbindung wieder hergestellt wurde, verschwindet das Info-Fenster.

Man steht anschließend wieder auf der Seite, auf der man vor Verbindungs-Abbruch aktiv war.

Ausnahme: PopUp-Seiten. Man steht wieder auf der Seite, von der aus die PopUp-Seite aufgerufen wurde.

Eingabe-Feld, im Beispiel admin

Benutzername für die Anmeldung am HomeServer bzw. Facility Server.
Dieser Benutzer bekommt die Startseite in der Visualisierung zugeordnet.

Eingabe-Feld, im Beispiel Alpha.123

Passwort für die Anmeldung am HomeServer bzw. Facility Server.

Eingabe-Feld (Kürzel), im Beispiel D1024V

Gibt an, welches Design bzw. welche Visu-Startseite angezeigt werden soll. Hat sonst keinen weiteren Einfluss auf die HomeServer AjaxVisu.

Eingabe-Feld (Kürzel), im Beispiel R1

Wird über ein Element in der Visu eine Änderung herbeigeführt, beispielsweise ein Licht eingeschaltet, wird in Abständen, die sich jedesmal verdoppeln, ein automatischer Refresh der Seite (der Status des betreffenden Objektes wird ermittelt und auf der Visu angezeigt) durchgeführt.
Dies passiert solange, bis eine Zeitspanne vergangen ist, die unter Refreshzeit im HS/FS Experten eingetragen wurde.

Beispiel:

Als Refreshzeit sind 5 Minuten (= 300 Sekunden) eingetragen. Dann wird nach 2, 4, 8, 16, 32, 64, 128 und 256 Sekunden ein automatischer Refresh durchgeführt.

Check-Box.

Wird diese Check-Box aktiviert, werden Benutzername und Passwort sowie alle weiteren Einstellungen als Cookie auf dem Gerät gespeichert

Button.

Mit Klick auf diesen Button meldet man sich mit den zuvor gemachten Angaben am Home- bzw. FacilityServer an und startet nach erfolgreichem Anmeldevorgang die Visualisierung.

Alle Internet-Explorer in den Versionen kleiner als Version 7 unterstützen keine transparenten Grafiken vom Typ ".png".

Erst ab Internet-Explorer Version 7 werden diese Grafiken korrekt dargestellt.

Bezeichnung: ax0.gif

Transparente Fläche, d.h. sie hat keine Farbe und ist somit 100-prozentig durchsichtig.

Diese Datei wird dazu benutzt, über alle als anklickbar definierten Visu-Elemente gelegt zu werden. Sie macht aus den reinen Grafik-Elementen erst bedienbare Schaltflächen.

Bezeichnung: hide.png

Nur teilweise transparente, rot eingefärbte Fläche, d.h. sie ist nicht völlig durchsichtig.

Diese Datei wird dazu benutzt, für kurze Zeit über ein Visu-Element gelegt zu werden, nachdem der Anwender darauf geklickt hat. Damit wird dem Anwender der Klick sichtbar gemacht. Nach ein bis zwei Sekunden verschwindet die rote Fläche wieder. Dies passiert aber nur in der Visu, die Masken sind davon ausgenommen. Siehe auch Kapitel Start-Dateien.

Bezeichnung: hide2.png

Nur teilweise transparente, weiß eingefärbte Fläche, d.h. sie ist nicht völlig durchsichtig.

Diese Datei wird dazu benutzt, um z.B. in den Masken inaktive Buttons zum Einen anzuzeigen und zum Anderen auch klick-inaktiv zu machen.

Bezeichnung: hide3.png

Halbtransparenter (grauer) Vollbild-Hintergrund, der nach Aufruf einer Systemmaske (z.B. UZSU, Werteingabe, ...) unterlegt wird. Damit werden Klicks auf den Hintergrund vermieden.

Bezeichnung: hide4.png

Halbtransparenter (grauer) Vollbild-Hintergrund, der nach Aufruf einer Visu-PopUp-Seite unterlegt wird. Damit werden Klicks auf den Hintergrund vermieden.