Kern von i-Plant ist eine Middleware zur Verteilung
Transcription
Kern von i-Plant ist eine Middleware zur Verteilung
Langner Communications Dokumentation i-Plant Dashboard Applets Version 1.3 Copyright © 2003 Langner Communications AG, Eulenkrugstr. 27, D-22359 Hamburg Alle Rechte vorbehalten. Langner, i-Plant, das i-Plant-Logo, P2B, FactoryXML und das FactoryXML-Logo sind eingetragene Marken von Langner Communications AG. Das als FactoryXML beschriebene Verfahren zur datentechnischen Anbindung von Automatisierungskomponenten ist von Langner Communications AG zum Patent angemeldet. Über Langner Communications Langner Communications AG ist Hersteller der Middleware i-Plant für die produktionsnahe IT. Das 1988 gegründete Softwarehaus hat seinen Firmensitz in Hamburg und betreut über 3000 Kunden in Europa, den USA, und Asien. Durch die konsequente Fokussierung auf automatisierte Meldesysteme speziell im industriellen Umfeld ist Langner Communications einer der international anerkannten Technologieführer auf diesem Sektor. Zahlreiche namhafte Softwarehersteller nutzen OEM-Softwarekomponenten von Langner Communications in ihren eigenen Produkten. Weitere Informationen über Langner Communications finden Sie im Internet unter www.langner.com. Weitere Informationen über i-Plant finden Sie unter www.factoryxml.com. i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 2 Alle Rechte vorbehalten Inhalt Übersicht ...................................................................................................................................................................................4 Was ist ein Digital Dashboard? ..............................................................................................................................................5 Gestaltung eigener Dashboards mit den i-Plant Dashboard Applets .....................................................................................5 Grundlagen................................................................................................................................................................................7 Voraussetzungen an die Systemumgebung...........................................................................................................................8 Integration von Applets in HTML-Seiten.................................................................................................................................8 Benutzung der i-Plant Dashboard Applets...........................................................................................................................10 Die Verbindung zu den Daten: Das Applet FxmlProvider und der i-Plant Proxy Server ......................................................11 Anzeige von Datenpunkten und Alarmen: Das Applet iPlantApplet .....................................................................................11 Gestaltvarianten ...................................................................................................................................................................11 Farbwahl...............................................................................................................................................................................12 Wertebereiche, Maßeinheiten und Bildresourcen ................................................................................................................12 Benutzerinteraktion...............................................................................................................................................................12 Authentifizierung...................................................................................................................................................................12 Online-Datenmodifikation innerhalb der Anwendung ...........................................................................................................12 Applet-Referenz ......................................................................................................................................................................15 FxmlProvider ........................................................................................................................................................................16 iPlantApplet ..........................................................................................................................................................................17 Referenz Gestaltvarianten .....................................................................................................................................................19 iPlantAlarmIcon ....................................................................................................................................................................20 iPlantAlarmText ....................................................................................................................................................................21 iPlantDateTime .....................................................................................................................................................................22 iPlantHBar ............................................................................................................................................................................23 iPlantImage...........................................................................................................................................................................24 iPlantMeter ...........................................................................................................................................................................25 iPlantShortHistory.................................................................................................................................................................26 iPlantText..............................................................................................................................................................................27 iPlantTrendArrow..................................................................................................................................................................28 iPlantVBar.............................................................................................................................................................................29 Einbinden einer Langzeit-Verlaufsgrafik ..............................................................................................................................30 Langzeit-Verlaufsgrafiken gegenüber Kurzzeit-Verlaufsgrafiken .........................................................................................31 Voraussetzungen an die Systemumgebung.........................................................................................................................31 Abfrage des i-Plant Resource Centers.................................................................................................................................32 URL-Parameter für das i-Plant Resource Center .................................................................................................................32 Dimensionierung der Langzeit-Verlaufsgrafik.......................................................................................................................32 Auffrischen von Langzeit-Verlaufsgrafiken...........................................................................................................................33 i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 3 Alle Rechte vorbehalten i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 4 Alle Rechte vorbehalten Was ist ein Digital Dashboard? "Dashboard" bedeutet zu Deutsch "Armaturenbrett". Der Sinn eines Dashboards besteht darin, dass wichtige Betriebsparameter auf einen Blick erkennbar sind. Im Unterschied zu einem konventionellen Armaturenbrett, welches normalerweise mit fest eingebauten mechanischen Armaturen arbeitet, ist ein Digital Dashboard völlig elektronisch und wird von einem Web-Browser angezeigt. Der folgende Screenshot zeigt ein Dashboard, welches die Auslastung und die Ausschussquote von drei Fertigungslinien darstellt. Ausserdem werden weitere Betriebsdaten und Alarme angezeigt. In diesem Dashboard finden sich zunächst eine ganze Reihe statischer HTML-Elemente wie zum Beispiel die grauen Querbalken und die Texte "Ist", "Soll" usw. Darüber hinaus gibt es hier insgesamt sechzig Java-Applets (orange dargestellte Schrift, Balkendiagramme, Verlaufsgrafiken und Alarmmeldungen unterhalb der Verlaufsgrafiken), die die entsprechenden Prozessvariablen dynamisch anzeigen. Die i-Plant Dashboards Applets, die in diesem Dokument beschrieben werden, dienen dazu, beliebige Prozessvariablen innerhalb eines i-Plant-Netzwerks in unterschiedlichen Formen (zum Beispiel analog als Balkendiagramm oder digital als Zahlenwert) anzuzeigen. Gestaltung eigener Dashboards mit den i-Plant Dashboard Applets Ein Dashboard ist stets individuell und anwendungsspezifisch. Mit den i-Plant Dashboard Applets können Sie eigene Dashboards gestalten, die Sie dann per Web-Browser betrachten können. Ein Dashboard ist nichts anderes als eine gewöhnliche HTML-Seite, die durch i-Plant Dashboard-Klassen um dynamische Elemente "angereichert" wird. Der Gestaltungsprozess eines eigenen Dashboards beinhaltet folgende Stufen: 1. Layout des gewünschten Dashboards in HTML. Sie können hierzu einen handelsüblichen HTML-Editor verwenden oder den HTML-Code per Hand mit einem ASCII-Editor erstellen. 2. Auswahl der gewünschten Dashboard Applets. Wählen Sie aus den verfügbaren Dashboard Applets diejenigen aus, die Sie verwenden möchten. i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 5 Alle Rechte vorbehalten 3. Integration der gewünschten Dashboard Applets in die HTML-Seite. Wie das funktioniert, wird im nächsten Kapitel beschrieben. 4. Speichern der HTML-Seite auf einem Web-Server, auf den von den gewünschten Clients zugegriffen werden kann. 5. Testen und ggf. Modifikation des Dashboards. Dieses Dokument beschreibt, wie Sie eigene Dashboards mit den i-Plant Dashboard Applets erstellen können. Es wendet sich somit an Systemadministratoren und Softwareentwickler, die über HTML-Kenntnisse verfügen. i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 6 Alle Rechte vorbehalten i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 7 Alle Rechte vorbehalten Voraussetzungen an die Systemumgebung Web-Server-Software Ein i-Plant Dashboard wird stets von einem Web-Server (HTTP-Server) geladen. Ein solcher Web-Server muss deshalb bereits erfolgreich installiert sein. Hierbei kann eine beliebige handelsübliche Software (z. B. Apache, MS IIS) verwendet werden. i-Plant-Systemumgebung i-Plant Dashboards setzen eine bereits erfolgreich installierte und getestete i-Plant-Systemumgebung voraus. Diese Systemumgebung besteht aus: •= einem i-Plant Directory Service •= mindestens einem i-Plant Data Source Connector, der das Bindeglied zur Automatisierungstechnik (z. B. SPS oder Roboter) darstellt •= einem i-Plant Proxy Server (dieser wird auf demselben Rechner installiert, auf dem der Web-Server läuft, von dem die Dashboards geladen werden) •= eventuell einem i-Plant Alarm Center, wenn auch Alarme im Dashboard angezeigt werden sollen. Es ist sinnvoll, die Systemumgebung mit dem i-Plant Explorer zu testen, bevor die Entwicklung von Dashboards begonnen wird. Das Archiv dashboard.jar Die i-Plant Dashboard Applets sind in dem Archiv dashboard.jar gespeichert. Dieses Archiv muss auf dem Web-Server installiert sein, von dem die Dashboards geladen werden. Bei den in diesem Dokument vorgestellten Codebeispielen gehen wir davon aus, dass sich das Archiv im Verzeichnis /iplant befindet. Client-seitige Voraussetzungen Auf dem Client, mit dem die Dashboards angezeigt werden, muss eine Java Virtual Machine Version 1.4.2 oder höher installiert sein. Ausserdem müssen die Browser-Sicherheitseinstellungen so gesetzt sein, dass Java-Applets geladen und ausgeführt werden dürfen. Integration von Applets in HTML-Seiten Jedes Dashboard ist technisch gesehen eine HTML-Seite. Diese HTML-Seite besteht zunächst wie jede andere HTML-Seite, die Sie aus dem Internet laden, aus statischen Elementen (Texten, Bildern, Tabellen usw.). Darüber hinaus enthält ein Dashboard dynamische Elemente, die ausgewählte Prozessvariablen "live" anzeigen. Hierzu dienen die i-Plant Dashboard Applets. Diese Applets müssen in dem vorbereiteten HTML-Code "nur" an die richtige Stelle gesetzt werden, und fertig ist das Dashboard. Die Einbindung eines Applets in eine HTML-Seite erfolgt grundsätzlich mit dem HTML-Tag <applet>. Attribute des applet-Tags •= Mit dem Attribut code identifizieren Sie, welches Applet geladen werden soll. Der Name des Applets erhält stets die Endung ".class". Da Sie für Dashboards lediglich zwei unterschiedliche Applets benötigen, tragen Sie hier entweder "com.langner.iplant.dashboard.FxmlProvider.class" ein oder "com.langner.iplant.dashboard.iPlantApplet.class". i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 8 Alle Rechte vorbehalten •= Mit dem Attribut archive legen Sie das Archiv fest, in dem das Applet gespeichert ist. Da alle i-Plant Dashboard Applets in dem Archiv "dashboard.jar" gespeichert sind, erhält dieses Attribut stets den Wert "dashboard.jar" (mit vorangestelltem Pfadnamen). •= Mit dem Attribut name können Sie einem Applet einen bestimmten Namen zuweisen. Dieser Name wird benötigt für das Applet FxmlProvider, damit der FxmlProvider von den Darstellungs-Applets "gefunden" werden kann. •= Mit den Attributen width und height legen Sie die Größe des Fensterbereichs fest, den das Applet für die Bildschirmausgabe nutzen darf. Bei dem Applet FxmlProvider, welches selbst keine Bildschirmausgaben vornimmt, werden diese Werte auf Null gesetzt. Inhalt des applet-Tags: Applet-Parameter Als Inhalt des applet-Tags werden Parameter für das Applet übergeben. Mit solchen Parametern wird zum Beispiel ausgewählt, welche Prozessvariable visualisiert werden soll. Die Syntax der Parameterübergabe besteht in einem paramTag, welches die Attribute name und value erhält. Mit dem Attribut name wird der Parametername identifiziert, mit dem Attribut value der Wert für diesen Parameter. Falls das jeweilige Applet Online-Datenmodifikationen per Java-Script vornehmen soll (siehe unten), muss das applet-Tag auch den Parameter MAYSCRIPT erhalten. Beispiel Das folgende HTML-Codebeispiel zeigt, wie die Einbindung eines Dashboard-Appets in der Praxis aussieht. In der in diesem Dokument enthaltenen Referenz finden Sie viele weitere Beispiele. <applet code="com.langner.iplant.dashboard.iPlantApplet.class" archive="/iplant/dashboard.jar" width="120" height="50"> <param name="dpaddress" value="Werk 1.Linie 2.Prozessdaten.Abgaskühler.Temperatur"> <param name="dashboard_class" value="iPlantText"> <param name="fontsize" value="18"> <param name="align" value="center"> <param name="bgcolor" value="blue"> <param name="fgcolor" value="yellow"> </applet> i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 9 Alle Rechte vorbehalten i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 10 Alle Rechte vorbehalten Die Verbindung zu den Daten: Das Applet FxmlProvider und der i-Plant Proxy Server Jede Dashboard-Seite benötigt eine Verbindung zu den Prozessvariablen eines i-Plant-Netzwerks. Diese Datenverbindung wird durch das Applet FxmlProvider geschaffen. Das Gegenstück zu diesem Applet ist ein i-Plant Proxy Server. Dieser Proxy Server ist ein i-Plant-Dienst, ähnlich dem i-Plant Directory Service oder dem i-Plant Alarm Center. Der i-Plant Proxy Server sorgt dafür, dass Web-Anwendungen auf einfache und effiziente Weise mit Live-Daten versorgt werden. Die Hostadresse des i-Plant Proxy Servers ist dem Dashboard bereits implizit bekannt, da der i-Plant Proxy Server stets auf demselben Rechner laufen muss, von dem die betreffende HTML-Seite geladen wird (also dort, wo sich der Web-Server befindet). Variabel hingegen ist die Portnummer des Proxy Servers, die beim Start desselben angegeben wird. Es können auf einem Rechner auch mehrere Proxy Server laufen. Deshalb muss dem Applet FxmlProvider die Portnummer mitgeteilt werden, sofern nicht die Voreinstellung verwendet wird. Hierzu dient der Parameter proxy_port. Anzeige von Datenpunkten und Alarmen: Das Applet iPlantApplet Die eigentliche Anzeige der Daten, die von dem Applet FxmlProvider geliefert werden, erfolgt durch das Applet iPlantApplet. Dieses Applet beinhaltet eine Reihe ganz unterschiedlicher Darstellungsvarianten. Die gewünschte Darstellungsvariante wird über den Parameter dashboard_class festgelegt. Das allerkleinste Dashboard, welches lediglich einen einzigen Datenpunkt anzeigt, besteht somit aus einem FxmlProviderApplet und aus einem iPlantApplet. Normalerweise werden jedoch mehrere Visualisierungs-Applets in einem Dashboard verwendet, um mehrere Prozessvariablen gleichzeitig anzuzeigen. Gestaltvarianten i-Plant bietet viele unterschiedliche Möglichkeiten zur Anzeige von Datenpunkten und Alarmen – zum Beispiel Textanzeigen und Analoganzeigen. Die Auswahl der gewünschten Gestaltvariante erfolgt mit dem Parameter dashboard_class beim Applet iPlantApplet. •= Datenpunktbezogen zustandsorientiert: iPlantHBar horizontales Balkendiagramm iPlantVBar vertikales Balkendiagramm iPlantMeter Analog- oder Digitalanzeige eines Datenpunkts iPlantText Textanzeige iPlantDateTime Anzeige eines Zeitpunkts verlaufsorientiert: iPlantShortHistory Kurzzeitverlauf iPlantTrendArrow Trendpfeil Metadaten: iPlantImage •= Anzeige der für diesen Datenpunkt hinterlegten Grafik Alarmbezogen iPlantAlarmIcon Anzeige des Dringlichkeits-Icons eines Alarms (sofern ausgelöst) iPlantAlarmText Anzeige der Textbeschreibung eines Alarms (sofern ausgelöst) i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 11 Alle Rechte vorbehalten Farbwahl Bei fast allen Gestaltvarianten können Vorder- und Hintergrundfarben vorgegeben werden, um ein optimales Layout für das Dashboard realisieren zu können. Die Angabe einer Hintergrundfarbe erfolgt mit dem Parameter bgcolor des Applets iPlantApplet. Bei den Gestaltvarianten, bei denen die Angabe einer Vordergrundfarbe möglich ist, dient hierzu der Parameter fgcolor. Farben werden entweder als Farbnamen oder als hexadezimale RGB-Werte angegeben. Bei der RGB-Darstellung erfolgt die Farbangabe durch Spezifikation der Sättigung von Rot, Grün und Blau, wobei die Sättigung einen Wert zwischen Null und 255 (hexadezimal FF) haben kann. Somit hat Schwarz den Wert #000000, Rot den Wert #FF0000, Grün den Wert #00FF00, Blau den Wert #0000FF und Weiß den Wert #FFFFFF. Darüber hinaus stehen folgende symbolische Farbnamen zur Verfügung: Farbe Farbname Farbe Farbname Weiß white Grün green Schwarz black Orange orange Blau blue Gelb yellow Rot red Violett magenta Grau gray Türkies cyan Dunkelgrau darkgray Rosa pink Die Farbnamen können wahlweise in Groß- oder in Kleinschreibung angegeben werden. Wertebereiche, Maßeinheiten und Bildresourcen Einige Dashboard-Applets benötigen bestimmte Metadaten, also "Daten über Daten". Beispiele für solche Metadaten sind •= Wertebereiche, die es den Gestaltvarianten iPlantHBar, iPlantVBar, iPlantMeter und iPlantShortHistory ermöglichen, eine automatische Skalierung vorzunehmen. •= Maßeinheiten, die bei iPlantText verwendet werden •= Bildinformationen, die mit iPlantImage angezeigt werden. Alle hier genannten Metadaten sind dezentral in den i-Plant Data Source Connectors gespeichert. Eine Änderung dieser Metadaten kann daher nicht im Dashboard erfolgen, sondern nur in der Konfiguration des betreffenden Data Source Connectors. Benutzerinteraktion Ein Dashboard-Element kann auch interaktiv verwendet werden. Bei einem Mausklick auf ein Dashboard-Element wird der Web-Link geöffnet, der mit dem Parameter linkURL im Applet iPlantApplet definiert ist. Authentifizierung Die Authentifizierung wird beim Laden der betreffenden HTML-Seite automatisch vom Applet FxmlProvider vorgenommen. Dieses Applet startet einen Dialog zur Eingabe von Benutzername und Passwort. Der Dialog zur Authentifizierung erfolgt nur einmal pro Seite, selbst wenn auf der betreffenden Seite mehrere Dashboard-Applets enthalten sind. Online-Datenmodifikation innerhalb der Anwendung Ein i-Plant Data Source Connector liefert die Daten nicht immer so, wie es von einer bestimmten Anwendung benötigt wird. Beispiel: Der Data Source Connector liefert die Werte eines Temperaturfühlers in Grad Celsius, die Anzeige soll jedoch in i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 12 Alle Rechte vorbehalten Grad Fahrenheit erfolgen. Das Applet iPlantApplet bietet daher die Möglichkeit einer Online-Datenmodifikation. Diese Möglichkeiten betreffen: •= die Maßeinheit eines Datenpunkts •= den Datentyp eines Datenpunkts •= die Inhaltsbeschreibung eines Datenpunkts •= die einem Datenpunkt zugeordneten Ressourcen (z. B. Bildinformationen) •= den Wert eines Datenpunkts. Maßeinheiten werden lediglich von der Gestaltvariante iPlantMeter angezeigt. Deshalb kann die Maßeinheit nur bei dieser Gestaltvariante konfiguriert werden. Der entsprechende Parameter lautet unit_override. Wertemodifikation per Java-Script Die Online-Modifikation von Werten und den anderen genannten Metadaten erfolgt über Methoden eines benutzerdefinierten Java-Scripts, welches sich in derselben HTML-Seite befindet, in der die Dashboard Applets geladen werden. Wichtig: Bitte beachten Sie, dass hierzu dem <applet>-Tag der Parameter MAYSCRIPT übergeben werden muss. Die entsprechenden Methoden werden von der jeweiligen Instanz des iPlantApplets aufgerufen, wenn ein neuer Wert vom Data Source Connector gemeldet wurde oder nachdem das Datenprofil eingelesen wurde (Initialisierung nach dem Laden des Applets). Mit dem Parameter on_new_value wird dem Applet iPlantApplet der Name einer Scriptfunktion mitgeteilt, die beim Eintreffen eines neuen Werts aufgerufen werden soll. Der Rückgabewert dieser Scriptfunktion wird von der Instanz des Applets als Wert angezeigt Mit dem Parameter on_profile wird dem Applet iPlantApplet der Name einer Scriptfunktion mitgeteilt, die beim Einlesen des Datenprofils aufgerufen wird und dazu genutzt werden kann, Metadaten des betreffenden Datenpunkts zu ändern und/oder zu ergänzen. Hierzu können mehrere Unterfunktionen benutzt werden, die in der Referenz von iPlantApplet beschrieben sind. Beispiel Das folgende HTML-Codebeispiel zeigt, wie die Online-Datenmodifikation per Java-Script funktioniert. Ein Data Source Connector liefert eine Schichtdauer in Minuten, die Anwendung möchte diesen Wert jedoch in Stunden anzeigen. Ausserdem soll der Wertebereich auf Null bis Acht festgelegt werden. Hierfür wird folgender HTML/Java-Script-Code verwendet: <html> <head> <title>i-Plant Anwendungsbeispiele für die Korrektur der Dimension</title> <script language="javascript"> function MinToHour(Address,Value,Unit,Date) { return String(Value/60) } function profileHour(Address,Profile) { Profile.setINTEGER("Stunden","0","8") } </script> </head> <body> <applet code="com.langner.iplant.dashboard.FxmlProvider.class" archive="dashboard.jar" width="0" height="0" name="FxmlProvider"> <param name="proxy_port" value="42000" /> </applet> <applet code="com.langner.iplant.dashboard.iPlantApplet.class" archive="dashboard.jar" width="120" height="50" name="Laufzeit" MAYSCRIPT> <param name="provider" value="FxmlProvider" /> <param name="dpaddress" value="Datasource.Schichtdauer" /> i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 13 Alle Rechte vorbehalten <param name="dashboard_class" value="com.langner.iplant.dashboard.iPlantMeter" /> <param name="on_new_value" value="MinToHour" /> <param name="on_profile" value="profileHour" /> </applet> </body> </html> Die benutzerdefinierte Funktion MinToHour wandelt in diesem Script Minuten in Stunden um. Bitte beachten Sie die Typkonvertierung mit der Funktion String(), die erforderlich ist, weil das Script in jedem Fall den Datentyp String zurückliefern muss. Ausserdem wird mit der Funktion profileHour die Einheit auf Stunden gesetzt und der Wertebereich von Null bis Acht definiert. Der Parameter MAYSCRIPT im applet-Tag sorgt dafür, dass die Applet-Instanz überhaupt ScriptFunktionen aufrufen darf. i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 14 Alle Rechte vorbehalten i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 15 Alle Rechte vorbehalten FxmlProvider Beschreibung Das Applet FxmlProvider fungiert als Datenlieferant für die im Dashboard verwendeten Visualisierungen. Es stellt eine Verbindung zu einem i-Plant Proxy Server her. Der betreffende i-Plant Proxy Server muss auf demselben Rechner laufen, auf dem sich der Web Server befindet, von dem das Dashboard heruntergeladen wurde. Die Portadresse des i-Plant Proxy Servers wird mit dem Parameter proxy_port angegeben, sofern nicht die Voreinstellung (42000) verwendet wird. In einem Dashboard muss es mindestens einen FxmlProvider geben. Mehrere FxmlProvider sind möglich, aber nicht notwendig. Die Hauptaufgabe eines FxmlProvider-Applets besteht darin, den Datenstrom zu bündeln, so dass nicht jedes Visualisierungs-Applet eine eigene Datenverbindung zu einem i-Plant Proxy Server unterhalten muss. Bei Verwendung eines einzigen FxmlProviders weisen Sie diesem auf jeden Fall den Namen "FxmlProvider" zu (wie im unten gezeigten Beispiel), da dieser Name als Voreinstellung für das Applet iPlantApplet benutzt wird. Wenn mehrere FxmlProvider in einem Dashboard benutzt werden, müssen diese unterschiedliche Namen haben, und über den Parameter provider wird dann bei jedem iPlantApplet festgelegt, welchen Provider dieses Applet benutzt. Parameter proxy_port Portnummer des i-Plant Proxy Servers. Mögliche Werte: 0..65535 HTML-Codebeispiel <applet code="com.langner.iplant.dashboard.FxmlProvider.class" archive="/iplant/dashboard.jar" width="0" height="0" name="FxmlProvider"> <param name="proxy_port" value="43000"> </applet> i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 16 Alle Rechte vorbehalten iPlantApplet Beschreibung Das Applet iPlantApplet ist das zentrale Applet zur Anzeige von Datenpunkten und Alarmen. Durch Angabe einer bestimmten Gestaltvariante (mit dem Parameter dashboard_class) wird die Darstellungsart festgelegt. In einem Dashboard können beliebig viele iPlantApplets verwendet werden, die normalerweise alle auf ein FxmlProvider-Applet zugreifen. Die Angabe des gewünschten Datenpunkts oder Alarms erfolgt mit dem Parameter dpaddress. Hierbei wird folgende Syntax verwendet: Referenzierung Angabe des gewünschten i-Plant Data Source Connectors, dahinter mit Punkt abgetrennt Angabe der von Datenpunkten Datenpunktadresse. Die Bestandteile der Datenpunktadresse werden wiederum mit Punkten voneinander abgetrennt. Beispiel: Linie 2.Maschinendaten.Materialmangelzeit Referenzierung von Alarmen Angabe des gewünschten i-Plant Alarm Centers, dahinter mit Punkt abgetrennt Angabe der vom Benutzer konfigurierten Identifikation des Alarms. Beispiel: AC Werk 1.Stillstand Linie 2 Parameter provider Name des FxmlProvider-Applets. Der hier eingetragene Wert muss mit dem Wert übereinstimmen, der dem gewünschten FxmlProvider-Applet mit dessen Parameter applet.name zugewiesen wurde. Wenn es in dem Dashboard nur einen FxmlProvider gibt (das ist der Normalfall), kann dieser Parameter weggelassen werden. Es muss dann jedoch beim FxmlProvider der Applet-Name "FxmlProvider" gesetzt worden sein. dpaddress Adresse des Datenpunkts oder des Alarms, der angezeigt werden soll. Bei einem Datenpunkt beginnt die Adresse mit dem Namen eines i-Plant Data Source Connectors, bei einem Alarm beginnt die Adresse mit dem Namen eines Alarm Centers (siehe oben). dashboard_class Name der gewünschten Gestaltvariante (siehe folgendes Kapitel). bgcolor Hintergrundfarbe. Die Angabe des Werts erfolgt entweder mit einem Farbnamen oder mit einem hexadezimalen RGB-Wert (siehe oben). Voreinstellung: white. linkURL Mit diesem Parameter kann ein Hyperlink angegeben werden, der geöffnet wird, wenn der Benutzer einen Mausklick auf dem Applet ausführt. on_new_value Name einer Scriptfunktion, die beim Eintreffen eines neuen Werts aufgerufen wird und dazu verwendet werden kann, einen modifizierten Wert anzuzeigen. Der modifizierte Wert wird dem Applet als Rückgabewert der Scriptfunktion geliefert. Der Rückgabewert muß den Datentyp String haben. Die Scriptfunktion erhält folgende Parameter, die alle als String übergeben werden: on_profile Address Datenpunktadresse Value gemeldeter Wert (Eingangswert) Unit im Datenprofil gespeicherte Maßeinheit Date Zeitstempel des Eingangswerts Name einer Scriptfunktion, die beim Einlesen des Datenprofils aufgerufen wird und dazu verwendet werden kann, Metadaten zu modifizieren und/oder zu ergänzen. Die Scriptfunktion erhält folgende Parameter, die als String übergeben werden: i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 17 Alle Rechte vorbehalten Address Datenpunktadresse Object Bezeichnung des Objekts, mit dem die Datenmanipulation durchgeführt werden soll (s. u.) Es wird kein Rückgabewert zurück geliefert. "Object" verweist auf ein Objekt innerhalb des Dashboard Applets, mit dem die Manipulation erfolgen soll. Folgende Funktionen können über das Objekt aufgerufen werden: setBOOL() Ändert den Datentyp auf Boolean setSTRING(unit) Ändert den Datentyp auf String und setzt die Maßeinheit auf den mit "unit" angegebenen Wert setINTEGER(unit,min,max) Ändert den Datentyp auf Integer und setzt den Minimal- und Maximalwert setFLOAT(unit,min,max) Ändert den Datentyp auf Float und setzt den Minimal- und Maximalwert setBINARY() Ändert den Datentyp auf Binary addContentInfo(content,info) Fügt dem Profil eine neue Inhaltsbeschreibung zu. Der Parameter "content" gibt den Typ der Inhaltsbeschreibung an. Der Parameter "info" enthält einen Hyperlink (URL), der auf die Beschreibung zeigt. addResource(content,res) Fügt dem Profil eine neue Ressource hinzu. Der Parameter "content" gibt den Typ der Ressource an. Der Parameter "res" enthält einen Hyperlink (URL), der auf die Ressource zeigt. weitere Parameter Das Applet iPlantApplet erhält normalerweise noch weitere Parameter in Abhängigkeit der ausgewählten Gestaltvariante. Die möglichen Parameter sind in der Referenz der Gestaltvarianten aufgeführt. HTML-Codebeispiel <applet code="com.langner.iplant.dashboard.iPlantApplet.class" archive="/iplant/dashboard.jar" width="120" height="50"> <param name="dpaddress" value="Werk 1.Linie 2.Betriebsdaten.Losnummer"> <param name="dashboard_class" value="iPlantText"> <param name="fontsize" value="18"> <param name="align" value="center"> <param name="bgcolor" value="red"> <param name="fgcolor" value="white"> </applet> i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 18 Alle Rechte vorbehalten i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 19 Alle Rechte vorbehalten iPlantAlarmIcon Beispiel Beschreibung Anzeige des Dringlichkeits-Icons zu einem bestimmten Alarm. Ein Alarm in i-Plant kann eine von folgenden Dringlichkeitsstufen haben, die vom Benutzer konfiguriert wird: •= kritischer Fehler •= unkritischer Fehler •= Warnung •= Information Jeder Dringlichkeitsstufe ist ein bestimmtes Icon fest zugewiesen. Diese Dashboard-Klasse zeigt das Dringlichkeits-Icon des angegebenen Alarms grafisch an. Ist der betreffende Alarm nicht ausgelöst, wird nichts (nur die Hintergrundfarbe) angezeigt. Spezielle Parameter für diese Gestaltvariante keine Besonderheiten Anstelle einer Datenpunktadresse wird als Parameter dpaddress die vom Benutzer in der Alarmkonfiguration vergebene Bezeichnung des Alarms angegeben. Dieser Bezeichnung wird die Adresse des betreffenden Alarm Centers, durch einen Punkt abgetrennt, vorangestellt. HTML-Codebeispiel <applet code="com.langner.iplant.dashboard.iPlantApplet.class" archive="/iplant/dashboard.jar" width="50" height="50"> <param name="dpaddress" value="AC Werk 1.Stillstand Linie 2"> <param name="dashboard_class" value="iPlantAlarmIcon"> </applet> i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 20 Alle Rechte vorbehalten iPlantAlarmText Beispiel Beschreibung Anzeige einer Alarmnachricht, sofern der betreffende Alarm ausgelöst ist. Wenn der betreffende Alarm nicht ausgelöst ist, wird nur die Hintergrundfarbe angezeigt. Spezielle Parameter für diese Gestaltvariante fgcolor Vordergrundfarbe. Die Angabe des Werts erfolgt entweder mit einem Farbnamen oder mit einem hexadezimalen RGB-Wert (siehe oben). Voreinstellung: black. fontsize Schriftgröße in Punkt align Ausrichtung des Textes. Eingabemöglichkeiten: left (linksbündig), center (zentriert) Besonderheiten Die Auswahl des gewünschten Alarms erfolgt mit dem Parameter dpaddress. Dort wird die vom Benutzer in der Alarmkonfiguration vergebene Bezeichnung des Alarms angegeben. Dieser Bezeichnung wird die Adresse des betreffenden Alarm Centers, durch einen Punkt abgetrennt, vorangestellt. HTML-Codebeispiel <applet code="com.langner.iplant.dashboard.iPlantApplet.class" archive="/iplant/dashboard.jar" width="120" height="50"> <param name="dpaddress" value="AC Werk 1.Lötofentemperatur zu niedrig"> <param name="dashboard_class" value="iPlantAlarmText"> <param name="fontsize" value="18"> <param name="align" value="center"> <param name="bgcolor" value="blue"> <param name="fgcolor" value="white"> </applet> i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 21 Alle Rechte vorbehalten iPlantDateTime Beispiel Beschreibung Anzeige von Datum und Uhrzeit. Mit dieser Gestaltvariante können Zeitpunkte wie zum Beispiel die Startzeit einer Schicht oder eines Auftrags in beliebigem Format angezeigt werden. Oft ist das Originalformat der entsprechenden Prozessvariablen nicht für eine ergonomische Bildschirmausgabe geeignet. Mit iPlantDateTime kann dann eine einfache Umformatierung vorgenommen werden. Spezielle Parameter für diese Gestaltvariante fgcolor Vordergrundfarbe. Die Angabe des Werts erfolgt entweder mit einem Farbnamen oder mit einem hexadezimalen RGB-Wert (siehe oben). Voreinstellung: black. fontsize Schriftgröße in Punkt align Ausrichtung des Textes. Eingabemöglichkeiten: left (linksbündig), center (zentriert) inputpattern Eingabeformat, entsprechend der Java-Klasse SimpleDateFormat. Beispiel: dd.MM.yyyy HH:mm:ss outputpattern Ausgabeformat, entsprechend der Java-Klasse SimpleDateFormat Besonderheiten Die Verwendung dieser Gestaltvariante macht nur Sinn in Zusammenhang mit Prozessvariablen, die Zeitpunkte darstellen. HTML-Codebeispiel <applet code="com.langner.iplant.dashboard.iPlantApplet.class" archive="/iplant/dashboard.jar" width="120" height="50"> <param name="dpaddress" value="Werk 1.Linie 2.Maschinendaten.Schichtanfang"> <param name="dashboard_class" value="iPlantDateTime"> <param name="fontsize" value="18"> <param name="align" value="center"> <param name="bgcolor" value="blue"> <param name="fgcolor" value="white"> </applet> i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 22 Alle Rechte vorbehalten iPlantHBar Beispiel Beschreibung Horizontales Balkendiagramm. Spezielle Parameter für diese Gestaltvariante fgcolor Vordergrundfarbe. Die Angabe des Werts erfolgt entweder mit einem Farbnamen oder mit einem hexadezimalen RGB-Wert (siehe oben). Voreinstellung: red. style Dieses Applet unterstützt mehrere Darstellungsformen. Grundsätzlich kann zwischen einem gerasterten Balken ("LED-Darstellung") und einem nicht gerasterten Balken gewählt werden. Der nicht gerasterte Balken kann zwei- (2D) oder dreidimensional (3D) dargestellt werden. Bei Verwendung von gerasterten Balken kann der Balken wahlweise in der Mitte getrennt werden (LED2) oder nicht (LED). Mögliche Werte: 2D, 3D, LED, LED2 segment_size Höhe der Rastersegmente in Pixeln bei LED-Darstellung segment_space Bei LED-Darstellung: Angabe, wie viel Pixel Zwischenraum zwischen den Rastersegmenten gelassen werden soll. ledcoloron Bei LED-Darstellung: Angabe der Farbe, die für den Zustand "an" verwendet werden soll ledcoloroff Bei LED-Darstellung: Angabe der Farbe, die für den Zustand "aus" verwendet werden soll Besonderheiten Diese Gestaltvariante kann nur für Datenpunkte verwendet werden, bei denen ein Wertebereich (Range) vorgegeben ist. HTML-Codebeispiel <applet code="com.langner.iplant.dashboard.iPlantApplet.class" archive="/iplant/dashboard.jar" width="120" height="50"> <param name="dpaddress" value="Werk 1.Linie 2.Prozessdaten.Abgaskühler.Temperatur"> <param name="dashboard_class" value="iPlantHBar"> <param name="style" value="2D"> <param name="bgcolor" value="white"> <param name="fgcolor" value="green"> </applet> i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 23 Alle Rechte vorbehalten iPlantImage Beispiel Beschreibung Anzeige einer Bildresource, die zu dem betreffenden Datenpunkt abgelegt ist. Es kann zwischen unterschiedlichen Bildresourcen gewählt werden. Spezielle Parameter für diese Gestaltvariante content Angabe der Resource, die angezeigt werden soll. Mögliche Werte sind SMALL_ICON, ICON, BIG_ICON und IMAGE. HTML-Codebeispiel <applet code="com.langner.iplant.dashboard.iPlantApplet.class" archive="/iplant/dashboard.jar" width="150" height="150"> <param name="dpaddress" value="Werk 1.Linie 2.Antrieb 3"> <param name="dashboard_class" value="iPlantImage"> <param name="content" value="image"> </applet> i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 24 Alle Rechte vorbehalten iPlantMeter Beispiel Beschreibung Anzeige einer numerischen (skalaren) Prozessvariable. Wenn für die Prozessvariable ein Wertebereich festgelegt ist, erfolgt die Darstellung automatisch als AnalogZeigerinstrument. Ist kein Wertebereich festgelegt, erfolgt die Darstellung als Sieben-Segment-Anzeige. Spezielle Parameter für diese Gestaltvariante fgcolor Vordergrundfarbe lightcolor Farbe der nicht aktiven Segmente bei Sieben-Segment-Anzeige metercolor Farbe der Anzeigenadel bei Analog-Zeigerinstrument bordercolor Farbe der Umrahmung unit_override Mit diesem Parameter kann eine eventuell in der Datenquelle vorkonfigurierte Maßeinheit überschrieben werden HTML-Codebeispiel <applet code="com.langner.iplant.dashboard.iPlantApplet.class" archive="/iplant/dashboard.jar" width="150" height="50"> <param name="dpaddress" value="Werk 1.Linie 2.Lötofen.Temperatur"> <param name="dashboard_class" value="iPlantMeter"> </applet> i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 25 Alle Rechte vorbehalten iPlantShortHistory Beispiel Beschreibung Kurzzeit-Verlaufsgrafik für den ausgewählten Datenpunkt. Die Verlaufsgrafik wird live von recht nach links "mitgeschrieben". Die "Papierfarbe" wird mit dem Parameter bgcolor gesetzt. Beim Bewegen des Mauszeigers auf die Verlaufsgrafik und Klicken (und Gedrückthalten) des linken Maus-Buttons wird der Wert, auf dem sich der Mauszeiger befindet, zusätzlich numerisch angezeigt. Dabei erscheint am oberen Bildrand die Anzeige des Maximums für den ausgewählten Zeitpunkt und am unteren Bildrand die Anzeige des Minimums für den ausgewählten Zeitpunkt. Der Mauszeiger kann bei gedrückt gehaltenem Maus-Button nach links und rechts verschoben werden, was eine Verschiebung der Anzeigelinie bewirkt. Spezielle Parameter für diese Gestaltvariante fgcolor Farbe des "Stifts" scalecolor Farbe des Gitternetzes, falls ein Gitternetz aktiviert ist scalelines Anzeige eines Gitternetzes (HOR = horizontales Gitternetz, VERT = vertikales Gitternetz, BOTH = horizontales und vertikales Gitternetz, NONE = kein Gitternetz) time Angezeigter Zeitraum in Sekunden. Bei Angabe des Werts Null wird die Grafik nicht kontinuierlich, sondern nur bei Werteänderungen fortgeschrieben. Besonderheiten Dieses Applet kann nur für Datenpunkte verwendet werden, bei denen ein Wertebereich (Range) konfiguriert ist. HTML-Codebeispiel <applet code="com.langner.iplant.dashboard.iPlantApplet.class" archive="/iplant/dashboard.jar" width="150" height="150"> <param name="dpaddress" value="Werk 1.Linie 2.Antrieb 3.Drehzahl"> <param name="dashboard_class" value="iPlantShortHistory"> <param name="fgcolor" value="orange"> <param name="bgcolor" value="white"> <param name="scalelines" value="both"> <param name="scalecolor" value="gray"> <param name="time" value="60"> </applet> i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 26 Alle Rechte vorbehalten iPlantText Beispiel Beschreibung Anzeige des Wertes eines Datenpunkts als Text. Falls zu diesem Datenpunkt eine Maßeinheit konfiguriert ist, wird diese automatisch mit angegeben. Spezielle Parameter für diese Gestaltvariante fgcolor Textfarbe fontsize Schriftgröße in typografischen Punkt align Textausrichtung (left = linksbündig, center = mittig, right = rechtsbündig) precision Anzahl der angezeigten Nachkommastellen für Fließkommawerte unit_override Mit diesem Parameter kann eine evtl. in der Datenquelle konfigurierte Maßeinheit überschrieben werden. HTML-Codebeispiel <applet code="com.langner.iplant.dashboard.iPlantApplet.class" archive="/iplant/dashboard.jar" width="150" height="30"> <param name="dpaddress" value="Werk 1.Linie 2.Kraftstoffverbrauch"> <param name="dashboard_class" value="iPlantText"> <param name="bgcolor" value="red"> <param name="fgcolor" value="yellow"> <param name="fontsize" value="24"> <param name="align" value="center"> <param name="precision" value="1"> </applet> i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 27 Alle Rechte vorbehalten iPlantTrendArrow Beispiel Beschreibung Trendpfeil für numerische Prozessvariablen. Der Pfeil kann fünf Zustände einnehmen: steil nach oben, 45% nach oben, horizontal, 45% nach unten, steil nach unten. Spezielle Parameter für diese Gestaltvariante media_count Anzahl der Werte, die in die Mittelwertbildung einbezogen werden gradient Zunahme oder Abnahme in Prozent, die erreicht werden muss, damit der Vollausschlag angezeigt wird threshold Minimale Änderung des Datenpunkts in Prozent, die zu einer Zustandsänderung des Trendpfeils führt up_color Vordergrundfarbe, die für den nach oben gerichteten Pfeilen verwendet wird down_color Vordergrundfarbe, die für den nach unten gerichteten Pfeilen verwendet wird neutral_color Vordergrundfarbe, die für den horizontalen Pfeil verwendet wird HTML-Codebeispiel <applet code="com.langner.iplant.dashboard.iPlantApplet.class" archive="/iplant/dashboard.jar" width="50" height="50"> <param name="dpaddress" value="Werk 1.Linie 2.Prozessdaten.Antrieb 3.Drehzahl"> <param name="dashboard_class" value="iPlantTrendArrow"> <param name="media_count" value="10"> <param name="bgcolor" value="white"> <param name="up_color" value="red"> <param name="neutral_color" value="black"> <param name="down_color" value="green"> <param name="threshold" value="5"> <param name="gradient" value="50"> </applet> i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 28 Alle Rechte vorbehalten iPlantVBar Beispiel Beschreibung Vertikales Balkendiagramm. Spezielle Parameter für diese Gestaltvariante fgcolor Vordergrundfarbe. Die Angabe des Werts erfolgt entweder mit einem Farbnamen oder mit einem hexadezimalen RGB-Wert (siehe oben). Voreinstellung: red. style Dieses Applet unterstützt mehrere Darstellungsformen. Grundsätzlich kann zwischen einem gerasterten Balken ("LED-Darstellung") und einem nicht gerasterten Balken gewählt werden. Der nicht gerasterte Balken kann zwei- (2D) oder dreidimensional (3D) dargestellt werden. Bei Verwendung von gerasterten Balken kann der Balken wahlweise in der Mitte getrennt werden (LED2) oder nicht (LED). Mögliche Werte: 2D, 3D, LED, LED2 segment_size Höhe der Rastersegmente in Pixeln bei LED-Darstellung segment_space Bei LED-Darstellung: Angabe, wie viel Pixel Zwischenraum zwischen den Rastersegmenten gelassen werden soll. ledcoloron Bei LED-Darstellung: Angabe der Farbe, die für den Zustand "an" verwendet werden soll ledcoloroff Bei LED-Darstellung: Angabe der Farbe, die für den Zustand "aus" verwendet werden soll Besonderheiten Diese Gestaltvariante kann nur für numerische Datenpunkte verwendet werden, bei denen ein Wertebereich (Range) vorgegeben ist. HTML-Codebeispiel <applet code="com.langner.iplant.dashboard.iPlantApplet.class" archive="/iplant/dashboard.jar" width="50" height="250"> <param name="dpaddress" value="Werk 1.Linie 2.Prozessdaten.Abgaskühler.Temperatur"> <param name="dashboard_class" value="iPlantVBar"> <param name="style" value="2D"> <param name="bgcolor" value="white"> <param name="fgcolor" value="green"> </applet> i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 29 Alle Rechte vorbehalten i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 30 Alle Rechte vorbehalten Langzeit-Verlaufsgrafiken gegenüber Kurzzeit-Verlaufsgrafiken Die Gestaltvariante iPlantShortHistory bietet eine Live-Verlaufsgrafik, mit der sich die Entwicklung einer Prozessvariablen gut visualisieren lässt. Diese Verlaufsgrafik ist jedoch nur für Kurzzeit-Verläufe von einigen Minuten geeignet. In der Praxis entsteht manchmal auch der Wunsch, einen Verlauf über längere Zeiträume zu beobachten, oder einen Zeitraum in der Vergangenheit anzeigen zu lassen (Beispiel: "wie hat sich diese Prozessvariable gestern, vorige Woche, vorigen Monat entwickelt?"). Entsprechende Grafiken werden vom i-Plant Resource Center wahlweise im JPEG- oder im PNG-Format geliefert. Das i-Plant Resource Center ist ein Dienst ähnlich dem i-Plant Directory Service und dem i-Plant Alarm Center. Wie solche Langzeit-Verlaufsgrafiken aussehen, zeigt zum Beispiel der i-Plant Explorer (im unteren Screenshot ist die Langzeit-Verlaufsgrafik durch Umrandung hervorgehoben). Voraussetzungen an die Systemumgebung Voraussetzung für den Zugriff auf eine Langzeit-Verlaufsgrafik ist zunächst, dass der i-Plant Historian und das i-Plant Resource Center installiert sind. •= Der i-Plant Historian ist eine Datenbankschnittstelle, mit der der Verlauf von beliebigen Prozessvariablen gespeichert werden kann. Die Speicherung erfolgt in einer handelsüblichen Datenbank (z. B. Oracle, MS SQL Server), die nicht Bestandteil des i-Plant Historians ist. Diese Datenbank muss auch nicht auf demselben Rechner laufen, auf dem der iPlant Historian läuft. •= Das i-Plant Resource Center bietet die Möglichkeit, mit einfachen Systemaufrufen eine Langzeit-Verlaufsgrafik für eine bestimmte Prozessvariable zu erzeugen. Dabei greift das i-Plant Resource Center intern auf den i-Plant Historian zu, um sich von dort die entsprechenden Verlaufsdaten zu beschaffen. Ob die Installationsvoraussetzungen gegeben sind, kann mit dem i-Plant Explorer leicht überprüft werden. LangzeitVerlaufsgrafiken, die vom i-Plant Explorer angezeigt werden, können auch innerhalb eigener Dashboards verwendet werden (entsprechende Zugriffsrechte vorausgesetzt). i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 31 Alle Rechte vorbehalten Abfrage des i-Plant Resource Centers Das i-Plant Resource Center kann wie ein Web-Server angesprochen werden. Es stellt nach aussen hin eine HTTPSchnittstelle zur Verfügung, auf die mit einer gewöhnlichen URL zugegriffen werden kann. Dadurch kann eine LangzeitVerlaufsgrafik sehr einfach in eine beliebige HTML-Seite und somit auch in ein Dashboard integriert werden. Hierzu wird einfach ein normales <IMG>-Tag benutzt. Zunächst müssen Sie den Hostnamen des Rechners kennen, auf dem das i-Plant Resource Center läuft. Das kann, muss aber nicht derselbe Rechner sein, auf dem sich der Web-Server befindet. Ausserdem müssen Sie wissen, welche Portnummer das i-Plant Resource Center verwendet. Diese Portnummer wird in der Konfiguration des i-Plant Resource Centers festgelegt. In den folgenden Beispielen gehen wir davon aus, dass das i-Plant Resource Center auf dem Rechner "iPlantServer" läuft und die Portnummer 9000 verwendet. Der erste Teil der URL ist damit bereits vorgegeben. Die vom i-Plant Resource Center gelieferten "Dokumente" werden dynamisch erzeugt. Der Abruf einer LangzeigVerlaufsgrafik erfolgt stets dadurch, dass auf das Wurzeldokument des Resource-Center-Web-Servers zugegriffen wird und mit einem Satz von Parametern festgelegt wird, welche Verlaufsgrafik benötigt wird. Parameter werden in einer URL vom Basis-Pfadnamen durch Fragezeichen abgetrennt. Wenn mehrere Parameter übergeben werden, werden die einzelnen Parameter durch das Sonderzeichen "&" voneinander abgetrennt. Es ergibt sich somit folgende Schematik: http://iPlantServer:9000/?param1=value1¶m2=value2¶m3=value3 Die Parameterübergabe beginnt hier direkt auf Wurzelebene. In diesem Beispiel werden drei Parameter mit den Namen "param1", "param2" und "param3" übergeben, denen jeweils die Werte "value1", "value2" und "value3" zugewiesen werden. Wenn Sie nach dieser Schematik das i-Plant Resource Center abfragen und die unten beschriebenen Parameter übergeben, liefert das Resource Center die gewünschte Langzeit-Verlaufsgrafik zurück. URL-Parameter für das i-Plant Resource Center Bei der Abfrage des i-Plant Resource Centers sind folgende URL-Parameter möglich: name Datenpunktadresse. Wie stets in i-Plant beginnt die Datenpunktadresse mit der Adresse des Data Source Connectors. Dahinter folgt, durch einen Punkt abgetrennt, die Adresse der gewünschten Prozessvariablen, deren hierarchische Bestandteile ebenfalls durch Punkte voneinander abgetrennt werden. start Startzeitpunkt, angegeben als FactoryXML-Zeitstempel. end Endezeitpunkt, angegeben als FactoryXML-Zeitstempel. count Maximale Anzahl der zu verwendenden Werte. Voreinstellung: 30 sizex Breite der angeforderten Grafik in Pixel. Voreinstellung: 400 sizey Höhe der angeforderten Grafik in Pixel. Voreinstellung: 300 fmt Grafikformat der Ausgabe. Das i-Plant Resource Center unterstützt die Formate JPEG (Joint Picture Experts Group) und PNG (Portable Network Graphics). Voreinstellung: JPEG. Ein Beispiel für eine URL zum Abruf einer Verlaufsgrafik für den Datenpunkt "Werk 1.Linie 2.Prozessdaten.Antrieb 3.Drehzahl" sieht somit wie folgt aus: http://iPlantServer:9000/?name= Werk%201.Linie%202.Prozessdaten.Antrieb%203.Drehzahl &sizex=600&sizey=400&start=20030117T090000.000Z&end=20030117T170000.000Z&fmt=PNG Als Startzeitpunkt ist hier der 17.1.2003, 9:00 Uhr angegeben und als Endzeitpunkt der 17.1.2003, 17:00 Uhr. Als Ausgabeformat wird PNG angefordert. Dimensionierung der Langzeit-Verlaufsgrafik Bei der Angabe von Start- und Endezeitpunkt sowie bei der Angabe der maximalen Anzahl von Werten sind folgende Besonderheiten zu berücksichtigen: i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 32 Alle Rechte vorbehalten •= Wird kein Start- und Endezeitpunkt angegeben, dann wird eine Verlaufsgrafik über die mit count explizit oder implizit angegebene Anzahl Werte erstellt. •= Wird ein Start-, aber kein Endezeitpunkt angegeben, dann wird beginnend vom Startzeitpunkt eine Verlaufsgrafik für die mit count explizit oder implizit angegebene Anzahl Werte erstellt. •= Wird kein Start-, aber ein Endezeitpunkt angegeben, dann wird eine Verlaufsgrafik für die mit count explizit oder implizit angegebene Anzahl Werte bis zum Endezeitpunkt erstellt. Auffrischen von Langzeit-Verlaufsgrafiken Eine Langzeit-Verlaufsgrafik ist ein statisches Bild, dessen Inhalt sich nicht mehr ändert. Eine Aktualisierung der LangzeitVerlaufsgrafik kann also nur dadurch erfolgen, dass die Grafik (mit einem neuen, "jüngeren" Endezeitpunkt) erneut geladen wird. Sinnvollerweise erfolgt dies in einem eigenen Frame mit voreingestelltem Auto-Refresh, wobei der Endezeitpunkt der Verlaufsgrafik offen gelassen wird. i-Plant Dashboard Applets Copyright © 2003 Langner Communications AG Seite 33 Alle Rechte vorbehalten