4D v14.3

XML SET OPTIONS

Home

 
4D v14.3
XML
XML SET OPTIONS

XML SET OPTIONS 


 

XML SET OPTIONS ( ElementRef | Dokument ; Selector ; Wert1...N {; Selector2 ; Wert1...N2 ; ... ; SelectorN ; Wert1...NN} ) 
Parameter Typ   Beschreibung
ElementRef | Dokument  Text, DokRef in XML Root Element Referenz oder Referenz auf offenes Dokument
Selector  Lange Ganzzahl in zu setzende Option
Wert1...N  Lange Ganzzahl in Wert der Option

Der Befehl XML SET OPTIONS ändert den Wert einer oder mehrerer XML Optionen der Struktur, die im ersten Parameter übergeben wurde.

Dieser Befehl gilt für die XML Strukturen vom Typ "Baum" (DOM) oder "Dokument" (SAX). Im ersten Parameter können Sie entweder die Referenz auf ein Root Element (ElementRef) oder die Referenz auf ein offenes SAX Dokument (Dokument) übergeben.

Die gesetzten Optionen werden nur in der Richtung 4D zu XML genutzt. Der Befehl hat keine Auswirkung auf das Lesen von XML Werten in 4D. Folgende Befehle verwenden diese Optionen:

Übergeben Sie die zu ändernde Option in Selector und den neuen Wert der Option in Wert. Sie können beliebig viele Paare Selector/Wert übergeben.

Sie müssen die nachfolgend beschriebenen Konstanten unter dem Thema XML verwenden. 

Konstante Typ Wert Meldung
XML binary encoding Lange Ganzzahl 5 Gibt an, wie binäre Daten konvertiert werden.
Mögliche Werte:
  • XML Base64 (Standardwert): binäre Daten werden einfach in Base64 konvertiert.
  • XML Data URI scheme: binäre Daten werden in Base64 konvertiert und der Header "data:;base64" wird hinzugefügt. Dieses Format ermöglicht hauptsächlich einem Browser, ein Bild automatisch zu decodieren. Es ist auch zum Einfügen von SVG Bildern erforderlich. Weitere Information dazu siehe http://en.wikipedia.org/wiki/Data_URI_scheme.
XML date encoding Lange Ganzzahl 2 Gibt an, wie 4D das Datum konvertiert, z.B. !01/01/2003! in der Paris Zeitzone..
Mögliche Werte:
  • XML ISO (Standardwert): verwendet das Format xs:datetime ohne Angabe der Zeitzone. Ergebnis: "2003-01-01". Ist im 4D Wert (via SQL) ein Zeitteil enthalten, geht er verloren.
  • XML Local: verwendet das Format xs:date mit Angabe der Zeitzone. Ergebnis: "2003-01-01 +01:00". Ist im 4D Wert (via SQL) ein Zeitteil enthalten, geht er verloren.
  • XML Datetime local: verwendet das Format xs:dateTime (ISO 8601) mit Angabe der Zeitzone. Ist im 4D Wert (via SQL) ein Zeitteil enthalten, wird er beibehalten. Ergebnis: "<Date>2003-01-01T00:00:00 +01:00</Date>"..
  • XML UTC: verwendet das Format xs:date. Ergebnis: "2003-01-01Z". Ist im 4D Wert (via SQL) ein Zeitteil enthalten, geht er verloren.
  • XML Datetime UTC: verwendet das Format xs:dateTime (ISO 8601). Ist im 4D Wert (via SQL) ein Zeitteil enthalten, wird er beibehalten. Ergebnis: "<Date>2003-01-01T00:00:00Z</Date>"
XML indentation Lange Ganzzahl 4 Gibt die Einrückung des XML Dokuments an.
Mögliche Werte:
  • XML With indentation (Standardwert): das Dokument ist eingerückt.
  • XML No indentation: Das Dokument ist nicht eingerückt; sein Inhalt wird in eine einzige Zeile gesetzt.
