Exécuter des actions en fonction de l’état du groupe à l’aide d’étendues dans Azure Logic Apps

Pour exécuter des actions uniquement après l’échec ou la réussite d’un groupe d’actions, placez ce groupe dans une étendue. Cette structure est utile lorsque vous souhaitez organiser les actions en tant que groupe logique, évaluer l’état de ce groupe et effectuer des actions qui sont basées sur l’état de l’étendue. Une fois que toutes les actions d’une étendue ont été exécutées, l’étendue récupère également son propre état. Par exemple, vous pouvez utiliser des étendues lorsque vous souhaitez implémenter la gestion des erreurs et des exceptions.

Pour vérifier l’état d’une étendue, vous pouvez utiliser les mêmes critères que ceux utilisés pour déterminer l’état d’exécution des applications logiques, tels que Réussi, Échec, Annulé, etc. Par défaut, quand toutes les actions de l’étendue réussissent, l’état de l’étendue est marqué comme Réussi. Mais quand une action dans l’étendue échoue ou est annulée, l’état de l’étendue est défini sur Échec. Pour les limites sur les étendues, consultez Limites et configuration.

Par exemple, voici une application logique de haut niveau qui utilise une étendue pour exécuter des actions spécifiques et une condition pour vérifier l’état de l’étendue. Si des actions de l’étendue échouent ou se ferment de façon inattendue, l’étendue est définie sur Échec ou Abandonné, respectivement ; l’application logique envoie un message « Scope failed » (Échec de l’étendue). Si toutes les actions de l’étendue réussissent, l’application logique envoie un message « Scope succeeded » (Réussite de l’étendue).

Diagram shows the logic app scope flow with examples of

Prérequis

Pour suivre l’exemple de cet article, vous avez besoin de ces éléments :

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

  • Un compte de messagerie de n’importe quel fournisseur de messagerie pris en charge par Logic Apps. Cet exemple utilise Outlook.com. Si vous utilisez un autre fournisseur, le flux général reste le même, mais votre interface utilisateur peut s’afficher différemment.

  • Une clé Bing Maps. Pour obtenir cette clé, consultez Getting a Bing Maps Key (Obtention d’une clé Bing Maps).

  • Des connaissances de base en création d’applications logiques

Créer un exemple d’application logique

Commencez par créer cet exemple d’application logique pour que vous puissiez ajouter une étendue plus tard :

Create sample logic app

  • Un déclencheur Planification - Périodicité qui vérifie le service Bing Maps à un intervalle que vous spécifiez
  • Une action Bing Maps - Obtenir un itinéraire qui vérifie le temps de trajet entre deux emplacements
  • Une action conditionnelle qui vérifie si le temps de trajet dépasse le temps de trajet spécifié
  • Une action qui vous envoie un e-mail indiquant que ce temps de trajet actuel dépasse celui que vous avez spécifié

