Effectuer des opérations sur les données dans Azure Logic Apps

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

Ce guide pratique montre comment utiliser des données dans votre flux de travail d’application logique des manières suivantes :

  • Créez une chaîne ou un objet JSON (JavaScript Object Notation) à partir de plusieurs entrées ayant différents types de données. Vous pouvez ensuite utiliser cette chaîne comme une entrée unique au lieu d’entrer plusieurs fois les mêmes entrées.
  • Créez des jetons conviviaux à partir des propriétés d’objet JSON (JavaScript Object Notation) afin de pouvoir facilement utiliser ces propriétés dans votre flux de travail.
  • Créez une table HTML ou CSV à partir d’un tableau.
  • Créez un tableau à partir d’un autre tableau en fonction d’un filtre ou d’une condition que vous spécifiez.
  • Créez un tableau en fonction des propriétés spécifiées pour tous les éléments dans un autre tableau.
  • Créez une chaîne à partir de tous les éléments d’un tableau et séparez ces éléments à l’aide d’un caractère spécifié.

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.

  • Le flux de travail d’application logique dans lequel vous souhaitez effectuer l’opération de données. Les flux de travail d’application logique Consommation et Standard prennent en charge les opérations de données décrites dans ce guide.

    Toutes les opérations de données sont disponibles uniquement sous forme d’actions. Par conséquent, avant de pouvoir utiliser ces actions, votre flux de travail doit déjà commencer par un déclencheur comme première étape et inclure toutes les autres actions requises pour créer les sorties que vous souhaitez utiliser dans l’opération de données.

Actions d’opérations de données

Les sections suivantes résument les opérations de données que vous pouvez utiliser. Les opérations sont organisées en fonction des types de données sources sur utilisant les opérations, mais chaque description apparaît par ordre alphabétique.

Actions JSON

Les actions suivantes vous permettent d’utiliser des données au format JSON (JavaScript Object Notation).

Action Description
Composer Créez un message ou une chaîne à partir de plusieurs entrées qui peuvent avoir différents types de données. Utilisez cette chaîne comme une entrée unique, plutôt que de saisir sans cesse les mêmes entrées. Par exemple, vous pouvez créer un message JSON unique à partir de diverses entrées.
Analyser JSON Créez des jetons de données conviviaux pour les propriétés au format JSON afin de pouvoir utiliser plus facilement les propriétés dans vos applications logiques.

Pour créer des transformations JSON plus complexes, consultez Effectuer des transformations JSON avancées avec des modèles Liquid.

Actions de tableau

Les actions suivantes vous permettent de travailler avec les données de tableaux.

Action Description
Créer une table CSV Créez une table CSV (valeurs séparées par des virgules) à partir d’un tableau.
Créer une table HTML Créez une table HTML à partir d’un tableau.
Filtrer le tableau Créez un sous-ensemble de tableau à partir d’un tableau en fonction du filtre ou de la condition que vous spécifiez.
Joindre Créez une chaîne à partir de tous les éléments d’un tableau et séparez chaque élément à l’aide du caractère spécifié.
Sélectionner Créez un tableau à partir des propriétés spécifiées pour tous les éléments dans un tableau différent.

Action de composition

Utilisez l’action Compose pour créer une seule sortie, telle qu’un objet JSON, à partir de plusieurs entrées. Vos entrées peuvent avoir différents types, tels que des entiers, des booléens, des tableaux, des objets JSON, et tout autre type natif pris en charge par Azure Logic Apps, y compris le binaire et le XML. Vous pouvez utiliser la sortie dans les actions qui suivent l’action Compose . L’action Composer vous permet également d’éviter d’entrer à plusieurs reprises les mêmes entrées pendant la création du flux de travail de votre application logique.

Par exemple, vous pouvez construire un message JSON à partir de plusieurs variables, telles que des variables de chaînes qui stockent les prénoms et noms de personnes, et une variable de type entier qui stocke l’âge de ces personnes. Dans cet exemple, l’action Composer accepte les entrées suivantes :

{ "age": <ageVar>, "fullName": "<lastNameVar>, <firstNameVar>" }

Et génère la sortie suivante :

{"age":35,"fullName":"Owens,Sophia"}

Pour essayer l’action Composer, procédez comme suit à l’aide du concepteur de flux de travail. Ou, si vous préférez travailler dans l’éditeur de vue de code, vous pouvez copier l’exemple d’action Compose et de définitions de variables pour l’action Initialize variables de ce guide dans la définition sous-jacente du workflow de votre propre application logique : Exemples de code d’opérations de données - Compose. Pour plus d’informations sur l’action Composer dans la définition de flux de travail JSON sous-jacente, consultez l’action Composer.

  1. Dans le Portail Azure ou Visual Studio Code, ouvrez votre flux de travail d’application logique dans le concepteur.

    Cet exemple utilise le portail Azure et un flux de travail d’exemple avec le déclencheur Récurrence suivi de l’action Initialiser les variables. Dans l’action Initialiser les variables , vous entrez le nom, le type et la valeur d’une variable puis sélectionnez + Ajouter une variable pour entrer la suivante.

    Dans cet exemple, vous créez deux variables de chaîne et une variable entière.

    Opération Propriétés et valeurs
    Initialisation des variables - Nom : firstNameVar
    - Type : chaîne
    - Valeur : Sophia
    Initialisation des variables - Nom : lastNameVar
    - Type : chaîne
    - Valeur : Owens
    Initialisation des variables - Nom : ageVar
    - Type : entier
    - Valeur : 35

    Capture d’écran montrant le portail Azure, le concepteur de flux de travail Consommation et un exemple de flux de travail pour l’action Composer.

  2. Suivez ces étapes générales pour ajouter l’action Opérations de données nommée Composer.

  3. Dans le concepteur, sélectionnez l’action Composer, si elle n’est pas déjà sélectionnée. Dans la zone Entrées, indiquez les entrées que vous souhaitez utiliser pour créer la sortie.

    Pour cet exemple, suivez ces étapes :

    1. Dans la zone Entrées, entrez l’exemple d’objet JSON suivant, y compris l’espacement, comme indiqué :

      {
          "age": ,
          "fullName": " , "
      }
      
    2. Dans l’objet JSON, placez votre curseur dans les emplacements correspondants, sélectionnez la liste de contenu dynamique (icône éclair), puis sélectionnez la variable correspondante dans la liste :

      Propriété JSON Variable
      age ageVar
      fullName «lastNameVar, firstNameVar»

      L’exemple suivant montre les définitions ajoutées pour deux variables et le processus d’ajout de la troisième variable :

      Capture d’écran montrant le flux de travail Consommation, l’action Composer, la liste de contenu dynamique et les entrées sélectionnées à utiliser.

  4. Enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.

