Modul XML - Versionsgeschichte

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

Michaelebner: /* $XML_DATATEXT */

2024-03-05T15:46:49Z

$XML_DATATEXT

Michaelebner: /* $XML_DATATEXT */

2024-03-05T15:04:29Z

$XML_DATATEXT

Michaelebner: /* $XML_DATA */

2024-03-05T15:03:07Z

$XML_DATA

Michaelebner: /* #xml_gav */

2023-04-06T09:14:36Z

#xml_gav

Michaelebner: /* #xml_loop */

2023-04-06T09:13:28Z

#xml_loop

Michaelebner: /* $XML_DATA */

2022-09-28T11:41:47Z

$XML_DATA

Michaelebner: /* $XML_DATA */

2022-09-28T11:24:59Z

$XML_DATA

← 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'''

@@ Zeile 195: / Zeile 195: @@
   #xml_parse2   xml=$XML_DATATEXT(xml,frm)
   #xml_loop2   n=sf   er=c_osterkampagne_standardfields   pfx=field   path=contact.standard_fields
 ==$XML==

@@ Zeile 183: / Zeile 183: @@
 ==$XML_DATATEXT==
-<nowiki>$XML_DATATEXT ermittelt das XML innerhalb einer #xml_loop-Schleife. Das kann dazu verwendet werden, dies seinerseits zu parsen.</nowiki>
+<nowiki>$XML_DATATEXT ermittelt das XML innerhalb einer #xml_loop-Schleife. Das kann dazu verwendet werden, dies seinerseits zu parsen. (Zum Beispiel, weil dann wieder geloopt werden muss.)</nowiki>
 '''Parameter'''
@@ Zeile 194: / Zeile 194: @@
   #xml_parse2   xml=$XML_DATATEXT(xml,frm)
 ==$XML==

@@ Zeile 180: / Zeile 180: @@
   #cout   c="$XML_DATA(xml,firstName) $XML_DATA(xml,lastName)"
   #cout   c="$XML_DATA(xml,contactData.phone)"
 ==$XML==

@@ Zeile 111: / Zeile 111: @@
   </contact>
-Die Werte werden in die Variablen adresse, ort, plz, vorname und nachname geschrieben:
+Die Werte werden in die Variablen adresse, ort, plz, vorname und nachname geschrieben; die Parameter name und value müssen hier nicht geschrieben werden, da sie im XML nach den Standard-Werten benannt sind.
   #xml_gav   path=contact.standard_fields   pfx=field   f_address=adresse   f_city=ort   f_zip=plz   f_firstname=vorname   f_lastname=nachname

← Nächstältere Version		Version vom 6. April 2023, 09:13 Uhr
Zeile 52:		Zeile 52:

	siehe #xml_parse		siehe #xml_parse
		+
		+	==#xml_gav==
		+
		+	<nowiki>#xml_gav ("GetArrayValues") durchläuft die verschiedenen Items im Array eines geparsten XML und ermittelt dabei die Daten, die im Format name/value vorliegen.</nowiki>
		+
		+	Es handelt sich dabei um eine nummerierte Prozedur. #xml_loop loopt durch die ersten XML-Daten, #xml_loop2 durch die zweiten und so weiter.
		+
		+	'''Parameter'''
		+	* cnd - ("condition") Die Prozedur wird nur dann ausgeführt, wenn das Statement in cnd Y ergibt. Default ist Y, Funktionen werden ersetzt
		+	* f_xxx - Name der Variable oder Nummer des Values, in die das jeweilige Ergebnis geschrieben werden soll; xxx ist das Namen-Feld im XML, Funktionen werden ersetzt
		+	* name - Bezeichnung des Namen-Feldes; default ist name, Funktionen werden ersetzt
		+	* path - Pfad im XML, der zu dem Array führt, durch das geloopt werden soll; Funktionen werden ersetzt
		+	* pfx ("prefix") - Name der einzelnen Array-Elemente; Funktionen werden ersetzt
		+	* sep ("separator") - Das Trennzeichen, mit dem die Elemente im Parameter path getrennt sind; Funktionen werden ersetzt, default ist der Punkt
		+	* value - Bezeichnung des Value-Feldes; default ist value, Funktionen werden ersetzt
		+
		+	'''Beispiel'''
		+
		+	Es sollen die Adressdaten aus folgendem XML geholt werden:
		+
		+	<contact>
		+	<email>test@gmail.com</email>
		+	<created>2022-07-18 07:57:51.0</created>
		+	<updated>2023-04-05 11:39:57.0</updated>
		+	<id>12345</id>
		+	<standard_fields>
		+	<field>
		+	<name>ADDRESS</name>
		+	<value>Bismarckstraße 17</value>
		+	</field>
		+	<field>
		+	<name>CITY</name>
		+	<value>Berlin</value>
		+	</field>
		+	<field>
		+	<name>FIRSTNAME</name>
		+	<value>Michael</value>
		+	</field>
		+	<field>
		+	<name>LASTNAME</name>
		+	<value>Mustermann</value>
		+	</field>
		+	<field>
		+	<name>SALUTATION</name>
		+	<value>Herr</value>
		+	</field>
		+	<field>
		+	<name>ZIP</name>
		+	<value>12345</value>
		+	</field>
		+	</standard_fields>
		+	<custom_fields>
		+	<field>
		+	<name>easter_calendar_prize_3</name>
		+	<value>20</value>
		+	</field>
		+	</custom_fields>
		+	</contact>
		+
		+	Die Werte werden in die Variablen adresse, ort, plz, vorname und nachname geschrieben:
		+
		+	#xml_gav path=contact.standard_fields pfx=field f_address=adresse f_city=ort f_zip=plz f_firstname=vorname f_lastname=nachname
		+	#coutl $VAR(vorname) $VAR(nachname)

	==#xml_chg==		==#xml_chg==

@@ Zeile 109: / Zeile 109: @@
 '''Parameter'''
-* Name der XML-Loop (parameter n in #xml_loop)
+# 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.
+# 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
@@ Zeile 117: / Zeile 117: @@
   #cout   c="$XML_DATA(xml,firstName) $XML_DATA(xml,lastName)"
   #cout   c="$XML_DATA(xml,contactData.phone)"