4D Doc Center : SAX ADD XML ELEMENT VALUE

Home

4D v14.3

SAX ADD XML ELEMENT VALUE


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. dem 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.

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, außer Sie haben diesen Mechanismus für den aktuellen Prozess deaktiviert. 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)

Um die Codierung dieser Parameter zu erzwingen, übergeben Sie einfach den optionalen Parameter *.

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).