Version 2004
DOM EXPORT TO VAR (ElementRef; vXmlVar)
| Parameter | Typ | Beschreibung | |
| ElementRef | String | Referenz auf das Root XML Element | |
| vXmlVar | Text | BLOB | Variable, die XML Baum empfangen muss |
Beschreibung
Der Befehl DOM EXPORT TO VAR sichert einen XML Baum in einer Variablen vom Typ Text oder BLOB.
In ElementRef übergeben Sie die Referenz auf das Root Element.
In vXmlVar übergeben Sie den Namen der Variablen, die den XML Baum enthalten muss. Sie muss vom Typ Text oder BLOB sein. Der Typ richtet sich nach der geplanten Größe für den Baum. Beachten Sie, dass Variablen vom Typ Text auf 32.000 Zeichen begrenzt sind.
Wird das Element in einer Textvariablen gespeichert, wird der aktuelle Mac Zeichensatz verwendet, z.B. Mac Roman. Folglich verliert der zurückgegebene Text seine ursprüngliche Codierung (Codierung = xxx). In diesem Fall ermöglicht die Variable vVarml, den Code zu sehen oder zu spei-chern, aber nicht ein gültiges XML Dokument zu erstellen, z.B. über den Befehl SEND PACKET.
Beachten Sie, dass eine in ElementRef gespeicherte Textvariable im aktuellen Mac-Zeichensatz codiert wird (z.B. Mac Roman auf dem meisten Standardsystemen). Das bedeutet, dass der zurückgegebene Text seine ursprüngliche Codierung verliert (Codierung="xxx"). In diesem Fall ermöglicht die Variable vVarXml zwar, den Code zu sehen oder zu speichern, jedoch NICHT, ein gültiges XML-Dokument zu erstellen, z.B. mit dem Befehl SEND PACKET.
Beispiel
Diese Anweisung speichert den Baum vElementRef in einer Text Variablen:
C_TEXT(vtMyText) DOM EXPORT TO VAR(vElemRef;vtMyText)
Referenz
Systemvariablen oder 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.