Tester votre workflow

Pour vérifier si l’action Composer produit les résultats attendus, envoyez-vous une notification incluant la sortie de l’action Composer.

  1. Dans votre flux de travail, ajoutez une action capable de vous envoyer les résultats de l’action Composer.

    Cet exemple continue en utilisant l’action Office 365 Outlook nommée Envoyer un e-mail (V2) :

    Capture d’écran montrant le flux de travail Standard, ajouter une action, Office 365 Outlook, Envoyer un e-mail (V2).

  2. Dans cette action, pour chaque zone dans laquelle vous souhaitez que les résultats apparaissent, sélectionnez à l’intérieur de chaque zone, puis sélectionnez la liste de contenu dynamique (icône éclair). Dans la liste, sous l’action Composer , sélectionnez Sorties.

    Pour cet exemple, le résultat apparaît dans le corps de l’e-mail. Vous ajoutez donc le champ Sorties à la zone Corps :

    La capture d’écran montre le concepteur de workflow, l’action Envoyer un e-mail (V2), et la sortie de l’action Compose précédente.

  3. Enregistrez votre flux de travail, puis exécutez-le manuellement. Dans la barre d’outils du concepteur, sélectionnez Exécuter>Exécuter.

Si vous utilisez l’action Office 365 Outlook - Envoyer un e-mail (V2), l’exemple suivant montre le résultat :

Capture d’écran montrant l’e-mail avec les résultats de l’action Composer.

Créer une action de table CSV

Pour créer une table de valeurs séparées par des virgules (CSV) avec les propriétés et valeurs d’objets JSON (JavaScript Objet Notation) dans un tableau, utilisez l’action appelée Créer une table CSV. Vous pouvez ensuite utiliser la table résultante dans les actions qui suivent l’action Créer une table CSV.

Pour essayer l’action Créer une table CSV, procédez comme suit à l’aide du concepteur de flux de travail. Ou, si vous préférez travailler dans l’éditeur de vue code, vous pouvez copier l’exemple Créer une action de table CSV et des définitions de variables pour l’action Initialisation des variables de ce guide dans la définition sous-jacente du workflow de votre propre application logique : Exemples de code d’opérations de données - Créer une table CSV. Pour plus d’informations sur l’action Créer une table CSV dans la définition de flux de travail JSON sous-jacente, consultez l’action Table.

  1. Dans le Portail Azure ou Visual Studio Code, ouvrez votre flux de travail d’application logique dans le concepteur.

    Cet exemple utilise le portail Azure et un flux de travail d’exemple avec le déclencheur Récurrence suivi de l’action Initialiser les variables. Dans l’action Initialiser les variables , vous entrez le Nom, le Type et la Valeur d’une variable. Pour entrer plus de variables, sélectionnez + Ajouter une variable.

    L’action Créer une table CSV est configurée pour créer une variable dont la valeur initiale est un tableau possédant certaines propriétés et valeurs au format JSON.

    Opération Propriétés et valeurs
    Initialisation des variables - Nom : myJSONArray
    - Type : tableau
    - Valeur : [ { "Description": "Apples", "Product_ID": 1 }, { "Description": "Oranges", "Product_ID": 2 }]

    Capture d’écran montrant le concepteur de flux de travail Consommation et un exemple de flux de travail pour l’action nommée Créer une table CSV.

  2. Suivez ces étapes générales pour ajouter l’action Opérations de données nommée Créer une table CSV.

  3. Dans le concepteur, sélectionnez l’action Créer une table CSV, si elle n’est pas déjà sélectionnée. Dans la zone À partir de, fournissez le tableau ou l’expression à utiliser pour la création de la table.

    Dans cet exemple, cliquez dans le champ From, puis sélectionnez le contenu dynamique (icône en forme d’éclair). Dans cette liste, sélectionnez la variable myJSONArray :

    Capture d’écran montrant le flux de travail Consommation, l’action nommée Créer une table CSV et l’entrée sélectionnée à utiliser.

    Conseil

    Pour créer des jetons conviviaux pour les propriétés des objets JSON afin de pouvoir sélectionner ces propriétés en tant qu’entrées, utilisez l’action appelée Analyser JSON avant d’utiliser l’action Créer une table CSV.

    La capture d’écran suivante montre l’exemple terminé de l’action Créer une table CSV :

    Capture d’écran montrant le flux de travail Consommation et l’exemple d’action terminée nommée Créer une table CSV.

  4. Enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.

Personnaliser le format de la table

Par défaut, la propriété Colonnes crée automatiquement les colonnes du tableau en fonction des éléments du tableau. Pour spécifier des en-têtes et valeurs personnalisés, effectuez les étapes suivantes :

  1. Si la propriété Colonnes n’apparaît pas dans la zone d’informations sur l’action, dans la liste Paramètres avancés, sélectionnez Colonnes.

    Capture d’écran montrant le paramètre Flux de travail standard et Colonnes sélectionnés dans la liste des paramètres avancés.

  2. Ouvrez la liste Colonnes, puis sélectionnez Personnalisé.

  3. Dans la propriété En-tête , saisissez le texte personnalisé de l’en-tête à utiliser.

  4. Dans la propriété Valeur , saisissez la valeur personnalisée à utiliser.

