Ajouter des mappages pour les transformations dans les workflows dans Azure Logic Apps

S’applique à : Azure Logic Apps (Consommation + Standard)

Les actions de workflow telles que Transform XML et Liquid nécessitent un mappage pour effectuer leurs tâches. Par exemple, l’action Transform XML nécessite un mappage pour convertir du code XML d’un format à un autre. Un mappage est un document XML qui utilise le langage XSLT (Extensible Stylesheet Language Transformation) pour décrire la manière de convertir des données au format XML dans un autre format. Il a l’extension de nom de fichier .xslt. Le mappage se compose d’un schéma XML source en entrée et d’un schéma XML cible en sortie. Vous pouvez définir une transformation de base, par exemple, la copie d’un nom et de l’adresse d’un document vers un autre. Vous pouvez aussi créer des transformations plus complexes à l'aide des opérations de mappage prêtes à l'emploi. Vous pouvez manipuler ou contrôler des données à l’aide de différentes fonctions intégrées, telles que des manipulations de chaînes, des affectations conditionnelles, des expressions arithmétiques, des formateurs d’heure et de date, voire des constructions de boucle.

Par exemple, imaginons que vous receviez régulièrement des commandes ou des factures B2B de la part d’un client qui utilise le format de date YearMonthDay (AAAAMMJJ). Votre organisation, quant à elle, utilise le format de date MonthDayYear (MMJJAAAA). Vous pouvez définir et utiliser un mappage qui transforme le format de AAAAMMJJ au format MMJJAAAA avant d’enregistrer les détails de la commande ou de la facture dans votre base de données d’activité client.

Ce guide montre comment ajouter une carte à utiliser pour votre flux de travail. Vous pouvez ajouter des cartes à votre compte d'intégration lié ou, si vous disposez d'une application logique standard, vous pouvez ajouter des cartes directement à votre ressource d'application logique.

Prérequis

• Un compte et un abonnement Azure. Si vous n’avez pas encore d’abonnement, vous pouvez vous inscrire pour obtenir un compte Azure gratuitement.

• Mappage que vous souhaitez ajouter. Pour créer des cartes, vous pouvez utiliser l'un des outils suivants :

  • Visual Studio Code et l’extension Mappeur de données. Pour appeler les mappages créés avec le Mappeur de données depuis votre workflow, vous devez utiliser l’action Opérations du mappeur de données nommée Transformer en utilisant le mappeur de données XSLT, et non l’action Opérations XML nommée Transformer du XML. Pour plus d’informations, consultez Créer des cartes pour la transformation de données avec Visual Studio Code.

  • Visual Studio 2019 et l’extension Outils Intégration Entreprise de Microsoft Azure Logic Apps.

  • Visual Studio 2015 et l’extension Microsoft Azure Logic Apps Enterprise Integration Tools pour Visual Studio 2015 2.0.

    Notes

    N’installez pas l’extension Outils Intégration Entreprise de Microsoft Azure Logic Apps avec l’extension BizTalk Server. Ces deux extensions installées côte à côte risquent d’entraîner un comportement inattendu. Vérifiez que seule l’une de ces extensions est installée.

    Sur les moniteurs à haute résolution, vous risquez de rencontrer un problème d’affichage avec le concepteur de mappages dans Visual Studio. Pour résoudre ce problème d’affichage, redémarrez Visual Studio en mode sans prise en charge DPI ou ajoutez la valeur de Registre DPIUNAWARE.

    Pour plus d’informations, consultez la section Créer des mappages dans cet article.