Vous pouvez enregistrer votre application logique à tout moment, par conséquent, enregistrez votre travail souvent.

  1. Si ce n’est pas déjà fait, connectez-vous au portail Azure. Créez une application logique vide.

  2. Ajoutez le déclencheur Planification - Périodicité avec ces paramètres : Intervalle = « 1 » et Fréquence = « Minute »

    Set up

    Conseil

    Pour simplifier l’affichage et masquer les détails de chaque action dans le concepteur, réduisez la forme de chaque action au cours de ces étapes.

  3. Ajoutez l’action Bing Maps - Obtenir un itinéraire.

    1. Si vous ne disposez pas d’une connexion à Bing Maps, vous êtes invité à en créer une.

      Paramètre Valeur Description
      Nom de connexion BingMapsConnection Donnez un nom à votre connexion.
      Clé API <your-Bing-Maps-key> Entrez la clé Bing Cartes que vous avez reçue précédemment.
    2. Configurez votre action Obtenir un itinéraire, comme le montre le tableau sous cette image :

      Set up

      Pour plus d’informations sur ces paramètres, voir Calculate a route (Calculer un itinéraire).

      Paramètre Valeur Description
      Étape 1 <start> Entrez l’origine de votre itinéraire.
      Étape 2 <end> Entrez la destination de votre itinéraire.
      Avoid None Entrez les éléments à éviter sur votre itinéraire, par exemple les autoroutes, les péages, etc. Pour les valeurs possibles, consultez Calculate a route (Calculer un itinéraire).
      Optimize timeWithTraffic Sélectionnez un paramètre permettant d’optimiser votre itinéraire, par exemple la distance, la durée du trajet avec les informations de circulation actuelle, etc. Cet exemple utilise cette valeur : « timeWithTraffic »
      Unité de distance <your-preference> Entrez l’unité de distance pour calculer votre itinéraire. Cet exemple utilise cette valeur : « Mile »
      Mode de déplacement Conduite Entrez le mode de déplacement pour votre itinéraire. Cet exemple utilise cette valeur : « Driving »
      Date et heure de transit None S’applique au mode transit uniquement.
      Type de date et heure de transit None S’applique au mode transit uniquement.
  4. Ajoutez une condition qui vérifie si le temps de trajet actuel dépasse une durée spécifiée. Pour cet exemple, suivez ces étapes :

    1. Renommez la condition avec cette description : Si le temps de trafic est supérieur à la durée spécifiée

    2. Dans la colonne de gauche, cliquez à l’intérieur de la zone Choisir une valeur pour afficher la liste de contenu dynamique. Dans cette liste, sélectionnez le champ Travel Duration Traffic (Trafic correspondant à la durée du trajet), qui est exprimé en secondes.

      Build condition

    3. Dans la zone du milieu, sélectionnez cet opérateur : est supérieur à.

    4. Dans la colonne la plus à droite, entrez cette valeur de comparaison, équivalente à 10 minutes en secondes : 600

      Une fois que vous avez terminé, votre condition ressemble à cet exemple :

      Finished condition

  5. Dans de la branche If true (Si true), ajoutez une action « Envoyer e-mail » pour votre fournisseur d’e-mail. Définissez cette action en suivant les étapes décrites sous cette image :

    Add

    1. Dans le champ À, entrez votre adresse e-mail à des fins de test.

    2. Dans le champ Sujet, entrez ce texte :

    Time to leave: Traffic more than 10 minutes

    1. Dans le champ Corps, entrez ce texte avec un espace de fin :

    Travel time:

    Alors que le curseur s’affiche dans le champ Corps, la liste de contenu dynamique reste ouverte afin que vous puissiez sélectionner tous les paramètres qui sont disponibles à ce stade.

    1. Dans la liste de contenu dynamique, choisissez Expression.

    2. Recherchez et sélectionnez la fonction div() . Placez votre curseur dans les parenthèses de la fonction.

    3. Alors que votre curseur se trouve dans les parenthèses de la fonction, choisissez Contenu dynamique pour afficher la liste de contenu dynamique.

    4. À partir de la section Obtenir un itinéraire, sélectionnez le champ Travel Duration Traffic (Trafic correspondant à la durée du trajet).

      Select

    5. Une fois que le champ correspond au format JSON, ajoutez une virgule (,) suivie du nombre 60 afin de convertir la valeur dans Travel Duration Traffic (Trafic correspondant à la durée du trajet) exprimée en secondes en minutes.

      div(body('Get_route')?['travelDurationTraffic'],60)
      

      Votre expression ressemble maintenant à cet exemple :

      Finish expression

    6. Une fois que vous avez terminé, sélectionnez OK.

    1. Une fois l’expression résolue, ajoutez ce texte avec un espace de début : minutes

      Votre champ Corps ressemble maintenant à cet exemple :

      Finished

  6. Enregistrez votre application logique.

Ensuite, ajoutez une étendue afin que vous puissiez regrouper des actions spécifiques et évaluer leur état.

Ajouter une étendue

  1. Si ce n’est pas déjà le cas, ouvrez votre application logique dans le concepteur d’application logique.

  2. Ajoutez une étendue à l’emplacement du flux de travail que vous souhaitez. Par exemple, pour ajouter une étendue entre des étapes existantes dans le workflow de l’application logique, effectuez les étapes suivantes :

    1. Déplacez votre pointeur sur la flèche où vous souhaitez ajouter l’étendue. Choisissez le signe plus (+) >Ajouter une action.

      Add a scope

    2. Dans la zone de recherche, entrez « étendue » comme filtre. Sélectionnez l’action Étendue.

Ajouter des étapes à l’étendue

  1. Ajoutez maintenant les étapes ou faites glisser les étapes que vous souhaitez exécuter dans l’étendue. Pour cet exemple, faites glisser ces actions dans l’étendue :

    • Obtenir un itinéraire
    • Si le temps de trajet est supérieur au temps spécifié, qui comprend les branches true et false

    Votre application logique ressemble maintenant à cet exemple :

    Scope added

  2. Sous l’étendue, ajoutez une condition qui vérifie l’état de l’étendue. Renommez la condition avec cette description : En cas d’échec de l’étendue

    Add condition to check scope status

  3. Dans la condition, ajoutez ces expressions qui vérifient si l’état de l’étendue est égal à « Échec » ou « Abandonné ».

    1. Pour ajouter une ligne, choisissez Ajouter.

    2. Dans chaque ligne, cliquez dans la zone de gauche pour afficher la liste de contenu dynamique. Dans la liste de contenu dynamique, choisissez Expression. Dans la zone d’édition, entrez cette expression, puis choisissez OK :

      result('Scope')[0]['status']

      Screenshot that shows the

    3. Pour les deux lignes, sélectionnez est égal à comme opérateur.

    4. Pour les valeurs de comparaison, dans la première ligne, entrez Failed. Dans la deuxième ligne, entrez Aborted.

      Une fois que vous avez terminé, votre condition ressemble à cet exemple :

      Add expression that checks the scope's status

      Maintenant, définissez la propriété runAfter de la condition afin que celle-ci vérifie l’état de l’étendue et exécute l’action correspondante que vous définissez dans les étapes ultérieures.

    5. Sur la condition Si l’étendue a échoué, choisissez le bouton points de suspension (...), puis choisissez Configurer la propriété Exécuter après.

      Configure runAfter property

    6. Sélectionnez tous ces états d’étendue : a réussi, a échoué, est ignorée et a expiré

      Select scope statuses

    7. Quand vous avez fini, choisissez Terminé. La condition affiche maintenant une icône « informations ».

  4. Dans les branches If true (Si true) et If false (Si false), ajoutez les actions que vous souhaitez effectuer en fonction de chaque état d’étendue, par exemple, envoyer un e-mail ou un message.

    Add actions to take based on scope status

  5. Enregistrez votre application logique.

