SAX ADD XML ELEMENT VALUE

Home

4D v20 R7


SAX ADD XML ELEMENT VALUE ( DokRef ; Daten {; *} )

Parameter	Typ	Beschreibung
DokRef	DokRef	Referenz auf das offene Dokument
Daten	Text, Variable	Text oder Variable zum Einfügen in das Dokument
*	Operator	Mit : Sonderzeichen werden codiert, ohne : Keine Codierung

Beschreibung

Der Befehl SAX ADD XML ELEMENT VALUE fügt im XML Dokument, definiert durch DokRef, Daten direkt hinzu, d.h. ohne Konvertierung. Dieser Befehl entspricht z.B. Hinzufügen eines Anhangs im Hauptteil eines E-Mail.

Sie können in Daten entweder direkt eine Zeichenkette oder eine 4D Variable übergeben. Der Variableninhalt wird vor Einbinden in das XML Dokument in Text konvertiert. Wird Daten als undefiniert gewertet, verwendet 4D einen leeren String. Wollen Sie den Inhalt von Daten codieren, müssen Sie den Befehl BASE64 ENCODE verwenden. Dann müssen Sie natürlich in Daten ein BLOB übergeben.

Dieser Befehl codiert standardmäßig Sonderzeichen (< > ' "...), die im Parameter Daten enthalten sind. Sie können diesen Mechanismus für den aktuellen Prozess deaktivieren. Dazu verwenden Sie den Befehl XML SET OPTIONS und übergeben in der Option XML string encoding den Wert XML raw data. Zum Beispiel:

XML SET OPTIONS($docRef;XML string encoding;XML raw data)

Benötigen Sie dann in Ausnahmefällen die Codierung von Sonderzeichen beim Aufrufen von SAX ADD XML ELEMENT VALUE, übergeben Sie den optionalen Parameter *. Das überschreibt den Befehl XML SET OPTIONS.

Dieser Befehl arbeitet nur korrekt, wenn ein Element geöffnet ist. Sonst wird ein Fehler erzeugt.

Beispiel

Diese Anweisung fügt im offenen XML Element die Datei whitepaper.pdf hinzu:

 C_BLOB(vBMyBLOB)

 DOCUMENT TO BLOB("c:\\whitepaper.pdf";vBMyBLOB)

 SAX ADD XML ELEMENT VALUE($DocRef;vBMyBLOB)

Systemvariablen und Mengen

Bei korrekt ausgeführtem Befehl wird die Systemvariable OK auf 1 gesetzt, sonst auf 0 (Null).

Siehe auch

SAX GET XML ELEMENT VALUE
XML SET OPTIONS