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&param2=value2&param3=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

Documents pareils