FB_XmlSrvReadByName

Mit dem Funktionsbaustein FB_XmlSrvReadByName kann eine SPS-Variable mit Daten aus einer XML-Datei initialisiert werden. Die Eingangsvariable sXPath muss dabei auf einen gültigen Knoten in der mit sFilePath angegebenen XML-Datei zeigen. Das Symbol, das initialisiert werden soll, wird anhand des Symbolnamens eindeutig identifiziert.

Eingänge

VAR_INPUT
    sNetId      : T_AmsNetId; 
    ePath       : E_OpenPath := PATH_GENERIC; 
    nMode       : WORD := XMLSRV_SKIPMISSING;
    sSymName    : T_MaxString;
    sFilePath   : T_MaxString;
    sXPath      : T_MaxString;
    bExecute    : BOOL; 
    tTimeout    : TIME := T#60s; 
END_VAR

Name	Typ	Beschreibung
sNetId	T_AmsNetId	String mit der Netzwerkadresse des TwinCAT 3 XML Servers. Für den lokalen Rechner (default) kann auch ein Leerstring angegeben werden.
ePath	E_OpenPath	Über diesen Eingang kann ein TwinCAT-Systempfad auf dem Zielgerät zum Öffnen der Datei angewählt werden.
nMode	WORD	Über diesen Eingang ist das Verhalten beeinflussbar, wie die XML-Datei ausgewertet wird. Für den Befehl XmlSrvReadByName wird zurzeit nur der Modus XMLSRV_SKIPMISSING unterstützt.
sSymName	T_MaxString	Name des SPS-Symbols, das mit den Daten aus der XML-Datei beschrieben werden soll.
sFilePath	T_MaxString	Enthält den Pfad- und Dateinamen der zu öffnenden Datei. Der Pfad kann nur auf das lokale Filesystem des Rechners zeigen. Das bedeutet, Netzwerkpfade können hier nicht angegeben werden.
sXPath	T_MaxString	Enthält die Adresse des Tags im XML-Dokument, aus der die Daten geschrieben werden soll. Die Adresse muss eine gültige XPath-Anweisung sein. Der Name des Tags muss dabei nicht dem Namen des Symbols entsprechen.
bExecute	BOOL	Über eine positive Flanke an diesem Eingang wird der Funktionsbaustein aktiviert.
tTimeout	TIME	Maximale Zeit, die bei der Ausführung des Funktionsbausteins nicht überschritten werden darf.

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS Bibliotheken
TwinCAT v3.1 Build 4011	PC oder CX (x86, x64, Arm®)	Tc2_XmlDataSrv

Ausgänge

VAR_OUTPUT
    bBusy   : BOOL;
    bError  : BOOL;
    nErrId  : UDINT;
END_VAR

Name	Typ	Beschreibung
bBusy	BOOL	Dieser Ausgang wird bei der Aktivierung des Funktionsbausteins gesetzt und bleibt so lange gesetzt, bis eine Rückmeldung erfolgt.
bError	BOOL	Dieser Ausgang wird, nachdem der bBusy-Ausgang zurückgesetzt wurde, gesetzt, sollte ein Fehler bei der Übertragung des Kommandos erfolgen.
nErrId	UDINT	Liefert bei einem gesetzten bError-Ausgang die TwinCAT 3 XML Server Fehlernummer.