4D Doc Center : DOM SET XML ELEMENT VALUE

Home

4D v14.3

DOM SET XML ELEMENT VALUE


DOM SET XML ELEMENT VALUE ( ElementRef {; xPath}; ElementWert {; *} )

Parameter	Typ	Beschreibung
ElementRef	String	Referenz auf XML Element
xPath	Text	Pfad xPath des XML Elements
ElementWert	String, Variable	Neuer Wert des Elements
*	Operator	Mit Stern: Setze Wert in CDATA

Beschreibung

Der Befehl DOM SET XML ELEMENT VALUE ändert den Wert des Elements, definiert durch ElementRef.

Mit den optionalen Parameter xPath legen Sie fest, dass auf das zu ändernde Element über die Notation XPath (siehe Absatz XPath Notation verwalten (DOM)) zugegriffen wird. In diesem Fall müssen Sie in ElementWert die Referenz auf ein Root XML Element übergeben und in xPath den Pfad XPath des zu ändernden Elements.

In ElementRef übergeben Sie die Referenz auf das zu ändernde Element, in ElementWert den neuen Wert:

Übergeben Sie einen String, wird der Wert wie gehabt in der XML Struktur verwendet.
Übergeben Sie eine Variable oder ein Feld, bearbeitet 4D den Wert je nach Typ von ElementWert. Sie können bis auf Arrays, Bilder und Zeiger alle Datentypen verwenden.

Ist der optionale Parameter Stern (*) übergeben, muss der Wert des Elements im Format CDATA gesetzt werden. In diesem Sonderformat lässt sich Ausgangstext unverändert schreiben (siehe Beispiel 2).

Hinweis: Ist in diesem Befehl das in ElementRef übergebene Element ein BLOB, wird es automatisch in base64 codiert. In diesem Fall führt der Befehl DOM SET XML ELEMENT VALUE automatisch die umgekehrte Operation aus.

Beispiel 1

Wird in dieser XML Quelle:

<Book>
   <Title>The Best Seller</Title>
</Book>

…der nachfolgende Code ausgeführt, wobei vElementRef die Referenz auf das Element ‘Title’ enthält:

DOM SET XML ELEMENT VALUE(vElemRef;"The Loser")

…erhalten Sie:

<Book>
   <Title>The Loser</Title>
</Book>

Beispiel 2

Wir gehen von folgender XML Struktur aus:

<Maths>
   <Postulate>1+2=3</Postulate>
</Maths>

Wir wollen in der XML Struktur den Text “12 < 18” im Element <Postulate> schreiben. Dieser String lässt sich in dieser Form nicht in XML schreiben, da das Zeichen “<” nicht akzeptiert wird. Es muss geändert werden in “<” oder das Format CDATA muss verwendet werden.Gibt vElemRef den XML-Knoten <Postulate> an, gilt folgendes:

  ` Normales Formular

 DOM SET XML ELEMENT VALUE(vRefElem;"12 < 18")

Wir erhalten:

<Maths>
   <Postulate>12 < 18</Postulate>
</Maths>

  ` Format CDATA

 DOM SET XML ELEMENT VALUE(vRefElem;"12 < 18";*)

Wir erhalten:

<Maths>
   <Postulate><![CDATA[12 < 18]]></Postulate>
</Maths>

Systemvariablen und Mengen

Bei korrekt ausgeführtem Befehl wird die Systemvariable OK auf 1 gesetzt, sonst auf 0 (Null) und ein Fehler wird zurückgegeben; z.B. bei ungültiger Referenz auf das Element.