XMLNSC: Feldtypen verwenden

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
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac67192_