Votre application logique terminée ressemble maintenant à cet exemple :

Finished logic app with scope

Tester votre travail

Dans la barre d’outils du concepteur, choisissez Exécuter. Si toutes les actions de l’étendue réussissent, vous recevez un message « Scope succeeded » (Réussite de l’étendue). Si des actions de l’étendue échouent, vous recevez un message « Scope failed » (Échec de l’étendue).

Définition JSON

Si vous travaillez en mode code, vous pouvez définir une structure d’étendue dans la définition JSON de votre application logique à la place. Par exemple, voici la définition JSON du déclencheur et des actions dans l’application logique précédente :

"triggers": {
  "Recurrence": {
    "type": "Recurrence",
    "recurrence": {
       "frequency": "Minute",
       "interval": 1
    }
  }
}
"actions": {
  "If_scope_failed": {
    "type": "If",
    "actions": {
      "Scope_failed": {
        "type": "ApiConnection",
        "inputs": {
          "body": {
            "Body": "Scope failed. Scope status: @{result('Scope')[0]['status']}",
            "Subject": "Scope failed",
            "To": "<your-email@domain.com>"
          },
          "host": {
            "connection": {
              "name": "@parameters('$connections')['outlook']['connectionId']"
            }
          },
          "method": "post",
          "path": "/Mail"
        },
        "runAfter": {}
      }
    },
    "else": {
      "actions": {
        "Scope_succeded": {
          "type": "ApiConnection",
          "inputs": {
            "body": {
              "Body": "Scope succeeded. Scope status: @{result('Scope')[0]['status']}",
              "Subject": "Scope succeeded",
              "To": "<your-email@domain.com>"
            },
            "host": {
              "connection": {
               "name": "@parameters('$connections')['outlook']['connectionId']"
              }
            },
            "method": "post",
            "path": "/Mail"
          },
          "runAfter": {}
        }
      }
    },
    "expression": {
      "or": [ 
         {
            "equals": [ 
              "@result('Scope')[0]['status']", 
              "Failed"
            ]
         },
         {
            "equals": [
               "@result('Scope')[0]['status']", 
               "Aborted"
            ]
         } 
      ]
    },
    "runAfter": {
      "Scope": [
        "Failed",
        "Skipped",
        "Succeeded",
        "TimedOut"
      ]
    }
  },
  "Scope": {
    "type": "Scope",
    "actions": {
      "Get_route": {
        "type": "ApiConnection",
        "inputs": {
          "host": {
            "connection": {
              "name": "@parameters('$connections')['bingmaps']['connectionId']"
            }
          },
          "method": "get",
          "path": "/REST/V1/Routes/Driving",
          "queries": {
            "distanceUnit": "Mile",
            "optimize": "timeWithTraffic",
            "travelMode": "Driving",
            "wp.0": "<start>",
            "wp.1": "<end>"
          }
        },
        "runAfter": {}
      },
      "If_traffic_time_is_more_than_specified_time": {
        "type": "If",
        "actions": {
          "Send_mail_when_traffic_exceeds_10_minutes": {
            "type": "ApiConnection",
            "inputs": {
              "body": {
                 "Body": "Travel time:@{div(body('Get_route')?['travelDurationTraffic'],60)} minutes",
                 "Subject": "Time to leave: Traffic more than 10 minutes",
                 "To": "<your-email@domain.com>"
              },
              "host": {
                "connection": {
                   "name": "@parameters('$connections')['outlook']['connectionId']"
                }
              },
              "method": "post",
              "path": "/Mail"
            },
            "runAfter": {}
          }
        },
        "expression": {
          "and" : [
            {
               "greater": [ 
                  "@body('Get_route')?['travelDurationTraffic']", 
                  600
               ]
            }
          ]
        },
        "runAfter": {
          "Get_route": [
            "Succeeded"
          ]
        }
      }
    },
    "runAfter": {}
  }
},

Obtenir de l’aide

Étapes suivantes