Gestione degli XML personalizzati

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:

  1. Creare un protocollo per il formato e associarlo con uno o più pacchetti
  2. Creare un flusso di documenti per il formato e associarlo al protocollo recentemente creato
  3. 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.

Creazione del formato di definizione del protocollo CustomXML

Le seguenti procedure descrivono in che modo creare un formato di definizione del protocollo XML personalizzato:

  1. Fare clic su Ammin hub > Definizioni flusso di documenti > Crea definizione di flusso di documenti.

    Figura 26. Pagine Crea definizioni del flusso di documenti


  2. Per Tipo di flusso di documenti, selezionare Protocollo.
  3. Per Codice, inserire il valore per il tipo di oggetto selezionato nella precedente procedura. Ad esempio, è possibile inserire l'XML.
  4. 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.
  5. Per Versione, inserire 1.0.
  6. Inserire una descrizione facoltativa del protocollo.
  7. Impostare Livello documento in No, dato che si definisce un protocollo, piuttosto che un flusso di documenti (che si definisce nella sezione successiva).
  8. Impostare Stato in Abilitato.
  9. Impostare Visibilità per questo protocollo. Si desidera probabilmente essere visibile a tutti i partecipanti.
  10. 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.
  11. Fare clic su Salva.

Creazione di un flusso di definizione di documenti

Successivamente, utilizzare la pagina Crea definizione di flusso di documenti per creare nuovamente un flusso di documenti.

  1. Fare clic su Ammin hub > Definizioni flusso di documenti > Crea definizione di flusso di documenti.
  2. Per tipo flusso di documenti, selezionare Flusso di documenti.
  3. Per Codice, inserire il valore per il tipo di oggetto (flusso di documenti) selezionato nella precedente procedura.
  4. 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.
  5. Per Versione, inserire 1.0.
  6. Inserire una descrizione facoltativa del protocollo.
  7. Impostare Livello documento in (perché si sta definendo un livello di documento).
  8. Impostare Stato in Abilitato.
  9. Impostare Visibilità per questo flusso. Probabilmente si vuole renderlo visibile a tutti i partecipanti.
  10. 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.).
  11. 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


Creazione di un formato XML

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.

  1. Fare clic su Ammin hub > Configurazione hub >Formati XML.
  2. Fare clic su Crea formato XML.

    Figura 28. La pagina Visualizza il formato XML


  3. Per Formato di instradamento, selezionare la definizione del flusso di documenti con la quale questo formato viene associato.
  4. Per Tipo di file, selezionare XML.

    Nota: L'XML è l'unica opzione disponibile per il tipo di file.

  5. Per Tipo identificativo, selezionare l'elemento utilizzato per identificare il tipo di documento in arrivo. Le scelte sono DTD, Spazio nome, or Tag root.
  6. 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.
    1. Per ID commerciale origine/destinazione, inserire il percorso dell'ID commerciale. Questo campo è obbligatorio.
    2. 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.
    3. Per Identificativo documento, inserire il percorso per il numero ID del documento.
    4. Per Data e ora documento, inserire il percorso per la data e ora di creazione del documento.
    5. Per Chiave di verifica duplicata 1-5, inserire i percorsi utilizzati per identificare l'instradamento di un documento duplicato.
  7. Fare clic su Salva.

Utilizzo delle mappe di convalida

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.

Aggiunta mappe di convalida

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.

  1. Salvare il file della mappa di convalida nell'hub o nella posizione dalla quale WebSphere Business Integration Connect può leggere i file
  2. Fare clic su Ammin hub > Configurazione hub > Mappe di convalida.
  3. Fare clic su Crea.
  4. 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.
  5. Fare clic su Salva.

Associazione delle mappe con le definizioni di flusso di documento

Per associare una mappa di convalida con una Definizione di flusso di documenti, utilizzare la seguente procedura.

  1. Fare clic su Ammin hub > Configurazione hub > Mappe di convalida. La Console visualizza la pagina Gestisci mappe.
  2. Fare clic sull'icona accanto alla mappa di convalida che si desidera associare alla Definizione di flusso di documenti.
  3. Fare clic sull'icona per espandere individualmente nel livello Azione, o selezionare Tutti per espandere tutto l'albero.
  4. Selezionare la Definizione di flusso di documenti che si desidera associare alla mappa di convalida.
  5. Fare clic su Inoltra.

Copyright IBM Corp. 1997, 2004