4D Doc Center : SAX OPEN XML ELEMENT

Home

4D v14.3

SAX OPEN XML ELEMENT


SAX OPEN XML ELEMENT ( DokRef ; Tag {; attrName ; attrWert} {; attrName2 ; attrWert2 ; ... ; attrNameN ; attrWertN} )

Parameter	Typ	Beschreibung
DokRef	DokRef	Referenz auf offenes Dokument
Tag	String	Name des zu öffnenden Elements
attrName	String	Attributname
attrWert	String	Attributwert

Beschreibung

Der Befehl SAX OPEN XML ELEMENT fügt im XML Dokument, definiert durch DokRef, ein neues Element hinzu, sowie optional Attribute und deren Werte.

Das hinzugefügte Element ist im Dokument “offen”, d.h. es ist kein End Tag hinzugefügt. Um es zu schließen, müssen Sie:

entweder den Befehl SAX CLOSE XML ELEMENT einsetzen
oder das XML Dokument schließen. In diesem Fall fügt 4D bei Bedarf automatisch die schließenden XML Tags hinzu.

In Tag übergeben Sie den Namen des zu erstellenden Elements. Er darf nur Buchstaben, Zahlen und die Zeichen “.”, “-“,”_” sowie “:” enthalten. Bei einem ungültigen Zeichen wird ein Fehler generiert.

Optional kann der Befehl für das erstellte Element ein/mehrere Paare von Attribut/Wert übergeben, und zwar in den Parametern attrName und attrWert in Form von Variablen, Feldern oder tatsächlichen Werten. Sie können beliebig viele Paare übergeben.

Beispiel

Die Anweisung:

 vElement:="Book"

 SAX OPEN XML ELEMENT($DocRef;vElement)

... schreibt im Dokument folgende Zeile:

<Book

Fehlerverwaltung

Wurde in Tag ein ungültiges Zeichen übergeben, wird ein Fehler generiert.