XML picture encoding Lange Ganzzahl 6 gibt an, wie Bilder konvertiert werden müssen (vor Codierung in Base64).
Mögliche Werte:
  • XML Convert to PNG (Standardwert): Bilder werden vor der Codierung in Base64 in PNG konvertiert.
  • XML Native codec: Bilder werden vor Codierung in Base64 in ihr erstes native Speicher CODEC konvertiert. Sie müssen diese Optionen zum Codieren in SVG Bilder verwenden (siehe Beispiel zum Befehl XML SET OPTIONS.
XML string encoding Lange Ganzzahl 1 gibt an, wie 4D Strings in Elementwerte konvertiert werden. Das gilt nicht für die Konvertierung in Attribute, für die XML die Verwendung von Escape-Zeichen verlangt.

Mögliche Werte:
  • XML With escaping (Standardwert): Konvertierung von 4D Strings in XML Elementwerte mit Ersetzen der Zeichen. Daten vom Typ Text werden automatisch analysiert, so dass verbotene Zeichen (<&>') durch XML Einheiten ersetzt werden (&&It;>'").
  • XML Raw data: 4D Strings werden als reine Daten gesendet; 4D führt weder eine Codierung noch eine Analyse durch. 4D Werte werden nach Möglichkeit in XML Fragmente konvertiert und als Unterelement des Zielelements eingefügt. Kann ein Wert nicht als ein XML Fragment bewertet werden, wird es in Form von Rohdaten in einen neuen Knoten CDATA eingefügt.
XML time encoding Lange Ganzzahl 3 Gibt an, wie 4D die Zeit konvertiert, z.B. ?02/00/46? (Paris Zeit). Die Codierung ist unterschiedlich, je nachdem ob Sie eine Uhrzeit oder eine Zeitspanne ausdrücken wollen.
Mögliche Werte für Uhrzeit:
  • XML Datetime UTC: Zeit ausgedrückt in UTC (Universal Time Coordinated). Beachten Sie, dass die Konvertierung in UTC automatisch ist. Ergebnis: "<Duration>0000-00-00T01:00:46Z</Duration>".
  • XML Datetime local: Zeit ausgedrückt mit der Zeitdifferenz des Rechners mit der 4D Engine. Ergebnis: "<Duration>0000-00-00T02:00:46+01:00</Duration>".
  • XML Datetime local absolute (Standardwert): Zeit ausgedrückt ohne Angabe der Zeitzone. Der Wert wird nicht geändert. Ergebnis: "<Duration>0000-00-00T02:00:46</Duration>".
Mögliche Werte für Zeitspanne:
  • XML Seconds: Anzahl Sekunden ab Mitternacht; der Wert wird nicht geändert, da er eine Dauer ausdrückt. Ergebnis: "<Duration>7246</Duration>".
  • XML Duration: Dauer ausgedrückt in Übereinstimmung mit dem XML Schema Teil 2: Datentypen Zweite Edition. der Wert wird nicht geändert, da er eine Dauer ausdrückt. Ergebnis: "<Duration>PT02H00M46S</Duration>".

Hinweise:

  • Die Werte XML Local und XML Datetime local liefern keine Daten ausgedrückt in UTC (Universal Time Coordinated); sie werden ohne Änderung konvertiert, jedoch mit Angabe der Zeitdifferenz. Diese Formate sind sinnvoll bei sukzessiver und reziproker Konvertierung (round tripping).
  •  Die Werte XML UTC und XML Datetime UTC ähneln den vorigen in Bezug auf die Formatierung, werden jedoch in UTC ausgedrückt. Diese Formate werden vorrangig verwendet, um die Interoperabilität zu sichern. Die Werte werden nicht geändert.

Ein SVG Bild einfügen

 XML SET OPTIONS($pictElemRef;XML binary encoding;XML data URI scheme)
 XML SET OPTIONS($pictElemRef;XML picture encoding;XML native codec)
 DOM SET XML ATTRIBUTE($pictElemRef;"xlink:href";PictVar)

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: XML
Nummer: 1090

 
GESCHICHTE 

Erstellt: 4D v12

 
SIEHE AUCH 

DOM SET XML ATTRIBUTE
DOM SET XML DECLARATION
DOM SET XML ELEMENT VALUE
SAX ADD XML ELEMENT VALUE
XML GET OPTIONS

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v12.4)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v13.5)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)