• Selon que vous travaillez sur un flux de travail d’application logique Consommation ou Standard, vous aurez besoin d’une ressource de compte d’intégration. En règle générale, vous avez besoin de cette ressource lorsque vous souhaitez définir et stocker des artefacts à utiliser dans des flux de travail d’intégration d’entreprise et B2B.

  Important

  Pour opérer ensemble, votre compte d’intégration et votre ressource d’application logique doivent exister dans le même abonnement et la même région Azure.

  • Si vous utilisez un workflow d’application logique Consommation, vous devez avoir un compte d’intégration qui est lié à votre ressource d’application logique.

  • Si vous travaillez sur un flux de travail d’application logique Standard, vous pouvez lier votre compte d’intégration à votre ressource d’application logique, charger des mappages directement dans votre ressource d’application logique, ou les deux, en fonction des scénarios suivants :

    • Si vous avez déjà un compte d’intégration avec les artefacts dont vous avez besoin ou que vous voulez utiliser, vous pouvez lier votre compte d’intégration à plusieurs ressources d’application logique Standard dans lesquelles vous souhaitez utiliser les artefacts. De cette façon, vous n’avez pas besoin de charger des mappages dans chaque application logique individuelle. Pour plus d’informations, consultez Lier votre ressource d’application logique à votre compte d’intégration.

    • Le connecteur intégré Liquid vous permet de sélectionner un mappage que vous avez précédemment chargé dans votre ressource d’application logique ou dans un compte d’intégration lié, mais pas les deux.

    Par conséquent, si vous n’avez pas ou n’avez pas besoin de compte d’intégration, vous pouvez utiliser l’option de chargement. Sinon, vous pouvez utiliser l’option de liaison. Quoi qu’il en soit, vous pouvez utiliser ces artefacts dans tous les flux de travail enfants au sein de la même ressource d’application logique.

• Les workflows Consommation et Standard prennent en charge les mappages XSLT qui font référence à des assemblés externes, ce qui permet d'appeler directement du code .NET personnalisé à partir de mappages XSLT. Pour prendre en charge cette fonctionnalité, les workflows de consommation ont également les exigences suivantes :

  • Vous avez besoin d’un assembly 64 bits. Le service de transformation exécute un processus 64 bits, de sorte que les assemblages 32 bits ne sont pas pris en charge. Si vous disposez du code source pour un assemblage 32 bits, recompilez le code en un assemblage 64 bits. Si vous n’avez pas le code source, mais que vous avez obtenu le fichier binaire d’un fournisseur tiers, obtenez la version 64 bits de ce fournisseur. Par exemple, certains vendeurs fournissent des assemblages dans des packages qui ont à la fois des versions 32 bits et 64 bits. Si vous avez l’option, utilisez la version 64 bits à la place.

  • Vous devez charger l’assembly et le mappage dans une ordre spécifique dans votre compte d’intégration. Vous devez d’abord charger votre assembly, puis charger le mappage qui le référence.

  • Si la taille de votre assembly ou mappage est de 2 Mo ou moins, vous pouvez ajouter votre assembly ou mappage à votre compte d’intégration directement depuis le portail Azure.

  • Si la taille de votre assembly est supérieure à 2 Mo, mais qu’elle ne dépasse pas la taille limite des assemblys, vous avez besoin d’un compte de stockage Azure et d’un conteneur d’objets blob où vous pourrez charger votre assembly. Vous pourrez ultérieurement fournir l’emplacement de ce conteneur lorsque vous ajouterez l’assembly à votre compte d’intégration. Pour cette tâche, vous avez besoin des éléments décrits dans le tableau ci-dessous :

    Élément	Description
    Compte Azure Storage	Dans ce compte, créez un conteneur d’objets blob Azure pour votre assembly. Découvrez comment créer un compte de stockage.
    Conteneur d’objets blob	Dans ce conteneur, vous pouvez charger votre assembly. Vous aurez également besoin de l’emplacement de l’URI de redirection de ce conteneur lorsque vous ajouterez l’assembly à votre compte d’intégration. Découvrez comment créer un conteneur d’objets blob.
    Azure Storage Explorer	Cet outil facilite la gestion des comptes de stockage et des conteneurs d’objets blob. Pour utiliser l’Explorateur Stockage, téléchargez et installez l’Explorateur Stockage Azure. Ensuite, connectez l’Explorateur Stockage à votre compte de stockage en suivant les étapes décrites dans Prise en main de l’Explorateur Stockage. Pour en savoir plus, consultez Démarrage rapide : Créer un objet blob dans le stockage d’objets avec l’Explorateur Stockage Azure. Dans le Portail Azure, sélectionnez votre compte de stockage. Dans le menu de votre compte de stockage, sélectionnez Explorateur Stockage.

    Pour ajouter des mappages plus volumineux, vous pouvez utiliser l’API REST Azure Logic Apps - Mappages. Pour les workflows Standard, l’API REST Azure Logic Apps n’est pas disponible actuellement.

Limites