Pour retourner des valeurs du tableau, utilisez la item() fonction avec l’action Créer une table CSV . Dans une For_each boucle, utilisez la items() fonction.

Par exemple, supposons que vous souhaitiez des colonnes de table contenant uniquement les valeurs de propriété et non les noms de propriété d’un tableau. Pour retourner uniquement ces valeurs, procédez comme suit pour travailler en mode Création ou en mode Code.

Cet exemple retourne le résultat suivant :

Apples,1
Oranges,2

Travaillez en mode Conception

Dans l’action Créer une table CSV, conservez la colonne En-tête vide. Sur chaque ligne de la colonne Value, déréférencez chaque propriété de tableau de votre choix. Chaque ligne sous Value retourne toutes les valeurs de la propriété de tableau spécifiée et devient une colonne de votre table.

  1. Pour chaque propriété de tableau souhaitée, dans la colonne Valeur, sélectionnez à l’intérieur de la zone d’édition, puis sélectionnez l’icône de fonction qui ouvre l’éditeur d’expressions. Assurez-vous que la liste Fonction apparaît sélectionnée.

    Capture d’écran montrant le flux de travail Standard, le paramètre Columns, l’expression de fonction sélectionnée pour le champ Valeur de colonne.

  2. Dans l’éditeur d’expressions, entrez l’expression suivante, mais remplacez <array-property-name> par le nom de la propriété de tableau pour la valeur souhaitée. Lorsque vous avez terminé avec chaque expression, sélectionnez Ajouter.

    Syntaxe : item()?['<array-property-name>']

    Exemples de valeurs :

    • item()?['Description']
    • item()?['Product_ID']

    La capture d’écran montre le concepteur de workflow, l’action nommée Créer une table CSV, et comment déréférencer la propriété du tableau nommée Description.

    Pour plus d’informations, voir la fonction item().

  3. Répétez les étapes précédentes pour chaque propriété du tableau. Lorsque vous avez terminé, votre action ressemble à l’exemple qui suit :

    Capture d’écran montrant l’action Créer une table CSV et une fonction nommée item().

  4. Enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.

Travailler en mode code

Dans la définition JSON de l’action Create CSV table, au sein du tableau columns, définissez la propriété header à une chaîne vide. Pour chaque propriété value, déréférencez chaque propriété de tableau de votre choix.

  1. Dans la barre d’outils du concepteur, sélectionnez Vue Code.

  2. Dans l’éditeur de code, recherchez le tableau de l’action columns. Pour chaque colonne de valeurs de tableau souhaitée, ajoutez une propriété header vide et l’expression suivante pour la propriété value :

    Syntaxe :

    {
       "header": "",
       "value": "@item()?['<array-property-name>']"
    }
    

    Exemple :

    "Create_CSV_table": {
       "type": "Table",
       "inputs": {
          "columns": [
             { 
                "header": "",
                "value": "@item()?['Description']"
             },
             { 
                "header": "",
                "value": "@item()?['Product_ID']"
             }
          ],
          "format": "CSV",
          "from": "@variables('myJSONArray')"
       }
    }
    

    Remarque

    Si vous copiez l’exemple dans votre code, veillez à inclure l’action runAfter à la fin de la Create_CSV_table définition.

  3. Revenez au mode Concepteur pour passer en revue les résultats.

Tester votre workflow

Pour vérifier si l’action Créer une table CSV produit les résultats attendus, envoyez-vous une notification incluant la sortie de l’action Créer une table CSV.

  1. Dans votre flux de travail, ajoutez une action capable de vous envoyer les résultats de l’action Créer une table CSV.

    Cet exemple continue en utilisant l’action Office 365 Outlook nommée Envoyer un e-mail (V2).

  2. Dans cette action, pour chaque zone où vous souhaitez que les résultats s’affichent, sélectionnez à l’intérieur de chaque zone, ce qui ouvre la liste de contenu dynamique. Depuis cette liste, sous l’action Créer une table CSV, sélectionnez Sortie.

    La capture d’écran montre le flux de travail avec l’action Envoyer un e-mail (V2). La propriété Corps contient le champ nommé Sortie de l’action précédente nommé Créer une table CSV.

  3. Enregistrez votre flux de travail, puis exécutez-le manuellement. Dans la barre d’outils du concepteur, sélectionnez Exécuter>Exécuter.

Si vous utilisez l’action Office 365 Outlook - Envoyer un e-mail (V2), l’exemple suivant montre le résultat :

Capture d’écran montrant l’e-mail avec les résultats de l’action Créer une table CSV.

Remarque

Si votre table est renvoyée avec une mise en forme incorrecte, consultez Vérifier la mise en forme de vos données de table.

Action Créer une table HTML

Pour créer une table HTML avec les propriétés et valeurs d’objets JSON dans un tableau, utilisez l’action Créer une table HTML. Vous pouvez ensuite utiliser la table résultante dans les actions qui suivent l’action Créer une table HTML.

