Création d'une transformation ou d'un mappage

Mis à jour: juillet 2015

Vous pouvez définir des relations entre un document XML d'entrée, ajouter des opérations de mappage pour modifier des données, puis générer un document XML. Une Transformation ou un mappage fait partie du modèle de Kit de développement logiciel (SDK) BizTalk Services dans Visual Studio. Consultez Installation du Kit de développement logiciel (SDK) Azure BizTalk Services.

Dans cette rubrique :

Choix de votre type de projet

Ajout de vos schémas

Ajout de vos opérations de mappage

Trucs et astuces concernant la zone de conception

Informations supplémentaires sur le mappage

Il existe deux manières de créer une Transformation : ajouter un mappage au projet de service BizTalk ou créer un projet Artefacts BizTalk Service.

Un mappage ajouté ou créé dans le projet de service BizTalk fait partie du projet et est destiné à être utilisé dans le pont unidirectionnel XML ou le Pont demande-réponse XML. Lorsque vous créez un projet Artefacts BizTalk Service, vous créez un mappage indépendant de tout autre projet. Une fois la Transformation terminée, vous pouvez l'enregistrer, l'ajouter à un accord interentreprises, ou l'ajouter à un projet de service BizTalk.

De nombreux développeurs préfèrent conserver leurs schémas dans un emplacement central. Dans ce cas, vous pouvez utiliser un projet Artefacts BizTalk Service pour stocker vos schémas et vos mappages. Ensuite, vous enregistrez/sauvegardez un projet et ses ressources. Quand vous avez besoin de ces schémas ou mappages, vous pouvez simplement les ajouter à d'autres projets.

  1. Ouvrez Visual Studio en tant qu'administrateur, puis ouvrez votre projet de service BizTalk.

  2. Dans le projet BizTalk Services, accédez à l'Explorateur de solutions.

  3. Cliquez avec le bouton droit sur le projet, sélectionnez Ajouter, puis Nouvel élément ou Élément existant.

  4. Entrez les détails de votre mappage, puis sélectionnez Ajouter.

Une fois la création du mappage terminée, vous pouvez ajouter celui-ci à l'étape de transformation du Pont XML. Consultez Création d'un pont unidirectionnel XML ou Création de pont demande-réponse XML. Utilisations et étapes des ponts fournit des informations supplémentaires sur l'étape de transformation.

  1. Ouvrez Visual Studio en tant qu'administrateur.

  2. Sélectionnez Nouveau projet.

  3. Développez le modèle Visual C#, puis sélectionnez BizTalk Services.

  4. Sélectionnez Artefacts BizTalk Service.

  5. Entrez les propriétés Nom, Emplacement et Nom de la solution du projet, puis la préférence Créer le répertoire pour la solution.

  6. Sélectionnez OK.

Une fois le projet ouvert, les fichiers Map.trfm, Schema1.xsd et Schema2.xsd sont créés automatiquement. Ces fichiers étant vides, vous pouvez les modifier ou les supprimer, voire ajouter vos propres fichiers. Les Transformations BizTalk Services ont une extension .trfm, et l'ouverture d'un fichier .trfm entraîne l'ouverture du concepteur de Transformation dans lequel vous pouvez ajouter des schémas et des Opération de mappage, ainsi que dessiner vos liens.

Vous pouvez créer et modifier des schémas à l'aide de l'éditeur de schéma intégré. Une fois le mappage ajouté, ajoutez vos schémas Source (entrée) et Cible (sortie) :

  1. Ouvrez un projet BizTalk Services ou Artefacts BizTalk Service dans Visual Studio en tant qu'administrateur.

  2. Ajoutez un schéma (.xsd) existant ou nouveau au projet :

    1. Cliquez avec le bouton droit sur le projet et sélectionnez Ajouter.

    2. Sélectionnez Élément existant pour ajouter un schéma déjà créé. Sélectionnez Nouvel élément, Schéma pour créer un schéma.

  3. Sélectionnez Ajouter.

  4. Double-cliquez sur le schéma (.xsd) pour ouvrir l'éditeur de schéma.

