Transformer du code JSON et XML en utilisant des modèles Liquid en tant que mappages dans Azure Logic Apps

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

Lorsque vous souhaitez effectuer des transformations de JSON de base dans vos flux de travail d’application logique, vous pouvez utiliser des opérations de données intégrées, telles que les actions Composer ou Analyser JSON. Toutefois, certains scénarios peuvent nécessiter des transformations avancées et complexes incluant des éléments tels que des itérations, des flux de contrôle et des variables. Pour les transformations de JSON en JSON, de JSON en texte, de XML en JSON ou de XML en texte, vous pouvez créer un modèle décrivant le mappage ou la transformation requis à l’aide du langage de modèle open source Liquid. Vous pouvez sélectionner ce modèle lorsque vous ajoutez une action intégrée Liquid à votre flux de travail. Vous pouvez utiliser des actions Liquid dans des flux de travail d’application logique Consommation multi-locataire et des flux de travail d’application logique Standard monolocataire.

Bien qu’aucun déclencheur Liquid ne soit disponible, vous pouvez utiliser n’importe quel déclencheur ou action pour alimenter le contenu JSON ou XML source dans votre flux de travail. Par exemple, vous pouvez utiliser un déclencheur de connecteur intégré, un déclencheur de connecteur géré ou hébergé par Azure disponible pour Azure Logic Apps, voire une autre application.

Cet article explique comment accomplir les tâches suivantes :

• Créez un modèle Liquid.
• Chargez le modèle dans votre compte d’intégration pour les flux de travail d’application logique Consommation, ou dans votre ressource d’application logique Standard afin de l’utiliser dans n’importe quel flux de travail enfant.
• Ajoutez une action Liquid à votre flux de travail.
• Sélectionnez le modèle en tant que mappage que vous souhaitez utiliser.

Pour plus d’informations, consultez la documentation suivante :

• Effectuer des opérations sur les données dans Azure Logic Apps
• Langage de modèle open source Liquid
• Applications logiques Consommation et Standard
• Connecteurs intégrés de compte d’intégration
• Vue d’ensemble des connecteurs intégrés pour Azure Logic Apps
• Vue d’ensemble des connecteurs gérés ou hébergés par Azure pour Azure Logic Apps et Connecteurs gérés ou hébergés par Azure dans Azure Logic Apps

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.

• Ressource et flux de travail de votre application logique. Les opérations Liquid n’ayant pas de déclencheurs disponibles, votre flux de travail doit inclure au minimum un déclencheur. Pour plus d’informations, consultez la documentation suivante :

  • Créer un exemple de workflow d’application logique de consommation dans Azure Logic Apps à locataires multiples

  • Créer un exemple de workflow d’application logique Standard dans Azure Logic Apps à locataire unique

• 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 travaillez sur un flux de travail d’application logique Consommation, votre compte d’intégration nécessite un lien vers 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 disposez déjà d’un compte d’intégration avec les artefacts dont vous avez besoin ou que vous souhaitez utiliser, vous pouvez lier le 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. Vous pouvez ensuite utiliser ces artefacts dans tous les flux de travail enfants au sein de la même ressource d’application logique.

    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.

• Connaissances de base sur le langage de gabarit Liquid. Les Applications logiques Azure utilisent DotLiquid 2.0.361.

  Notes

  L’action Liquid nommée Transformer JSON en JSON suit l’implémentation DotLiquid pour Liquid, qui diffère dans des cas spécifiques de l’implémentation Shopify pour Liquid. Pour plus d’informations, consultez Considérations relatives aux modèles Liquid.

• Installez ou utilisez un outil capable d’envoyer des requêtes HTTP pour tester votre solution, par exemple :

  • Visual Studio Code avec une extension de Visual Studio Marketplace
  • Invoke-RestMethod de PowerShell
  • Microsoft Edge - Outil console réseau
  • Bruno
  • curl

  Attention

  Dans les scénarios comprenant des données sensibles, comme des informations d’identification, des secrets, des jetons d’accès, des clés API et d’autres informations similaires, veillez à utiliser un outil qui protège vos données avec les fonctionnalités de sécurité nécessaires, qui fonctionne en mode hors connexion ou localement, qui ne synchronise pas vos données avec le cloud, et qui ne vous impose pas de vous connecter à un compte en ligne. Vous réduirez ainsi les risques liés à l’exposition de données sensibles au public.

Étape 1 : Créer le modèle

Avant de pouvoir effectuer une transformation Liquid dans votre flux de travail d’application logique, vous devez créer un modèle Liquid qui définit le mappage souhaité.

1. Créez le modèle Liquid à utiliser comme mappage pour la transformation de code JSON. Vous pouvez utiliser l’outil d’édition de votre choix.

   L’exemple de transformation de JSON en JSON présenté dans cet article utilise l’exemple de modèle Liquid suivant :

   {%- assign deviceList = content.devices | Split: ', ' -%}
   
   {
      "fullName": "{{content.firstName | Append: ' ' | Append: content.lastName}}",
      "firstNameUpperCase": "{{content.firstName | Upcase}}",
      "phoneAreaCode": "{{content.phone | Slice: 1, 3}}",
      "devices" : [
         {%- for device in deviceList -%}
            {%- if forloop.Last == true -%}
            "{{device}}"
            {%- else -%}
            "{{device}}",
            {%- endif -%}
         {%- endfor -%}
      ]
   }
   

