Partager via


Guide de démarrage : Créer des flux de travail de consommation dans Azure Logic Apps multi-tenant à l’aide de Visual Studio Code

S’applique à : Azure Logic Apps (Consommation)

En tant que développeur d’intégration, vous devez souvent automatiser les processus métier entre les applications SaaS, les systèmes d’entreprise et les sources de données sans gérer l’infrastructure. Vous avez également besoin d’une méthode de création de code pour créer des flux de travail afin que vous puissiez définir des définitions de version, apporter des mises à jour et examiner efficacement les modifications.

Ce démarrage rapide montre comment créer et gérer des workflows Consommation dans un environnement Azure Logic Apps multilocataire, à l’aide des outils locaux et orientés code dans Visual Studio Code. Les flux de travail de consommation fournissent un modèle d’intégration serverless pour les flux de travail pilotés par les événements et planifiés. Vous pouvez donc connecter des services et automatiser des processus tout en payant uniquement les actions qui s’exécutent.

Dans Visual Studio Code, vous pouvez modifier des définitions de flux de travail en JavaScript Object Notation (JSON) à l’aide de l’éditeur de code, utiliser le concepteur visuel si nécessaire et gérer les flux de travail déployés dans Azure. Vous pouvez également travailler sur des flux de travail et des comptes d’intégration à partir de n’importe quelle plateforme de développement où Visual Studio Code s’exécute, comme Linux, Windows et macOS.

La capture d’écran suivante montre comment un exemple de définition de flux de travail Consommation peut ressembler :

Capture d’écran montrant un exemple de définition de flux de travail d’application logique Consommation dans Visual Studio Code.

Pour en savoir plus, consultez :

Prérequis

Accéder à Azure à partir de Visual Studio Code

  1. Dans Visual Studio Code, connectez-vous à votre compte Azure.

    Si la connexion prend plus de temps que d’habitude, Visual Studio Code vous invite à vous connecter via un site web d’authentification Microsoft en vous fournissant un code d’appareil. Pour vous connecter à l’aide du code à la place, procédez comme suit :

    1. Sélectionnez Utiliser le code de l’appareil, puis sélectionnez Copier & Ouvrir.

    2. Sélectionnez Ouvrir le lien pour ouvrir une nouvelle fenêtre de navigateur et passer au site web d’authentification.

    3. Dans la page Connectez-vous à votre compte, entrez votre code d’authentification, puis sélectionnez Suivant.

  2. Dans la barre d’activité, sélectionnez l’icône Azure.

    Capture d’écran montrant Visual Studio Code, la barre d’activité et l’icône Azure sélectionnée.

    Dans le volet Azure, les sections Logic Apps (Consommation) et Comptes d’intégration affichent désormais les abonnements Azure associés à votre compte. Si vous ne voyez pas les abonnements attendus ou si les sections affichent trop d’abonnements, procédez comme suit :

    1. Dans la section Logic Apps (Consommation), sélectionnez Sélectionner des abonnements.

      Capture d’écran montrant le volet Azure, la section Consommation de Logic Apps et sélectionnez Abonnements sélectionnés pour filtrer les abonnements Azure.

    2. Dans la liste des abonnements, sélectionnez les abonnements que vous souhaitez utiliser.

  3. Dans la section Logic Apps (Consommation), développez votre abonnement pour afficher les applications logiques déployées dans cet abonnement.

    Capture d’écran montrant un abonnement Azure étendu avec des applications logiques associées.

