Creare riferimenti a un altro nodo o tipo

È possibile usare nodi globali per creare tipi di dati riutilizzabili, ovvero frammenti di struttura, che è possibile usare in tutto lo schema, ovunque sia appropriata. È possibile usare solo nodi figlio diretti del nodo Schema per creare tipi globali.

È anche possibile creare riferimenti ciclici usando i tipi di dati dei nodi che non sono discendenti diretti del nodo Schema . Ciò è utile per rappresentare strutture ricorsive negli schemi.

In questo argomento vengono fornite istruzioni dettagliate per i vari tipi di nodi globali e viene descritto come farvi riferimento per utilizzarli.

Creazione di dichiarazioni globali

È possibile creare tipi globali utilizzando record, campi o attributi. I tipi globali creati da record possono essere utilizzati solo nei record, i tipi creati da campi solo nei campi e i tipi creati da attributi solo negli attributi. Nelle seguenti procedure viene descritto come definire e utilizzare le dichiarazioni globali.

Creare una dichiarazione globale da un nodo

  1. Selezionare il nodo Record , Field Attribute o Field Element il cui tipo si desidera rendere disponibile a livello globale.

  2. Nella finestra Proprietà digitare un nome nell'elenco Tipo struttura dati che verrà usato come nome globale per il tipo complesso e quindi premere INVIO.

Creare un nodo gruppo di sequenze definito a livello globale, un nodo Gruppo di scelta o un nodo Tutti i gruppi

  1. Selezionare il nodo Record in cui si vuole inserire il nodo del gruppo definito a livello globale.

  2. Scegliere Inserisci nodo schema dal menu BizTalk, quindi fare clic su Gruppo di sequenze, Gruppodi scelta o Tutti, in base alle esigenze.

  3. Creare una struttura nel gruppo appena inserito. Ad esempio, inserire nodi Record o Elemento campo per esprimere la struttura dei dati all'interno del nodo del gruppo.

    Nota

    I nodi Sequence Group, Choice Group e All Group possono contenere solo nodi che corrispondono agli elementi XML e pertanto non possono contenere nodi Field Attribute .

  4. Selezionare il nodo di gruppo inserito al passaggio 2.

  5. Nella Finestra Proprietà fare clic su Riferimento gruppo, digitare un nome nel campo valore e quindi premere INVIO.

    Specificando un nome nella proprietà Riferimento gruppo , è disponibile un nodo di gruppo definito a livello globale, dopo il quale è possibile associare altri nodi di gruppo a questo tipo definito a livello globale (struttura).

Creare un nodo gruppo di attributi definito a livello globale

  1. Selezionare il nodo Record in cui si vuole inserire il nodo Gruppo di attributi definito a livello globale.

  2. Scegliere Inserisci nodo schema dal menu BizTalk e quindi fare clic su Gruppo di attributi.

    In questo modo viene aggiunto un nodo Gruppo di attributi alla fine dei nodi figlio nel nodo Record selezionato.

  3. Aggiungere i nodi Attributo campo o Gruppo di attributi appropriati al gruppo di attributi.

  4. Facoltativamente, se si vuole rinominare il nodo Gruppo di attributi , selezionare il nodo Gruppo di attributi e modificare la relativa proprietà Riferimento gruppo in un nuovo nome scelto.

    I gruppi di attributi sono sempre globali e ad essi viene fatto riferimento dal loro punto di utilizzo.

Usare un tipo o un gruppo definito a livello globale

  1. Selezionare il nodo per il quale si desidera utilizzare un tipo definito globalmente.

  2. Nella Finestra Proprietà selezionare il tipo definito a livello globale dall'elenco a discesa per la proprietà Tipo struttura dati (nodi Record), la proprietà Tipo di dati (nodi Elemento campo e Attributo campo) o Riferimento gruppo (gruppo di sequenze, gruppo di scelta, tutti i gruppi e nodi gruppo di attributi). Altre informazioni su queste proprietà sono disponibili nelle linee guida dell'interfaccia utente e nelle informazioni di riferimento sullo spazio dei nomi delle API per sviluppatori.

    Nota

    Sarà possibile apportare successivamente modifiche al tipo o gruppo definito globalmente in qualsiasi posizione dello schema in cui l'elemento è presente. Le modifiche verranno applicate a tutte le posizioni dopo averle apportate nella sola posizione scelta.

    Dopo avere creato una dichiarazione globale non sarà possibile eliminarla in un solo passaggio. Tuttavia, è possibile eliminarlo usando la finestra di dialogo Pulisci tipi di dati globali quando lo schema viene salvato, utilizzando la procedura seguente.

Eliminare una dichiarazione globale

  1. Eliminare tutti i nodi in cui viene utilizzato il tipo o gruppo globale o specificare un tipo o gruppo diverso da utilizzare in tutti questi nodi oppure una combinazione dei due. Per istruzioni dettagliate sull'eliminazione di un nodo, vedere Eliminazione di nodi.

  2. Al salvataggio della specifica, viene visualizzata la finestra di dialogo Pulisci tipi di dati globali . Selezionare la dichiarazione globale da eliminare completamente dalla specifica e quindi fare clic su OK.

    Nota

    La finestra di dialogo Pulisci tipi di dati globali viene visualizzata ogni volta che si salva uno schema con tipi di dati inutilizzati. Se la finestra di dialogo non viene visualizzata, tutti i tipi di dati sono utilizzati in qualche punto dello schema o lo schema non è stato modificato dall'apertura (nel secondo caso potrebbe comunque contenere tipi di dati inutilizzati conservati in precedenza).

Creare riferimenti ciclici a un altro nodo

È possibile creare riferimenti ciclici a un nodo per rappresentare elementi dello schema ricorsivi. Per eseguire questa operazione si crea un nodo il cui tipo è definito da un record di inclusione. Si consideri a titolo di esempio un messaggio di istanza inserito in un numero arbitrario di buste con la stessa struttura. È possibile creare uno schema che definisce tali messaggi di istanza utilizzando i riferimenti ciclici.

Creare un riferimento ciclico

  1. Selezionare un nodo Record per il quale si vuole creare un riferimento ricorsivo. Questo nodo rappresenta il vertice della struttura ricorsiva.

  2. Nella Finestra Proprietà verificare che il tipo di struttura dei dati abbia un valore.

    Verificare che al nodo Record sia associato un tipo denominato perché le strutture ricorsive vengono definite quando un tipo contiene se stesso. I tipi possono contenere se stessi soltanto tramite l'utilizzo annidato di tipi globali denominati.

  3. Selezionare un nodo Record figlio o inserire un nodo Record figlio.

  4. Per il nodo Record figlio, nella Finestra Proprietà, nell'elenco Tipo struttura dati selezionare la struttura dei dati identificata nel passaggio 2.

Importante

  • La proprietà Min Occurs per il nodo ripetuto deve essere impostata su zero (0). Impostandolo su uno (1) si verifica un ciclo infinito.

  • Se si importa uno schema contenente un elemento ricorsivo, nell'Editor BizTalk non viene automaticamente eseguita una verifica per accertare che l'elemento ricorsivo sia valido.

Vedere anche

Gestione dei nodi contenuti in uno schema