Pour essayer l’action Créer une table HTML, procédez comme suit à l’aide du concepteur de flux de travail. Ou, si vous préférez travailler dans l’éditeur de vue de code, vous pouvez copier l’exemple Créer une table HTML action et des définitions de variables pour l’action Initialiser des variables de ce guide dans la définition sous-jacente du workflow de votre propre application logique : Exemples de code d’opérations de données - Créer une table HTML. Pour plus d’informations sur l’action Créer une table HTML dans la définition de flux de travail JSON sous-jacente, consultez l’action Table.

  1. Dans le Portail Azure ou Visual Studio Code, ouvrez votre flux de travail d’application logique dans le concepteur.

    Cet exemple utilise le portail Azure et un flux de travail d’exemple avec le déclencheur Récurrence suivi de l’action Initialiser les variables. Dans l’action Initialiser les variables , vous entrez le Nom, le Type et la Valeur d’une variable. Pour entrer plus de variables, sélectionnez + Ajouter une variable.

    L’action est configurée pour la création d’une variable dont la valeur initiale est un tableau ayant certaines propriétés et valeurs au format JSON.

    Opération Propriétés et valeurs
    Initialisation des variables - Nom : myJSONArray
    - Type : tableau
    - Valeur : [ { "Description": "Apples", "Product_ID": 1 }, { "Description": "Oranges", "Product_ID": 2 }]

    Capture d’écran montrant le portail Azure, le concepteur de flux de travail Consommation et l’exemple de flux de travail pour l’action nommée Créer une table HTML.

  2. Suivez ces étapes générales pour ajouter l’action Opérations de données nommée Créer une table HTML.

  3. Dans le concepteur, sélectionnez l’action Créer une table HTML, si elle n’est pas déjà sélectionnée. Dans la zone À partir de, fournissez le tableau ou l’expression à utiliser pour la création de la table.

    Dans cet exemple, cliquez dans le champ From, puis sélectionnez le contenu dynamique (icône en forme d’éclair). Dans cette liste, sélectionnez la variable myJSONArray :

    Capture d’écran montrant le flux de travail Consommation, l’action nommée Créer une table HTML et l’entrée sélectionnée à utiliser.

    Conseil

    Pour créer des jetons conviviaux pour les propriétés des objets JSON afin de pouvoir sélectionner ces propriétés en tant qu’entrées, utilisez l’action appelée Analyser JSON avant d’utiliser l’action Créer une table HTML.

    La capture d’écran suivante montre l’exemple terminé de l’action Créer une table HTML :

    Capture d’écran montrant le flux de travail Consommation et l’exemple d’action terminée nommée Créer une table HTML.

  4. Enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.

Personnaliser le format de la table

Par défaut, la propriété Colonnes crée automatiquement les colonnes du tableau en fonction des éléments du tableau. Pour spécifier des en-têtes et valeurs personnalisés, effectuez les étapes suivantes :

  1. Si la propriété Colonnes n’apparaît pas dans la zone d’informations sur l’action, dans la liste Paramètres avancés, sélectionnez Colonnes.

  2. Ouvrez la liste Colonnes, puis sélectionnez Personnalisé.

  3. Dans la propriété En-tête , saisissez le texte personnalisé de l’en-tête à utiliser.

  4. Dans la propriété Valeur , saisissez la valeur personnalisée à utiliser.

Pour retourner des valeurs du tableau, utilisez la item() fonction avec l’action Créer une table HTML . Dans une For_each boucle, utilisez la items() fonction.

Par exemple, supposons que vous souhaitiez des colonnes de table contenant uniquement les valeurs de propriété et non les noms de propriété d’un tableau. Pour retourner uniquement ces valeurs, procédez comme suit pour travailler en mode Création ou en mode Code.

Cet exemple retourne le résultat suivant :

Apples,1
Oranges,2

Travaillez en mode Conception

Dans l’action Créer une table HTML, conservez la colonne En-tête vide. Sur chaque ligne de la colonne Value, déréférencez chaque propriété de tableau de votre choix. Chaque ligne sous Value retourne toutes les valeurs de la propriété de tableau spécifiée et devient une colonne de votre table.

  1. Pour chaque propriété de tableau souhaitée, dans la colonne Valeur, sélectionnez à l’intérieur de la zone d’édition, puis sélectionnez l’icône de fonction qui ouvre l’éditeur d’expressions. Assurez-vous que la liste Fonction apparaît sélectionnée.

  2. Dans l’éditeur d’expressions, entrez l’expression suivante, mais remplacez <array-property-name> par le nom de la propriété de tableau pour la valeur souhaitée. Lorsque vous avez terminé avec chaque expression, sélectionnez Ajouter.

    Syntaxe : item()?['<array-property-name>']

    Exemples :

    • item()?['Description']
    • item()?['Product_ID']

    La capture d’écran montre le concepteur de workflow, l’action nommée Créer une table HTML, et comment déréférencer la propriété du tableau nommée Description.

    Pour plus d’informations, voir la fonction item().

  3. Répétez les étapes précédentes pour chaque propriété du tableau. Lorsque vous avez terminé, votre action ressemble à l’exemple qui suit :

    Capture d’écran montrant l’action Créer une table HTML et une fonction nommée item().

Travailler en mode code

Dans la définition JSON de l’action Créer une table HTML, dans le tableau columns, définissez la propriété header sur une chaîne vide. Pour chaque propriété value, déréférencez chaque propriété de tableau de votre choix.

  1. Dans la barre d’outils du concepteur, sélectionnez Vue Code.

  2. Dans l’éditeur de code, recherchez le tableau de l’action columns. Pour chaque colonne de valeurs de tableau souhaitée, ajoutez une propriété header vide et l’expression suivante pour la propriété value :

    Syntaxe :

    {
       "header": "",
       "value": "@item()?['<array-property-name>']"
    }
    

    Exemple :

    "Create_HTML_table": {
       "type": "Table",
       "inputs": {
          "columns": [
             { 
                "header": "",
                "value": "@item()?['Description']"
             },
             { 
                "header": "",
                "value": "@item()?['Product_ID']"
             }
          ],
          "format": "HTML",
          "from": "@variables('myJSONArray')"
       }
    }
    

    Remarque

    Si vous copiez l’exemple dans votre code, veillez à inclure l’action runAfter à la fin de la Create_HTML_table définition.

  3. Revenez au mode Concepteur pour passer en revue les résultats.

Tester votre workflow