2. Enregistrez le modèle en utilisant l’extension de fichier (.liquid) de modèle Liquid. Cet exemple utilise le fichier SimpleJsonToJsonTemplate.liquid.

Étape 2 : Charger le modèle Liquid

Après avoir créé votre modèle Liquid, vous devez le charger en fonction du scénario suivant :

• Si vous travaillez sur un flux de travail d’application logique Consommation, chargez votre modèle dans votre compte d’intégration.

• Si vous travaillez sur un flux de travail d’application logique Standard, vous pouvez charger votre modèle dans votre compte d’intégration ou charger votre modèle dans votre ressource d’application logique.

Charger le modèle dans le compte d’intégration

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

2. Dans la zone de recherche du portail Azure, entrez integration accounts, puis sélectionnez Integration accounts.

   

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

   

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

   

5. Dans le volet Mappages, sélectionnez Ajouter. Fournissez les informations suivantes concernant votre mappage :

   Propriété	Valeur	Description
   Nom	JsonToJsonTemplate	Nom de votre mappage (« JsontoJsonTemplate » dans cet exemple)
   Type de mappage	Liquid	Type de votre mappage. Pour une transformation de JSON en JSON, vous devez sélectionner Liquid.
   Map	SimpleJsonToJsonTemplate.liquid	Fichier de modèle ou de mappage Liquid existant à utiliser pour la transformation (« SimpleJsonToJsonTemplate.liquid » dans cet exemple). Pour trouver ce fichier, vous pouvez utiliser le sélecteur de fichiers. Pour connaître les limites de taille qui s'appliquent aux mappages, consultez Limites et configuration.

   

Charger le modèle dans l’application logique Standard

1. Dans le portail Azure, recherchez et ouvrez votre ressource d’application logique. Assurez-vous que vous êtes au niveau ressource, et non au niveau flux de travail.

2. Dans le menu de navigation de votre ressource d’application logique, sous Artefacts, sélectionnez Mappages.

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

4. Dans le volet Ajouter un mappage, fournissez les informations suivantes concernant votre modèle :

   Propriété	Valeur	Description
   Nom	JsonToJsonTemplate	Nom de votre mappage (« JsontoJsonTemplate » dans cet exemple)
   Type de mappage	Liquid	Type de votre mappage. Pour une transformation de JSON en JSON, vous devez sélectionner Liquid.
   Map	SimpleJsonToJsonTemplate.liquid	Fichier de modèle ou de mappage Liquid existant à utiliser pour la transformation (« SimpleJsonToJsonTemplate.liquid » dans cet exemple). Pour trouver ce fichier, vous pouvez utiliser le sélecteur de fichiers. Pour connaître les limites de taille qui s'appliquent aux mappages, consultez Limites et configuration.

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é.

Étape 3 : Ajouter l’action de transformation Liquid

Les étapes suivantes montrent comment ajouter une action de transformation Liquid pour des flux de travail d’application logique Consommation et Standard.

Tester votre workflow

Pour déclencher votre workflow, suivez ces étapes :

1. Dans le déclencheur Requête, recherchez la propriété URL HTTP POST et copiez l’URL.

2. Ouvrez votre outil de requête HTTP et utilisez ses instructions pour envoyer une requête HTTP à l’URL copiée, y compris la méthode attendue par le déclencheur Requête.

   Cet exemple utilise la méthode POST avec l’URL.

3. Incluez l’entrée JSON à transformer, par exemple :

   {
      "devices": "Surface, Mobile, Desktop computer, Monitors",
      "firstName": "Dean",
      "lastName": "Ledet",
      "phone": "(111)0001111"
   }
   

4. Une fois l’exécution de votre workflow terminée, accédez à l’historique des exécutions du workflow, puis examinez les entrées et sorties de l’action Transformer de JSON en JSON, par exemple :

   

Autres transformations Liquid

Vous pouvez utiliser Liquid pour effectuer d’autres transformations, par exemple :

• de JSON en texte
• de XML vers JSON
• de XML en texte

Transformer du JSON en texte

Le modèle Liquid suivant présente un exemple de transformation de JSON en texte :

{{content.firstName | Append: ' ' | Append: content.lastName}}

L’exemple suivant présente les échantillons d’entrées et de sorties :

Transformer du XML en JSON

Le modèle Liquid suivant présente un exemple de transformation de XML en JSON :

[{% JSONArrayFor item in content -%}
      {{item}}
  {% endJSONArrayFor -%}]

