CodeList (proprietà Node di tutti gli schemi)

 

Utilizzare la proprietà CodeList per definire il numero di riferimento per l'elenco di codice da utilizzare con il nodo Elemento campo o Attributo campo selezionato e per accedere alla finestra di dialogo CodeList in cui si selezionano i valori dell'elenco di codice da impostare come valori di enumerazione per questo nodo.

Si applica ai nodi di tipo

Elemento Field, Attributo Field

Category

BizTalk

Valori consentiti

Valore numerico che si verifica nella colonna Code in una o più righe di una tabella nel database di Access specificato dalla proprietà CodeList Database del nodo Schema per lo schema da modificare. 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à Standard Version su "MyVersion1", il database di Access specificato dalla proprietà CodeList Database deve avere una tabella denominata "XML_MyVersion1".

Questa tabella dovrà essere composta da tre colonne, denominate solitamente "Codice", "Valore" e "Desc". La prima colonna identifica le righe correlate l'una all'altra, in cui ogni riga di questo tipo fornisce una delle opzioni di enumerazione che potrebbero essere consentite per i dati che corrispondono al nodo Elemento campo o Attributo campo selezionato.

Valore predefinito

Nessuno.

Persistenza XSD

Il valore di riferimento viene salvato in modo permanente come valore dell'attributo codelist di:

  • Per i nodi Elemento campo , l'elemento di annotazione element/annotation/appinfo/fieldInfo .

  • Per i nodi Attributo campo , l'elemento annotation/appinfo/fieldInfo annotation.

Le scelte effettive di enumerazione dell'elenco di codice scelto vengono mantenute come un elemento di enumerazione per ogni riga scelta tramite la finestra di dialogo CodeList , in cui l'attributo value di ogni elemento di enumerazione viene impostato sulla stringa nella colonna Value della riga corrispondente nella tabella di database di Access specificata.

Commenti

È possibile esaminare e impostare questa proprietà nel Finestra Proprietà di Visual Studio quando si seleziona un nodo Elemento campo o Attributo campo nell'editor BizTalk ed è stata impostata la relativa proprietà Derivata da su Restrizione.

Nota

Le proprietà CodeList e CodeList Database vengono utilizzate solo in fase di progettazione e vengono mantenute nell'XSD come impostazioni corrispondenti per la proprietà Enumeration . In fase di esecuzione, tutti i valori vengono verificati solo in base alla proprietà Enumeration .

È necessario configurare questa proprietà insieme alla proprietà CodeList Database del nodo Schema .

La configurazione della proprietà prevede quattro passaggi distinti.

  1. Per il nodo Schema, verificare che le proprietà CodeList Database, Standard e Standard Version siano impostate correttamente per il database Microsoft Access in cui vengono archiviati i valori dell'elenco di codice.

  2. Per il nodo Elemento campo o Attributo campo selezionato, impostare la proprietà Derived By su Restriction.For the selected Field Element or Field Attribute node, set the Derived By property to Restriction. La proprietà CodeList non verrà abilitata fino a quando non si esegue questo passaggio.

  3. Digitare un valore nella proprietà CodeList Database . Si tratta solitamente di un numero intero, ma può essere una stringa che non contiene spazi. Indipendentemente dal valore, deve verificarsi una o più volte nella colonna Code (la prima colonna) di una tabella di database di Access, in cui il nome della tabella è una concatenazione del valore della proprietà Standard , un carattere di sottolineatura (_) e il valore della proprietà Versione standard e il file di database viene specificato utilizzando la proprietà Database CodeList(standard,Le proprietà Standard Version e CodeList Database sono tutte proprietà del nodo Schema .

  4. Fare clic sul pulsante con i puntini di sospensione (...) 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 che corrispondono al nodo Elemento campo o Attributo campo selezionato.

Per un determinato nodo Elemento campo o Attributo campo , non utilizzare sia la proprietà Enumeration che la proprietà CodeList . Se si utilizza la seconda proprietà, i valori immessi utilizzando la prima proprietà verranno sovrascritti.

Per informazioni concettuali sull'uso degli elenchi di codice nell'editor BizTalk, vedere Gestione elenchi di codice.

Vedere anche

Proprietà dei nodi di tutti gli schemi