Pour vérifier si l’action Créer une table HTML produit les résultats attendus, envoyez-vous une notification incluant la sortie de l’action Créer une table HTML.

  1. Dans votre flux de travail, ajoutez une action capable de vous envoyer les résultats de l’action Créer une table HTML.

    Cet exemple continue en utilisant l’action Office 365 Outlook nommée Envoyer un e-mail (V2).

  2. Dans cette action, pour chaque zone où vous souhaitez que les résultats s’affichent, sélectionnez à l’intérieur de chaque zone, puis sélectionnez l’icône éclair, qui ouvre la liste de contenu dynamique. Depuis cette liste, sous l’action Créer une table HTML, sélectionnez Sortie.

    La capture d’écran montre le flux de travail avec l’action Envoyer un e-mail (V2). La propriété Corps contient le champ Sortie de l’action précédente nommé Créer une table HTML.

  3. Enregistrez votre flux de travail, puis exécutez-le manuellement. Dans la barre d’outils du concepteur, sélectionnez Exécuter>Exécuter.

Si vous utilisez l’action Office 365 Outlook - Envoyer un e-mail (V2), l’exemple suivant montre le résultat :

Capture d’écran montrant l’e-mail avec les résultats de l’action Créer une table HTML.

Action Filtrer le tableau

Utilisez l’action Filter Array pour créer un sous-ensemble à partir d’un tableau existant où les éléments du sous-ensemble répondent à des critères spécifiques. Vous pouvez ensuite utiliser le tableau filtré résultant dans les actions qui suivent l’action du tableau de filtrage .

Pour essayer l’action Filtrer le tableau, procédez comme suit à l’aide du concepteur de flux de travail. Ou, si vous préférez travailler dans l’éditeur de vue de code, vous pouvez copier l’exemple d’action Filter Array et de définitions de variables pour l’action Initialisation des variables de ce guide dans la définition sous-jacente du workflow de votre propre application logique : Exemples de code d’opérations de données - Filter array. Pour plus d’informations sur l’action Filtrer le tableau dans la définition de flux de travail JSON sous-jacente, consultez l’action Interroger.

Remarque

Tout texte de filtre que vous utilisez dans votre condition est sensible à la casse. En outre, cette action ne permet pas de modifier le format ou les composants des éléments du tableau.

Pour que les actions utilisent la sortie du tableau générée par l’action Filtrer le tableau, ces actions doivent accepter des tableaux en tant qu’entrée, ou vous devrez éventuellement convertir le tableau de sortie dans un autre format compatible.

Si vous appelez un point de terminaison HTTP et recevez une réponse JSON, utilisez l’action Analyser JSON pour traiter la réponse JSON. Sinon, l’action Filtrer le tableau ne peut lire que le corps de la réponse et non la structure de la charge utile JSON.

  1. Dans le Portail Azure ou Visual Studio Code, ouvrez votre flux de travail d’application logique dans le concepteur.

    Cet exemple utilise le portail Azure et un flux de travail d’exemple avec le déclencheur Récurrence suivi de l’action Initialiser les variables. Dans l’action Initialiser les variables , vous entrez le Nom, le Type et la Valeur d’une variable. Pour entrer plus de variables, sélectionnez + Ajouter une variable.

    L’action est configurée pour créer une valeur initiale qui est un tableau avec quelques valeurs entières d’échantillon.

    Opération Propriétés et valeurs
    Initialisation des variables - Nom : myIntegerArray
    - Type : tableau
    - Valeur : [1,2,3,4]

    Remarque

    Bien que cet exemple utilise un simple tableau d’entiers, cette action est particulièrement utile pour les tableaux d’objets JSON que vous pouvez filtrer selon les propriétés et valeurs des objets.

    Capture d’écran du portail Azure, du concepteur de flux de travail Consommation et d’un exemple de flux de travail pour l’action intitulée « Filtrer le tableau ».

  2. Suivez ces étapes générales pour rechercher l’action Opérations de données nommée Filtrer tableau.

  3. Dans le concepteur, sélectionnez l’action Filtrer tableau, si elle n’est pas déjà sélectionnée. Dans la zone À partir de , entrez le tableau ou l’expression à utiliser comme filtre.

    Dans cet exemple, cliquez dans la zone De, puis sélectionnez l’icône en forme d’éclair, qui ouvre la liste du contenu dynamique. Dans cette liste, sélectionnez la variable créée précédemment :

    La capture d’écran montre le workflow Consommation, l’action nommée « Filtrer un tableau », ainsi que l’entrée sélectionnée à utiliser.

  4. Pour la condition, choisissez les éléments du tableau à comparer, sélectionnez l’opérateur de comparaison, puis spécifiez la valeur de comparaison.

    Cet exemple utilise la fonction item() pour accéder à chaque élément du tableau lorsque l’action Filtrer le tableau recherche les éléments de tableau dont la valeur est supérieure à 1. La capture d’écran suivante montre l’exemple terminé de l’action Filtrer le tableau :

    La capture d’écran montre le flux de travail de consommation et un exemple finalisé de l’action nommée Filtrer un tableau.

  5. Enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.

Tester votre workflow

Pour vérifier que l’action Filter array génère les résultats attendus, envoyez-vous une notification contenant la sortie de l’action Filter array.

  1. Dans votre flux de travail, ajoutez une action capable de vous envoyer les résultats de l’action Filtrer le tableau.

    Cet exemple continue en utilisant l’action Office 365 Outlook nommée Envoyer un e-mail (V2).

  2. Dans cette action, suivez les étapes ci-dessous :

    1. Pour chaque case où vous souhaitez que les résultats apparaissent, sélectionnez la case, puis sélectionnez l’icône de fonction. L’icône ouvre l’éditeur d’expressions. Assurez-vous que la liste Fonction apparaît sélectionnée.

    2. Pour obtenir la sortie de tableau à partir de l’action Filtrer un tableau, entrez l’expression suivante, qui utilise la fonction body() à l’aide du nom de l’action Filtrer un tableau, puis sélectionnez Ajouter.

      body('Filter_array')

      La capture d’écran montre le flux de travail avec l’action Envoyer un e-mail (V2). La propriété Corps contient la fonction body(), qui obtient le contenu du corps à partir de l’action précédente appelée tableau de filtre.

      L’expression résolue spécifie d’afficher les sorties de l’action Filter_array dans le corps de l’e-mail lors de l’envoi :

      Capture d’écran montrant le flux de travail Standard et l’exemple d’action terminée pour envoyer un e-mail.

  3. Enregistrez votre flux de travail, puis exécutez-le manuellement. Dans la barre d’outils du concepteur, sélectionnez Exécuter>Exécuter.

