Effettuare le procedure in questa sezione solo se si utilizza un formato
XML personalizzato.
XML(Extensible Markup Language) è il formato universale per i documenti
strutturati e i dati sul Web. Utilizzando la pagina Gestisci i
protocolli XML, è possibile creare e gestire i formati XML personalizzati che
possono essere aggiunti all'elenco delle Definizioni di flusso di
documenti disponibili.
Un formato XML definisce i percorsi in un gruppo di documenti XML.
Questo consente al Gestore documenti di recuperare i valori che unicamente
identificano un documento in entrata e accedono alle informazioni in gestore
documenti necessarie per una corretto instradamento ed elaborazione.
La creazione di un formato XML è un processo multifase. Ô
necessario:
- Creare un protocollo per il formato e associarlo con uno o più pacchetti
- Creare un flusso di documenti per il formato e associarlo al protocollo
recentemente creato
- Creare il formato
Si crea quindi una valida interazione per il formato recentemente
creato.
Queste procedure vengono descritte nelle sezioni che seguono. Ô
possibile trovare un esempio di queste procedure in Impostazione dell'hub per i documenti XML personalizzati.
Le seguenti procedure descrivono in che modo creare un formato di
definizione del protocollo XML personalizzato:
- Fare clic su Ammin hub > Definizioni flusso di documenti >
Crea definizione di flusso di documenti.
Figura 26. Pagine Crea definizioni del flusso di documenti

- Per Tipo di flusso di documenti, selezionare
Protocollo.
- Per Codice, inserire il valore per il tipo di oggetto
selezionato nella precedente procedura. Ad esempio, è possibile
inserire l'XML.
- Per Nome, inserire un identificativo per la definizione del
flusso di documenti.Ad esempio, per un protocollo personalizzato XML, è
possibile inserire un XML_personalizzato. Questo campo è
obbligatorio.
- Per Versione, inserire 1.0.
- Inserire una descrizione facoltativa del protocollo.
- Impostare Livello documento in No, dato che si
definisce un protocollo, piuttosto che un flusso di documenti (che si
definisce nella sezione successiva).
- Impostare Stato in Abilitato.
- Impostare Visibilità per questo protocollo. Si desidera
probabilmente essere visibile a tutti i partecipanti.
- Selezionare i pacchetti nei quali questo nuovo protocollo viene
incluso. Ad esempio, se si desidera associare questo protocollo a tutti
e tre i pacchetti, selezionare Pacchetto: AS,
Pacchetto: Nessuno, e Pacchetto: Integrazione
backend.
- Fare clic su Salva.
Successivamente, utilizzare la pagina Crea definizione di flusso di
documenti per creare nuovamente un flusso di documenti.
- Fare clic su Ammin hub > Definizioni flusso di documenti >
Crea definizione di flusso di documenti.
- Per tipo flusso di documenti, selezionare Flusso di
documenti.
- Per Codice, inserire il valore per il tipo di oggetto (flusso
di documenti) selezionato nella precedente procedura.
- Per Nome, inserire un identificativo per la definizione del
flusso di documenti.Ad esempio, è possibile inserire XML_Tester come un
nome per il flusso di documenti. Questo campo è obbligatorio.
- Per Versione, inserire 1.0.
- Inserire una descrizione facoltativa del protocollo.
- Impostare Livello documento in Sì (perché si sta
definendo un livello di documento).
- Impostare Stato in Abilitato.
- Impostare Visibilità per questo flusso. Probabilmente si
vuole renderlo visibile a tutti i partecipanti.
- Fare clic sull'icona della cartella per ingrandire ogni pacchetto
selezionato nella precedente procedura. Ingrandire la cartella e
selezionare il nome del protocollo creato nella sezione precedente (ad
esempio, Protocollo: CustomXML.).
- Fare clic su Salva.
Il seguente è un esempio di come la porzione del pacchetto AS della
schermata Gestisci flusso di documenti deve apparire se è stato creato un
protocollo di CustomXML, associato al protocollo con l'impacchettamento
AS, e creato un flusso di documenti di XML_Tester:
Figura 27. La pagina Definizione del flusso di documenti con il nuovo protocollo XML personalizzato e il flusso di documenti aggiunto

Dopo la creazione di un protocollo XML personalizzato (e
l'associazione con un pacchetto o una serie di pacchetti) e la creazione
di un flusso di documento associato, si è pronti per creare il formato
XML.
Per creare un formato XML, utilizzare la seguente procedura.
- Fare clic su Ammin hub > Configurazione hub >Formati
XML.
- Fare clic su Crea formato XML.
Figura 28. La pagina Visualizza il formato XML

- Per Formato di instradamento, selezionare la definizione del
flusso di documenti con la quale questo formato viene associato.
- Per Tipo di file, selezionare XML.
Nota: L'XML è l'unica opzione disponibile per il tipo di file.
- Per Tipo identificativo, selezionare l'elemento utilizzato
per identificare il tipo di documento in arrivo. Le scelte sono
DTD, Spazio nome, or Tag root.
- Per ogni campo per il quale una scelta dei tipi viene offerta, selezionare
Percorso elemento, che è il pecorso nel valore nel documento o
Costante, che il valore effettivo nel documento. Quindi
fornire un valore.
- Per ID commerciale origine/destinazione, inserire il percorso
dell'ID commerciale. Questo campo è obbligatorio.
- Per Flusso di documenti di origine & Versione, inserire
un'espressione che definisce il percorso nel Flusso di documenti e il
valore della versione nel documento XML. Questo campo è
obbligatorio.
- Per Identificativo documento, inserire il percorso per il
numero ID del documento.
- Per Data e ora documento, inserire il percorso per la data e
ora di creazione del documento.
- Per Chiave di verifica duplicata 1-5, inserire i percorsi
utilizzati per identificare l'instradamento di un documento
duplicato.
- Fare clic su Salva.
Websphere Business Integration Connect utilizza le mappe di convalida per
convalidare la struttura di RosettaNet o i documenti XML. Se non è
necessario importare le mappe di convalida, passare direttamente a Creazione interazioni.
Un'azione può avere una mappa di convalida associata per garantire che
il partecipante di destinazione o il sistema di back-end possano analizzare il
documento. Notare che una mappa di convalida convalida solo la
struttura del documento. Non convalida i contenuti del
messaggio.
Nota: Una volta associata la mappa di convalida a una Definizione di flusso di
documenti, non è possibile dissociarli.
Per aggiungere una nuova mappa di convalida all'hub, utilizzare la
seguente procedura.
- Salvare il file della mappa di convalida nell'hub o nella posizione
dalla quale WebSphere Business Integration Connect può leggere i file
- Fare clic su Ammin hub > Configurazione hub > Mappe di
convalida.
- Fare clic su Crea.
- Digitare una descrizione della mappa di convalida. Scegliere il
percorso e il nome del file dello schema che si desidera utilizzare per
convalidare i documenti.
- Fare clic su Salva.
Per associare una mappa di convalida con una Definizione di flusso di
documenti, utilizzare la seguente procedura.
- Fare clic su Ammin hub > Configurazione hub > Mappe di
convalida. La Console visualizza la pagina Gestisci mappe.
- Fare clic sull'icona accanto alla mappa di convalida che si desidera
associare alla Definizione di flusso di documenti.
- Fare clic sull'icona per espandere individualmente nel livello
Azione, o selezionare Tutti per espandere tutto
l'albero.
- Selezionare la Definizione di flusso di documenti che si desidera
associare alla mappa di convalida.
- Fare clic su Inoltra.