La boucle JSONArrayFor est un mécanisme de boucle personnalisé pour les entrées XML, qui permet de créer des charges utiles JSON sans virgule de fin. En outre, la condition where de ce mécanisme de boucle personnalisé utilise le nom de l’élément XML à des fins de comparaison, plutôt que la valeur de l’élément comme d’autres filtres Liquid. Pour plus d’informations, consultez une présentation approfondie de la stratégie set-body - collections d’éléments.

L’exemple suivant présente les échantillons d’entrées et de sorties :

Transformer du XML en texte

Le modèle Liquid suivant présente un exemple de transformation de XML en texte :

{{content.firstName | Append: ' ' | Append: content.lastName}}

L’exemple suivant présente les échantillons d’entrées et de sorties :

Considérations relatives aux modèles Liquid

• Les modèles Liquid suivent les limites de taille de fichier pour les mappages dans Azure Logic Apps.

• L’action Transformer JSON en JSON suit l’implémentation de DotLiquid pour Liquid. Cette implémentation est un port vers le .NET Framework à partir de l’implémentation Shopify pour Liquid et diffère dans des cas spécifiques.

  La liste suivante décrit les différences connues :

  • L’action Transformer JSON en JSON génère en mode natif une chaîne pouvant inclure du code JSON, XML, HTML, etc. L’action Liquid indique uniquement que la sortie de texte attendue du modèle Liquid est une chaîne JSON. L’action indique à votre application logique d’analyser l’entrée en tant qu’objet JSON et applique un wrapper afin que Liquid puisse interpréter la structure JSON. Après la transformation, l’action indique à votre application logique d’analyser la sortie de texte de Liquid en retour vers JSON.

    DotLiquid ne comprend pas de façon native le code JSON. Veillez donc à échapper la barre oblique inverse (\) et tout autre caractère JSON réservé.

  • Si votre modèle utilise des filtres Liquid, veillez à respecter les conventions de nommage DotLiquid et C#, qui utilisent la casse des phrases. Pour toutes les transformations Liquid, assurez-vous que les noms des filtres dans votre modèle utilisent également la casse des phrases. Sinon, les filtres ne fonctionneront pas.

    Par exemple, lorsque vous utilisez le filtre replace, utilisez Replace et non pas replace. La même règle s’applique si vous essayez des exemples sur le site d’essai en ligne de DotLiquid. Pour plus d’informations, consultez les filtres Shopify Liquid et les filtres DotLiquid Liquid. La spécification Shopify inclut des exemples pour chaque filtre. Ainsi, à des fins de comparaison, vous pouvez essayer ces exemples sur le site d’essai en ligne de DotLiquid.

  • Le filtre json des filtres d’extension Shopify est actuellement non implémenté dans DotLiquid. En règle générale, vous pouvez utiliser ce filtre pour préparer la sortie de texte pour l’analyse des chaînes JSON, mais vous devez utiliser le filtre Replace à la place.

  • Le filtre Replace standard dans l’implémentation DotLiquid utilise la correspondance d’expression régulière (RegEx), tandis que l’implémentation Shopify utilise la correspondance de chaîne simple. Les deux implémentations fonctionnent apparemment de la même façon jusqu’à ce que vous utilisiez un caractère RegEx réservé ou un caractère d’échappement dans le paramètre match.

    Par exemple, pour échapper le caractère d’échappement de barre oblique inverse RegEx réservé (\), utilisez | Replace: '\\', '\\' et non pas | Replace: '\', '\\'. Ces exemples montrent comment le filtre Replace se comporte différemment lorsque vous essayez d’échapper le caractère de barre oblique inverse. Cette version fonctionne correctement :

    { "SampleText": "{{ 'The quick brown fox "jumped" over the sleeping dog\\' | Replace: '\\', '\\' | Replace: '"', '\"'}}"}

    Avec le résultat suivant :

    { "SampleText": "The quick brown fox \"jumped\" over the sleeping dog\\\\"}

    Tandis que cette version échoue :

    { "SampleText": "{{ 'The quick brown fox "jumped" over the sleeping dog\\' | Replace: '\', '\\' | Replace: '"', '\"'}}"}

    Avec cette erreur :

    { "SampleText": "Liquid error: parsing "\" - Illegal \ at end of pattern."}

    Pour plus d’informations, consultez Replace standard filter uses RegEx pattern matching....

  • Le filtre Sort dans l’implémentation de DotLiquid trie les éléments d’un tableau ou d’une collection par propriété, mais avec les différences suivantes :

    • Suit le comportement sort_natural de Shopify et non pas le comportement sort de Shopify.

    • Trie uniquement dans l’ordre alphanumérique des chaînes. Pour plus d’informations, consultez Numeric sort.

    • Utilise un ordre ne respectant pas la casse, et non pas un ordre respectant la casse. Pour plus d’informations, consultez Sort filter doesn’t follow casing behavior from Shopify’s specification.

Étapes suivantes

• Langage et exemples Shopify Liquid
• DotLiquid
• Essai en ligne de DotLiquid
• Page GitHub de DotLiquid
• Page GitHub des problèmes relatifs à DotLiquid
• En savoir plus sur les mappages