Le Gestionnaire de documents WebSphere Business Integration Connect identifie un document cXML par le nom de l'élément racine du document XML, "cXML", et la version identifiée par cXML DOCTYPE (DTD). Par exemple, le DOCTYPE suivant est pour cXML version 1.2.009 :
<!DOCTYPE cXML SYSTEM "http://xml.cXML.org/schemas/cXML/1.2.009/cXML.dtd">
Le gestionnaire de documents effectue la validation DTD sur les documents cXML ; toutefois, Business Integration Connect ne fournit pas de DTD cXML. Vous pouvez les télécharger à partir du site www.cxml.org ; puis les télécharger vers l'amont dans Business Integration Connect via le module de mappe de validation dans Console de communauté. Une fois que vous avez téléchargé vers l'amont le DTD, associez-le au flot de documents cXML. Pour plus d'informations sur l'association de DTD avec le flot de documents cXML, voir Configuration du concentrateur.
Le Gestionnaire de documents utilise deux attributs de l'élément racine du gestionnaire de documents : payloadID et timestamp. Les payloadID cXML et timestamp sont utilisés entant que numéro d'ID document et horodatage du document. Ces deux informations peuvent être consultées sur la Console de communauté pour le Gestionnaire du document.
Les éléments From (De) et To (A) de l'en-tête cXML contient l'élément Credential utilisé pour le routage et l'authentification du document. L'exemple ci-dessous affiche les éléments From (De) et To (A) comme source et cible du document cXML :
<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>
Si plusieurs éléments credential sont utilisés, le Gestionnaire de documents utilise le numéro DUNS comme identificateur commercial pour le routage et l'authentification. Si aucun numéro DUNS n'a été indiqué, le premier Credential est utilisé.
Business Integration Connect n'utilise pas les informations se trouvant dans l'élément Sender.
Dans le cadre d'une transaction synchrone, les en-têtes From (De) et To (A) ne sont pas utilisés dans le document de réponse cXML. La document de réponse est envoyé via la même connexion HTTP qui est établie par le document de la demande.
Un document cXML peut se présenter sous trois types : Demande, Réponse ou Message.
Il existe plusieurs types de demandes cXML. L'élément de demande dans le document cXML correspond à la définition de flot de documents dans Business Integration Connect. Les éléments de demandes classiques sont les suivants :
La table suivante illustre la relation entre les éléments dans un document de demande cXML et des définitions de flot de documents dans Business Integration Connect :
Le participant cible envoie une réponse cXML pour indiquer au participant source les résultats de la demande cXML. Etant donné que les résultats de certaines demandes peuvent ne contenir aucune donnée, l'élément Réponse peut contenir uniquement un élément Etat. Un élément Réponse peut également contenir toute donnée de niveau d'application. Lors de la phase PunchOut, par exemple, les données au niveau de l'application sont contenues dans un élément PunchOutSetupResponse. Les éléments Réponse classiques sont les suivants :
La table suivante illustre la relation entre les éléments dans un document de demande cXML et des définitions de flot de documents dans Business Integration Connect :
Un message cXML contient des informations de flot de documents de Business Integration Connect dans l'élément de message de cXML. Il peut contenir un élément d'état optionnel identique à celui trouvé dans un élément Réponse. Il serait utilisé dans des messages qui sont des réponses aux messages de demandes.
Le contenu de ce message est personnalisé en fonction des besoins commerciaux de l'utilisateur. L'élément se trouvant directement sous l'élément <Message> correspond au flot de documents créé dans Business Integration Connect. Dans l'exemple ci-dessous, SubscriptionChangeMessage serait le flot de documents :
<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>
La table suivante illustre la relation entre les éléments dans un message cXML et les définitions de flot de documents dans Business Integration Connect :
Le moyen le plus simple d'indiquer la différence entre un message unidirectionnel et un document Demande-Réponse est la présence d'un élément de message au lieu d'un élément de demande ou de réponse.
Un message peut posséder les attributs suivants :
Tous les documents cXML doivent contenir un en-tête Content-type. Pour les documents cXML ne contenant pas de pièces jointes, les en-têtes Content-type suivants sont utilisés :
Le protocole cXML prend en charge la connexion des fichiers externes via le format MIME. Par exemple, les clients ont souvent besoin de se remémorer les ordres d'achat à l'aide de mémos, dessins ou télécopies. L'un des en-têtes Content-type répertorié ci-dessous doit être utilisés dans les documents cXML contenant des pièces jointes :
L'élément boundary correspond à tout texte unique utilisé pour séparer le corps du message de la partie payload du message MIME. Pour plus d'information, consultez le guide d'utilisateur cXML à l'adresse www.cxml.org.
Business Integration Connect prend en charge les interactions de définition
de flot de documents :
Source | Cible | Module source | Module cible | Protocole source | Protocole cible | Passe-système | Validation | Conversion |
---|---|---|---|---|---|---|---|---|
Participant
|
Gestion.
|
Aucun
|
Aucun
|
cXML
|
cXML
|
x
|
x
|
|
Gestion.
|
Participant
|
Aucun
|
Aucun
|
cXML
|
cXML
|
x
|
x
|
|
Gestion.
|
Participant
|
|
Aucun
|
XML
|
cXML
|
x
|
x
|
x
|