Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 :
Pour en savoir plus, consultez :
- Qu’est-ce qu’Azure Logic Apps
- Comparaison entre les modèles monolocataire et multilocataire dans Azure Logic Apps.
Prérequis
Un compte et un abonnement Azure. Obtenez un compte Azure gratuit.
Connaissances de base sur les définitions de flux de travail d’application logique et leur structure au format JSON.
L’exemple de cet article crée le même flux de travail d’application logique que dans ce guide de démarrage rapide qui se concentre davantage sur les concepts de base. Vous pouvez également apprendre à créer et gérer des flux de travail via Azure CLI.
Accès au web pour la connexion à Azure et à votre abonnement Azure.
Téléchargez et installez les outils suivants, si vous ne les avez pas déjà :
Visual Studio Code version 1.25.1 ou ultérieure, qui est gratuite.
Extention de Visual Studio Code pour Azure Logic Apps (Consumption).
Installez cette extension à partir de Visual Studio Marketplace ou directement à partir de Visual Studio Code.
Rechargez Visual Studio Code après l’installation.
Pour plus d’informations, consultez la Place de marché des extensions. Pour contribuer à la version open source de cette extension, accédez à l’extension Azure Logic Apps pour Visual Studio Code sur GitHub.
Si votre flux de travail d’application logique doit communiquer via un pare-feu qui limite le trafic à des adresses IP spécifiques, le pare-feu doit autoriser l’accès aux adresses IP entrantes et sortantes utilisées par Azure Logic Apps ou au runtime dans la région Azure où se trouve votre flux de travail d’application logique.
Si votre flux de travail d’application logique utilise également des connecteurs managés, tels que le connecteur Office 365 Outlook ou le connecteur SQL, ou utilise des connecteurs personnalisés, le pare-feu doit autoriser l’accès pour toutes lesadresses IP sortantes du connecteur managé dans la région Azure de votre application logique.
Accéder à Azure à partir de Visual Studio Code
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 :
Sélectionnez Utiliser le code de l’appareil, puis sélectionnez Copier & Ouvrir.
Sélectionnez Ouvrir le lien pour ouvrir une nouvelle fenêtre de navigateur et passer au site web d’authentification.
Dans la page Connectez-vous à votre compte, entrez votre code d’authentification, puis sélectionnez Suivant.
Dans la barre d’activité, sélectionnez l’icône Azure.
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 :
Dans la section Logic Apps (Consommation), sélectionnez Sélectionner des abonnements.
Dans la liste des abonnements, sélectionnez les abonnements que vous souhaitez utiliser.
Dans la section Logic Apps (Consommation), développez votre abonnement pour afficher les applications logiques déployées dans cet abonnement.
Créer une application logique
Dans Visual Studio Code, dans la section Logic Apps (Consommation), dans le menu contextuel de l’abonnement, sélectionnez Créer une application logique.
Une liste apparaît et montre tous les groupes de ressources de votre abonnement.
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 :
Entrez un nom pour votre groupe de ressources Azure.
Sélectionnez la région Azure où enregistrer les métadonnées de l’application logique.
Entrez un nom pour votre 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 :
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_actionpar 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.
Lorsque vous avez terminé, enregistrez la définition du flux de travail. (Fichier>Enregistrez ou appuyez sur Ctrl+S).
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.
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 :
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 :
Dans le portail Azure, connectez-vous à l’aide du même compte Et du même abonnement Azure associé à votre application logique.
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.
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.
Dans la barre d’activités de Visual Studio Code, sélectionnez l’icône Azure.
Dans la fenêtre Azure, dans la section Logic Apps (Consommation), développez votre abonnement Azure, puis sélectionnez l’application logique souhaitée.
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.
Visual Studio Code ouvre le fichier .logicapp.json dans votre dossier temporaire local afin de pouvoir afficher la définition du flux de travail.
Apportez vos modifications dans le fichier de définition de flux de travail.
Lorsque vous avez terminé, enregistrez vos modifications (Enregistrement de > ou appuyez sur Ctrl+S).
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.
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.
Dans la fenêtre Azure, dans la section Logic Apps (Consommation), développez votre abonnement Azure pour afficher les applications logiques associées.
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.
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.
Pour promouvoir une version antérieure en version active, effectuez les étapes suivantes :
Sous Versions, dans le menu contextuel de la version antérieure, sélectionnez Promouvoir.
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 :
- Dans le flux de travail, modifiez n’importe quelle partie du déclencheur.
- Enregistrez vos modifications. Cette étape réinitialise l’état actuel de votre déclencheur.
- 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 :
Dans Visual Studio Code, ouvrez la fenêtre Azure.
Dans la section Logic Apps (Consommation), développez votre abonnement Azure pour afficher les applications logiques associées.
Pour désactiver une ressource d’application logique, dans le menu contextuel de l’application logique, sélectionnez Désactiver.
Lorsque vous êtes prêt à réactiver la ressource d’application logique, dans le menu contextuel de l’application logique, sélectionnez Activer.
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 :
Dans Visual Studio Code, ouvrez la fenêtre Azure.
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.
Dans le menu contextuel de l’application logique, sélectionnez Supprimer.