FB_XmlSrvWriteByName

FB_XmlSrvWriteByName 1:

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

FB_XmlSrvWriteByName 2: 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, mit welchen Daten die XML-Datei beschrieben wird. Für den Befehl XmlSrvWriteByte gibt es den Modus XMLSRV_SKIPMISSING und XMLSRV_ADDMISSING. Im Modus XMLSRV_SKIPMISSING werden nur die Sub-Elemente eines SPS-Symbols in die XML-Datei geschrieben, die bereits vorher in der XML-Datei existierten. Im Modus XMLSRV_ADDMISSING werden in der XML-Datei fehlende Subelemente der XML-Datei hinzugefügt. Ab Produktversion 3.2.31.0 ist es möglich mit den Parametern XMLSRV_SERIALIZESYMCOMMENT und XMLSRV_SERIALIZETYPECOMMENT die Kommentare aus dem Deklarationsbereich mit in die XML Datei zu schreiben.

sSymName

T_MaxString

Name des SPS-Symbols, das in die XML-Datei geschrieben 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

FB_XmlSrvWriteByName 3: 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.