Panoramica

Gestore documenti di WebSphere Partner Gateway identifica un documento cXML grazie al nome dell'elemento root del documento XML, che è cXML, e la versione identificata da cXML DOCTYPE (DTD). Ad esempio, il seguente DOCTYPE è per la versione cXML 1.2.009:

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

Gestore documenti effettua la convalida DTD sui documenti cXML; tuttavia, WebSphere Partner Gateway non fornisce DTD cXML. È possibile scaricarli da www.cxml.org, quindi caricarli in WebSphere Partner Gateway mediante il modulo Mappa di convalida nella Console comunità. Dopo aver caricato il DTD, associarlo al flusso di documenti cXML. Fare riferimento a Associazione delle mappe alle definizioni di flusso di documenti per ulteriori informazioni sull'associazione del DTD con il flusso di documenti cXML.

Il Gestore documenti utilizza due attributi dell'elemento root cXML per la gestione del documento: l'ID payload e data e ora. Il cXML payloadID e data e ora vengono utilizzati come il numero ID del documento e la data e ora del documento. Entrambi sono visualizzabili nella Console comunità per la gestione del documento.

Gli elementi Da e A nell'intestazione cXML contengono l'elemento delle Credenziali che viene utilizzato per l'instradamento del documento e l'autenticazione. Il seguente esempio in basso vengono mostrati gli elementi Da e A come origine e destinazione del documento cXML.

Nota: Qui e in tutto il manuale, i numeri DUNS sono solo esempi.
<intestazione>
 <Da>
 
             <Credential domain="AcmeUserId">
                 <Identity>admin@acme.com</Identity>
             </Credential>
             <Credential domain="DUNS">
                 <Identity>130313038</Identity>
             </Credential>
 </Da
 <A>
             <Credential domain="DUNS">
                 <Identity>987654321</Identity>
             </Credential>
             <Credential domain="IBMUserId">
                 <Identity>test@ibm.com</Identity>
             </Credential>
 </A>

Se più di un elemento della credenziale viene utilizzato, il Gestore documenti utilizza il numero DUNS come identificativo aziendale per l'instradamento e l'autenticazione. Nel caso in cui non ci sia alcun numero fornito DUNS, viene utilizzata la prima Credenziale.

WebSphere Partner Gateway non utilizza le informazioni nell'elemento Mittente.

In una transazione sincrona, l'intestazione Da e A non viene utilizzata in un documento di risposta cXML. L'elemento di risposta viene inviato mediante la stessa connessione HTTP che viene stabilita dal documento di richiesta.

Tipi di documenti cXML

Un documento cXML può essere uno dei tre tipi: Richiesta, Risposta o Messaggio.

Richiesta

Ci sono molti tipi di richieste cXML. L'elemento Richiesta all'interno del documento cXML corrisponde al Flusso di documenti in WebSphere Partner Gateway. Gli elementi tipici della richiesta sono:

La seguente tabella mostra la relazione tra gli elementi in un documento di richiesta cXML e le definizioni di flusso di documenti in WebSphere Partner Gateway:

Elemento cXML
Definizione del flusso di documenti
cXML DOCTYPE
Protocollo
Versione DTD
Versione del protocollo
Richiesta (tipo)
Ad esempio, OrderRequest
Flusso di documenti
Risposta

Il partecipante di destinazione invia a una risposta cXML per informare il partecipante di origine dei risultati della richiesta cXML. Poiché i risultati di alcune richieste potrebbero non disporre di dati, l'elemento Risposta può facoltativamente contenere un solo elemento Stato. Un elemento Risposta può contenere anche i dati a livello di applicazione. Durante un PunchOut, ad esempio, i dati a livello dell'applicazione sono contenuti in un elemento PunchOutSetupResponse. Gli elementi Risposta tipici sono:

La seguente tabella mostra la relazione tra gli elementi in un documento di richiesta cXML e le definizioni di flusso di documenti in WebSphere Partner Gateway:

Elemento cXML
Definizione del flusso di documenti
cXML DOCTYPE
Protocollo
Versione DTD
Versione del protocollo
Risposta (tipo)
Ad esempio, ProfileResponse
Flusso di documenti
Messaggio

Un messaggio cXML contiene le informazioni sul flusso di documenti di WebSphere Partner Gateway nell'elemento Messaggio cXML. Può contenere un elemento Stato facoltativo identico a quello trovato nell'elemento Risposta. Può essere utilizzato nei messaggi che sono risposte ai messaggi di richiesta.

Il contenuto del messaggio è personale e definito dalle esigenze commerciali dell'utente. L'elemento direttamente in basso all'elemento <Messaggio> corrisponde al flusso di documenti creato in WebSphere Partner Gateway. Nel seguente esempio, SubscriptionChangeMessage è il flusso di documenti:

<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 seguente tabella mostra la relazione tra gli elementi in un messaggio cXML e le definizioni di flusso di documenti in WebSphere Partner Gateway:

Elemento cXML
Definizione del flusso di documenti
cXML DOCTYPE
Protocollo
Versione DTD
Versione del protocollo
Messaggio
Flusso di documenti

Il modo più semplice per indicare la differenza tra un messaggio di sola andata e un documento Richiesta-Risposta è la presenza di un elemento Messaggio invece di un elemento di richiesta o risposta.

Un messaggio può avere i seguenti attributi:

Intestazioni del tipo di contenuto e documenti allegati

Tutti i documenti cXML devono contenere Intestazione del tipo di contenuto. Per i documenti cXML senza allegati, vengono utilizzate le seguenti intestazioni del tipo di contenuto:

Il protocollo cXML supporta l'allegato dei file esterni mediante MIME. Ad esempio, gli acquirenti spesso devono chiarire gli ordini di acquisto con i memo, illustrazioni o fax di supporto. Una delle intestazioni del tipo di contenuto elencata in basso deve essere utilizzata nei documenti cXML che contengono gli allegati:

L'elemento confine è un testo unico che viene utilizzato per separare il corpo dalla parte payload del messaggio MIME. Per ulteriori informazioni, fare riferimento alla Guida utente cXML all'indirizzo www.cxml.org.

Interazioni cXML valide

WebSphere Partner Gateway supporta le seguenti interazioni di definizione di flusso di documenti cXML:

Copyright IBM Corp. 2003, 2005