(6 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)

Zeile 1:

Das Modul XML stellt ein paar Routinen zum Umgang mit XML bereit.

Das Modul XML stellt ein paar Routinen zum Umgang mit XML bereit.

+

==Vorbemerkung zum Pfad==

+

In allen Prozeduren und Funktionen, die mit einem geparsten XML arbeiten, spielt der Pfad eine maßgebliche Rolle. Dieser kann überall - ohne dass dies im Folgenden eigens erwähnt wird - durch die Node-Adresse ersetzt werden (die Speicheradresse des Nodes im hexadezimalen Format). (Bei den Funktionen zur Ermittlung der Node-Adresse ist die Verwendung einer Node-Adresse statt eines Pfades möglich, jedoch sinnlos.)

+

Node-Adresse werden üblicherweise dann verwendet, wenn Nodes in einem Array eindeutig adressiert werden müssen. Zur Ermittlung der Node-Adresse verwenden Sie $XML_NA oder $XML_DATANA.

+

Die Node-Adresse ist nur solange gültig, wie das XML nicht neu geparst wird. Wird ein XML in seiner Struktur verändert, sind die davon betroffenen Node-Adressen auch nicht mehr gültig.

==#xml_clearall==

==#xml_clearall==

Zeile 137:

Zeile 145:

Das Beispiel zeigt einen Ausschnitt aus einem Save-Kommando: Zunächst werden die Daten über einen REST-Server geholt (das ist noch nicht im Beispiel-Code), geparst, dann werden einzelne Felder durch die Daten im Grid ersetzt, danach (auch wieder nicht im Beispiel-Code) werden die Daten zum REST-Server zurück geschrieben. Um die #xml_chg-Prozeduren übersichtlicher zu halten, wird der wesentliche Teil des Pfades in der Variablen ''cp'' gespeichert.

Das Beispiel zeigt einen Ausschnitt aus einem Save-Kommando: Zunächst werden die Daten über einen REST-Server geholt (das ist noch nicht im Beispiel-Code), geparst, dann werden einzelne Felder durch die Daten im Grid ersetzt, danach (auch wieder nicht im Beispiel-Code) werden die Daten zum REST-Server zurück geschrieben. Um die #xml_chg-Prozeduren übersichtlicher zu halten, wird der wesentliche Teil des Pfades in der Variablen ''cp'' gespeichert.

+

==#xml_changenode==

+

Übernimmt Nodes aus einem anderen geparsten XML in das XML.

+

Es handelt sich dabei um eine nummerierte Prozedur. #xml_chg ändert in die ersten XML-Daten, #xml_chg2 in die zweiten und so weiter.

+

'''Parameter'''

+

* cnd ("condition") - wenn Y, dann wird die Prozedur ausgeführt; default Y, Funktionen werden ersetzt

+

* n ("number") - Nummer des XML, aus dem die Daten bezogen werden ("Source")

+

* path - Pfad im XML, der zu dem XML-Feld führt

+

* pis ("path in source") - Pfad in dem mit N spezifizierten XML zu den Daten, die übernommen werden sollen

+

* sep ("separator") - Das Trennzeichen, mit dem die Elemente im Parameter path getrennt sind; Funktionen werden ersetzt, default ist der Punkt

+

* y - Typ der Operation

+

** replcae - ersetzt Name, Wert, die Eigenschaften und insbesondere die Child-Nodes

+

** replacechilds - ersetzt nur die Child-Nodes

+

** addchilds - fügt die Child-Nodes der mit n und pis spezifizierten Quelle den eigenen, mit path spezifizierten Nodes hinzu

+

'''Beispiele'''

+

 #xml_changenode2   y=addchilds   path=web:doAmend.amendRequest.booking   n=1  pis=ns2:doDisplayResponse.displayResponse.booking

+

 #xml_changenode2   y=replace   path=$VAL(1)   n=3   pis=passport

==$XML_TEXT==

==$XML_TEXT==

Zeile 166:

Zeile 196:

  #cout   c=$XML_VALUE(1,soap:Envelope.soap:Body.ns2:searchCustomerResponse.searchCustomerResponse.customer.firstName)

  #cout   c=$XML_VALUE(1,soap:Envelope.soap:Body.ns2:searchCustomerResponse.searchCustomerResponse.customer.firstName)

+

==$XML_NA==

+

<nowiki>$XML_NA gibt die Node-Adresse des übergebenen Pfads zurück</nowiki>

+

'''Parameter'''

+

# Nummer des geparsten XML

+

# Pfad zum gewünschten Wert

+

# optional: Trennzeichen, mit dem die Elemente im Pfad getrennt werden; default ist der Punkt

+

'''Beispiel'''

+

 #cout   c=$XML_NA(1,soap:Envelope.soap:Body.ns2:searchCustomerResponse.searchCustomerResponse.customer.firstName)

==$XML_DATA==

==$XML_DATA==

Zeile 180:

Zeile 223:

  #cout   c="$XML_DATA(xml,firstName) $XML_DATA(xml,lastName)"

  #cout   c="$XML_DATA(xml,firstName) $XML_DATA(xml,lastName)"

  #cout   c="$XML_DATA(xml,contactData.phone)"

  #cout   c="$XML_DATA(xml,contactData.phone)"

+

==$XML_DATANA==

+

<nowiki>$XML_DATANA gibt die Node-Adresse eines Elementes eines XML-Arrays zu, durch das mit #xml_loop geloopt wird.</nowiki>

+

'''Parameter'''

+

# Name der XML-Loop (parameter n in #xml_loop)

+

# Pfad; bei Felder, die direkt unter der Loop-Ebene liegen, nur der Feldname, ansonsten ein entsprechender Pfad, siehe zweites Beispiel.

+

# optional: Trennzeichen, mit dem die Elemente im Pfad getrennt werden; default ist der Punkt

+

'''Beispiele'''

+

 #val_set   n=1   z=$XML_DATANA(xml,passport)

+

 #val_set   n=2   z=$XML_DATANA(xml,passport.passportNumber)

==$XML_DATATEXT==

==$XML_DATATEXT==

bafbal.de - Letzte Änderungen [de]

Modul XML