L'article Développement des schémas EDI fournit des informations sur la création et la modification de schémas existants.

Une fois les schémas ajoutés, vous pouvez utiliser les opérations de mappage intégrées pour modifier ou manipuler les données entrantes afin qu'elles correspondent au schéma de sortie :

  1. Dans la boîte à outils, cliquez et faites glisser l'Opération de mappage vers le concepteur Transformation :

    Double-cliquez sur l'Opération de mappage pour configurer les entrées.

  2. Cliquez et faites glisser des éléments à partir de votre schéma d'entrée vers les opérations de mappage ou le schéma de sortie pour créer les liens. Les opérations de mappage prennent en charge trois types de sources d'entrée :

    • Lien d'un nœud d'arborescence

    • Lien d'une Opération de mappage

    • Valeur constante

TipConseil
  • Si un lien d'une arborescence ou une Opération de mappage n'est pas autorisé, un message en indiquant la raison est affiché dans la barre d'état.

  • Certaines opérations de mappage ont une propriété Type dans la boîte de dialogue Configurer. Cette propriété Type est en lecture seule.

 

   

Couper, Copier et Coller

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.

Une Opération de mappage et les liens ne peuvent pas faire l'objet d'un glisser-déplacer. Pour déplacer une Opération de mappage et ses liens, utilisez le raccourci Ctrl+Clic pour sélectionner les éléments à déplacer. Le raccourci clavier Ctrl+Clic coupe les éléments. Il ne vous reste qu'à les coller à l'emplacement désiré.

Prise en charge de XSLT

Dans un projet BizTalk Services ou Artefacts BizTalk Service, un fichier de Transformation (.trfm) peut utiliser XSLT. Les options XSLT incluent l'entrée d'une syntaxe XSLT et l'importation de fichiers XSLT existants, y compris des fichiers d'extension XML (EXT XML).

Pour importer un fichier XSLT existant, sélectionnez la zone de conception Transformation. Dans les propriétés, sélectionnez Importer XSLT. Vous pouvez sélectionner un fichier ou entrer directement la syntaxe XSLT.

Pour importer un fichier d'extension XML existant, sélectionnez la zone de conception Transformation. Dans les propriétés, sélectionnez Importer EXTXML. Vous pouvez sélectionner un fichier ou entrer directement la syntaxe XML.

Sélectionnez Utiliser XslCompiledTransform pour optimiser les performances pour transformer les données XML en compilant les feuilles de style XSLT et en exécutant les Transformations XSLT. Une fois la feuille de style compilée, elle peut être mise en cache et réutilisée. Quand cette option est désactivée, la classe XslTransform est utilisée, ce qui est préférable lorsqu'une Transformation est exécutée une seule fois.

Liens directs avec enregistrements répétés

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.

Défilement

Deux méthodes s'offrent à vous pour faire défiler de façon verticale le Concepteur de Transformation :

  • à l'aide de la molette de la souris ;

  • en utilisant les touches de direction haut et bas.

Deux méthodes s'offrent à vous pour faire défiler de façon horizontale le Concepteur de Transformation :

  • en appuyant de façon prolongée sur la touche MAJ tout en faisant défiler la molette de la souris ;

  • en utilisant les touches de direction gauche et droite.

Surface de dessin

La surface de dessin du Concepteur de Transformation a une taille par défaut de 200*200 cellules. Pour modifier la taille :

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

  2. Développez le Concepteur de Transformation et cliquez sur Général.

  3. Modifiez les valeurs du nombre de cellules sur l'axe X de la zone de grille et du nombre de cellules sur l'axe Y de la zone de grille. Les valeurs sont comprises entre 100 et 1000.

  4. Cliquez sur OK.

Page

Des pages peuvent être ajoutées, supprimées et renommées sur l'aire de conception Transformation. Les opérations de mappage et leurs conteneurs d'étendues sont par page.

Pour ajouter, supprimer ou renommer une page, cliquez avec le bouton droit sur l'onglet Page 1 en bas de l'aire de conception pour afficher les options disponibles.

Voir aussi

Afficher: