Gestione degli elenchi di codici
Panoramica
Il linguaggio XSD consente di specificare un determinato set di valori validi per un elemento o un attributo. Questa funzionalità è disponibile usando l'elemento di enumerazione . Quando si deriva un tipo di dati per un nodo Field Element o Field Attribute per restrizione, una delle proprietà che diventa disponibili nella categoria Di restrizione è la proprietà Enumeration . Usando questa proprietà, è possibile aprire la finestra di dialogo Editor enumerazione in cui è possibile immettere i valori che devono essere considerati validi per l'elemento o l'attributo corrispondente nei messaggi di istanza.
In Microsoft BizTalk Server è disponibile un metodo alternativo e più funzionale per gestire le enumerazioni negli schemi, noto come elenchi di codici. Tale funzionalità si basa sull'utilizzo di un database di Microsoft Access in cui vengono memorizzati i possibili valori per le varie enumerazioni consentendo di gestirli in modo più centralizzato. Inoltre, se i valori di enumerazione da usare sono costituiti da codici numerici non intuitivi, che devono essere immessi in tale formato usando la proprietà Enumeration , le tabelle create in un database di Access da usare con la funzionalità dell'elenco di codice includono descrizioni testuali di questi valori numerici. Le descrizioni testuali vengono usate nella finestra di dialogo CodeList anziché gli equivalenti numerici più oscuri.
Usare l'elenco di codice
Per utilizzare la funzionalità degli elenchi di codici, è necessario eseguire numerosi passaggi differenti, descritti di seguito:
È necessario creare un database di Access con una tabella denominata correttamente contenente le colonne previste e compilarlo con valori.
Il nome della tabella è una combinazione delle proprietà Standard e Standard Version del nodo Schema , separate da un carattere di sottolineatura (_). Ad esempio, se è stata impostata la proprietà Standard del nodo Schema su XML e la proprietà Versione Standard su MyVersion1, il database di Accesso specificato dalla proprietà Database CodeList deve avere una tabella denominata XML_MyVersion1.
Altre informazioni su queste proprietà nella guida per l'interfaccia utente e informazioni di riferimento sullo spazio dei nomi delle API per sviluppatori.
Questa tabella dovrà essere composta da tre colonne, denominate solitamente Codice, Valore e Desc. La prima colonna identifica le righe correlate tra loro, in cui ogni riga fornisce una delle opzioni di enumerazione che potrebbero essere potenzialmente consentite per i dati corrispondenti al nodo Field Element o Field Attribute selezionato. Tutte le righe con lo stesso valore nella prima colonna formano un gruppo. Si tratta solitamente di valori integer ma possono ugualmente essere rappresentati da stringhe senza spazi intermedi.
È necessario che la seconda e la terza colonna di ogni riga della tabella siano configurate per contenere rispettivamente il valore e la rappresentazione testuale corrispondenti di ogni possibile valore di enumerazione.
Nella rappresentazione seguente di una tabella di un database di Access, ad esempio, da utilizzare con la funzionalità degli elenchi di codici, sono contenuti due set di tre valori di enumerazione correlati. I valori specifici indicati nella prima colonna sono arbitrari e sono utilizzati per associare le righe correlate.
Codice Valore Desc 1 13 Red 1 16 Green 1 19 Blu 2 1 Piccolo 2 2 Medio 2 3 Grande
È necessario configurare correttamente tre proprietà del nodo Schema :
La proprietà CodeList Database deve essere impostata sul nome del database di Access creato.
Le proprietà Standard e Standard Version devono essere impostate in modo che, quando vengono combinate con un carattere di sottolineatura di separazione (_), formano il nome della tabella appropriata all'interno del database di Access specificato.
Per usare effettivamente i valori nel database di Access per un determinato nodo Field Element o Field Attribute , è necessario configurare due delle relative proprietà:
È necessario impostare la proprietà Derivata by su Restrizione. L'altra proprietà che è necessario configurare, CodeList, non verrà abilitata finché non si esegue questo passaggio.
È necessario digitare un valore nella proprietà CodeList corrispondente al valore nella prima colonna (colonna Code ) di una o più righe nel database di Access specificato. Questa azione identifica il set di valori di enumerazione che si intende avere corrispondente al nodo Field Element o Field Attribute selezionato.
È quindi necessario fare clic sul pulsante con i puntini di sospensione (...) che si trova a destra del campo valore della proprietà CodeList per aprire la finestra di dialogo CodeList. Usando le caselle di controllo in questa finestra di dialogo, selezionare i valori che si desidera consentire come valori legali per i dati del messaggio di istanza corrispondenti al nodo Field Element o Field Attribute selezionato. È consentito selezionare solo un sottoinsieme dei valori disponibili. Ad esempio, usando l'esempio di tabella precedente, se si digita il valore 1 nella proprietà CodeList , la finestra di dialogo CodeList conterrà le opzioni Rosso, Verde e Blu. Se si selezionano le caselle di controllo per Rosso e Verde e non si seleziona la casella di controllo blu, verranno visualizzati solo i colori precedenti come valori validi per il nodo Field Element o Field Attribute selezionato.
Nota
Le proprietà CodeList e CodeList Database vengono usate solo in fase di progettazione e vengono mantenute in XSD come impostazioni corrispondenti per la proprietà Enumeration . In fase di esecuzione, tutti i valori vengono verificati solo sulla proprietà Enumeration .
Attenzione
Per un determinato nodo Field Element o Field Attribute , non usare sia la proprietà Enumeration che la proprietà CodeList . Se si utilizza la seconda proprietà, i valori immessi utilizzando la prima proprietà verranno sovrascritti.