Créer une application logique

  1. Dans Visual Studio Code, dans la section Logic Apps (Consommation), dans le menu contextuel de l’abonnement, sélectionnez Créer une application logique.

    Capture d’écran montrant le menu contextuel de l’abonnement et l’option Créer une application logique.

    Une liste apparaît et montre tous les groupes de ressources de votre abonnement.

  2. Dans la liste des groupes de ressources, sélectionnez Créer un groupe de ressources ou un groupe de ressources existant.

    Pour cet exemple, sélectionnez Créer un groupe de ressources, par exemple :

    Capture d’écran montrant la liste des groupes de ressources avec Créer un groupe de ressources sélectionné.

  3. Entrez un nom pour votre groupe de ressources Azure.

    Capture d’écran montrant un nouveau nom de groupe de ressources Azure entré.

  4. Sélectionnez la région Azure où enregistrer les métadonnées de l’application logique.

    Capture d’écran montrant une région Azure sélectionnée.

  5. Entrez un nom pour votre application logique.

    Capture d’écran montrant un nom entré pour une application logique.

    Dans la fenêtre Azure, sous votre abonnement Azure, votre nouvelle application logique et votre flux de travail vide s’affichent. Visual Studio Code ouvre également un fichier JSON (.logicapp.json), qui inclut une définition de flux de travail squelette, par exemple :

    Capture d’écran montrant l’infrastructure d’une définition de flux de travail d’application logique vide dans un fichier JSON.

    Vous pouvez maintenant commencer à créer manuellement votre définition de flux de travail dans ce fichier JSON. Pour obtenir une référence technique sur la structure et la syntaxe d’une définition de flux de travail, consultez le schéma du langage de définition de flux de travail pour Azure Logic Apps.

    L’exemple de définition de flux de travail d’application logique suivant commence par un déclencheur RSS et une action Office 365 Outlook. En règle générale, les éléments JSON sont affichés par ordre alphabétique dans chaque section. Toutefois, cet exemple montre ces éléments à peu près dans l’ordre dans lequel les opérations de flux de travail apparaissent dans le concepteur.

    {
       "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
       "contentVersion": "1.0.0.0",
       "parameters": {
          "$connections": {
             "defaultValue": {},
             "type": "Object"
          }
       },
       "triggers": {
          "When_a_feed_item_is_published": {
             "recurrence": {
                "frequency": "Minute",
                "interval": 30
             },
             "splitOn": "@triggerBody()?['value']",
             "type": "ApiConnection",
             "inputs": {
                "host": {
                   "connection": {
                      "name": "@parameters('$connections')['rss']['connectionId']"
                   }
                },
                "method": "get",
                "path": "/OnNewFeed",
                "queries": {
                   "feedUrl": "@{encodeURIComponent('https://feeds.content.dowjones.io/public/rss/RSSMarketsMain')}",
                   "sinceProperty": "PublishDate"
                }
             }
          }
       },
       "actions": {
          "Send_an_email_(V2)": {
             "runAfter": {},
             "type": "ApiConnection",
             "inputs": {
                "body": {
                   "Body": "<p>Title: @{triggerBody()?['title']}<br>\n<br>\nDate published: @{triggerBody()?['updatedOn']}<br>\n<br>\nLink: @{triggerBody()?['primaryLink']}</p>",
                   "Subject": "RSS item: @{triggerBody()?['title']}",
                   "To": "sophia-owen@fabrikam.com"
                },
                "host": {
                   "connection": {
                      "name": "@parameters('$connections')['office365']['connectionId']"
                   }
                },
                "method": "post",
                "path": "/v2/Mail"
             }
          }
       },
       "outputs": {}
    }
    

    Important

    Pour réutiliser cet exemple de définition de flux de travail, vous avez besoin d’un compte professionnel ou scolaire, par exemple @fabrikam.com. Veillez à remplacer l’adresse e-mail fictive par votre propre adresse e-mail.

    Pour utiliser un autre connecteur de messagerie, tel que Outlook.com ou Gmail, remplacez l’action Send_an_email_action par une action similaire disponible à partir d’un connecteur de messagerie pris en charge par Azure Logic Apps.

    Si vous souhaitez utiliser le connecteur Gmail, seuls les comptes professionnels G-Suite peuvent utiliser ce connecteur sans restriction dans les applications logiques. Si vous disposez d’un compte de consommateur Gmail, vous pouvez utiliser ce connecteur uniquement avec des services google approuvés par Google ou créer une application cliente Google à utiliser pour l’authentification avec votre connecteur Gmail. Pour plus d’informations, consultez Stratégies de confidentialité et de sécurité des données pour les connecteurs Google dans Azure Logic Apps.

  6. Lorsque vous avez terminé, enregistrez la définition du flux de travail. (Fichier>Enregistrez ou appuyez sur Ctrl+S).

  7. Lorsque vous êtes invité à charger votre définition de flux de travail d’application logique dans votre abonnement Azure, sélectionnez Charger.

    Cette étape publie votre définition de flux de travail d’application logique à partir de Visual Studio Code sur le portail Azure, ce qui rend le flux de travail actif et en cours d’exécution dans Azure.

    Capture d’écran montrant une boîte de dialogue avec le bouton Charger mis en surbrillance pour charger une application logique sur le portail Azure.

Afficher le flux de travail dans le concepteur

Dans Visual Studio Code, vous pouvez ouvrir votre flux de travail d’application logique en mode création en lecture seule. Bien que vous ne puissiez pas modifier votre définition de flux de travail dans le concepteur, vous pouvez vérifier visuellement votre flux de travail à l’aide de la vue concepteur.

