cXML-Unterstützungsübersicht

WebSphere Business Integration Connect Document Manager gibt ein cXML-Dokument durch den Rootelementnamen des XML-Dokuments, der lautet "cXML", und die Version an, die mit dem cXML-DOCTYPE (DTD) angegeben wird. Der folgende DOCTYPE ist z. B. cXML-Version 1.2.009:

<!DOCTYPE cXML SYSTEM "http://xml.cXML.org/schemas/cXML/1.2.009/cXML.dtd">

Document Manager führt die DTD-Validierung für cXML-Dokumente aus; Business Integration Connect stellt jedoch keine cXML-DTDs bereit. Sie können diese unter www.cxml.org herunterladen; und sie dann in Business Integration Connect über das Validierungszuordnungsmodul in Community Console hochladen. Nachdem Sie die DTD hochgeladen haben, ordnen Sie diese dem cXML-Dokumentenfluss zu. Weitere Informationen zum Zuordnen der DTD zum cXML-Dokumentenfluss finden Sie in Den Hub konfigurieren.

Document Manager verwendet zwei Attribute des cXML-Rootelements für die Dokumentverwaltung: payloadID und timestamp. payloadID und timestamp werden als Dokument-ID-Nummer und Dokumentzeitmarke verwendet. Beide können in Community Console für die Dokumentverwaltung angezeigt werden.

Die Elemente From und To im cXML-Header enthalten das Element Credential, das für die Dokumentweiterleitung und -authentifizierung verwendet wird. Das Beispiel unten stellt die Elemente From und To als die Quelle und das Ziel des cXML-Dokuments dar:

<Header>
 <From>
  
             <Credential domain="AcmeUserId">
                 <Identity>admin@acme.com</Identity>
             </Credential>
             <Credential domain="DUNS">
                 <Identity>130313038</Identity>
             </Credential>
 </From
 <To>
             <Credential domain="DUNS">
                 <Identity>987654321</Identity>
             </Credential>
             <Credential domain="IBMUserId">
                 <Identity>test@ibm.com</Identity>
             </Credential>
 </To>
 

Wenn mehr als ein Element Credential verwendet wird, verwendet Document Manager die DUNS-Nummer als Geschäftskennung für die Weiterleitung und Authentifizierung. In dem Fall, wenn keine DUNS-Nummer vorgegeben ist, wird das erste Element Credential verwendet.

Business Integration Connect verwendet nicht die Informationen im Absenderelement.

Bei einer synchronen Transaktion wird der Header From und To in einem cXML-Antwortdokument nicht verwendet. Das Antwortdokument wird über dieselbe HTTP-Verbindung gesendet, die vom Anforderungsdokument hergestellt wurde.

cXML-Dokumenttypen

Es gibt die folgenden drei cXML-Dokumenttypen: Anforderung, Antwort oder Nachricht.

Anforderung

Es gibt viele Typen von cXML-Anforderungen. Das Element Request im cXML-Dokument entspricht der Dokumentenflussdefinition in Business Integration Connect. Typische Anforderungselemente:

Die folgende Tabelle zeigt die Beziehung zwischen den Elementen in einem cXML-Anforderungsdokument und den Dokumentenflussdefinitionen in Business Integration Connect:

cXML-Element
Dokumentenflussdefinition

cXML-DOCTYPE
Protokoll

DTD-Version
Protokollversion

Anforderungstyp
Beispiel: OrderRequest
Dokumentenfluss

Antwort

Der Zielteilnehmer sendet eine cXML-Antwort, um den Quellenteilnehmer über die Ergebnisse der cXML-Anforderung zu informieren. Da die Ergebnisse einiger Anforderungen unter Umständen über keine Daten verfügen, kann das Element Response optional nichts außer einem Statuselement enthalten. Ein Element Response kann auch Daten der Anwendungsebene enthalten. Während PunchOut sind z. B. die Daten der Anwendungsebene in einem Element PunchOutSetupResponse enthalten. Typische Antwortelemente:

Die folgende Tabelle zeigt die Beziehung zwischen den Elementen in einem cXML-Antwortdokument und den Dokumentenflussdefinitionen in Business Integration Connect:

cXML-Element
Dokumentenflussdefinition

cXML-DOCTYPE
Protokoll

DTD-Version
Protokollversion

Antworttyp
Beispiel: ProfileResponse
Dokumentenfluss

Nachricht

Eine cXML-Nachricht enthält die Business Integration Connect-Dokumentenflussinformation im cXML-Nachrichtenelement. Es kann optional ein Statuselement enthalten, das mit dem im Antwortelement identisch ist. Es würde in Nachrichten verwendet, die Antworten auf Anforderungsnachrichten sind.

Der Inhalt der Nachricht ist durch die Geschäftsanforderungen der Benutzer kundenspezifisch. Das Element direkt unterhalb des Elements <Message> entspricht dem Dokumentenfluss, der in Business Integration Connect erstellt wurde. In dem Beispiel darunter würde SubscriptionChangeMessage der Dokumentenfluss sein:

<Message>
 <SubscriptionChangeMessage type="new">
            <Subscription>
                 <InternalID>1234</InternalID>
                 <Name xml:lang="en-US">Q2 Prices</Name>
                 <Changetime>1999-03-12T18:39:09-08:00</Changetime>
                 <SupplierID domain="DUNS">942888711</SupplierID>
                 <Format version="2.1">CIF</Format>
             </Subscription>
 </SubscriptionChangeMessage>
 </Message>
 

Die folgende Tabelle zeigt die Beziehung zwischen den Elementen in einer cXML-Nachricht und den Dokumentenflussdefinitionen in Business Integration Connect:

cXML-Element
Dokumentenflussdefinition

cXML-DOCTYPE
Protokoll

DTD-Version
Protokollversion

Nachricht
Dokumentenfluss

Sie können den Unterschied zwischen einer Einwegnachricht und einem Anforderungs-/Antwortdokument am einfachsten dadurch feststellen, ob ein Nachrichtenelement anstelle eines Anforderungs- oder Antwortelements vorhanden ist.

Eine Nachricht kann über die folgenden Attribute verfügen:

Die Header "Content-Type" und angehängte Dokumente

Alle cXML-Dokumente müssen einen Header Content-Type enthalten. Für cXML-Dokumente ohne Anhänge werden die folgenden Header Content-Type verwendet:

Das cXML-Protokoll unterstützt das Anhängen von externen Dateien über MIME. Käufer müssen z. B. oft die Bestellungen mit unterstützenden Kurzinformationen, Zeichnungen oder per Fax verdeutlichen. Einer der unten aufgelisteten Header Content-Type muss in cXML-Dokumenten verwendet werden, die Anhänge enthalten:

Das Element boundary ist ein beliebiger Text, der den Hauptteil vom payload-Abschnitt (Nutzinformationen) der MIME-Nachricht trennt. Weitere Informationen finden Sie im cXML User Guide unter www.cxml.org.

Gültige cXML-Interaktionen

Business Integration Connect unterstützt die folgenden cXML-Dokumentenflussdefinitionsinteraktionen:
Quelle Ziel Quellenpaket Zielpaket Quellenprotokoll Zielprotokoll Pass-Through Validierung Konvertierung

Teilnehmer

Manager

Keins

Keins

cXML

cXML

x

x


Manager

Teilnehmer

Keins

Keins

cXML

cXML

x

x


Manager

Teilnehmer


Keins

XML

cXML

x

x

x

Copyright IBM Corp. 1997, 2004