IoTDataRetrieveJob

Beschreibung

Klassenname: com.ebd.hub.datawizard.util.IoTDataRetrieveJob

Konfiguration: Absoluter oder relativer Pfad zu einer .conf- oder .properties-Datei mit den Abrufparametern.

Diese Klasse ruft Daten von einem OPC UA-Server zeitgesteuert (Cron) ab. Sie verwendet den IoTClientService (OPC UA-Clientdienst zur Verwaltung von Serververbindungen). Die Verbindung erfolgt zu Server-Aliasnamen, die in ./etc/iotclient.xml definiert sind. Die Klasse unterstützt das Lesen von Knotenwerten und den Aufruf von OPC UA-Methoden.

Der IoTClientService muss aktiv sein, bevor diese Klasse ausgeführt wird. Weitere Informationen zur Einrichtung und Alias-Konfiguration finden Sie unter IoT (Input Agent).

Parameter

Alle Parameter sind in der Konfigurationsdatei definiert, die im Feld Konfigurationsdatei des Cron-Eingangsagenten angegeben ist. Zeilen, die mit # beginnen, werden als Kommentare behandelt und ignoriert.

Parameter	Erforderlich	Beschreibung
`alias`	ja	Name des OPC UA-Server-Alias. Der Wert muss mit einem Alias in `iotclient.xml` übereinstimmen.
`charset`	nein	Zeichenkodierung der Ausgabedaten. Beispiel: `UTF8`.
`readident.<name>`	nein	OPC UA-Knoten-ID zum Lesen. `<name>` ist eine frei wählbare Bezeichnung für diesen Lesevorgang. Beispiel: `readident.nodefields = ns=2;s=85/LDI/DataDBInfo`.
`readident.<name>.addHeaderComment`	nein	Wenn `true`, wird dem Ausgabeabschnitt für diesen Lesevorgang ein Header-Kommentar hinzugefügt. Standardwert: `false`.
`readident.<name>.recursive`	nein	Wenn `true`, werden auch die untergeordneten Knoten des angegebenen Knotens gelesen. Standardwert: `false`.
`readident.<name>.outputident`	nein	Eigene Bezeichnung für die Abschnittsüberschrift in der Ausgabe. Standardwert: `<name>`.
`methodcall.<name>`	nein	OPC UA-Knoten-ID einer aufzurufenden Methode. `<name>` ist eine frei wählbare Bezeichnung für diesen Methodenaufruf.
`methodcall.<name>.addHeaderComment`	nein	Wenn `true`, wird dem Ausgabeabschnitt für diesen Methodenaufruf ein Header-Kommentar hinzugefügt. Standardwert: `false`.
`methodcall.<name>.parent`	nein	Übergeordnete Knoten-ID für die Methode. Geben Sie diese nur an, wenn die Methode einen übergeordneten Knotenkontext erfordert.
`methodcall.<name>.param`	nein	Eingabeparameter für den Methodenaufruf. Wiederholen Sie diesen Schlüssel für jeden Parameter. Die Reihenfolge ist relevant. Werte können numerisch oder als Zeichenkette angegeben werden. Beispiel: `methodcall.profilecall.param = value1`, gefolgt von `methodcall.profilecall.param = value2`. Weitere Informationen finden Sie in den Codebeispielen unten.

Beispiele

Datenabruf mit Methodenaufruf

Dieses Beispiel liest einen Knotenbaum von einem lokalen OPC UA-Server. Außerdem ruft es eine Profilmethode mit sieben Parametern auf. Der Alias localserver muss in ./etc/iotclient.xml definiert sein.

alias = localserver
charset = UTF8
readident.nodefields = ns=2;s=85/LDI/DataDBInfo
readident.nodefields.addHeaderComment = true
readident.nodefields.recursive = true
methodcall.profilecall = ns=2;s=85/LDI/LDCPs/profile_32a706d9:17434cdcb55:-3f00.57c377bb4259e254:32a706d9:17434cd0b19:-8000/call
methodcall.profilecall.addHeaderComment = true
methodcall.profilecall.param = 1
methodcall.profilecall.param = 2
methodcall.profilecall.param = 3
methodcall.profilecall.param = 4
methodcall.profilecall.param = text1
methodcall.profilecall.param = text2
methodcall.profilecall.param = text3
readident.serverversion = ns=0;i=2264
readident.serverversion.addHeaderComment = true

Abruf von Boiler Data

Dieses Beispiel liest zwei Knotenbäume von einem OPC UA-Boiler-Simulator-Server. Die auskommentierten Einträge zeigen, wie ein Methodenaufruf und weitere Lesevorgänge nach dem Simulationsstart hinzugefügt werden.

alias = boiler
readident.scalars = ns=2;i=10159
readident.scalars.addHeaderComment = true
readident.scalars.recursive = true
readident.boiler1beforestart = ns=4;i=1241
readident.boiler1beforestart.addHeaderComment = true
readident.boiler1beforestart.outputident = Boiler 1 Before Start
readident.boiler1beforestart.recursive = true
#methodcall.startsimulation = ns=4;i=1343
#methodcall.startsimulation.parent = ns=4;i=1287
#
#readident.boiler1afterstart = ns=4;i=1241
#readident.boiler1afterstart.addHeaderComment = true
#readident.boiler1afterstart.outputident = Boiler 1 After Start
#readident.boiler1afterstart.recursive = true
#
#readident.serverversion = ns=0;i=2264
#
#methodcall.stopsimulation = ns=4;i=1346
#methodcall.stopsimulation.parent = ns=4;i=1287

Registrierung

Tragen Sie die Klasse in custom_own_classes.properties unter IS/etc/admin/datawizard/ ein:

com.ebd.hub.datawizard.util.IoTDataRetrieveJob

Siehe auch

IoT (Input Agent): Einrichtung des IoTClientService, Alias-Konfiguration und iotclient.xml-Referenz
Custom class (cron input agent): Allgemeine Informationen zu zeitgesteuerten Custom Classes und zum Feld für die Konfigurationsdatei

Documentation Index