• Des limites s’appliquent au nombre d’artefacts, tels que les mappages, par compte d’intégration. Pour plus d’informations, consultez Informations relatives aux limites et à la configuration pour Azure Logic Apps.

• Selon que vous utilisez un workflow d’application logique Consommation ou Standard, les limitations suivantes s’appliquent :

  • Workflows Standard

    • Prise en charge de XSLT 1.0, 2.0 et 3.0.

    • Aucune limite ne s’applique aux tailles des fichiers de mappage.

  • Workflows Consommation

    • Azure Logic Apps alloue de la mémoire finie pour le traitement des transformations XML. Si vous créez des workflows Consommation et que vos transformations de mappage ou de charge utile consomment beaucoup de mémoire, ces transformations peuvent échouer et provoquer des erreurs de mémoire insuffisante. Pour éviter ce scénario, envisagez les options suivantes :

      • Modifiez vos cartes ou charges utiles pour réduire la consommation de mémoire.

      • Créer des flux de travail avec l’application logique standard qui exécutent dans les instances Azure Logic Apps mono-locataires et offrent des options dédiées et flexibles pour les ressources de calcul et de mémoire.

Créer des mappages

Vous pouvez créer des cartes à l’aide de Visual Studio Code avec l’extension Mappeur de données, ou de Visual Studio avec l’extension Outils Intégration Entreprise de Microsoft Azure Logic Apps.

Visual Studio Code

Lorsque vous créez des cartes à l’aide de Visual Studio Code et de l’extension Mappeur de données, vous pouvez appeler ces cartes depuis votre workflow, mais uniquement avec l’action Opérations du mappeur de données nommée Transformer en utilisant le mappeur de données XSLT, et non l’action Opérations XML nommée Transformer du XML. Pour plus d’informations, consultez Créer des cartes pour la transformation de données avec Visual Studio Code.

Visual Studio

Lorsque vous créez des cartes à l’aide de Visual Studio, vous devez créer un projet d’intégration avec l’un des outils suivants :

• Visual Studio 2019 et l’extension Outils Intégration Entreprise de Microsoft Azure Logic Apps

• Visual Studio 2015 et l’extension Outils Intégration Entreprise de Microsoft Azure Logic Apps pour Visual Studio 2015 2.0.

Dans le projet d’intégration, vous pouvez créer un fichier de mappage d’intégration qui vous permet de mapper graphiquement des éléments entre deux fichiers de schéma XML. Ces outils offrent les fonctionnalités de mappage suivantes :

• Vous utilisez une représentation graphique du mappage, qui montre l’ensemble des relations et des liens que vous créez.

• Vous pouvez effectuer une copie directe des données entre les schémas XML que vous utilisez pour créer le mappage. Le kit de développement logiciel (SDK) Intégration Entreprise pour Visual Studio comprend un mappeur qui rend cette tâche aussi simple de dessiner une ligne qui connecte les éléments du schéma XML source à leurs équivalents dans le schéma XML cible.

• Des opérations ou des fonctions de mappages multiples sont disponibles, y compris des fonctions de chaîne, des fonctions de date et d’heure, etc.

• Pour ajouter un exemple de message XML, vous pouvez utiliser la fonctionnalité de test de mappage. En un seul geste, vous pouvez tester le mappage que vous avez créé et évaluer la sortie générée.

• Une fois votre projet créé, vous obtenez un document XSLT.

Votre mappage doit également comporter les attributs suivants et une section CDATA contenant l’appel au code de l’assembly :

• name est le nom d’assembly personnalisé.

• namespace est l’espace de noms de l’assembly qui comprend le code personnalisé.

L'exemple suivant montre une carte qui fait référence à un assemblée nommé XslUtilitiesLib et appelle la méthode circumference à partir de l’assemblée.

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:user="urn:my-scripts">
<msxsl:script language="C#" implements-prefix="user">
    <msxsl:assembly name="XsltHelperLib"/>
    <msxsl:using namespace="XsltHelpers"/>
    <![CDATA[public double circumference(int radius){ XsltHelper helper = new XsltHelper(); return helper.circumference(radius); }]]>
</msxsl:script>
<xsl:template match="data">
<circles>
    <xsl:for-each select="circle">
        <circle>
            <xsl:copy-of select="node()"/>
                <circumference>
                    <xsl:value-of select="user:circumference(radius)"/>
                </circumference>
        </circle>
    </xsl:for-each>
