Gestion des listes de codes

Vue d’ensemble

Utilisez XSD pour spécifier un ensemble spécifique de valeurs valides pour un élément ou un attribut. Cette fonctionnalité est disponible à l’aide de l’élément énumération . Lorsque vous dérivez un type de données pour un nœud Field Element ou Field Attribute par restriction, l’une des propriétés qui devient disponible dans la catégorie Restriction est la propriété Énumération . À l’aide de cette propriété, vous pouvez ouvrir la boîte de dialogue Éditeur d’énumération dans laquelle vous pouvez entrer les valeurs qui doivent être considérées comme valides pour l’élément ou l’attribut correspondant dans instance messages.

Avec les listes de codes, Microsoft BizTalk Server fournit une alternative plus puissante pour gérer les énumérations dans vos schémas. Les listes de codes utilisent une base de données Microsoft Access pour stocker les choix de vos diverses énumérations, vous permettant de les gérer d'une manière plus centralisée. En outre, si les valeurs d’énumération que vous devez utiliser se composent de codes numériques non intuitifs, qui doivent être entrés dans ce formulaire à l’aide de la propriété Énumération , les tables que vous créez dans une base de données Access à utiliser avec la fonctionnalité de liste de codes incluent des descriptions textuelles de ces valeurs numériques. Les descriptions textuelles sont utilisées dans la boîte de dialogue CodeList plutôt que dans leurs équivalents numériques plus obscurs.

Utiliser la liste de codes

Pour utiliser la fonctionnalité des listes de codes, vous devez effectuer plusieurs étapes dont :

• Vous devez créer une base de données Access, y placer une table nommée de façon appropriée et comportant les colonnes prévues, et la renseigner avec des valeurs.

  • 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é CodeList Database doit avoir une table nommée XML_MyVersion1.

    Pour plus d’informations sur ces propriétés, consultez les instructions de l’interface utilisateur et les informations de référence sur l’espace de noms d’API des développeurs.

  • 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é. Toutes les lignes ayant une même valeur dans la première colonne forment un groupe. Généralement, ces valeurs sont des entiers, mais elles peuvent aussi être n'importe quelle chaîne sans espace.

    La deuxième et la troisième colonnes de chaque ligne doivent être configurées pour accueillir respectivement la valeur correspondante et la représentation textuelle de chaque valeur d'énumération possible.

    Par exemple, la représentation suivante d'une table de base de données Access à utiliser avec la fonctionnalité Liste de codes contient deux ensembles de trois valeurs d'énumération associées. Les valeurs spécifiques de la première colonne sont arbitraires et sont utilisées pour associer les lignes liées entre elles.

    Code	Valeur	Desc
    1	13	Rouge
    1	16	Vert
    1	19	Bleu
    2	1	Petite
    2	2	Moyenne
    2	3	grand

• Vous devez configurer correctement trois propriétés du nœud de schéma :

  • La propriété Base de données CodeList doit être définie sur le nom de la base de données Access que vous avez créée.

  • Les propriétés Standard et Version standard doivent être définies de telle sorte que lorsqu’elles sont combinées avec un caractère de soulignement séparé (_), elles forment le nom de la table appropriée dans la base de données Access spécifiée.

• Pour utiliser les valeurs de la base de données Access pour un élément Field ou un nœud Attribut de champ sélectionné, vous devez configurer deux de ses propriétés :

  • Vous devez définir sa propriété Derived By sur Restriction. L’autre propriété que vous devez configurer, CodeList, n’est pas activée tant que vous n’avez pas effectué cette étape.

  • Vous devez taper une valeur dans la propriété CodeList qui correspond à la valeur de la première colonne (colonne Code ) d’une ou plusieurs lignes de la base de données Access spécifiée. Cette action identifie l’ensemble de valeurs d’énumération que vous souhaitez avoir correspondant au nœud Field Element ou Field Attribute sélectionné.

    Vous devez ensuite cliquer 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é. Il ne vous est permis que de sélectionner un sous-ensemble des valeurs disponibles. Par exemple, à l’aide de l’exemple de tableau précédent, si vous tapez la valeur 1 dans la propriété CodeList , la boîte de dialogue CodeList contient les choix Rouge, Vert et Bleu. Si vous sélectionnez les zones de case activée pour Rouge et Vert, et que vous ne sélectionnez pas la zone de case activée pour Bleu, seules les anciennes couleurs apparaissent dans le XSD comme valeurs valides pour l’élément Field ou le nœud Attribut de champ sélectionné.

Voir aussi

Considérations à prendre en compte lors de la création de schémas