Personnalisation d'une mappe de messages pour inclure l'arborescence d'environnement local

Pour personnaliser votre mappe de messages afin d'y inclure l'arborescence d'environnement local, vous devez ajouter cette arborescence au message d'entrée et au message de sortie puis définir des transformations entre ces deux messages.

Avant de commencer

  1. Créez une mappe de messages. Pour plus d'informations, voir Création d'une mappe de messages pour transformer des messages SOAP.
  2. Définissez des transformations entre les éléments du dossier Propriétés. Pour plus d'informations, voir Transformation d'éléments dans le dossier Propriétés à l'aide de la fonction Remplacer.

A propos de cette tâche

Par défaut, lorsqu'une mappe de messages est créée, le seul composant d'assemblage de message qui est configuré automatiquement est le dossier Propriétés. Le dossier Propriétés d'entrée est connecté au dossier Propriétés de sortie avec une transformation Déplacer. Il est également possible de mapper les autres composants de l'assemblage de message tels que les en-têtes de transport et l'arborescence de l'environnement local.

Dans ce scénario, vous configurez l'arborescence d'environnement local en tant que composant supplémentaire pour une mappe de messages dans l'éditeur de mappage de données graphiques.

Procédure

Pour configurer l'arborescence d'environnement local dans une mappe de messages, procédez comme suit :

  1. Ouvrez la mappe de messages dans l'éditeur de mappage de données graphiques.
  2. Ajoutez l'arborescence d'environnement local au message d'entrée.
    • Méthode 1 :
      1. Sélectionnez Assemblage de message.

        Cette figure montre l'emplacement de l'assemblage de messages dans le message d'entrée.

      2. Dans la vue Propriétés, sélectionnez l'onglet Général.

        Cette figure illustre l'onglet Général. Dans cet onglet, vous pouvez voir que seule l'arborescence Propriétés est incluse car aucun autre composant d'assemblage de messages n'est inclus.

      3. Cliquez sur Propriétés.
        Remarque: Si d'autres structures sont incluses dans votre assemblage de messages, l'option sur laquelle vous pouvez cliquer inclut tous les composants d'assemblage de messages que vous avez sélectionnés. Par exemple, si vous aviez sélectionné l'arborescence Propriétés et l'arborescence d'environnement local, vous cliquez sur Environnement local, Propriétés.
    • Méthode 2 :
      1. Sélectionnez l'icône d'information Cette icône est représentée par un i dans un carré. située en regard du type de corps du message d'entrée.

        Cette figure montre l'emplacement de l'icône dans le message d'entrée.

      2. Sélectionnez En-tête : Propriétés.

        Cette figure illustre la fenêtre en incrustation qui s'affiche lorsque vous sélectionnez l'icône, où vous sélectionnez En-tête: Propriétés.

  3. Dans le Ajouter ou supprimer des en-têtes et des dossiers fenêtre, sélectionnez Environnement local, puis cliquez sur D'accord.

    Cette figure montre la fenêtre Ajouter ou supprimer des en-têtes et des dossiers qui s'ouvre.

  4. Répétez les étapes précédentes pour ajouter l'arborescence d'environnement local au message de sortie.
  5. Définissez une transformation Déplacer entre l'arborescence d'environnement local d'entrée et l'arborescence d'environnement local de sortie. Vous pouvez ajouter d'autres transformations. Pour plus d'informations, voir Spécification d'une transformation et Types de transformation dans l'éditeur de mappage de données graphiques.

Résultats

L'illustration suivante montre la mappe de messages dans l'éditeur de mappage de données graphiques une fois que vous avez créé une mappe de messages pour transformer un message SOAP et configurer l'arborescence d'environnement local :

Cette figure illustre la mappe de messages que vous avez créée dans l'éditeur de données de mappage graphique lors des étapes précédentes du scénario. Il montre comment les parties En-tête, Corps et Pièce jointe sont décrites avec un élément générique de type any.

Etape suivante

Ajoutez des variables définies dans le dossier des variables de l'arborescence d'environnement local. Voir Configuration du dossier Variables de l'arborescence de l'environnement local à l'aide de la fonction de diffusion.