Partager via


CodeList (propriété node de tous les schémas)

 

Utilisez la propriété CodeList pour définir le numéro de référence de la liste de codes à utiliser avec l’élément Field ou le nœud Attribut de champ sélectionné, et pour accéder à la boîte de dialogue CodeList dans laquelle vous sélectionnez les valeurs de liste de codes à définir comme valeurs d’énumération pour ce nœud.

S'applique aux nœuds de type

Field, élément, attribut Field

Category

BizTalk

Valeurs autorisées

Valeur numérique qui se produit dans la colonne Code dans une ou plusieurs lignes d’une table de la base de données Access spécifiée par la propriété De base de données CodeList du nœud Schéma pour le schéma en cours de modification. Le nom de la table est une combinaison des propriétés Standard et Version standard du nœud Schéma , séparées par un caractère de soulignement (_).

Par exemple, si vous avez défini la propriété Standard du nœud Schéma sur « XML » et la propriété Version standard sur « MyVersion1 », la base de données Access spécifiée par la propriété Base de données CodeList doit avoir une table nommée « XML_MyVersion1 ».

Cette table doit se composer de trois colonnes généralement intitulées « Code », « Valeur » et « Description ». La première colonne identifie les lignes qui sont liées les unes aux autres, où chacune de ces lignes fournit l’un des choix d’énumération qui peuvent être autorisés pour les données qui correspondent au nœud Field Element ou Field Attribute sélectionné.

Valeur par défaut

Aucun.

XSD_Persistence

La valeur de référence est conservée en tant que valeur de l’attribut codelist de :

  • Pour les nœuds Field Element , l’élément d’annotation element/annotation/appinfo/fieldInfo .

  • Pour les nœuds d’attribut de champ , l’élément d’annotation attribute/annotation/appinfo/fieldInfo .

Les choix d’énumération de codelist choisis sont conservés en tant qu’élément d’énumération pour chaque ligne choisie à l’aide de la boîte de dialogue CodeList , où l’attribut value de chaque élément d’énumération est défini sur la chaîne dans la colonne Valeur de la ligne correspondante dans la table de base de données Access spécifiée.

Remarques

Vous pouvez examiner et définir cette propriété dans le Fenêtre Propriétés Visual Studio lorsque vous sélectionnez un élément field ou un nœud Attribut de champ dans l’éditeur BizTalk et que vous avez défini sa propriété Derived By sur Restriction.

Notes

Les propriétés CodeList et CodeList Database sont utilisées au moment du design uniquement et sont conservées dans le XSD en tant que paramètres correspondants pour la propriété Énumération . Au moment de l’exécution, toutes les valeurs sont vérifiées par rapport à la propriété Énumération uniquement.

Vous devez configurer cette propriété conjointement avec la propriété Base de données CodeList du nœud Schéma .

La définition de cette propriété se fait en quatre temps :

  1. Pour le nœud Schéma , vérifiez que les propriétés Base de données CodeList, Standard et Version standard sont correctement définies pour la base de données Microsoft Access dans laquelle vos valeurs de liste de code sont stockées.

  2. Pour l’élément Field sélectionné ou le nœud Attribut de champ sélectionné, définissez la propriété Derived By sur Restriction. La propriété CodeList n’est pas activée tant que vous n’avez pas effectué cette étape.

  3. Tapez une valeur dans la propriété Base de données CodeList . Généralement, cette valeur devra être un entier, mais elle peut aussi être n'importe quelle chaîne sans espace. Quelle que soit la valeur, elle doit se produire une ou plusieurs fois dans la colonne Code (la première colonne) d’une table de base de données Access, où le nom de la table est une concaténation de la valeur de la propriété Standard , un caractère de soulignement (_) et la valeur de la propriété Version standard , et où le fichier de base de données est spécifié à l’aide de la propriété Base de données CodeList ( standard, Les propriétés Version standard et CodeList Database sont toutes des propriétés du nœud Schéma ).

  4. Cliquez sur le bouton de sélection (...) situé à droite du champ valeur de la propriété CodeList pour ouvrir la boîte de dialogue CodeList . À l’aide des zones de case activée de cette boîte de dialogue, sélectionnez les valeurs que vous souhaitez autoriser comme valeurs légales pour les données de message instance qui correspondent au nœud Field Element ou Field Attribute sélectionné.

Pour un élément Field ou un nœud d’attribut de champ donné, n’utilisez pas à la fois la propriété Énumération et la propriété CodeList . L'utilisation de la deuxième propriété peut avoir pour effet que les valeurs entrées utilisent la première pour être remplacées.

Pour plus d’informations conceptuelles sur l’utilisation des listes de code dans l’éditeur BizTalk, consultez Gestion des listes de code.

Voir aussi

Propriétés de nœud de tous les schémas