Si vous utilisez l’action Office 365 Outlook - Envoyer un e-mail (V2), l’exemple suivant montre le résultat :

Capture d’écran montrant l’e-mail avec les résultats de l’action nommée Filtrer tableau.

Rejoindre l'action

Pour créer une chaîne contenant tous les éléments d’un tableau et séparer ces éléments à l’aide d’un caractère délimiteur spécifique, utilisez l’action Joindre. Vous pouvez ensuite utiliser la chaîne dans les actions qui suivent l’action Joindre.

Pour essayer l’action Joindre, procédez comme suit à l’aide du concepteur de flux de travail. Ou, si vous préférez travailler dans l’éditeur de vue de code, vous pouvez copier l’exemple d’action Join et de définitions de variables pour l’action Initialisation des variables de ce guide dans la définition sous-jacente de votre propre application logique : Exemples de code d’opérations de données - Join. Pour plus d’informations sur l’action Joindre dans votre définition de flux de travail sous-jacente, consultez l’action Joindre.

  1. Dans le Portail Azure ou Visual Studio Code, ouvrez votre flux de travail d’application logique dans le concepteur.

    Cet exemple utilise le portail Azure et un flux de travail d’exemple avec le déclencheur Récurrence suivi de l’action Initialiser les variables. Dans l’action Initialiser les variables , vous entrez le Nom, le Type et la Valeur d’une variable. Pour entrer plus de variables, sélectionnez + Ajouter une variable.

    L’action est configurée pour créer une valeur initiale qui est un tableau avec quelques valeurs entières d’échantillon.

    Opération Propriétés et valeurs
    Initialisation des variables - Nom : myIntegerArray
    - Type : tableau
    - Valeur : [1,2,3,4]

    Capture d’écran montrant le portail Azure, le concepteur de flux de travail Consommation et un exemple de flux de travail pour l’action nommée Joindre.

  2. Suivez ces étapes générales pour rechercher l’action Opérations de données nommée Joindre.

  3. Dans le concepteur, sélectionnez l’action Ajouter, si elle n’est pas déjà sélectionnée. Dans la zone De, entrez le tableau contenant les éléments que vous souhaitez joindre sous forme de chaîne.

  4. Dans la zone À partir de, entrez le tableau contenant les éléments que vous souhaitez joindre sous forme de chaîne.

    Dans cet exemple, cliquez dans la zone De, puis sélectionnez l’icône en forme d’éclair, qui ouvre la liste du contenu dynamique. Dans cette liste, sélectionnez la variable créée précédemment :

    Capture d’écran montrant le flux de travail Consommation, l’action nommée Joindre et la sortie de tableau sélectionnée à joindre sous forme de chaîne.

  5. Dans la zone Joindre avec, spécifiez le caractère à utiliser pour séparer chaque élément du tableau.

    Cet exemple utilise un signe deux-points (:) comme séparateur pour la propriété Joindre avec.

    Capture d’écran montrant le flux de travail Consommation et l’exemple d’action terminée nommée Joindre.

  6. Enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.

Tester votre workflow

Pour vérifier si l’action Joindre produit les résultats attendus, envoyez-vous une notification incluant la sortie de l’action Joindre.

  1. Dans votre flux de travail, ajoutez une action capable de vous envoyer les résultats de l’action Joindre.

    Cet exemple continue en utilisant l’action Office 365 Outlook nommée Envoyer un e-mail (V2).

  2. Dans cette action, pour chaque zone où vous souhaitez que les résultats s’affichent, sélectionnez à l’intérieur de chaque zone, puis sélectionnez l’icône éclair, qui ouvre la liste de contenu dynamique. Depuis cette liste, sous l’action Joindre, sélectionnezSortie.

    Capture d’écran montrant un flux de travail avec l’action terminée nommée Envoyer un e-mail pour l’action Joindre.

  3. Enregistrez votre flux de travail, puis exécutez-le manuellement. Dans la barre d’outils du concepteur, sélectionnez Exécuter>Exécuter.

Si vous utilisez l’action Office 365 Outlook - Envoyer un e-mail (V2), l’exemple suivant montre le résultat :

Capture d’écran montrant l’e-mail avec les résultats de l’action Joindre.

Action d’analyse de JSON

Pour référencer ou accéder aux propriétés du contenu JavaScript Object Notation (JSON), créez des champs ou des jetons conviviaux pour ces propriétés en utilisant l’action Parse JSON . Vous pouvez sélectionner ces propriétés dans la liste de contenu dynamique lorsque vous spécifiez les entrées pour les actions suivantes dans votre flux de travail. Pour cette action, vous pouvez fournir un schéma JSON ou générer un schéma JSON à partir de votre exemple de contenu JSON ou de charge utile.