</circles>
</xsl:template>
</xsl:stylesheet>

Ajouter des assemblys référencés

Ajouter des mappages

• Si vous utilisez un workflow Consommation, vous devez ajouter votre mappage à un compte d’intégration lié.

• Si vous utilisez un workflow Standard, vous avez les options suivantes :

  • Ajouter votre mappage à un compte d’intégration lié. Vous pouvez partager le mappage et le compte d’intégration entre plusieurs ressources d’application logique Standard et leurs workflows enfants.

  • Ajouter le mappage directement à la ressource d’application logique. Toutefois, vous pouvez uniquement partager ce mappage entre les workflows enfants dans la même ressource d’application logique.

Ajouter un mappage au compte d’intégration

1. Dans le portail Azure connectez-vous avec les informations d’identification de votre compte Azure.

2. Dans le portail Azure, entrez comptes intégration comme filtre, puis sélectionnez Comptes d’intégration.

3. Recherchez et sélectionnez votre compte d’intégration.

4. Dans le menu de navigation de votre compte d’intégration, sous Paramètres, sélectionnez Mappages.

5. Dans la barre d’outils du volet Mappages, sélectionnez Ajouter.

Pour les workflows Consommation, en fonction de la taille de fichier de votre mappage, effectuez maintenant les étapes de chargement prévues pour les mappages de taille inférieure ou égale à 2 Mo ou de taille supérieure à 2 Mo.

Ajouter des mappages de taille inférieure ou égale à 2 Mo

1. Dans le volet Ajouter un mappage, entrez un nom unique pour votre mappage.

2. Sous Type de mappage, sélectionnez un type, par exemple : Liquid, XSLT, XSLT 2.0 ou XSLT 3.0.

3. À côté de la zone Mappage, choisissez l’icône de dossier. Sélectionnez le mappage à télécharger.

   Si vous avez laissé la propriété Nom vide, le nom de fichier du mappage s’affiche automatiquement dans cette propriété après avoir sélectionné le fichier du mappage.

4. Quand vous avez terminé, sélectionnez OK.

   Une fois que le chargement de votre fichier de mappage est terminé, le mappage s’affiche dans la liste Mappages. Sur la page Vue d’ensemble de votre compte d’intégration, sousArtefacts, s’affiche également votre mappage téléchargé.

Ajouter des mappages de taille inférieure ou égale à 2 Mo

Si vous avez besoin d’ajouter des mappages plus volumineux pour les workflows Consommation, utilisez l’API REST Azure Logic Apps - Mappages.

Ajouter un mappage à la ressource d’application logique Standard

Les étapes suivantes s’appliquent uniquement si vous souhaitez ajouter un mappage directement à votre ressource d’application logique Standard. Sinon, ajoutez le mappage à votre compte d’intégration.

Portail Azure

1. Dans le menu de la ressource de votre application logique, sous Artefacts, sélectionnez Cartes.

2. Dans la barre d’outils du volet Mappages, sélectionnez Ajouter.

3. Dans le volet Ajouter une carte, entrez un nom unique pour votre carte et incluez le nom de l'extension .xslt.

4. À côté de la zone Mappage, choisissez l’icône de dossier. Sélectionnez le mappage à télécharger.

5. Quand vous avez terminé, sélectionnez OK.

   Une fois que le chargement de votre fichier de mappage est terminé, le mappage s’affiche dans la liste Mappages. Sur la page Vue d’ensemble de votre compte d’intégration, sousArtefacts, s’affiche également votre mappage téléchargé.

Visual Studio Code

1. Dans la structure du projet de votre application logique, ouvrez le dossier Artefacts, puis le dossier Mappages.

2. Dans le dossier Mappages, ajoutez votre mappage.

Modifier un mappage

Pour mettre à jour un mappage existant, vous devez charger un nouveau fichier de mappage qui comporte les modifications souhaitées. Cependant, vous pouvez d’abord télécharger le mappage existant pour le modifier.

Supprimer un mappage

Étapes suivantes

• Transformer du code XML pour des flux de travail dans Azure Logic Apps
• Valider des données XML pour les workflows dans Azure Logic Apps