Modul XML - Versionsgeschichte

Michaelebner: /* #xml_chg */

2026-08-14T16:25:15Z

#xml_chg

Michaelebner: /* #xml_chg */

2026-08-14T16:24:39Z

#xml_chg

Michaelebner: /* $XML_DATA */

2026-08-14T16:09:48Z

$XML_DATA

Michaelebner: /* $XML_VALUE */

2026-08-14T16:07:56Z

$XML_VALUE

Michaelebner: /* $XML_VALUE */

2026-08-14T16:07:37Z

$XML_VALUE

Michaelebner: /* Vorbemerkung zum Pfad */

2026-08-14T16:06:20Z

Vorbemerkung zum Pfad

Michaelebner: /* #xml_clearall */

2026-08-14T16:04:01Z

#xml_clearall

Michaelebner: /* $XML_LFR */

2024-07-22T10:50:05Z

$XML_LFR

Michaelebner: /* $XML_LFR */

2024-07-22T10:41:38Z

$XML_LFR

Michaelebner: /* $XML_LFR */

2024-03-05T15:48:43Z

$XML_LFR

@@ Zeile 146: / Zeile 146: @@
 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_chg==
+==#xml_changenode==
 Übernimmt Nodes aus einem anderen geparsten XML in das XML.

← Nächstältere Version		Version vom 14. August 2026, 16:24 Uhr
Zeile 145:		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_chg==
		+
		+	Ü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 201: / Zeile 201: @@
   #cout   c="$XML_DATA(xml,firstName) $XML_DATA(xml,lastName)"
   #cout   c="$XML_DATA(xml,contactData.phone)"
 ==$XML_DATATEXT==

← Nächstältere Version		Version vom 14. August 2026, 16:07 Uhr
Zeile 174:		Zeile 174:

	#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==		==$XML_NA==

← Nächstältere Version		Version vom 14. August 2026, 16:07 Uhr
Zeile 174:		Zeile 174:

	#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 5: / Zeile 5: @@
 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.
+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.
 ==#xml_clearall==

← Nächstältere Version		Version vom 14. August 2026, 16:04 Uhr
Zeile 1:		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.

	==#xml_clearall==		==#xml_clearall==

← Nächstältere Version		Version vom 22. Juli 2024, 10:50 Uhr
Zeile 212:		Zeile 212:

	#cout c=$XML_LFR(1,$VAL(1)price,.,discountAmounts,code,[A-Z]{3}\d{4})		#cout c=$XML_LFR(1,$VAL(1)price,.,discountAmounts,code,[A-Z]{3}\d{4})
		+
		+	==$XML_VALEX==
		+
		+	Die Funktion $XML_VALEX ermittelt, ob ein bestimmter Wert existiert ("value exists").
		+
		+	'''Parameter'''
		+
		+	# Nummer des geparsten XML
		+	# Pfad zum gewünschten Wert
		+	# Trennzeichen, mit dem die Elemente im Pfad getrennt werden; default ist der Punkt
		+	# Prefix
		+	# Feldname
		+	# Wert, alternativ das Regex-Statement
		+	# Typ
		+	## ic - ignore case (Groß- und Kleinschreibung wird beim Vergleich ignoriert)
		+	## regex - Der Wert-Parameter wird als Regex-Statement verwendet
		+	## alles andere - Stringvergleich unter der Berücksichtigung der Groß- und Kleinschreibung
		+	# Rückgabewert Yes, default Y
		+	# Rückgabewert No, default N
		+
		+
		+
		+	'''Beispiel'''
		+
		+	#text <soap:Envelope xmlns:soap="
		+	...
		+	#text <customer>
		+	...
		+	#text <toDelete>false</toDelete>
		+	#text <characteristics>
		+	#text <characteristics>
		+	#text <code>Rollator</code>
		+	#text </characteristics>
		+	#text <characteristics>
		+	#text <code>Gluten</code>
		+	#text </characteristics>
		+	#text <characteristics>
		+	#text <code>Ernährung</code>
		+	#text </characteristics>
		+	#text </customer>
		+	...
		+
		+	#xml_parse xml=$TEXT(1)
		+	#val_set n=1 z=soap:Envelope.soap:Body.ns2:searchCustomerResponse.searchCustomerResponse.customer
		+	#cout c="Gluten: $XML_VALEX(1,$VAL(1),.,characteristics,code,gluten,ic)"
		+	#cout c="Gluten nic: $XML_VALEX(1,$VAL(1),.,characteristics,code,gluten)"
		+	#cout c="Rollator: $XML_VALEX(1,$VAL(1),.,characteristics,code,Rollator,ic)"
		+	#cout c="Unsinn: $XML_VALEX(1,$VAL(1),.,characteristics,code,unsinn,ic)"

	==$XML==		==$XML==

@@ Zeile 211: / Zeile 211: @@
 '''Beispiel'''
-  #cout   c=$XML_LFR(1,$VAL(1)price,.,discountAmounts,code,\D\D\d\d\d\d)
+  #cout   c=$XML_LFR(1,$VAL(1)price,.,discountAmounts,code,[A-Z]{3}\d{4})
 ==$XML==

@@ Zeile 198: / Zeile 198: @@
 ==$XML_LFR==
-<nowiki>$XML_LFR den ersten Wert innerhalb einer Loop, der einem Regex-Ausdruck entspricht. Dies wird primär für den Fall verwendet, dass in einer Loop nur ein Wert erwartet wird, der dem Regex-Kriterium entspricht.</nowiki>
+<nowiki>$XML_LFR den ersten Wert innerhalb einer Loop, der einem Regex-Ausdruck entspricht. Dies wird primär für den Fall verwendet, dass in einer Loop nur ein Wert erwartet wird, der dem Regex-Kriterium entspricht. Nach dem ersten gefundenen Wert wird die interne Schleife abgebrochen und der gefundene Wert als Funktionsergebnis zurückgegeben.</nowiki>
 '''Parameter'''
 '''Beispiel'''