Créer des références à un autre nœud ou type
Vous pouvez utiliser des nœuds globaux pour créer des types de données, ou fragments de structure, réutilisables dont vous pouvez vous servir dans votre schéma dès lors que cette structure est appropriée. Vous pouvez uniquement utiliser des nœuds qui sont des enfants directs du nœud Schéma pour créer des types globaux.
Vous pouvez également créer des références cycliques à l’aide des types de données de nœuds qui ne sont pas des descendants directs du nœud Schéma . Cela se révèle utile pour représenter des structures récursives dans des schémas.
Cette rubrique fournit des instructions étape par étape concernant différents types de nœuds globaux ainsi qu'à propos de la manière d'y faire référence pour les utiliser.
Création de déclarations globales
Vous pouvez créer des types globaux à l'aide d'enregistrements, de champs ou d'attributs. Les types globaux créés à partir d'enregistrements ne peuvent être utilisés que dans les enregistrements. De même, les types créés à partir de champs ne peuvent être utilisés que dans les champs et les types d'attribut ne peuvent être utilisés que dans les attributs. Les procédures suivantes décrivent comment définir et utiliser des déclarations globales.
Créer une déclaration globale à partir d’un nœud
Sélectionnez le nœud Record , Field Attribute ou Field Element dont vous souhaitez rendre le type disponible globalement.
Dans la fenêtre Propriétés , tapez un nom dans la liste Type de structure de données qui sera utilisé comme nom global pour le type complexe, puis appuyez sur Entrée.
Créer un nœud Groupe de séquences défini globalement, un nœud Groupe de choix ou un nœud Tout le groupe
Sélectionnez le nœud Enregistrement dans lequel vous souhaitez insérer le nœud de groupe défini globalement.
Dans le menu BizTalk , pointez sur Insérer un nœud de schéma, puis cliquez sur Groupe de séquences, Groupe de choix ou Tout le groupe, le cas échéant.
Créez une structure dans le groupe nouvellement inséré. Par exemple, insérez des nœuds Record ou Field Element pour exprimer la structure des données au sein du nœud de groupe.
Notes
Les nœuds Sequence Group, Choice Group et All Group ne peuvent contenir que des nœuds qui correspondent à des éléments XML et ne peuvent donc pas contenir de nœuds d’attribut de champ .
Sélectionnez le nœud de groupe inséré à l'étape 2.
Dans le Fenêtre Propriétés, cliquez sur Référence de groupe, tapez un nom dans le champ de valeur, puis appuyez sur Entrée.
En fournissant un nom dans la propriété Référence de groupe , vous avez défini globalement le nœud de groupe, après quoi vous pouvez associer d’autres nœuds de groupe à ce type (structure) globalement défini.
Créer un nœud de groupe d’attributs défini globalement
Sélectionnez le nœud Enregistrement dans lequel vous souhaitez insérer le nœud Groupe d’attributs défini globalement.
Dans le menu BizTalk , pointez sur Insérer un nœud de schéma, puis cliquez sur Groupe d’attributs.
Cela ajoute un nœud Groupe d’attributs à la fin des nœuds enfants dans le nœud Enregistrement sélectionné.
Ajoutez les nœuds Attribut de champ ou Groupe d’attributs appropriés à votre groupe d’attributs.
Si vous souhaitez renommer le nœud Groupe d’attributs, sélectionnez le nœud Groupe d’attributs et remplacez sa propriété Référence de groupe par un nouveau nom de votre choix.
Les groupes d'attributs sont toujours globaux et référencés à partir de leur point d'utilisation.
Utiliser un type ou un groupe qui a été défini globalement
Sélectionnez le nœud pour lequel vous souhaitez utiliser un type globalement défini.
Dans le Fenêtre Propriétés, sélectionnez le type défini globalement dans la liste déroulante pour la propriété Type de structure de données (nœuds d’enregistrement), la propriété Type de données (nœuds d’attribut d’élément field et d’attribut de champ) ou la référence de groupe (nœuds Groupe de séquences, Groupe de choix, Tous les groupes et Groupe d’attributs). Pour plus d’informations sur ces propriétés, consultez les conseils d’interface utilisateur et les informations de référence sur l’espace de noms d’API des développeurs.
Notes
Les changements apportés ultérieurement au type ou groupe globalement défini peuvent être effectués dans tous les emplacements de schéma où il apparaît. Ces modifications seront appliquées à tous ces emplacements au fur et à mesure que vous les apporterez dans l'emplacement unique arbitraire.
Une fois que vous avez créé une déclaration globale, vous êtes dans l'impossibilité de la supprimer en une seule étape. Toutefois, vous pouvez le supprimer à l’aide de la boîte de dialogue Nettoyer les types de données globaux lors de l’enregistrement du schéma, à l’aide de la procédure suivante.
Supprimer une déclaration globale
Supprimez tous les nœuds dans lesquels ce type ou ce groupe global est utilisé, ou spécifiez un autre type ou groupe à utiliser dans tous ces nœuds, ou combinez ces deux opérations. Pour obtenir des instructions détaillées sur la suppression d’un nœud, consultez Suppression de nœuds.
Lors de l’enregistrement de votre spécification, la boîte de dialogue Nettoyer les types de données globaux s’affiche. Sélectionnez la déclaration globale que vous souhaitez supprimer complètement de votre spécification, puis cliquez sur OK.
Notes
La boîte de dialogue Nettoyer les types de données globaux s’affiche chaque fois que vous enregistrez un schéma avec des types de données inutilisés. Si cette boîte de dialogue n'apparaît pas, c'est soit que tous les types de données sont utilisés quelque part dans le schéma, soit que le schéma n'a pas été modifié depuis son ouverture, auquel cas il contient peut-être encore des types de données non utilisés précédemment conservés.
Créer des références cycliques à un autre nœud
Vous pouvez créer des références cycliques à un nœud pour représenter des éléments récursifs de schéma. Pour ce faire, vous devez créer un nœud dont le type est défini par un enregistrement associé. Imaginez par exemple un message d'instance intégré dans un nombre arbitraire d'enveloppes partageant la même structure. À l'aide de références cycliques, vous pouvez créer un schéma définissant de tels messages d'instance.
Créer une référence cyclique
Sélectionnez un nœud Enregistrement pour lequel vous souhaitez créer une référence récursive. Il s'agit du nœud représentant la partie supérieure de la structure récursive.
Dans le Fenêtre Propriétés, vérifiez que le type de structure de données a une valeur.
Il est nécessaire de vérifier qu’un type nommé est associé au nœud Record , car les structures récursives sont définies lorsqu’un type se contient lui-même. Les types ne peuvent se contenir eux-mêmes que via une utilisation imbriquée de types globaux nommés.
Sélectionnez un nœud Enregistrement enfant ou insérez un nœud Enregistrement enfant.
Pour le nœud Enregistrement enfant, dans le Fenêtre Propriétés, dans la liste Type de structure de données, sélectionnez la structure de données identifiée à l’étape 2.
Important
La propriété Min Occurs du nœud répétiteur doit être définie sur zéro (0). Le fait de le définir sur une (1) provoque une boucle infinie.
Si vous importez un schéma qui contient un élément récursif, l'Éditeur BizTalk ne vérifie pas automatiquement que ce dernier est valide.