Il gestore documenti di WebSphere Business Integration Connect 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">
Il Gestore documenti effettua la convalida DTD sui documenti cXML; tuttavia, Business Integration Connect non fornisce i DTD cXML. Ô possibile scaricarli da www.cxml.org; e quindi caricarli in Business Integration Connect mediante la convalida del modulo Mappa nella Console comunità. Dopo aver caricato il DTD, associarlo con il flusso di documenti cXML. Fare riferimento a Configurazione hub 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. L'esempio in basso mostra gli elementi Da e A come origine e destinazione del documento 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>
Se più di un elemento della credenziale viene utilizzato, il Gestore documenti utilizza il numero DUNS come identificativo commerciale per l'instradamento e l'autenticazione. Nel caso in cui non c'è alcun numero fornito DUNS, viene utilizzata la prima Credenziale.
Business Integration Connect non utilizza le informazioni nell'elemento del Mittente.
In una transazione sincronica, 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.
Un documento cXML può essere uno dei tre tipi: Richiesta, Risposta o Messaggio.
Ci sono molti tipi di richieste cXML. L'elemento di richiesta nel documento cXML corrisponde alla definizione del flusso di documenti in Business Integration Connect. Gli elementi tipici della richiesta sono:
La seguente tabella mostra la relazione tra gli elementi in un documento di richiesta cXML e le definizioni del flusso di documenti in Business Integration Connect:
Il partecipante di destinazione invia una risposta cXML per informare il partecipante di origine dei risultati della richiesta cXML. Dato che i risultati di alcune richieste potrebbero non avere dati, l'elemento di Risposta può facoltativamente contenere niente altro che un elemento Stato. Un elemento di Risposta può contenere i dati di livello di applicazione. Durante un PunchOut, ad esempio, i dati del livello di applicazione sono contenuti in un elemento PunchOutSetupResponse. Gli elementi tipici della Risposta sono:
La seguente tabella mostra la relazione tra gli elementi in un documento di richiesta cXML e le definizioni del flusso di documenti in Business Integration Connect:
Un messaggio cXML contiene le definizioni del flusso di documenti Business Integration Connect nell'elemento del messaggio cXML. Può contenere uno elemento di stato facoltativo identico a quello trovato in un elemento di Risposta. Può essere utilizzato nei messaggi che sono risposte ai messaggi di richiesta.
Il contenuto del messaggio è personalizzato definito dalle esigenze commerciali dell'utente. L'elemento direttamente in basso all'elemento <Messaggio> corrisponde al flusso di documenti creato in Business Integration Connect. Nell'esempio in basso, SubscriptionChangeMessage sarebbe 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 del flusso di documenti in Business Integration Connect:
Il modo più semplice per indicare la differenza tra un messaggio a senso unico e un documento di Risposta della richiesta è la presenza di un elemento del messaggio invece di un elemento di richiesta o di risposta.
Un messaggio può avere i seguenti attributi:
Tutti i documenti cXML devono contenere un'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 elencato in basso deve essere utilizzata nei documenti cXML che contengono gli allegati:
L'elemento di confine è un testo unico che viene utilizzato per separare il corpo dalla porzione payload del messaggio MIME. Fare riferimento alla Guida utente cXML all'indirizzo www.cxml.org per ulteriori informazioni.
Business Integration Connect supporta le seguenti interazioni di
definizione del flusso di documenti cXML:
Origine | Destinaz. | Pacchetto di origine | Pacchetto di destinaz. | Protocollo di origine | Protocollo di destinaz. | Passaggio autorizzato | Convalida | Conversione |
---|---|---|---|---|---|---|---|---|
Partecipante
|
Gestore
|
Nessuno
|
Nessuno
|
cXML
|
cXML
|
x
|
x
|
|
Gestore
|
Partecipante
|
Nessuno
|
Nessuno
|
cXML
|
cXML
|
x
|
x
|
|
Gestore
|
Partecipante
|
|
Nessuno
|
XML
|
cXML
|
x
|
x
|
x
|