Dans l'interface Azure, dans la section Logic Apps (Consommation), à partir du menu contextuel de votre application logique, sélectionnez Ouvrir dans le Concepteur.

Le concepteur en lecture seule s’ouvre dans un onglet distinct et montre le workflow de l’application logique, par exemple :

Capture d’écran montrant le flux de travail de votre application logique en mode Création.

Afficher le flux de travail dans le portail Azure

Pour passer en revue la définition de flux de travail de votre application logique dans le portail Azure, procédez comme suit :

  1. Dans le portail Azure, connectez-vous à l’aide du même compte Et du même abonnement Azure associé à votre application logique.

  2. Dans la zone de recherche du portail Azure, entrez le nom de l’application logique. Dans la liste des résultats, sélectionnez l’application logique.

    Capture d’écran montrant le portail Azure, la zone de recherche et le nom entrés pour l’application logique avec le résultat mis en surbrillance.

  3. Dans la barre latérale de l’application logique, sous Outils de développement, ouvrez le flux de travail dans le concepteur ou la vue de code.

Modifier l’application logique déployée

Dans Visual Studio Code, vous pouvez ouvrir et modifier la définition de workflow pour une ressource d’application logique déjà déployée dans Azure.

Important

Avant de modifier un workflow d’application logique en cours d’exécution active en production, réduisez les interruptions et évitez le risque de briser le flux de travail en désactivant d’abord votre ressource d’application logique.

  1. Dans la barre d’activités de Visual Studio Code, sélectionnez l’icône Azure.

  2. Dans la fenêtre Azure, dans la section Logic Apps (Consommation), développez votre abonnement Azure, puis sélectionnez l’application logique souhaitée.

  3. Dans le menu contextuel de l’application logique, sélectionnez Ouvrir dans l’éditeur. Ou, en regard du nom de l’application logique, sélectionnez l’icône de modification.

    Capture d’écran montrant la fenêtre Azure, le menu contextuel de l’application logique et l’option Ouvrir dans l’éditeur sélectionnée.

    Visual Studio Code ouvre le fichier .logicapp.json dans votre dossier temporaire local afin de pouvoir afficher la définition du flux de travail.

    Capture d’écran montrant Visual Studio Code et le fichier de définition de flux de travail d’application logique ouvert.

  4. Apportez vos modifications dans le fichier de définition de flux de travail.

  5. Lorsque vous avez terminé, enregistrez vos modifications (Enregistrement de > ou appuyez sur Ctrl+S).

  6. Lorsque vous êtes invité à charger vos modifications et à remplacer votre flux de travail d’application logique existant dans le portail Azure, sélectionnez Charger.

    Cette étape publie vos mises à jour dans votre ressource d’application logique dans le portail Azure.

    Capture d’écran montrant une boîte de dialogue Visual Studio Code avec le bouton Charger mis en surbrillance pour charger les modifications apportées à l’application logique dans le portail Azure.

Afficher ou promouvoir d’autres versions

Dans Visual Studio Code, vous pouvez ouvrir et passer en revue les versions antérieures de votre flux de travail d’application logique. Vous pouvez également promouvoir une version antérieure en version active.

Important

Avant de modifier un workflow d’application logique en cours d’exécution active en production, réduisez les interruptions et évitez le risque de briser cette application logique en désactivant d’abord votre ressource d’application logique.

  1. Dans la fenêtre Azure, dans la section Logic Apps (Consommation), développez votre abonnement Azure pour afficher les applications logiques associées.

  2. Sous votre abonnement, développez votre application logique, puis développez Versions.

    La liste versions affiche les versions antérieures de l’application logique, le cas échéant.

    Capture d’écran montrant Visual Studio Code et les versions antérieures d’une application logique.

  3. Pour afficher une version antérieure, choisissez l’une des étapes suivantes :

    • Pour voir la définition JSON, sous Versions, sélectionnez le numéro de version de cette définition. Ou, dans le menu contextuel de version, sélectionnez Ouvrir dans l’éditeur.

      Un nouveau fichier s’ouvre sur votre ordinateur local et montre la définition JSON de cette version.

    • Pour afficher la version dans le concepteur en lecture seule, dans le menu contextuel de la version, sélectionnez Ouvrir dans le Concepteur.

  4. Pour promouvoir une version antérieure en version active, effectuez les étapes suivantes :

    1. Sous Versions, dans le menu contextuel de la version antérieure, sélectionnez Promouvoir.

      Capture d’écran montrant Visual Studio Code et comment promouvoir une version antérieure de l’application logique vers la version actuelle.

    2. Pour continuer après l’invite de confirmation de Visual Studio Code, sélectionnez Oui.

      Visual Studio Code promeut la version sélectionnée en version active et affecte un nouveau numéro à la version promue. La version active précédente apparaît maintenant sous la version promue.

