Der XMLNSC-Parser setzt den Feldtyp in jedem von ihm erstellten Syntaxelement.
Der Feldtyp gibt den Typ des XML-Konstrukts an, den das Element darstellt. Dieser Feldtyp wird vom XMLNSC-Parser beim Schreiben einer Nachrichtenbaumstruktur verwendet.
Der Feldtyp kann mit ESQL oder Java gesetzt werden, um so die Ausgabe-XML zu steuern. Auf die vom XMLNSC-Parser verwendeten Feldtypen muss mit Konstanten verwiesen werden, deren Namen das Präfix 'XMLNSC.' vorangestellt ist.
Tipp: Feldtypkonstanten mit dem Präfix 'XML.' werden nur in Zusammenhang mit den XMLNS- und XML-Parsern verwendet. Sie könne nicht mit XMLNSC- oder MRM-Parsern verwendet werden.
Feldtypen für die Erstellung von Syntaxelementen
Für die Erstellung von Syntaxelementen in der Nachrichtenbaumstruktur müssen die folgenden Feldtypkonstanten verwendet werden. Der XMLNSC-Parser verwendet diese Werte bei der Erstellung einer Nachrichtenbaumstruktur anhand einer Eingabenachricht.
| XML-Konstrukt |
XMLNSC-Feldtypkonstante |
Wert |
Einfaches Element
|
XMLNSC.PCDataField
XMLNSC.CDataField
|
0x02000000
0x02000001
|
Attribute
|
XMLNSC.SingleAttribute
XMLNSC.DoubleAttribute
|
0x03000100
0x03000101
|
Gemischter Inhalt
|
XMLNSC.PCDataValue
XMLNSC.CDataValue
|
0x03000000
0x03000001
|
Namespacedeklaration
|
XMLNSC.SingleNamespaceDecl
XMLNSC.DoubleNamespaceDecl
|
0x03000102
0x03000103
|
Komplexes Element
|
XMLNSC.Folder
|
0x01000000
|
Integrierte DTD
|
XMLNSC.DocumentType
|
0x01000300
|
XML-Deklaration
|
XMLNSC.XmlDeclaration
|
0x01000400
|
Entitätsverweis
|
XMLNSC.EntityReference
|
0x02000100
|
Entitätsdefinition
|
XMLNSC.SingleEntityDefinition
XMLNSC.DoubleEntityDefinition
|
0x03000301
0x03000300
|
Kommentar
|
XMLNSC.Comment
|
0x03000400
|
Verarbeitungsanweisung
|
XMLNSC.ProcessingInstruction
|
0x03000401
|
Feldtypen für Pfadausdruck (generische Feldtypen)
Bei der Abfrage der Nachrichtenbaumstruktur unter Verwendung eines Pfadausdrucks sollten Sie die folgenden Feldtypkonstanten verwenden. Beispiel:
SET str = FIELDVALUE(InputRoot.e1.(XMLNSC.Attribute)attr1)
Es empfiehlt sich, für die Abfrage einer mit dem XMLNSC-Parser erstellten Nachrichtenbaumstruktur die Feldtypen anzugeben. Dadurch wird der ESQL-Code präziser und verständlicher, außerdem werden auf diese Weise in manchen Fällen falsche Ergebnisse vermieden. Allerdings sollten Sie darauf achten, welche Feldtypkonstanten verwendet werden. Beim XMLNSC-Parser sollte für die Abfrage der Nachrichtenbaumstruktur eine generische Feldtypkonstante verwendet werden. Dadurch sind beim Pfadausdruck auch Variationen der Eingabe-XML möglich.
Die generischen Feldtypkonstanten sind im Folgenden aufgeführt:
| XML-Konstrukt |
XMLNSC-Feldtypkonstante |
Zweck |
| Element |
XMLNSC.Field |
Deckt normalen Text und/oder CData ab |
| Attribute |
XMLNSC.Attribute |
Deckt Attribute in einfachen und doppelten Anführungszeichen ab |
| Gemischter Inhalt |
XMLNSC.Value |
Deckt normalen Text und/oder CData ab |
| XML-Deklaration |
XMLNSC.NamespaceDecl |
Deckt Deklarationen in einfachen und doppelten Anführungszeichen ab |
Wenn Sie
InputRoot.e1.(XMLNSC.DoubleAttribute)attrName
schreiben, entspricht der Pfadausdruck keinem Attribut in doppelten Anführungszeichen. Bei Verwendung der generischen Feldtypkonstante
XMLNSC.Attribute können im Nachrichtenfluss Attribute in einfachen oder doppelten Anführungszeichen verarbeitet werden.
Sie sollten immer die Feldtypkonstanten, nicht die numerischen Werte verwenden.
Feldtypen zur Steuerung des Ausgabeformats
Zur Unterstützung des XML-Schemas und der base64-Codierung stehen die folgenden Feldtypen bereit. Diese Feldtypkonstanten sollten nicht in Pfadausdrücken verwendet werden, sondern zusammen mit 'XMLNSC.Attribute' und 'XMLNSC.Field', um das erforderliche Ausgabeformat für DATE- und BLOB-Werte anzugeben. Weitere Informationen finden Sie im Abschnitt
XMLNSC: Unterstützung für XML-Schemas.
| XMLNSC-Feldtypkonstante |
Zweck |
Value |
| XMLNSC.gYear |
Der Wert muss ein DATE (Datum) sein. Wenn der Feldtyp diesen Wert enthält, wird der DATE-Wert mit dem gYear-Format des XML-Schemas ausgegeben. |
0x00000010 |
| XMLNSC.gYearMonth |
Der Wert muss ein DATE (Datum) sein. Wenn der Feldtyp diesen Wert enthält, wird der DATE-Wert mit dem gYearMonth-Format des XML-Schemas ausgegeben. |
0x00000040 |
| XMLNSC.gMonth |
Der Wert muss ein DATE (Datum) sein. Wenn der Feldtyp diesen Wert enthält, muss wird DATE-Wert mit dem gMonth-Format des XML-Schemas ausgegeben. |
0x00000020 |
| XMLNSC.gMonthDay |
Der Wert muss ein DATE (Datum) sein. Wenn der Feldtyp diesen Wert enthält, wird der DATE-Wert mit dem gMonthDay-Format des XML-Schemas ausgegeben. |
0x00000050 |
| XMLNSC.gDay |
Der Wert muss ein DATE (Datum) sein. Wenn der Feldtyp diesen Wert enthält, wird der DATE-Wert mit dem gDay-Format des XML-Schemas ausgeben. |
0x00000030 |
| XMLNSC.base64Binary |
Der Wert muss ein BLOB sein. Der Wert wird mit base64-Codierung ausgegeben. |
0x00000060 |
| XMLNSC.List |
Das Element muss ein 'XMLNSC.Attribute' oder 'XMLNSC.Field' sein. Wenn der Feldtyp diesen Wert enthält, müssen die Werte aller untergeordneten Elemente in der Nachrichtenbaumstruktur in einer Liste ausgegeben werden, deren Einträge durch Leerzeichen getrennt sind. |
0x00000070 |
Feldtypen für die direkte Ausgabe.
Mit den folgenden Feldtypen können Sie vordefinierte Segmente eines XML-Dokuments ausgeben. Es werden keine Escapezeichen verwendet; Sie müssen daher mit Umsicht vorgehen, damit kein falsch formatiertes Ausgabedokument erstellt wird. Deshalb sollten diese Konstanten nur verwendet werden, wenn keine andere Lösung in Frage kommt.
| XMLNSC-Feldtypkonstante |
Zweck |
Value |
| XMLNSC.Bitstream |
Der Wert des Syntaxelements muss ein BLOB sein. Der Wert wird direkt in den Ausgabebitstrom geschrieben. Weitere Informationen zur Verwendung finden Sie im Abschnitt Mit umfangreichen XML-Nachrichten arbeiten. |
0x03000200 |
| XMLNSC.AsisElementContent |
Der Wert des Syntaxelements muss ein CHARACTER sein. Der Wert wird direkt in den Ausgabebitstrom geschrieben. Es werden keine Zeichen ersetzt. Daher sollte diese Feldtypkonstante mit Umsicht verwendet werden. |
0x03000600 |