Pour essayer l’action Analyser JSON, procédez comme suit à l’aide du concepteur de flux de travail. Ou, si vous préférez travailler dans l’éditeur de code view, vous pouvez copier l’exemple d’action Parse JSON et de définitions de variables pour l’action Initialize variables de ce guide dans la définition sous-jacente du workflow de votre propre application logique : Exemples de code d’opérations de données - Parse JSON. Pour plus d’informations sur cette action dans votre définition de flux de travail sous-jacente, consultez l’action Analyser JSON.

  1. Dans le Portail Azure ou Visual Studio Code, ouvrez votre flux de travail d’application logique dans le concepteur.

    Cet exemple utilise le portail Azure et un flux de travail d’exemple avec le déclencheur Récurrence suivi de l’action Initialiser les variables. Dans l’action Initialiser les variables , vous entrez le Nom, le Type et la Valeur d’une variable. Pour entrer plus de variables, sélectionnez + Ajouter une variable.

    Cette action est configurée pour créer une variable dont la valeur initiale est l’objet JSON suivant avec des propriétés et des valeurs :

    {
        "Member": {
            "Email": "Sophia.Owen@fabrikam.com",
            "FirstName": "Sophia",
            "LastName": "Owen"
        }
    }
    

    Capture d’écran montrant le portail Azure, le concepteur de flux de travail Consommation et un exemple de flux de travail pour l’action nommée Analyser JSON.

  2. Suivez ces étapes générales pour rechercher l’action Opérations de données nommée Analyser JSON.

  3. Dans le concepteur, sélectionnez l’action Analyser JSON, si elle n’est pas déjà sélectionnée. Dans la zone Contenu, entrez l’objet JSON que vous souhaitez analyser.

    Pour cet exemple, sélectionnez à l’intérieur de la zone Contenu, puis sélectionnez l’icône éclair, qui ouvre la liste de contenu dynamique. Dans cette liste, sélectionnez la variable créée précédemment :

    Capture d’écran montrant le flux de travail Consommation, l’action nommée Analyser JSON et la variable d’objet JSON sélectionnée à analyser.

  4. Dans la zone Schéma, entrez le schéma JSON qui décrit l’objet JSON, ou la charge utile, que vous souhaitez analyser.

    Pour cet exemple, utilisez le schéma suivant pour l’exemple d’objet JSON :

    {
        "type": "object",
        "properties": {
            "Member": {
                "type": "object",
                "properties": {
                    "Email": {
                        "type": "string"
                    },
                    "FirstName": {
                        "type": "string"
                    },
                    "LastName": {
                        "type": "string"
                    }
                }
            }
        }
    }
    

    Capture d’écran montrant le flux de travail Consommation, l’action nommée Analyser JSON et le schéma JSON pour l’objet JSON que vous souhaitez analyser.

    Si vous n’avez pas un schéma, vous pouvez en générer un à partir de l’objet JSON :

    1. Dans l’action Analyser JSON, sous la zone Schéma, sélectionnez Utiliser l’exemple de charge utile pour générer le schéma.

    2. Dans la zone Entrer ou coller un exemple de charge utile JSON, entrez le contenu ou l’objet JSON, puis sélectionnez Terminé, par exemple :

      {
          "Member": {
             "Email": "Sophia.Owens@fabrikam.com",
             "FirstName": "Sophia",
             "LastName": "Owens"
          }
      }
      

      La capture d’écran représente le flux de travail de consommation, l’action nommée Analyser JSON et la zone intitulée « Entrer ou coller un exemple de charge utile JSON », qui contient un exemple de JSON permettant de générer le schéma.

  5. Enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.

Tester votre workflow

Pour vérifier si l’action Analyser JSON produit les résultats attendus, envoyez-vous une notification incluant la sortie de l’action Analyser JSON.

  1. Dans votre flux de travail, ajoutez une action capable de vous envoyer les résultats de l’action Analyser JSON.

    Cet exemple continue en utilisant l’action Office 365 Outlook nommée Envoyer un e-mail (V2).

  2. Dans cette action, pour chaque zone où vous souhaitez que les résultats s’affichent, sélectionnez à l’intérieur de chaque zone d’édition, puis sélectionnez l’icône éclair, qui ouvre la liste de contenu dynamique. Depuis cette liste, sous l’action Analyser JSON, sélectionnez les propriétés à partir de l’objet JSON analysé.

    Cet exemple sélectionne les propriétés suivantes : PrénomCorps, Nom de Corps et Courriel de Corps.

    Capture d’écran montrant un flux de travail Standard avec des propriétés JSON dans l’action nommée Envoyer un e-mail

    Lorsque vous avez terminé, l’action Envoyer un e-mail ressemble à l’exemple suivant :

    Capture d’écran montrant le flux de travail avec l’action terminée nommée Envoyer un e-mail pour l’action nommée Analyser JSON.

  3. Enregistrez votre flux de travail, puis exécutez-le manuellement. Dans la barre d’outils du concepteur, sélectionnez Exécuter>Exécuter.

Si vous utilisez l’action Office 365 Outlook - Envoyer un e-mail (V2), l’exemple suivant montre le résultat :

Capture d’écran montrant l’e-mail avec les résultats de l’action nommée Analyser JSON.

Sélectionner une action

Par défaut, l’action Sélectionner crée un tableau contenant les objets JSON générés à partir des valeurs d’un tableau existant. Par exemple, vous pouvez créer un objet JSON pour chaque valeur d’un tableau entier. Spécifiez les propriétés que chaque objet JSON doit avoir et mapper les valeurs du tableau source aux propriétés. Même si vous pouvez modifier les composants des objets JSON, le tableau de sortie possède toujours le même nombre d’éléments que le tableau source. Pour utiliser la sortie du tableau générée par l’action Sélectionner, les actions subséquentes doivent accepter des tableaux en tant qu’entrée, ou vous devrez éventuellement convertir le tableau de sortie dans un autre format compatible.

Pour essayer l’action Sélectionner, procédez comme suit à l’aide du concepteur de flux de travail. Ou, si vous préférez travailler dans l’éditeur de vue de code, vous pouvez copier l’exemple Sélectionner les définitions d’action et de variable pour l’action Initialiser les variables de ce guide dans la définition sous-jacente du workflow de votre propre application logique : Exemples de code d’opérations de données - Sélectionner. Pour plus d’informations sur cette action dans votre définition de flux de travail sous-jacente, consultez l’action Sélectionner.

