Utilisation de l'étendue dans une boucle - Procédure

Mis à jour: août 2015

Cette rubrique décrit l'utilisation d'une étendue dans Microsoft Azure BizTalk Services.

Aire de conception d'étendue

Au bas de l'aire de conception de la Transformation, la hiérarchie d'étendue de la boucle MapEach est affichée dans le cheminement de navigation. L'étendue de la boucle MapEach actuelle est le dernier élément du cheminement de navigation. Lorsque l'étendue est définie dans une boucle MapEach, le cheminement de navigation est mis à jour pour tenir compte de la hiérarchie actuelle. Dans l'exemple suivant, Employee Mapping est la dernière boucle MapEach dans le cheminement de navigation, et par conséquent l'étendue de jeu actuelle :

Cheminement de navigation

Les opérations Boucle MapEach, Boucle ForEach et Créer une liste ont un conteneur. Les objets enfants sont regroupés dans le conteneur. Les éléments au sein du conteneur sont dans l'étendue du conteneur et y sont exécutés. Un conteneur interne est un enfant du conteneur externe. Lorsqu'un conteneur est sélectionné, il est encadré d'une ligne pleine. Dans l'exemple ci-dessous, Dept Mapping est sélectionné, de sorte que le conteneur est encadré d'une ligne pleine :

Conteneur

Chaque conteneur peut être réduit et développé de deux manières :

  • sélectionnez le conteneur et appuyez sur la barre d'espace.

  • sélectionnez le signe moins (-) pour réduire, et le signe plus (+) pour développer.

Le fait de réduire un conteneur désactive automatiquement l'étendue de la boucle MapEach. Il est seulement possible d'ajouter des Opération de mappage à un conteneur lorsque celui-ci est développé. Les liens peuvent être modifiés lorsque le conteneur est réduit ou développé. Dans l'exemple suivant, Employee Mapping est réduit et la propriété Étendue contenante se déplace automatiquement vers son nœud parent, à savoir Dept Mapping :

Réduit

En-tête de conteneur

Lorsque l'étendue MapEach est définie, l'en-tête de conteneur est mis en surbrillance. Vous pouvez modifier les couleurs en procédant comme suit :

  1. Accédez au menu Outils et sélectionnez Options.

  2. Développez le Concepteur de Transformations, puis sélectionnez Couleurs polices.

  3. Sélectionnez Arrière-plan de l'en-tête d'étendue active pour modifier sa couleur.

  4. Sélectionnez OK.

Lors de la liaison d'un enregistrement répété dans le document source avec un enregistrement répété dans le document cible, une boucle MapEach est nécessaire. La création de ces liens à partir de chaque nœud source vers le nœud cible peut prendre beaucoup de temps. Par conséquent, BizTalk Services comprend la fonctionnalité Lien direct.

La création de liens directs consiste uniquement à copier un élément dans un nœud d'entrée vers un nœud de sortie. La création de liens directs est également utilisée lors de la liaison d'enregistrements non répétés qui ne demande pas de boucle MapEach.

La rubrique Opérations de mappage de boucle : utilisation et exemples décrit la fonctionnalité Lien direct.

L'étendue du conteneur est présentée page par page. Quand une étendue est définie sur une boucle MapEach sur la page 1, le fait de sélectionner Page 2 définit l'étendue sur l'accueil de la page 2.

Lorsque vous sélectionnez un conteneur, les liens de nœud source et cible sont surlignés en vert. Dans l'exemple suivant, les étendues Company Mapping, Dept Mapping et Employee Mapping sont définies. Le cheminement de navigation montre la hiérarchie de la boucle MapEach. Employee Mapping est le dernier élément du cheminement de navigation et représente donc l'étendue actuelle. Le nœud Employee Mapping est surligné en vert :

Liens d'indications d'étendue

  1. Dans le menu Outils, sélectionnez Options.

  2. Sélectionnez Concepteur de transformations.

  3. Pour désactiver la fonctionnalité de mise en évidence, sélectionnez Général, puis désactivez l'option Propagation de la mise en surbrillance.

  4. Pour modifier le surlignage des couleurs, sélectionnez Couleurs & polices.

Lorsqu'une boucle enfant est sélectionnée, la propriété Étendue contenante est mise à jour avec le nom de l'étiquette de l'étendue parente. Dans l'exemple suivant, Dept Mapping est sélectionné, et la propriété Étendue contenante affiche le nœud parent Company Mapping :

Élément contenant la propriété de la portée

La sélection de Accueil dans le cheminement de navigation affiche l'étendue sur la page. Aucune étendue n'est définie et la propriété Étendue du conteneur affiche Aucune :

Accueil du cheminement de navigation

Une Opération de mappage peut être déplacée à l'aide des options Couper/Copier et Coller, mais pas les liens. Si vous déplacez une Opération de mappage avec les commandes Couper/Copier et Coller, les liens sont supprimés.

Pour déplacer une Opération de mappage et ses liens, utilisez le raccourci Ctrl+Clic pour sélectionner les éléments à déplacer. La méthode Ctrl+clic coupe les éléments, que vous pouvez ensuite coller à l'emplacement souhaité. Les opérations de mappage et les liens ne peuvent pas être déplacés et déposés.

Pour quitter l'étendue d'une boucle MapEach, effectuez l'une des opérations suivantes :

  • Annuler l'étendue Étendue non épinglée. Cette option déplace l'affichage vers l'étendue de la boucle MapEach supérieure dans la hiérarchie.

    Dans l'exemple suivant, l'étendue est définie :

    Élément contenant la propriété de la portée

    Puis l'étendue de la boucle MapEach Employee Mapping est désactivée. L'étendue de la boucle MapEach Dept Mapping est le dernier élément du cheminement de navigation et par conséquent l'étendue actuelle :

    Élément dans la portée et prochain sans portée
  • Sélectionnez une étendue parente dans le cheminement de navigation. Par exemple, sélectionnez Dept Mapping dans le cheminement de navigation :

    Sortie de l'étendue du cheminement de navigation
  • Définissez une étendue différente.

Pour en savoir plus sur les meilleures pratiques lorsque vous travaillez avec l'étendue du conteneur et l'exemple d'étendue, consultez les rubriques suivantes :

Meilleures pratiques en matière de transformations/mappages

Exemples de boucles et de portées dans le mappage ou les transformations

Voir aussi

Afficher: