Partager via


Configuration de la forme Transformer

Image qui représente la forme Transformer.
Forme Transformer

Les transformations sont utilisées uniquement lorsque vous construisez des messages, de sorte que votre forme De transformation s’affiche toujours à l’intérieur d’une forme de message de construction . Vous pouvez supprimer la forme De message de construction sur l’aire de conception, puis supprimer la forme Transformer à l’intérieur de celle-ci, ou vous pouvez simplement supprimer la forme Transformer sur l’aire de conception, et orchestration Designer créera la forme de message de construction englobante pour vous.

Notes

Tout message source ou de destination dans une transformation doit être basé sur un schéma.

Procédure

Pour configurer une forme Transformer

  1. Dans la fenêtre Propriétés, cliquez sur le bouton Points de suspension (...) pour la propriété Messages d’entrée, Messages de sortie ou Nom de la carte .

  2. Utilisez la boîte de dialogue Transformer la configuration pour configurer la forme Transformer .

Notes

Une forme Transform ne peut exister qu’au sein d’une forme de message de construction . Si vous faites glisser une forme d’affectation de message n’importe où sur l’aire de conception, une nouvelle forme de message de construction est créée.

Observations importantes concernant les performances

BizTalk Server optimise la possibilité d’effectuer des transformations sur des messages volumineux en continuant le document en mémoire tout en appliquant la transformation au lieu de charger le document entier en mémoire à la fois. Cette optimisation permet le mappage/la transformation de documents bien plus volumineux que ce que les versions précédentes de BizTalk Server permettaient. Cette optimisation présente des limites lorsqu'une orchestration accepte plusieurs entrées et/ou sorties sur les formes Transformer.

Si une orchestration accepte plusieurs entrées et/ou sorties sur les formes Transformer, le flux du document n'est pas effectué et l'utilisation de la mémoire augmente considérablement. L'une des solutions possibles consiste à appliquer la ou les transformations dans un pipeline de réception de sorte que l'orchestration n'accepte jamais plus d'une entrée ou une sortie sur une forme Transformer.

Fichier de mappage nouveau ou existant

Dans cette section, vous pouvez cliquer sur le bouton Nouvelle carte ou sur le bouton d’option Carte existante pour sélectionner une carte à affecter à la forme Transformer .

Utilisez le champ Nom sous le bouton d’option sélectionné pour spécifier une carte. Si vous avez sélectionné Nouvelle carte, vous pouvez taper une désignation pour la carte que vous souhaitez affecter. Lorsque vous utilisez l’option Nouvelle carte , vous devez spécifier le nom complet de la carte dans la zone de texte. La zone de texte affiche un exemple de ce nom par défaut, car il est prérempli avec un nom d’identificateur unique basé sur l’espace de noms du projet et transformer le nom de la forme : <espace de noms> project.<Transformer le nom> de la forme_Map (par exemple, MyProject.Transform3_Map).

Si vous avez sélectionné Carte existante, cliquez sur la flèche bas dans le champ Nom pour sélectionner le fichier de carte à utiliser. Cette liste, classée par ordre alphabétique, contient tous les mappages existants disponibles pour le projet. Dans cette liste, si vous cliquez sur le texte <Sélectionner à partir d’un assembly> référencé, la boîte de dialogue Sélectionner un type d’artefact s’affiche. Pour plus d’informations sur les sélections qu’il rend disponibles, consultez Comment utiliser la boîte de dialogue Sélectionner un type d’artefact.

Sélection des messages sources et des messages de destination

Utilisez cette partie de la boîte de dialogue Transformer la configuration pour configurer la carte que vous avez sélectionnée dans la section Fichier cartographique nouveau/existant ? Si vous avez sélectionné Nouvelle carte dans cette section, vous créez cette carte en la configurant dans cette section.

Si vous avez sélectionné La carte existante, vous pouvez utiliser cette section pour effectuer l’une des deux opérations suivantes :

  • Sélectionnez un mappage existant à réutiliser tel quel dans la transformation active.

  • Sélectionnez un mappage existant à modifier (reconfigurer), puis utilisez-le avec sa nouvelle configuration dans la transformation active.

    Spécifiez les messages sources et de destination à l’aide des contrôles de grille Messages sources et Messages de destination . Ces contrôles de grille permettent de modifier le fichier de mappage de diverses manières. Si vous supprimez un message (une ligne dans un contrôle de grille), ajoutez un message ou sélectionnez un message de type différent, vous modifiez la structure du mappage. Lorsque vous modifiez la structure d'un mappage, vous devez modifier toutes les autres transformations qui l'utilisent pour qu'elles correspondent à la nouvelle structure du mappage. D'autres modifications, comme la suppression d'un message et l'insertion à sa place d'un message de même type, ne modifient pas la structure du mappage.

    L’apparence et le comportement des contrôles de grille Messages sources et Messages de destination sont identiques. Chaque contrôle de grille comporte deux colonnes : Message et Type. Vous complétez les contrôles de grille en sélectionnant des messages dans la colonne Message. (Vous ne remplissez que la colonne Message, car la colonne Type est en lecture seule.) Les cellules de la colonne Message possèdent des listes déroulantes complétées par les instances de messages qui se trouvent dans l'étendue de l'orchestration active.

    Vous pouvez sélectionner une ligne dans l’un ou l’autre contrôle grille en cliquant sur le bouton flèche droite (>) à gauche du contrôle grille. Une fois la ligne sélectionnée, appuyez sur la touche Suppr pour la supprimer. La suppression d'une ligne (message) modifie la structure du fichier de mappage qui la contient. Seuls les fichiers de mappage locaux du projet peuvent être modifiés.

Lancer le Mappeur BizTalk, après avoir cliqué sur OK

Lorsque je clique sur OK, lancez le mappeur BizTalk automatiquement lorsque vous cliquez sur OK pour fermer la boîte de dialogue Transformer la configuration et enregistrer vos modifications. En revanche, vous ne pouvez pas enregistrer les modifications s'il manque des informations obligatoires. Dans ce cas, terminez de remplir les champs dans la boîte de dialogue, puis cliquez sur OK.

Voir aussi

À propos des mappages
Construction de messages
Utilisation d'expressions pour transformer dynamiquement les messages