Activer ou désactiver des applications logiques

Dans Visual Studio Code, si vous modifiez un flux de travail d’application logique publié et enregistrez vos modifications, vous remplacez votre application logique déjà déployée. Pour éviter de rompre votre flux de travail d’application logique en production et de réduire les interruptions, désactivez d’abord votre ressource d’application logique. Une fois que vous avez confirmé que le flux de travail fonctionne toujours comme prévu, vous pouvez réactiver la ressource d’application logique.

La désactivation ou l’activation d’une ressource d’application logique affecte les instances de flux de travail de la manière suivante :

  • Azure Logic Apps continue les exécutions de workflow en cours et en attente jusqu'à leur achèvement. En fonction du volume ou du backlog, ce processus peut prendre du temps.

  • Le service Azure Logic Apps ne crée ni n’exécute pas de nouvelles instances de flux de travail.

  • Le déclencheur ne déclenche pas la prochaine fois que ses conditions sont remplies.

  • L’état du déclencheur mémorise le point où le flux de travail s’est arrêté. Par conséquent, si vous réactivez l’application logique, le déclencheur se déclenche pour tous les éléments qui ne sont pas encore traités depuis la dernière exécution.

    Pour empêcher le déclenchement du déclencheur sur ces éléments non traités, avant de réactiver la ressource d’application logique, effacez l’état du déclencheur :

    1. Dans le flux de travail, modifiez n’importe quelle partie du déclencheur.
    2. Enregistrez vos modifications. Cette étape réinitialise l’état actuel de votre déclencheur.
    3. Réactivez votre ressource d’application logique.
  • Lorsque la ressource d’application logique est désactivée, vous pouvez toujours soumettre à nouveau des exécutions de flux de travail.

Pour désactiver ou activer une ressource d’application logique dans Visual Studio Code, procédez comme suit :

  1. Dans Visual Studio Code, ouvrez la fenêtre Azure.

  2. Dans la section Logic Apps (Consommation), développez votre abonnement Azure pour afficher les applications logiques associées.

  3. Pour désactiver une ressource d’application logique, dans le menu contextuel de l’application logique, sélectionnez Désactiver.

    Capture d’écran montrant Visual Studio Code et comment désactiver une ressource d’application logique.

  4. Lorsque vous êtes prêt à réactiver la ressource d’application logique, dans le menu contextuel de l’application logique, sélectionnez Activer.

    Capture d’écran montrant Visual Studio Code et comment activer une ressource d’application logique.

Supprimer des applications logiques

Voici de quelles manières la suppression d’une application logique affecte les instances de workflow :

  • Azure Logic Apps tente d’annuler les exécutions de flux de travail en cours et en attente.

    Même avec un gros volume ou un backlog important, la plupart des exécutions sont annulées avant qu’elles ne finissent ou ne démarrent. Toutefois, le processus d’annulation peut prendre du temps. Pendant ce temps, le service peut prendre en charge certaines exécutions pour les traiter, même s’il est en train de gérer le processus d’annulation.

  • Le service Azure Logic Apps ne crée ni n’exécute pas de nouvelles instances de flux de travail.

  • Si vous supprimez un flux de travail, puis recréez le même flux de travail, le flux de travail recréé a des métadonnées différentes. Vous devez enregistrer de nouveau les workflows qui ont appelé le workflow supprimé. Lorsque vous enregistrez de nouveau, l’appelant obtient les informations correctes pour le flux de travail recréé. Dans le cas contraire, les appels au workflow recréé échouent avec une erreur Unauthorized. Ce comportement s’applique aussi aux workflows qui utilisent des artefacts dans les comptes d’intégration et les workflows qui appellent des fonctions Azure.

Pour supprimer une ressource d’application logique de Visual Studio Code, procédez comme suit :

  1. Dans Visual Studio Code, ouvrez la fenêtre Azure.

  2. Dans la section Logic Apps (Consommation), développez votre abonnement Azure pour afficher les ressources d’application logique associées. Recherchez la ressource d’application logique que vous souhaitez supprimer.

  3. Dans le menu contextuel de l’application logique, sélectionnez Supprimer.

    Capture d’écran montrant Visual Studio Code et comment supprimer une ressource d’application logique.