OPC Client Connector

Dieser Adapter stellt die Verbindung zu einem OPC-Server her und kann Werte auslesen und setzen.

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Adapter durchführt

Mögliche Werte: execute: Adapter ausführen

Parameter

`Adapter`	Hauptklasse des Adapters (nicht verändern!) Mögliche Werte: `de.softproject.integration.adapter.opc.OpcAdapter`: Hauptklasse (Standard)
`Host`	Hostname oder IP-Adresse des OPC-Servers
`Domain`	Name der Windows-Domain des OPC-Servers
`User`	Benutzername, um auf den OPC-Server zuzugreifen
`Password`	Entsprechendes Passwort des Benutzers
`Clsid`	Class-ID der OPC-Server-Software
`ProgID`	Programm-ID

Statuswerte

Die Operation wurde ohne technische Fehler ausgeführt

-1

Die Operation wurde mit einem technischem Fehler beendet

Die Operation ist eventuell teilweise ausgeführt worden; Genauere Informationen zur Fehlerursache entnehmen Sie dem Server-Log.

Konfiguration

Im Verzeichnis X4DB/0 muss eine Datei opc.xml angelegt werden, die über folgende Struktur verfügt:

XML

 <opc_config>
 	<Connection> 
 		<Host></Host>
		<Domain></Domain>
 		<User></User>
 		<Password></Password>
 		<ClsId></ClsId>
	</Connection>
 	<Group name="">
 		<Item name=""/>
 		<Item name=""/>
 	</Group> 
</opc_config>

Für jedes Element <Group> und <Item> gilt:

Es können beliebig viele Gruppen mit beliebig vielen Items angelegt werden.
Eine Gruppe ist eine vom Benutzer selbst zusammengestellte Sammlung von Items, die zusammen behandelt werden sollen.
Der Gruppenname kann selbst gewählt werden.
Der Item-Name muss dessen Benennung auf dem OPC-Sever entsprechen.
Lese-Operationen werden immer auf die komplette Gruppe ausgeführt.
Ein Item darf sich in mehreren Gruppen gleichzeitig befinden.
Beim Schreiben kann man nur auf diejenigen Items schreiben, die sich in derselben Gruppe befinden.

Input

Der Adapter erwartet spezifische Input-XML-Strukturen. Diese Input-XML-Strukturen können über XSL-Mappings in Abhängigkeit von den verarbeiteten XML-Daten dynamisch generiert werden.

XML

 <OPC>
 	<read>
		 <Group name=""/>
		 <Group name=""/>
 	</read>
 	<write>
 		<Group name=""> 
 			<Item name="">...</Item>
			<Item name="">...</Item>
 		</Group>
	 </write>
	 <copy>
 		...
 	</copy> 
</OPC>

Erläuterung

Für jedes Element <read> gilt:

Auf dem read-Element können beliebige Attribute angegeben werden, die in die Ausgabe kopiert werden.
Ein read-Element kann beliebig viele Group-Elemente enthalten.

Für jedes Element <write> gilt:

Auf dem write-Element können beliebige Attribute angegeben werden, die in die Ausgabe kopiert werden.
Ein write-Element kann beliebig viele Group-Elemente mit beliebig vielen Item-Elementen enthalten.

Für jedes Element <copy> gilt:

Auf dem copy-Element können beliebige Attribute angegeben werden, die in die Ausgabe kopiert werden.
Das copy-Element kann beliebige XML-Elemente mit beliebigem Inhalt enthalten; Diese Elemente werden in die Ausgabe kopiert.

Output

Für alle Kommandos werden die jeweiligen Attribute entsprechend auf die Container-Elemente kopiert.

Kommando: read

XML

<OPC>
 <read>
 <Group name=''> 
 <Item name=''> ... </Item>
 <Item name=''> ... </Item>
 </Group>
 </read>
</OPC>

Kommando: write

Das Kommando wird ausgeführt, es wird jedoch keine Ausgabe generiert:

XML

<OPC>
 <write/>
</OPC>

Kommando: copy

XML

<OPC>
 <copy> <!-- XML-Struktur aus dem Input-Dokument --> </copy>
</OPC>