Conseil

Pour obtenir un exemple qui crée un tableau avec des chaînes ou des entiers générés à partir des valeurs d’un tableau d’objets JSON, consultez les définitions d’action Sélectionner et initialiser des variables dans des exemples de code d’opération de données - Sélectionner.

  1. Dans le Portail Azure ou Visual Studio Code, ouvrez votre flux de travail d’application logique dans le concepteur.

    Cet exemple utilise le portail Azure et un flux de travail d’exemple avec le déclencheur Récurrence suivi de l’action Initialiser les variables. Dans l’action Initialiser les variables , vous entrez le Nom, le Type et la Valeur d’une variable. Pour entrer plus de variables, sélectionnez + Ajouter une variable.

    L’action est configurée pour créer une variable dont la valeur initiale est un tableau contenant des entiers échantillons.

    Opération Propriétés et valeurs
    Initialisation des variables - Nom : myIntegerArray
    - Type : tableau
    - Valeur : [1,2,3,4]

    Capture d’écran montrant le portail Azure, le concepteur de flux de travail Consommation et un exemple de flux de travail pour l’action nommée Sélectionner.

  2. Suivez ces étapes générales pour rechercher l’action Opérations de données nommée Sélectionner.

  3. Dans le concepteur, sélectionnez l’action Sélectionner, si elle n’est pas déjà sélectionnée. Dans la zone À partir de, entrez le tableau source que vous souhaitez utiliser.

    Dans cet exemple, cliquez dans la zone De, puis sélectionnez l’icône en forme d’éclair, qui ouvre la liste du contenu dynamique. Dans cette liste, sélectionnez la variable créée précédemment :

    Capture d’écran montrant le flux de travail Consommation, l’action nommée Sélectionner et la variable de tableau source sélectionnée à utiliser.

  4. Pour la propriété Map, dans la colonne de gauche, entrez un nom de propriété pour décrire toutes les valeurs du tableau source.

    Cet exemple utilise Product_ID comme nom de propriété pour les valeurs entières dans le tableau source. Ainsi, chaque valeur, comme 1, 2, 3 et 4, est un identifiant de produit.

  5. Dans la colonne de droite, entrez une expression qui spécifie la valeur dans le tableau source pour le nom de propriété dans la colonne de gauche.

    Cet exemple utilise la fonction item() pour itérer dans chaque élément du tableau et y accéder.

    1. Sélectionnez à l’intérieur de la colonne de droite, puis sélectionnez l’icône de fonction, qui ouvre l’éditeur d’expressions. Assurez-vous que la liste Fonction apparaît sélectionnée.

    2. Dans l’éditeur d’expressions, entrez la fonction nommée item(), puis sélectionnez Ajouter.

      Capture d’écran montrant le flux de travail Consommation, l’action nommée Sélectionner et la propriété et les valeurs de l’objet JSON pour créer le tableau d’objets JSON.

    L’action Sélectionner ressemble maintenant à l’exemple suivant :

    Capture d’écran montrant le flux de travail Consommation et l’exemple d’action terminée nommée Sélectionner.

  6. Enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.

Tester votre workflow

Pour vérifier si l’action Sélectionner produit les résultats attendus, envoyez-vous une notification incluant la sortie de l’action Sélectionner.

  1. Dans votre flux de travail, ajoutez une action capable de vous envoyer les résultats de l’action Sélectionner.

  2. Dans cette action, suivez les étapes ci-dessous :

    1. Pour chaque case où vous souhaitez que les résultats apparaissent, sélectionnez la case, puis sélectionnez l’icône de fonction. L’icône ouvre l’éditeur d’expressions. Assurez-vous que la liste Fonction apparaît sélectionnée.

    2. Pour obtenir la sortie du tableau à partir de l’action Sélectionner, entrez l’expression suivante, qui utilise la fonction body() avec le nom de l’action Sélectionner, puis sélectionnez Ajouter :

      body('Select')

      La capture d’écran montre le flux de travail avec l’action Envoyer un e-mail (V2), et les actions sortent de l’action Select.

      L’expression résolue spécifie d’afficher les sorties de l’action Sélectionner dans le corps de l’e-mail lors de l’envoi :

      Capture d’écran montrant le flux de travail et l’action terminée nommée Envoyer un e-mail pour l’action Sélectionner.

  3. Enregistrez votre flux de travail, puis exécutez-le manuellement. Dans la barre d’outils du concepteur, sélectionnez Exécuter>Exécuter.

Si vous utilisez l’action Office 365 Outlook - Envoyer un e-mail (V2), l’exemple suivant montre le résultat :

Capture d’écran montrant l’e-mail avec les résultats de l’action Sélectionner.

Dépannage

Mettre en forme les données de table

Si votre table CSV ou HTML renvoie des données mal formatées, assurez-vous que vos données d’entrée incluent des sauts de ligne entre les lignes.

Mise en forme incorrecte :

Fruit,Number Apples,1 Oranges,2

Mise en forme correcte :

Fruit,Number
Apples,1
Oranges,2

Pour ajouter des sauts de ligne entre les lignes, ajoutez l’une des expressions suivantes à votre table :

replace(body('Create_CSV_table'),'\r\n','<br/>')
replace(body('Create_HTML_table'),'\r\n','<br/>')

Par exemple :

{
	"Send_an_email": {
		"inputs": {
			"body": {
				"Body": "<p>Results from Create CSV table action:<br/>\n<br/>\n<br/>\n@{replace(body('Create_CSV_table'),'\r\n','<br/>')}</p>",
				"Subject": "Create CSV table results",
				"To": "sophia.owen@fabrikam.com"
			}
		}
	}
}