Version 11 (Geändert)
SAX ADD XML ELEMENT VALUE (Dokument; Data; *)
Parameter | Typ | Beschreibung | |
Dokument | DokRef | Referenzu auf das offene Dokument | |
Data | Text | Variable | Text oder Variable zum Einfügen in das Dokument | |
* | * | Mit *: Sonderzeichen werden codiert | |
Ohne *: Keine Codierung |
Beschreibung
Der Befehl SAX ADD XML ELEMENT VALUE fügt im XML Dokument, definiert durch Dokument, 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 Data 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 Data codieren, müssen Sie den Befehl ENCODE verwenden. Dann müssen Sie natürlich in Data ein BLOB übergeben.
Dieser Befehl codiert standardmäßig keine Sonderzeichen(< > ' ""...), die im Parameter Data enthalten sind. Um die Codierung dieser Parameter zu forcieren, ü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)
Referenz
Systemvariablen oder Mengen:
Bei korrekt ausgeführtem Befehl wird die Systemvariable OK auf 1 gesetzt, sonst auf 0 (Null).
Backup Preferences, SVG-Erzeugung, XSLT Office 2003, vCard Import Export with XML