Créer des flux de travail d’application logique standard avec Visual Studio Code

S’applique à : Azure Logic Apps (Standard)

Ce guide montre comment créer localement un exemple de flux de travail d’application logique Standard que vous pouvez exécuter dans Azure Logic Apps à locataire unique lorsque vous utilisez Visual Studio Code avec l’extension Azure Logic Apps (Standard).

Dans ce guide, vous créez un espace de travail et un projet d’application logique standard, générez votre flux de travail et déployez votre projet en tant que ressource d’application logique standard dans Azure où votre flux de travail peut s’exécuter dans Azure Logic Apps monolocataire ou dans App Service Environment v3 (plans App Service basés sur Windows uniquement). Vous pouvez également déployer et exécuter votre flux de travail partout où Kubernetes peut s’exécuter, comme Azure, Azure Kubernetes Service, localement ou même d’autres fournisseurs de cloud, en raison du runtime conteneurisé pour Azure Logic Apps (Standard).

Voici quelques avantages que fournissent les applications logiques standard :

• Vous pouvez créer, déboguer, exécuter et tester localement des workflows dans l’environnement de développement Visual Studio Code local. Le portail Azure et Visual Studio Code offrent la possibilité de générer, d’exécuter et de déployer des ressources et des workflows d’application logique standard. Toutefois, avec Visual Studio Code, vous pouvez effectuer ces tâches localement.

• Votre projet d’application logique standard peut inclure des flux de travail avec état et sans état.

• Les flux de travail dans la même ressource d’application logique standard et le même locataire s’exécutent dans le même processus que le runtime Azure Logic Apps (Standard), de sorte qu’ils partagent les mêmes ressources et offrent de meilleures performances.

L’exemple de flux de travail de ce guide commence initialement par un déclencheur de requête suivi d’une action Office 365 Outlook . Le déclencheur de requête crée un point de terminaison pouvant être appelé pour le flux de travail et attend une requête HTTPS entrante de n’importe quel appelant. Lorsque le déclencheur reçoit une demande et se déclenche, l’action suivante s’exécute en envoyant un e-mail au destinataire spécifié, ainsi que les sorties de déclencheur que vous sélectionnez. Plus tard, vous pouvez ajouter une action Réponse qui retourne une réponse et des données traitées à l’appelant.

Bien que l’exemple de ce guide soit basé sur le cloud et n’a que quelques étapes, vous pouvez créer des flux de travail à l’aide d’opérations à partir de 1 400 connecteurs qui vous aident à intégrer un vaste éventail de services, de systèmes, d’applications et de données dans des environnements cloud, locaux et hybrides.

À mesure que vous progressez dans le guide, vous effectuez les tâches générales suivantes :

• Créez un espace de travail et un projet d’application logique standard avec un flux de travail avec état vide.
• Ajoutez un déclencheur et des actions à votre flux de travail.
• Exécutez, déboguez et testez localement.
• Passez en revue l’historique des exécutions du flux de travail.
• Recherchez les détails relatifs au nom de domaine pour l’accès au pare-feu.
• Activez l’historique des exécutions pour les workflows sans état.
• Déployez sur Azure, ce qui implique éventuellement l’activation d’Application Insights.
• Activez ou ouvrez Application Insights après le déploiement.
• Gérez votre ressource d’application logique déployée dans Visual Studio Code et le portail Azure.

Conditions préalables

Exigences en matière d’accès et de connectivité

Si vous envisagez de créer et d’exécuter localement des flux de travail à l’aide d’opérations intégrées uniquement, qui s’exécutent en mode natif sur le runtime Azure Logic Apps (Standard), vous n’avez pas besoin des exigences d’accès et de connectivité dans cette section. Toutefois, pour les scénarios suivants, vous devez répondre à ces exigences :

• Déployez votre application logique sur Azure à partir de Visual Studio Code.
• Créez un flux de travail qui utilise des opérations de connecteur managé qui s’exécutent dans Azure global.
• Accédez aux ressources et flux de travail d’application logique standard existants dans Azure ou à d’autres ressources Azure déployées.

Ces exigences incluent les éléments suivants :

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

• Accès à Internet afin de pouvoir télécharger l’extension requise, vous connecter à partir de Visual Studio Code à votre compte Azure, tester les flux de travail qui incluent les opérations de connecteur managé et déployer sur Azure à partir de Visual Studio Code.

• Pour créer le même exemple de flux de travail dans ce guide, vous avez besoin d’un compte de messagerie Office 365 Outlook qui utilise un compte professionnel ou scolaire Microsoft pour vous connecter.

  Si vous n’avez pas de compte Office 365, vous pouvez utiliser toute autre action disponible pouvant envoyer des messages à partir de votre compte e-mail, par exemple, Outlook.com. Si vous choisissez un autre connecteur de courrier, tel que Outlook.com, vous pouvez toujours suivre l’exemple. Les étapes globales générales sont les mêmes. Toutefois, votre expérience et vos options peuvent différer d’une certaine manière. Par exemple, avec le connecteur Outlook.com, utilisez votre compte Microsoft personnel pour vous connecter.

Outils

1. Téléchargez et installez Visual Studio Code, qui est gratuit.

2. Téléchargez et installez l’extension Azure Logic Apps (Standard) pour Visual Studio Code en procédant comme suit :

   1. Dans Visual Studio Code, dans la barre d’activité, sélectionnez Extensions. (Clavier : appuyez sur Ctrl+Maj+X)

   2. Dans la zone de recherche Extensions, entrez azure logic apps standard. Dans la liste des résultats, sélectionnez Azure Logic Apps (standard)>Installer.

      L’extension télécharge et installe toutes les dépendances requises et les versions appropriées pour les infrastructures suivantes :

      • Azure Functions Outils Principaux
      • Kit de développement logiciel (SDK) .NET
      • Node.js

      Une fois l’installation terminée, l’extension apparaît dans la liste Extensions : Installées.

      

   3. Rechargez ou redémarrez Visual Studio Code pour vous assurer que l’extension et toutes les dépendances sont correctement installées.

   4. Pour vérifier que l’extension et toutes les dépendances correctement installées, consultez Vérifier l’installation de l’extension.

   Vous pouvez à présent installer les extensions Consommation (multilocataire) et Standard (locataire unique) simultanément. Les expériences de développement diffèrent les unes des autres de certaines façons, mais votre abonnement Azure peut inclure des types de ressources d’application logique Standard et Consommation. Dans Visual Studio Code, le volet Azure affiche toutes les applications logiques déployées et hébergées azure dans votre abonnement Azure, mais organise vos applications de la manière suivante :

   • Section Ressources : toutes les applications logiques Standard de votre abonnement.
   • Section Logic Apps (Consommation) : toutes les applications logiques Consommation de votre abonnement.

3. Pour exécuter localement des déclencheurs et des actions basés sur le webhook, tels que le déclencheur webhook HTTP intégré, vous devez configurer le transfert pour l’URL de rappel dans Visual Studio Code.

4. Pour activer la journalisation et le suivi des diagnostics avec Application Insights pour votre application logique Standard, vous pouvez effectuer cette tâche pendant le déploiement d’une application logique ou après le déploiement. Vous devez disposer d’une ressource Application Insights, mais vous pouvez créer cette ressource à l’avance, pendant le déploiement ou après le déploiement.

5. Installez ou utilisez un outil capable d’envoyer des requêtes HTTP pour tester l’exemple de flux de travail, par exemple :

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

   Avertissement

   Pour les scénarios où vous avez des données sensibles, telles que des informations d’identification, des secrets, des jetons d’accès, des clés API et d’autres informations similaires, veillez à utiliser un outil qui protège vos données avec les fonctionnalités de sécurité nécessaires. L’outil doit fonctionner hors connexion ou localement, et ne nécessite pas de se connecter à un compte en ligne ou de synchroniser des données sur le cloud. Lorsque vous utilisez un outil avec ces caractéristiques, vous réduisez le risque d’exposer des données sensibles au public.

Vérifier l’installation de l’extension

1. Pour vous assurer que l’extension et toutes les dépendances sont correctement installées, rechargez ou redémarrez Visual Studio Code.

2. Vérifiez que Visual Studio Code détecte et installe automatiquement les mises à jour d’extensions, afin que toutes vos extensions reçoivent les dernières mises à jour. Dans le cas contraire, vous devez désinstaller manuellement la version obsolète et installer la version la plus récente.

   1. Dans le menu Fichier, accédez à Préférences>Paramètres.

   2. Sous l’onglet Utilisateur, accédez à Fonctionnalités>Extensions.

   3. Vérifiez que les mises à jour de vérification automatique sont sélectionnées et que la mise à jour automatique est définie sur Toutes les extensions.

3. Vérifiez que le paramètre Azure Logic Apps Standard : Project Runtime est défini sur la version correcte :

   1. Sous l’onglet Utilisateur, accédez à >Extensions>Azure Logic Apps (standard).

   2. Vérifiez que Project Runtime est défini sur la version ~4, par exemple :

      

      Remarque

      Cette version est obligatoire pour utiliser les actions Opérations de code inlined.

Se connecter au compte Azure

Si vous n’êtes pas déjà connecté à votre compte Azure, procédez comme suit pour vous connecter :

1. Dans Visual Studio Code, dans la barre d’activité, sélectionnez l’icône Azure pour ouvrir le volet Azure .

   

2. Dans le volet Azure, sous Ressources, sélectionnez Se connecter à Azure. Quand la page d’authentification de Visual Studio Code s’affiche, connectez-vous avec votre compte Azure.

   

   Une fois connecté, le volet Azure affiche les abonnements Azure associés à votre compte Azure. Si les abonnements attendus n’apparaissent pas, ou si vous souhaitez que le volet affiche uniquement des abonnements spécifiques, procédez comme suit :

   1. Dans la liste des abonnements, positionnez votre pointeur à côté du premier abonnement jusqu’à ce que le bouton Sélectionner les abonnements (icône de filtre) s’affiche. Sélectionnez l’icône de filtre.

      

      Ou, dans la barre d’état de Visual Studio Code, sélectionnez votre compte Azure.

   2. Lorsque la liste des abonnements mis à jour s’affiche, sélectionnez les abonnements souhaités, puis vérifiez que vous sélectionnez OK.

Créer un espace de travail local

Un projet d’application logique nécessite toujours un espace de travail. Par conséquent, avant de pouvoir créer votre application logique, vous devez créer un espace de travail dans lequel vous conservez votre projet d’application logique. Vous utilisez ultérieurement cet espace de travail et ce projet pour gérer, exécuter et déployer votre application logique à partir de Visual Studio Code dans votre environnement de déploiement. Le projet sous-jacent est similaire à un projet Azure Functions, également appelé projet d’application de fonction.

1. Sur votre ordinateur, créez un dossier local vide à utiliser ultérieurement pour l’espace de travail et le projet.

   Cet exemple crée un dossier nommé fabrikam-workflows.

2. Dans Visual Studio Code, fermez tous les dossiers ouverts.

3. Dans la fenêtre Azure , dans la barre d’outils de la section Espace de travail , dans le menu Azure Logic Apps , sélectionnez Créer un espace de travail d’application logique.

   

   Si le Pare-feu Windows Defender vous invite à accorder un accès réseau pour Code.exe, c’est-à-dire Visual Studio Code, ainsi que pour func.exe, c’est-à-dire Azure Functions Core Tools, sélectionnez Réseaux privés, tels qu’un réseau domestique ou un réseau d’entreprise>Autoriser l’accès.

4. Dans la fenêtre Sélectionner un dossier , accédez à l’emplacement où vous avez créé votre dossier, sélectionnez le dossier, puis sélectionnez Sélectionner (ne double-sélectionnez pas le dossier).

   

   Dans la barre d’outils visual Studio Code, une invite s’affiche pour nommer votre espace de travail.

5. Pour fournir un nom d’espace de travail, entrez le nom de l’espace de travail à utiliser.

   Cet exemple utilise Fabrikam-Workflows.

   

Ensuite, créez votre projet d’application logique.

Créer votre projet d’application logique

Après avoir créé l’espace de travail requis, suivez les instructions pour créer votre projet.

1. Pour votre modèle de projet, sélectionnez Application logique. Entrez un nom de projet à utiliser.

   Cet exemple utilise Fabrikam-Workflows.

   

2. Pour votre modèle de flux de travail, sélectionnez Flux de travail avec état ou Flux de travail sans état, en fonction de votre scénario. Entrez un nom de flux de travail à utiliser.

   Cet exemple sélectionne le flux de travail avec état, qui stocke l’historique des flux de travail, les entrées et les sorties, et utilise Stateful-Workflow comme nom.

   Les flux de travail sans état ne stockent pas ces données et prennent actuellement en charge uniquement les actions de connecteur managées, pas les déclencheurs. Bien que vous ayez la possibilité d’activer des connecteurs dans Azure pour votre flux de travail sans état, le concepteur n’affiche aucun déclencheur de connecteur managé à sélectionner.

   Remarque

   Si vous obtenez une erreur nommée azureLogicAppsStandard.createNewProject avec le message d’erreur, Impossible d’écrire dans les paramètres de l’espace de travail, car azureFunctions.suppressProject n’est pas une configuration inscrite, essayez de réinstaller l’extension Azure Functions pour Visual Studio Code, directement à partir de Visual Studio Marketplace ou à partir de Visual Studio Code.

3. Choisissez maintenant si vous souhaitez ouvrir votre projet dans la fenêtre Visual Studio Code actuelle ou dans une nouvelle fenêtre. Sélectionnez Ouvrir dans la fenêtre active ou Ouvrir dans la nouvelle fenêtre, en fonction de vos préférences.

   Le volet Explorateur s’ouvre pour afficher votre espace de travail, votre projet et le fichier workflow.json automatiquement ouvert. Ce fichier existe dans le dossier nommé Stateful-Workflow et stocke la définition JSON sous-jacente du flux de travail que vous générez dans le concepteur. Pour plus d’informations sur la structure de votre projet, consultez la structure de projet d’application logique standard.

   Vous obtenez également une invite pour activer les connecteurs « partagés » hébergés par Azure multilocataire, par exemple :

   

4. Pour activer tous les connecteurs « partagés » gérés qui s’exécutent dans Azure multilocataire afin de pouvoir les afficher et choisir de les utiliser dans votre flux de travail, sélectionnez Utiliser des connecteurs à partir d’Azure.

   Remarque

   Si vous ne sélectionnez pas cette option et que vous essayez ultérieurement d’ajouter une opération de connecteur managé lorsque vous générez votre flux de travail, vous ne pouvez pas continuer, car le volet d’informations sur l’opération affiche un cercle de rotation qui ne s’arrête pas.

5. Pour le groupe de ressources Azure, sélectionnez Créer un groupe de ressources. Entrez le nom du groupe de ressources à utiliser.

   Cet exemple utilise Fabrikam-Workflows-RG.

6. Pour l’abonnement, sélectionnez l’abonnement Azure à utiliser avec votre projet d’application logique.

7. Pour l’emplacement où créer votre groupe et vos ressources, sélectionnez la région Azure.

   Cet exemple utilise la région USA Centre-Ouest.

8. Si votre projet a besoin d’une autre configuration pour le développement ou a besoin de prendre en charge des artefacts pour générer votre flux de travail, consultez les scénarios suivants et les tâches associées :

   Scénario	Tâche
   Exécutez localement des déclencheurs ou des actions basés sur le webhook.	Configurer le transfert pour les URL de rappel de webhook.
   Configurer l’historique d’exécution du workflow sans état.	Activez l’historique des exécutions pour les flux de travail sans état.
   Ajoutez des artéfacts et des dépendances, tels que des cartes, des schémas et des assemblies.	Ajoutez des artefacts et des dépendances.
   Utiliser un projet NuGet (.NET)	Convertissez un projet groupé basé sur une extension (Node.js) en projet nuGet basé sur un package (.NET). Remarque : Pour convertir un projet basé sur un ensemble d’extensions (Node.js) que vous avez créé avant l’existence d’assemblys, consultez également Migrer des projets basés sur des packages NuGet pour utiliser des assemblys dans le dossier lib.
   Créez vos propres connecteurs intégrés.	1. Convertissez un projet basé sur un groupe d’extensions (Node.js) en projet nuGet basé sur un package (.NET). 2. Activez la fonctionnalité de création intégrée de connecteurs.

Ouvrez maintenant le concepteur de flux de travail.

Ouvrir le concepteur de flux de travail

Une fois votre projet ouvert dans le volet Explorateur, ouvrez le concepteur pour pouvoir générer votre flux de travail.

Dans le menu contextuel du fichier workflow.json, sélectionnez Ouvrir le Designer.

Remarque

Après avoir sélectionné cette option, vous pouvez recevoir le message indiquant que le démarrage peut prendre quelques secondes en raison du « démarrage de l’API au moment du design du flux de travail ». Vous pouvez ignorer ce message ou sélectionner OK.

Visual Studio Code ouvre le concepteur de flux de travail et affiche l’invite Ajouter un déclencheur , par exemple :

Remarque

Si le concepteur ne s’ouvre pas, consultez la section de résolution des problèmes, Échec de l’ouverture du concepteur.

Ensuite, ajoutez un déclencheur et des actions pour créer votre flux de travail.

Ajouter un déclencheur et une action

Pour créer votre flux de travail, démarrez votre flux de travail avec un déclencheur, puis ajoutez initialement une seule action. De cette façon, vous pouvez tester votre flux de travail avant d’ajouter l’action suivante. L’exemple de flux de travail utilise le déclencheur et les actions suivants, collectivement appelés opérations :

Connecteur ou groupe d’opérations	Nom de l’opération	Type d'opération	Descriptif
Requête	Quand une requête HTTP arrive	Déclencheur (intégré)	Crée une URL de point de terminaison sur le flux de travail pour recevoir des appels entrants ou des requêtes provenant d’autres services ou flux de travail d’application logique. Pour plus d’informations, consultez Recevoir et répondre aux appels HTTPs entrants aux flux de travail.
Office 365 Outlook	Envoyer un message électronique	Action (gérée)	Envoyez un e-mail à l’aide d’un compte Office 365 Outlook. Pour suivre les étapes décrites dans ce guide, vous avez besoin d’un compte de messagerie Office 365 Outlook. Pour plus d’informations, consultez Se connecter à Office 365 Outlook à partir d’Azure Logic Apps. Remarque : Si vous disposez d’un compte de messagerie pris en charge par un autre connecteur, vous pouvez utiliser ce connecteur, mais l’expérience utilisateur de ce connecteur diffère des étapes décrites dans cet exemple.
Requête	Réponse	Action (intégrée)	Envoyez une réponse et renvoyez des données à l’appelant. Pour plus d’informations, consultez Ajouter une action Réponse.

Ajoutez le déclencheur Request

1. Dans le concepteur de flux de travail, sélectionnez Ajouter un déclencheur, s’il n’est pas déjà sélectionné.

   Le volet Ajouter un déclencheur s’ouvre et affiche une galerie dans laquelle vous pouvez sélectionner parmi les connecteurs et groupes d’opérations disponibles, par exemple :

   

2. Dans le volet Ajouter un déclencheur , suivez ces étapes générales pour ajouter le déclencheur de requête nommé Lorsqu’une requête HTTP est reçue.

   L’exemple suivant sélectionne l’option intégrée afin que seuls les déclencheurs intégrés apparaissent :

   

   Lorsque le déclencheur apparaît sur le concepteur, le volet d'informations du déclencheur s'ouvre et affiche les paramètres, les réglages et d'autres tâches associées du déclencheur.

   

   Remarque

   Si le volet d'informations du déclencheur n'apparaît pas, assurez-vous que le déclencheur est sélectionné sur le concepteur.

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

Ajouter l’action Office 365 Outlook

1. Dans le concepteur, sous le déclencheur de demande , suivez ces étapes générales pour ajouter l’action Office 365 Outlook nommée Envoyer un e-mail (V2).

   Si l’action n’apparaît pas dans les résultats initiaux, en regard du nom du connecteur, sélectionnez Voir plus, par exemple :

   

2. Lorsque le volet d’authentification de l’action s’affiche, sélectionnez Se connecter pour créer une connexion à votre compte de messagerie.

   

3. Suivez les invites suivantes pour authentifier vos informations d’identification, autoriser l’accès et revenir à Visual Studio Code.

   Remarque

   Si trop de temps s’écoule avant que vous répondiez aux invites, le processus d’authentification expire et échoue. Dans ce cas, revenez au concepteur et réessayez de vous connecter pour créer la connexion.

   1. Lorsque l’invite d’authentification Microsoft s’affiche, sélectionnez votre compte d’utilisateur pour Office 365 Outlook. Dans la page de confirmation requise qui s’ouvre, sélectionnez Autoriser l’accès.

   2. Quand Azure Logic Apps vous invite à ouvrir un lien Visual Studio Code, sélectionnez Ouvrir.

      

   3. Lorsque Visual Studio Code vous invite à ouvrir l’extension Microsoft Azure Tools, sélectionnez Ouvrir.

      

   Une fois que Visual Studio Code a créé votre connexion, certains connecteurs affichent le message indiquant que la connexion sera valide pendant <n> jours uniquement. Cette limite de temps s’applique uniquement à la durée pendant laquelle vous créez votre workflow d’application logique dans Visual Studio Code. Après le déploiement, cette limite ne s’applique plus, car votre workflow peut s’authentifier au moment de l’exécution à l’aide de son identité managée affectée par le système qui est activée automatiquement. Cette identité managée diffère des informations d’identification d’authentification ou de la chaîne de connexion que vous utilisez lors de la création d’une connexion. Si vous désactivez cette identité managée affectée par le système, les connexions ne fonctionneront pas au moment de l’exécution.

4. Dans le volet Envoyer des informations sur l’e-mail qui s’ouvre, sous l’onglet Paramètres , fournissez les informations requises pour l’action.

   Remarque

   Si le volet d’informations sur l’action ne s’ouvre pas automatiquement, sélectionnez l’action Envoyer un e-mail sur le concepteur.

   Propriété	Obligatoire	Valeur	Descriptif
   À	Oui	< votre adresse e-mail>	Destinataire de l’e-mail, qui peut être votre adresse de messagerie à des fins de test. Cet exemple utilise l’e-mail fictif sophia.owen@fabrikam.com.
   Sujet	Oui	E-mail de votre exemple de workflow	L’objet de l’e-mail
   Corps	Oui	Bonjour de votre exemple de workflow !	Contenu du corps de l’e-mail.

   Par exemple:

   

5. Enregistrez votre flux de travail. Dans le concepteur, sélectionnez Enregistrer.

Structure de projet d’application logique standard

Dans Visual Studio Code, votre projet d’application logique a l’un des types suivants :

• Extension basée sur un bundle (Node.js), qui est le type par défaut
• NuGet basé sur un package (.NET), que vous pouvez convertir à partir du type par défaut

En fonction de ces types, votre projet peut inclure des dossiers ou des fichiers légèrement différents. Par exemple, un projet nuget basé sur des packages a un dossier .bin qui contient des packages et d’autres fichiers de bibliothèque. Un projet basé sur un bundle d’extensions n’inclut pas ce dossier .bin .

Certains scénarios nécessitent l’exécution d’un projet basé sur un package NuGet pour que votre application s’exécute, par exemple lorsque vous souhaitez développer et exécuter des opérations intégrées personnalisées. Pour plus d’informations sur la conversion de votre projet pour utiliser NuGet, consultez Activer la création de connecteurs intégrés.

Le projet basé sur l’extension par défaut a un dossier et une structure de fichiers semblable à l’exemple suivant :

MyWorkspaceName
| MyBundleBasedLogicAppProjectName
  || .vscode
  || Artifacts
     ||| Maps 
         |||| MapName1
         |||| ...
     ||| Rules
     ||| Schemas
         |||| SchemaName1
         |||| ...
  || lib
     ||| builtinOperationSdks
         |||| JAR
         |||| net472
     ||| custom
  || WorkflowName1
     ||| workflow.json
     ||| ...
  || WorkflowName2
     ||| workflow.json
     ||| ...
  || workflow-designtime
     ||| host.json
     ||| local.settings.json
  || .funcignore
  || connections.json
  || host.json
  || local.settings.json

Au niveau racine de votre projet, vous trouverez les dossiers et fichiers suivants, ainsi que d’autres éléments :

Nom	Fichier ou dossier	Descriptif
.vscode	Dossier	Contient les fichiers de paramètres liés à Visual Studio Code, comme les fichiers extensions.json, launch.json, settings.json et tasks.json.
Artefacts	Dossier	Contient les artefacts de compte d’intégration que vous définissez et utilisez dans des workflows qui prennent en charge les scénarios interentreprises (B2B, Business-to-Business). Par exemple, l’exemple de structure inclut les dossiers suivants : - Cartes : contient des mappages à utiliser pour les opérations de transformation XML. - Schémas : contient des schémas à utiliser pour les opérations de validation XML. - Règles : Artefacts pour les règles d’entreprise dans les projets de moteur basés sur des règles.
Lib	Dossier	Contient des assemblages pris en charge que votre application logique est capable d'utiliser ou de référencer. Vous pouvez charger ces assemblys dans votre projet dans Visual Studio Code, mais vous devez les ajouter à des dossiers spécifiques dans votre projet. Par exemple, ce dossier inclut les dossiers suivants : - builtinOperationSdks : contient les dossiers JAR et net472 pour les assemblys Java et .NET Framework, respectivement. - custom : contient des assemblys personnalisés .NET Framework. Pour plus d’informations sur les types d’assemblys pris en charge et sur l’emplacement où les placer dans votre projet, consultez Ajouter des assemblys à votre projet.
< WorkflowName>	Dossier	Pour chaque workflow, le dossier <WorkflowName> inclut un fichier workflow.json, qui contient la définition JSON sous-jacente de ce workflow.
workflow-designtime	Dossier	Contient les fichiers de paramètres liés à l’environnement de développement.
.funcignore	Fichier	Contient des informations relatives à votre ensemble d’outils Azure Functions Core Tools installé.
connections.json	Fichier	Contient les métadonnées, les points de terminaison et les clés de toutes les connexions managées et fonctions Azure utilisées par vos workflows. Important : Pour utiliser des connexions et des fonctions différentes pour chaque environnement, veillez à paramétrer ce fichier connections.json et mettre à jour les points de terminaison.
host.json	Fichier	Contient des paramètres de configuration et des valeurs spécifiques au runtime, par exemple les limites par défaut pour la plateforme, les applications logiques, les workflows, les déclencheurs et les actions Azure Logic Apps à locataire unique. Au niveau racine de votre projet d’application logique, le fichier de métadonnées host.json contient les paramètres de configuration et les valeurs par défaut que tous les workflows d’une même application logique utilisent lors de l’exécution, que ce soit localement ou dans Azure. Pour obtenir des informations de référence, consultez Modifier les paramètres de l’application et les paramètres de l’hôte. Remarque : Quand vous créez votre application logique, Visual Studio Code crée un fichier host.snapshot.*.json de sauvegarde dans votre conteneur de stockage. Si vous supprimez votre application logique, ce fichier de sauvegarde n’est pas supprimé. Si vous créez une autre application logique portant le même nom, un autre fichier d’instantané est créé. Vous pouvez avoir jusqu’à 10 instantanés pour la même application logique. Si vous dépassez cette limite, vous obtenez l’erreur suivante : Microsoft.Azure.WebJobs.Script.WebHost: Repository has more than 10 non-decryptable secrets backups (host)) Pour résoudre cette erreur, supprimez les fichiers d’instantanés supplémentaires de votre conteneur de stockage.
local.settings.json	Fichier	Contient les paramètres d’application, les chaînes de connexion et d’autres paramètres utilisés par vos workflows lors d’une exécution locale. Ces paramètres et valeurs s’appliquent uniquement lorsque vous exécutez vos projets dans votre environnement de développement local. Lors d’un déploiement sur Azure, le fichier et les paramètres sont ignorés et ne sont pas inclus dans votre déploiement. Ce fichier stocke les paramètres et les valeurs en tant que variables d’environnement locales que vos outils de développement locaux utilisent pour les appSettings valeurs. Vous pouvez appeler et référencer ces variables d’environnement au moment de l’exécution et au moment du déploiement à l’aide des paramètres d’application et des configurations. Important : Le fichier local.settings.json peut contenir des secrets. Par conséquent, veillez à exclure également ce fichier du contrôle de code source de votre projet. Ce fichier contient également les paramètres d’application dont votre application logique a besoin pour fonctionner correctement. Pour obtenir des informations de référence, consultez Modifier les paramètres de l’application et les paramètres de l’hôte.

Autres tâches de configuration de développement

Après avoir créé votre projet, vous pouvez toujours avoir d’autres tâches d’installation pour prendre en charge des scénarios de développement locaux spécifiques autour de la création, de l’exécution et du déploiement d’applications logiques Standard à l’aide de Visual Studio Code. Les sections suivantes décrivent les tâches de ces scénarios.

Activer les webhooks exécutés localement

Une opération de webhook est un déclencheur de flux de travail ou une action qui attend qu’un événement se produise avant que l’opération puisse s’exécuter. Plus précisément, l’opération de webhook attend qu’une requête HTTPS arrive d’un service ou d’un workflow d’appelant avant que l’opération puisse continuer. Par exemple, les webhooks incluent des opérations telles que le déclencheur de requête et le déclencheur HTTP + Webhook .

Dans le Portail Microsoft Azure, l’environnement d’exécution Azure Logic Apps abonne automatiquement le webhook au service appelant ou au workflow. L'environnement d'exécution enregistre une URL de rappel pour le webhook auprès du service appelant ou du workflow. Le webhook attend ensuite que l’appelant envoie la requête à l’aide de l’URL de rappel.

Toutefois, dans Visual Studio Code, vous devez effectuer certaines tâches d’installation pour que les opérations de webhook fonctionnent correctement. Dans ce scénario, l’URL de rappel utilise votre serveur localhost (http://localhost:7071/...), qui est privé, afin que l’appelant ne puisse pas envoyer directement une demande sur Internet à cette URL.

Pour les opérations de webhook dans des flux de travail en cours d’exécution locale, vous devez configurer une URL publique qui expose votre serveur localhost et transfère en toute sécurité les appels de l’appelant à l’URL de rappel. Vous pouvez utiliser un service de transfert et un outil comme ngrok, qui ouvre un tunnel HTTP sur votre port localhost, ou vous pouvez utiliser votre propre outil équivalent.

Configurer le transfert d’appel à l’aide de ngrok

1. Accédez au site Web ngrok. Inscrivez-vous à un nouveau compte ou connectez-vous à votre compte, si vous en avez déjà un.

2. Récupérez votre jeton d’authentification personnel, dont votre client ngrok a besoin pour se connecter et authentifier l’accès à votre compte.

   1. Pour trouver la page de votre jeton d’authentification, dans le menu du tableau de bord de votre compte, déroulez Authentification et sélectionnez Votre jeton d’authentification.

   2. À partir de la zone Your Authtoken (Votre jeton d’authentification), copiez le jeton dans un emplacement sûr.

3. À partir de la page de téléchargement ngrok ou du tableau de bord de votre compte, téléchargez la version ngrok de votre choix et extrayez le fichier .zip.

   Pour plus d'informations, consultez Étape 1 : Unzip to install (Décompressez pour installer).

4. Sur votre ordinateur, ouvrez l’outil d’invite de commandes. Accédez à l’emplacement où se trouve le fichier ngrok.exe.

5. Connectez le client ngrok à votre compte ngrok en exécutant la commande suivante :

   ngrok authtoken <your-authentication-token>

   Pour plus d'informations, consultez Étape 2 : Connect your account (Connectez votre compte).

6. Ouvrez le tunnel HTTP sur le port localhost 7071 en exécutant la commande suivante :

   ngrok http 7071

   Pour plus d'informations, consultez Étape 3 : Fire it up (Lancez le logiciel).

7. Dans la sortie, recherchez la ligne suivante :

   http://<domain>.ngrok.io -> http://localhost:7071

8. Copiez et enregistrez l’URL qui a le format suivant : http://<domain>.ngrok.io.

Configurer l’URL de transfert dans les paramètres de votre application

1. Dans Visual Studio Code, sur le concepteur, ajoutez l’opération de webhook que vous souhaitez utiliser dans votre flux de travail.

   Cet exemple se poursuit avec le déclencheur HTTP + Webhook.

2. Quand l’invite s’affiche pour l’emplacement du point de terminaison hôte, entrez l’URL de transfert (redirection) que vous avez créée précédemment.

   Remarque

   Si vous ignorez l’invite, un avertissement s’affiche pour vous indiquer que vous devez fournir l’URL de transfert. Sélectionnez alors Configurer, puis entrez l’URL. Une fois cette étape terminée, l’invite n’apparaît pas pour les opérations de webhook suivantes que vous pouvez ajouter.

   Pour que l’invite apparaisse, au niveau de la racine de votre projet, ouvrez le menu contextuel du fichier local.settings.js, puis sélectionnez Configurer le point de terminaison de redirection du webhook. L’invite s’affiche alors pour vous permettre de fournir l’URL de transfert.

   Visual Studio Code ajoute l’URL de transfert au fichier local.settings.json situé dans le dossier racine de votre projet. Dans l’objet Values , la propriété nommée Workflows.WebhookRedirectHostUri s’affiche et est définie sur l’URL de transfert, par exemple :

   {
      "IsEncrypted": false,
      "Values": {
         "AzureWebJobsStorage": "UseDevelopmentStorage=true",
         "FUNCTIONS_WORKER_RUNTIME": "dotnet",
         "FUNCTIONS_V2_COMPATIBILITY_MODE": "true",
         <...>
         "Workflows.WebhookRedirectHostUri": "http://xxxXXXXxxxXXX.ngrok.io",
         <...>
      }
   }
   

   Pour plus d’informations sur ces paramètres d’application, consultez Modifier les paramètres de l’application et les paramètres d’hôte pour les applications logiques standard.

La première fois que vous démarrez une session de débogage locale ou exécutez le flux de travail sans débogage, le runtime Azure Logic Apps inscrit le flux de travail auprès de l’appelant et s’abonne au point de terminaison de l’appelant qui avertit les opérations de webhook. La prochaine fois que votre workflow sera exécuté, le runtime ne s’inscrira pas ni ne se réabonnera, car l’inscription de l’abonnement existe déjà dans le stockage local.

Lorsque vous arrêtez la session de débogage d’un flux de travail qui utilise des opérations webhook exécutées localement, les inscriptions d’abonnement existantes ne sont pas supprimées. Pour les désinscrire, vous devez supprimer manuellement les inscriptions d’abonnement.

Remarque

Une fois que votre workflow commence à s’exécuter, la fenêtre de terminal peut afficher des erreurs telles que l’exemple suivant :

message='Http request failed with unhandled exception of type 'InvalidOperationException' and message: 'System.InvalidOperationException: Synchronous operations are disallowed. Call ReadAsync or set AllowSynchronousIO to true instead.'

Dans ce cas, ouvrez le fichier local.settings.json situé dans le dossier racine de votre projet et vérifiez que la propriété est définie sur true :

"FUNCTIONS_V2_COMPATIBILITY_MODE": "true"

Activer l’historique des exécutions pour les workflows sans état

Pour déboguer plus facilement un workflow sans état, vous pouvez activer l’historique des exécutions du workflow en question, puis le désactiver lorsque vous avez terminé. Procédez comme suit pour Visual Studio Code ou, si vous travaillez dans le portail Azure, consultez Créer des workflows monolocataires dans le portail Azure.

1. Dans votre projet Visual Studio Code, au niveau du dossier racine, ouvrez le fichier local.settings.json.

2. Ajoutez la propriété Workflows.<workflow-name>.operationOptions et définissez la valeur sur WithStatelessRunHistory, par exemple :

   Windows

   {
      "IsEncrypted": false,
      "Values": {
         "AzureWebJobsStorage": "UseDevelopmentStorage=true",
         "FUNCTIONS_WORKER_RUNTIME": "dotnet",
         "Workflows.<workflow-name>.OperationOptions": "WithStatelessRunHistory"
      }
   }
   

   macOS ou Linux

   {
      "IsEncrypted": false,
      "Values": {
         "AzureWebJobsStorage": "DefaultEndpointsProtocol=https;AccountName=fabrikamstorageacct; \
             AccountKey=<access-key>;EndpointSuffix=core.windows.net",
         "FUNCTIONS_WORKER_RUNTIME": "dotnet",
         "Workflows.<workflow-name>.OperationOptions": "WithStatelessRunHistory"
      }
   }
   

3. Dans le dossier du projet nommé workflow-designtime, ouvrez le fichier local.settings.json et apportez-y la même modification.

4. Pour désactiver l’historique des exécutions lorsque vous avez terminé, soit définissez la propriété Workflows.<workflow-name>.OperationOptions sur None, soit supprimez la propriété et sa valeur.

Ajouter des artefacts et des dépendances à votre projet

Dans des scénarios spécifiques, votre workflow peut inclure des opérations qui nécessitent des dépendances telles que des assemblys ou des artefacts tels que des mappages, des schémas ou des règles. Dans Visual Studio Code, vous pouvez ajouter ces éléments aux dossiers correspondants de votre projet, par exemple :

Élément	Type de fichier	Descriptif
Cartes	.xslt	Pour plus d’informations, consultez Ajouter des mappages pour les transformations dans les flux de travail.
Schémas	.xsd	Pour plus d’informations, consultez Ajouter des schémas pour la validation.
Règles	.xml	Pour plus d’informations, consultez Créer un projet de moteur de règles Azure Logic Apps.
Assemblys	- .dll (.NET Framework ou .NET 8) - .jar (Java)	Une ressource d’application logique standard peut utiliser ou référencer des types spécifiques d’assemblys, que vous pouvez charger dans votre projet dans Visual Studio Code. Toutefois, vous devez les ajouter à des dossiers de projet spécifiques. Pour plus d'informations, voir Ajouter des assemblées référencés. Remarque : si vous disposez d’un projet d’application logique (.NET) NuGet avant que la prise en charge des assemblys ne soit disponible, consultez Migrer des projets basés sur des packages NuGet pour utiliser des assemblys dans le dossier lib.

Convertissez votre projet en un projet NuGet basé sur des packages (.NET)

Par défaut, Visual Studio Code crée votre projet d’application logique en tant que projet basé sur un groupe d’extensions (Node.js). Si vous avez besoin d’un projet basé sur un package NuGet (.NET), par exemple, pour créer vos propres connecteurs intégrés, vous devez convertir votre projet par défaut en projet basé sur un package NuGet (.NET).

Important

Cette action relève d’une opération unidirectionnelle irréversible.

1. Dans le volet Explorateur, déplacez votre pointeur de souris sur n’importe quelle zone vide située sous les dossiers et fichiers de votre projet, ouvrez le menu contextuel, puis sélectionnez Convertir en projet d’application logique basée sur NuGet.

   

2. Lorsque l’invite s’affiche, confirmez la conversion du projet.

Migrer des projets basés sur des packages NuGet pour utiliser des assemblys dans le dossier « lib »

Important

Cette tâche est requise uniquement pour les projets d’application logique basés sur des packages NuGet (.NET) créés avant que la prise en charge des assemblées ne soit disponible.

Si vous avez créé votre projet d’application logique alors que la prise en charge des assemblys n’était pas disponible pour des workflows d’application logique Standard, vous pouvez ajouter les lignes suivantes à votre fichier <nom-projet>.csproj pour travailler avec des projets qui utilisent des assemblys :

  <ItemGroup>
    <LibDirectory Include="$(MSBuildProjectDirectory)\lib\**\*"/>
  </ItemGroup>
  <Target Name="CopyDynamicLibraries" AfterTargets="_GenerateFunctionsExtensionsMetadataPostPublish">
    <Copy SourceFiles="@(LibDirectory)" DestinationFiles="@(LibDirectory->'$(MSBuildProjectDirectory)\$(PublishUrl)\lib\%(RecursiveDir)%(Filename)%(Extension)')"/>
  </Target>

Important

Pour un projet qui s’exécute sur Linux ou macOS, veillez à mettre à jour le séparateur de répertoires. Par exemple, passez en revue l’image suivante qui montre le code précédent ajouté au < fichier project-name.csproj> :

Activer la création de connecteurs intégrés

Vous pouvez créer vos propres connecteurs intégrés pour tous les services dont vous avez besoin à l’aide du framework d’extensibilité Azure Logic Apps monolocataire. Comme pour les connecteurs intégrés tels qu’Azure Service Bus et SQL Server, ces connecteurs offrent un débit plus élevé, une faible latence, une connectivité locale, et s’exécutent en mode natif dans le même processus que le runtime d’Azure Logic Apps monolocataire.

Actuellement, la fonctionnalité de création est uniquement disponible dans Visual Studio Code, mais elle n’est pas activée par défaut. Pour créer ces connecteurs, procédez comme suit :

1. Si vous ne l’avez pas déjà fait, convertissez votre projet basé sur un ensemble d’extensions (Node.js) en projet NuGet basé sur un package (.NET).

2. Passez en revue et suivez les étapes décrites dans l’article Azure Logic Apps s’exécutant n’importe où : Extensibilité de connecteur intégré.

Exécuter, déboguer et tester des flux de travail localement

Les sections suivantes montrent comment définir des points d’arrêt et démarrer une session de débogage pour exécuter et tester votre workflow localement.

Définir des points d’arrêt pour le débogage

Avant d’exécuter et de tester le workflow de votre application logique en démarrant une session de débogage, vous pouvez définir des points d’arrêt dans le fichier workflow.json pour chaque workflow. Aucune autre configuration n’est requise.

Les points d'arrêt ne sont actuellement pris en charge que pour les actions, pas pour les déclencheurs. Chaque définition d’action comporte ces emplacements de point d’arrêt :

• Définissez le point d’arrêt de départ sur la ligne qui indique le nom de l’action. Lorsque ce point d’arrêt est atteint pendant la session de débogage, vous pouvez examiner les entrées de l’action avant qu’elles soient évaluées.

• Définissez le point d’arrêt final sur la ligne qui indique l’accolade fermante de l’action ( } ). Lorsque ce point d’arrêt est atteint pendant la session de débogage, vous pouvez examiner les résultats de l’action avant que l’action se termine.

Pour ajouter un point d’arrêt, procédez comme suit :

1. Ouvrez le fichier workflow.json du workflow que vous souhaitez déboguer.

2. Sélectionnez dans la colonne de gauche la ligne où vous souhaitez définir le point d’arrêt. Pour supprimer le point d’arrêt, sélectionnez-le.

   Lorsque vous démarrez votre session de débogage, la vue Exécution apparaît sur le côté gauche de la fenêtre de code, tandis que la barre d’outils de débogage apparaît en haut.

   Remarque

   Si la vue Exécution ne s’affiche pas automatiquement, appuyez sur Ctrl+Maj+D.

3. Pour passer en revue les informations disponibles lorsqu’un point d’arrêt est atteint, dans la vue Exécution, examinez le volet Variables.

4. Pour continuer l’exécution du workflow, dans la barre d’outils de débogage, sélectionnez Continuer (bouton Lecture).

Vous pouvez ajouter et supprimer des points d’arrêt à tout moment pendant l’exécution du workflow. Toutefois, si vous mettez à jour le fichier workflow.json après le démarrage de l’exécution, les points d’arrêt ne sont pas automatiquement mis à jour. Pour mettre à jour les points d’arrêt, redémarrez l’application logique.

Pour obtenir des informations générales, consultez Points d’arrêt – Visual Studio Code.

Déboguer et tester votre workflow

Pour tester votre flux de travail, procédez comme suit pour exécuter une session de débogage et rechercher l’URL du point de terminaison créé par le déclencheur de requête . Vous avez besoin de cette URL pour pouvoir envoyer ultérieurement une requête à ce point de terminaison.

1. Si vous disposez d’un flux de travail sans état, activez l’historique des exécutions pour le workflow afin de faciliter le débogage.

2. Dans le menu Exécuter , sélectionnez Démarrer le débogage (F5).

   La fenêtre Terminal s’ouvre pour vous permettre d’examiner la session de débogage.

   Remarque

   Si vous obtenez l’erreur « Une erreur existe après l’exécution de preLaunchTask 'generateDebugSymbols' » », consultez la section de résolution des problèmes, Échec du démarrage de la session de débogage.

3. Recherchez maintenant l’URL de rappel pour le point de terminaison créé par le déclencheur de Requête.

   1. Rouvrez le volet Explorateur pour afficher votre projet.

   2. Dans le menu contextuel workflow.json fichier, sélectionnez Vue d’ensemble.

      

   3. Copiez et enregistrez l’URL de rappel, qui ressemble à l’URL suivante pour le déclencheur Lorsqu’une requête HTTP est reçue dans cet exemple :

      http://localhost:7071/api/<workflow-name>/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<shared-access-signature>

      

4. Pour tester l’URL de rappel et déclencher le flux de travail, envoyez une requête HTTP à l’URL, y compris la méthode attendue par le déclencheur, à l’aide de votre outil de requête HTTP et de ses instructions.

   Cet exemple utilise la méthode GET avec l’URL copiée, qui ressemble à l’exemple suivant :

   GET http://localhost:7071/api/Stateful-Workflow/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<shared-access-signature>

   Lorsque le déclencheur est activé, l’exemple de workflow s’exécute et envoie un e-mail qui ressemble à l’exemple suivant :

   

5. Dans Visual Studio Code, revenez à la page de présentation de votre flux de travail. Sous Historique des exécutions, vérifiez l’état de l’exécution du flux de travail.

   Conseil / Astuce

   Si l’état d’exécution ne s’affiche pas, essayez d’actualiser la page de présentation en sélectionnant Actualiser. Une exécution n'a pas lieu pour un déclencheur ignoré en raison de critères non satisfaits ou de l'absence de données.

   

   Le tableau suivant montre les états finaux possibles que chaque exécution de workflow peut avoir et afficher dans Visual Studio Code :

   Statut de l’exécution	Descriptif
   Abandonné	L’exécution s’est arrêtée ou ne s’est pas terminée en raison de problèmes externes, par exemple, une panne système ou un abonnement Azure expiré.
   annulé	L’exécution a été déclenchée et a démarré, mais a reçu une demande d’annulation.
   Échec	Au moins une action de l’exécution a échoué. Aucune action subséquente n’était configurée dans le flux de travail pour gérer l’échec.
   en cours d’exécution	L’exécution a été déclenchée et est en cours, mais cet état peut également apparaître pour une exécution limitée en raison de limites d’action ou du plan de tarification actuel. Conseil : Si vous configurez la journalisation des diagnostics, vous pouvez obtenir des informations sur tous les événements de limitation qui se produisent.
   Réussi	L’exécution a réussi. Si une action a échoué, une action subséquente dans le flux de travail a géré cet échec.
   Délai dépassé	L’exécution a expiré parce qu’elle a dépassé la limite de durée d’exécution qui est contrôlée par le paramètre appelé Rétention de l’historique des exécutions en jours. La durée d’une exécution est calculée en utilisant l’heure de début et la limite de durée d’exécution à cette heure. Remarque : si la durée d’exécution dépasse aussi la limite de rétention de l’historique d’exécutionen cours, qui est également contrôlée par le paramètre de rétention de l’historique d’exécution en jours, l’exécution est effacée de l’historique d’exécution par un travail de nettoyage quotidien. Que l’exécution expire ou se termine, la période de rétention est toujours calculée sur la base de l’heure de début de l’exécution et de la limite de rétention actuelle. Par conséquent, si vous réduisez la limite de durée pour une exécution en cours, l’exécution expire. Toutefois, soit l’exécution reste dans l’historique des exécutions soit elle est effacée de celui-ci selon que la durée de l’exécution a ou non dépassé la limite de rétention.
   En attente	L’exécution n’a pas démarré ou est suspendue, par exemple, en raison d’une instance de flux de travail antérieure qui est toujours en cours d’exécution.

6. Pour afficher l’état, les entrées et les sorties de chaque étape pour une exécution de flux de travail spécifique, choisissez l’une ou l’autre étape :

   • Dans la colonne Identificateur , sélectionnez l’ID d’exécution du flux de travail.

   • À côté de la colonne Durée, ouvrez le menu des points de suspension (...) pour une exécution de workflow et sélectionnez Afficher l'exécution, par exemple :

     

   Visual Studio Code ouvre la vue détails de l’exécution et affiche l’état de chaque étape de l’exécution du flux de travail.

   

   Remarque

   Si une exécution a échoué et qu’une étape dans l’affichage détails de l’exécution affiche l’erreur 400 Demande incorrecte , ce problème peut résulter d’un nom de déclencheur ou d’un nom d’action plus long qui entraîne le dépassement de la limite de caractères par défaut. Pour plus d’informations, consultez « 400 Demande incorrecte ».

   Le tableau suivant montre les états possibles que chaque action de workflow peut avoir et afficher dans Visual Studio Code :

   État d’action	Descriptif
   Abandonné	L’action a été arrêtée ou ne s’est pas terminée en raison de problèmes externes, par exemple, une panne du système ou l’expiration d’un abonnement Azure.
   annulé	L’action était en cours d’exécution mais a reçu une demande d’annulation.
   Échec	L’action a échoué.
   en cours d’exécution	L’action est en cours d’exécution.
   Ignoré	L’action a été ignorée parce qu’elle précède immédiatement l’action qui a échoué. Une action a une condition runAfter qui exige que l’action précédente se termine correctement avant que l’action en cours puisse s’exécuter.
   Réussi	L’action a réussi.
   Réussie avec de nouvelles tentatives	L’action a réussi, mais uniquement après une ou plusieurs tentatives. Pour consulter l’historique des tentatives, dans la vue des détails de l’historique des exécutions, sélectionnez cette action afin de voir les entrées et sorties.
   Délai dépassé	L’action a été arrêtée en raison du délai d’expiration spécifié par les paramètres de cette action.
   En attente	S’applique à une action de webhook qui attend une demande entrante d’un appelant.

7. Pour afficher les entrées et sorties de chaque étape, sélectionnez l’étape souhaitée, par exemple :

   

   Pour afficher les entrées et sorties brutes, sélectionnez Afficher les entrées brutes ou Afficher les sorties brutes.

8. Pour arrêter la session de débogage, dans le menu Exécuter, sélectionnez Arrêter le débogage (Maj + F5).

Retourner une réponse

Lorsque vous disposez d’un flux de travail qui commence par le déclencheur Lors de la réception d’une requête HTTP , votre flux de travail peut renvoyer une réponse à l’appelant qui a envoyé la requête initiale à l’aide de l’action de requête nommée Réponse.

1. Dans le concepteur de flux de travail, sous l’action Envoyer un e-mail , suivez ces étapes générales pour ajouter l’action de demande nommée Réponse.

   

2. Dans le volet d’informations de l’action Réponse , sous l’onglet Paramètres , fournissez les informations requises pour la réponse à l’appelant.

   Cet exemple retourne la valeur du paramètre Corps qui est la sortie de l’action Envoyer un e-mail.

   1. Pour le paramètre Corps, sélectionnez l’intérieur de la zone d’édition, puis sélectionnez l’icône d’éclair, ce qui ouvre la liste de contenu dynamique. La liste indique les valeurs de sortie disponibles à partir des actions et du déclencheur précédents dans le workflow.

   2. Dans la liste contenu dynamique, sous Envoyer un e-mail, sélectionnez Corps.

      

      Lorsque vous avez terminé, la propriété Corps de l'action Réponse est maintenant définie sur la valeur de sortie du Corps de l'action Envoyer un e-mail, par exemple :

      

3. Enregistrez votre flux de travail.

Retester votre flux de travail

Pour tester vos mises à jour, vous pouvez réexécuter le débogueur et envoyer une autre requête qui déclenche votre flux de travail, similaire aux étapes d’exécution, de débogage et de test localement.

1. Dans la barre d’outils de Visual Studio Code, dans le menu Exécuter , puis sélectionnez Démarrer le débogage (F5).

2. Dans votre outil de création et d’envoi de demandes, envoyez une autre demande pour déclencher votre flux de travail.

3. Dans la page vue d’ensemble du flux de travail, sous Historique des exécutions, vérifiez l’état de l’exécution la plus récente et ouvrez la vue détails de l’exécution.

   Par exemple, voici l’état pas à pas d’une exécution après la mise à jour de l’exemple de flux de travail avec l’action Réponse .

   

4. Pour arrêter la session de débogage, dans le menu Exécuter, sélectionnez Arrêter le débogage (Maj + F5).

Préparer le déploiement

Avant de déployer votre application logique Standard sur le portail Azure, passez en revue cette section pour toute préparation que vous devrez peut-être effectuer.

Configurer l’accès au pare-feu

Si votre environnement a des exigences réseau strictes ou des pare-feu qui limitent le trafic, vous devez configurer des autorisations pour toutes les connexions créées par les connecteurs managés, hébergés et partagés Azure et utilisées dans votre flux de travail.

Pour rechercher les noms de domaine complets (FQDN) de ces connexions, procédez comme suit :

1. Dans votre projet d’application logique, ouvrez le fichier local.settings.json .

2. Pour chaque connexion que vous avez créée, recherchez la propriété nommée <connection-name>-ConnectionRuntimeUrl, qui utilise la syntaxe suivante :

   "<connection-name>-ConnectionRuntimeUrl": <connection-runtime-URL>

   Par exemple, supposons que vous disposez d’un exemple de fichierlocal.settings.json qui contient ces connexions : une connexion Office 365 et une connexion AS2. Ces connexions utilisent les exemples de valeurs suivants pour les <connection-name>-ConnectionRuntimeUrl propriétés :

   • Office 365 : "office365-ConnectionRuntimeUrl": https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/office365/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1"

   • AS2 : "as2-ConnectionRuntimeUrl": https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/as2/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2

   L’exemple de fichierlocal.settings.json ressemble à la version suivante :

   {
      "IsEncrypted": false,
      "Values": {
         "AzureWebJobsStorage": "UseDevelopmentStorage=true",
         "FUNCTIONS_WORKER_RUNTIME": "node",
         "APP_KIND": "workflowapp",
         "ProjectDirectoryPath": "c:\\Users\\<local-username>\\Desktop\\Visual Studio Code projects\\Azure Logic Apps\fabrikam-workflows\\Fabrikam-Workflows\\Fabrikam-Workflows",
         "WORKFLOWS_TENANT_ID": "<Microsoft-Entra-tenant-ID>",
         "WORKFLOWS_SUBSCRIPTION_ID": "<Azure-subscription-ID>",
         "WORKFLOWS_RESOURCE_GROUP_NAME": "Fabrikam-Workflows-RG",
         "WORKFLOWS_LOCATION_NAME": "westcentralus",
         "WORKFLOWS_MANAGEMENT_BASE_URI": "https://management.azure.com/",
         "as2-connectionKey": "<connection-key>",
         "as2-ConnectionRuntimeUrl": "https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/as2/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2",
         "office365-connectionKey": "<connection-key>",
         "office365-ConnectionRuntimeUrl": "https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/office365/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
      }
   }
   

3. Copiez et enregistrez ces URL d’exécution de connexion quelque part en toute sécurité afin de pouvoir configurer votre pare-feu avec ces informations.

4. Lorsque vous êtes prêt, configurez votre pare-feu à l’aide des URL enregistrées. Pour plus d’informations, consultez la documentation suivante :

   • Vue d’ensemble de la stratégie Azure Firewall Manager
   • Déployez et configurez le Pare-feu Azure à l’aide du portail Azure - Classic.

Déployer sur Azure

Pour déployer votre application logique Standard à partir de Visual Studio Code, vous pouvez publier directement votre projet sur Azure. Vous pouvez publier votre application logique en tant que nouvelle ressource, ce qui crée automatiquement toutes les ressources requises, telles qu’un compte de stockage Azure, comme les exigences de l’application de fonction. Vous pouvez également publier votre application logique sur une ressource d’application logique standard précédemment déployée, qui remplace la version déployée.

Le déploiement de la ressource d’application logique standard nécessite un plan d’hébergement et un niveau tarifaire, que vous sélectionnez pendant le déploiement. Pour plus d’informations, consultez Plans d’hébergement et niveaux tarifaires.

Publier sur une nouvelle ressource d’application logique standard

1. Dans le volet Explorateur, déplacez le pointeur de la souris sur n’importe quelle zone vide située sous les dossiers et fichiers de votre projet, ouvrez le menu contextuel, puis sélectionnez Déployer sur une application logique.

   Bien que vous n’ayez pas besoin de disposer de fichiers ouverts pour le déploiement, assurez-vous que vous avez enregistré tout ce que vous envisagez de déployer.

   

   Vous êtes invité à utiliser les options suivantes pour la ressource d’application logique standard de destination. Vous pouvez créer une application logique standard ou sélectionner une application logique standard déployée existante dans Azure :

   • Créer une application logique (standard) dans Azure (rapide)
   • Créer une application logique (standard) dans Advanced Azure
   • Sélectionnez les ressources d’application logique standard précédemment déployées, le cas échéant.

2. Pour les options de déploiement, sélectionnez s’il faut créer ou utiliser une ressource d’application logique de destination existante.

   Nous poursuivons cet exemple avec l’option Créer une ressource Application logique (standard) dans Azure Advanced.

   

3. Procédez comme suit pour créer la ressource d’application logique de destination :

   1. Entrez un nom global unique pour l’application logique de destination.

      Cet exemple utilise Fabrikam-Workflows-App.

      

   2. Pour l’emplacement où déployer, sélectionnez la région Azure.

      Cet exemple utilise la région USA Centre-Ouest.

   3. Pour le plan d’hébergement, choisissez parmi les options suivantes :

      Plan d’hébergement	Descriptif
      Workflow Standard	Déployez en tant que nouvelle ressource d'application logique standard hébergée dans Azure Logic Apps à locataire unique.
      Hybride	Déployez en tant qu’application logique standard hébergée sur votre propre infrastructure. Remarque : Avant de sélectionner cette option, vérifiez que vous avez configuré l’infrastructure nécessaire. Pour plus d’informations, consultez Configurer votre propre infrastructure pour les applications logiques Standard à l’aide d’un déploiement hybride.

   4. Pour le plan Windows App Service, choisissez l’une des options suivantes :

      • Créer un nouveau plan App Service
      • Sélectionnez les plans App Service existants dans la région Azure sélectionnée (plans Basés sur Windows uniquement), le cas échéant.

      Cet exemple sélectionne Créer un nouveau plan App Service.

   5. Pour le nouveau plan, fournissez un nom global unique et sélectionnez un niveau tarifaire.

      Cet exemple utilise Fabrikam-Workflows-App-Service-Plan et sélectionne le niveau WS1 Workflow Standard .

      Pour plus d’informations, consultez Plans d’hébergement et niveaux tarifaires.

   6. Pour le groupe de ressources Azure de destination, sélectionnez le même groupe de ressources que votre projet pour obtenir des performances optimales.

      Cet exemple utilise le même groupe créé précédemment nommé Fabrikam-Workflows-RG.

      Remarque

      Bien que vous puissiez créer ou utiliser un groupe de ressources différent, cela peut affecter les performances. Si vous créez ou choisissez un groupe de ressources différent, mais annulez l’opération après l’affichage de l’invite de confirmation, votre déploiement est également annulé.

   7. Pour que le compte de stockage Azure utilise des flux de travail qui permettent d’enregistrer les informations d’historique des exécutions, choisissez parmi les options suivantes :

      • Créer un compte de stockage
      • Sélectionnez les comptes de stockage Azure existants, le cas échéant.

      Cet exemple montre comment sélectionner Créer un compte de stockage.

   8. Entrez un nom global unique pour le compte de stockage. Vous ne pouvez utiliser que des lettres minuscules et des chiffres.

      Cet exemple utilise fabrikamstorageaccount< numéro>.

   9. Pour l’option d’utilisation du stockage SQL dans cet exemple, sélectionnez Non.

      Si vous avez déjà configuré une base de données SQL à utiliser pour le stockage en suivant configurer le stockage de base de données SQL pour les flux de travail d’application logique standard, vous pouvez sélectionner Oui.

   10. Pour la ressource Application Insights, qui active la journalisation et le suivi des diagnostics pour votre application logique, choisissez parmi les options suivantes :

       • Créer une ressource Application Insights
       • Ignorez pour l’instant. Vous pouvez configurer Application Insights après le déploiement.
       • Sélectionnez une ressource Application Insights existante, le cas échéant.

       Cet exemple montre comment sélectionner Skip pour le moment.

       Remarque

       • Si vous disposez d’une ressource Application Insights que vous souhaitez utiliser, vous pouvez sélectionner cette ressource.

       • Pour créer une ressource Application Insights à ce stade afin d’activer la journalisation et le suivi des diagnostics, consultez Activer Application Insights pendant le déploiement.

       Pour plus d’informations sur Application Insights, consultez la documentation suivante :

       • Vue d’ensemble d’Application Insights
       • Créer et configurer des ressources Application Insights

       Après avoir sélectionné Skip pour l’instant ou une ressource Application Insights existante, Visual Studio Code affiche un message de confirmation pour démarrer le déploiement. Le message recommande également que pour les meilleures performances, placez les ressources de connexion pour les opérations managées dans le même groupe de ressources que votre ressource d’application logique et vos flux de travail. Dans Azure Logic Apps, les connexions d’opération managée existent en tant que ressources Azure individuelles.

       

4. Lorsque vous êtes prêt à déployer, dans le message de confirmation, sélectionnez Déployer.

   Visual Studio Code commence à créer et déployer les ressources nécessaires pour publier votre application logique sur Azure.

5. Pour afficher et surveiller le processus de déploiement, dans le menu Affichage , sélectionnez Sortie.

6. Dans la barre d’outils de la fenêtre Sortie, dans la liste d’étendues, sélectionnez Azure Logic Apps (Standard).

   

   Lorsque Visual Studio Code termine le déploiement de votre application logique sur Azure, un message s’affiche :

   

   Vos ressources et flux de travail d’application logique sont désormais en direct, activés et en cours d’exécution dans Azure.

Activer Application Insights pendant le déploiement

Pour activer la journalisation et le suivi des diagnostics avec Application Insights pendant le déploiement de votre application logique, procédez comme suit :

1. Sélectionnez une ressource Application Insights existante ou créez une ressource Application Insights.

2. Dans le portail Azure, accédez à la ressource Application Insights.

3. Dans le menu des ressources, sélectionnez Vue d’ensemble. Recherchez et copiez la valeur de Clé d’instrumentation.

4. Dans Visual Studio Code, dans le dossier racine de votre projet, ouvrez le fichier local.settings.json.

   1. Dans l’objet Values, ajoutez la propriété APPINSIGHTS_INSTRUMENTATIONKEY et définissez la valeur sur la clé d’instrumentation, par exemple :

      {
         "IsEncrypted": false,
         "Values": {
            "AzureWebJobsStorage": "UseDevelopmentStorage=true",
            "FUNCTIONS_WORKER_RUNTIME": "dotnet",
            "APPINSIGHTS_INSTRUMENTATIONKEY": <instrumentation-key>
         }
      }
      

   2. Vérifiez si les noms de déclencheur et d’action de flux de travail s’affichent correctement dans votre instance Application Insights.

      1. Dans le portail Azure, accédez à la ressource Application Insights.

      2. Dans le menu de la ressource, sous Examiner, sélectionnez Cartographie d’application.

      3. Examinez les noms des opérations qui apparaissent dans la cartographie.

         Certaines demandes entrantes provenant de déclencheurs intégrés peuvent apparaître en doublons dans la cartographie d’application. Au lieu d’utiliser le format WorkflowName.ActionName, ces doublons utilisent le nom du workflow comme nom d’opération et proviennent de l’hôte Azure Functions.

   3. Si vous le souhaitez, ajustez le niveau de gravité des données de suivi que votre application logique collecte et envoie à votre instance Application Insights.

      Chaque fois qu’un événement relatif au workflow se produit, par exemple lorsqu’un workflow est déclenché ou qu’une action est exécutée, le runtime émet plusieurs traces. Ces traces couvrent la durée de vie du workflow et incluent notamment les types d’événements suivants :

      • Activité relative au service, telle que le démarrage, l’arrêt et les erreurs.
      • Activité aux travaux et au répartiteur.
      • Activité relative au workflow, telle qu’un déclencheur, une action et une exécution.
      • Activité relative à une demande de stockage, comme la réussite ou l’échec.
      • Activité relative à une requête HTTP, par exemple : entrante, sortante, réussite et échec.
      • Toutes les traces de développement, comme les messages de débogage.

      Un niveau de gravité est attribué à chaque type d’événement. Par exemple, le niveau Trace capture les messages les plus détaillés, tandis que le niveau Information capture l’activité générale dans votre workflow, par exemple lorsque une application logique, un workflow, un déclencheur et des actions démarrent et s’arrêtent.

      Le tableau suivant décrit les niveaux de gravité et leurs types de trace :

      Niveau de gravité	Type de trace
      Critique	Journaux décrivant une défaillance irrécupérable dans le flux de travail de votre application logique.
      Déboguer	Journaux que vous pouvez utiliser pour examen pendant le développement, par exemple les appels HTTP entrants et sortants.
      Erreur	Journaux qui indiquent un échec dans l’exécution du workflow, mais pas un échec général de votre application logique.
      Information	Journaux qui effectuent le suivi de l’activité générale dans votre application logique ou dans votre workflow, par exemple : – Quand un déclencheur, une action ou une exécution démarre et se termine. – Lorsque votre application logique démarre ou se termine.
      Trace	Journaux qui contiennent les messages les plus détaillés, par exemple, les demandes de stockage ou l’activité relative au répartiteur, ainsi que tous les messages liés à l’activité d’exécution du workflow.
      Avertissement	Journaux qui mettent en évidence un état anormal dans votre application logique, mais qui n’empêche pas son exécution.

      Pour définir le niveau de gravité, à la racine de votre projet, ouvrez le fichier host.json et recherchez l’objet logging. Cet objet contrôle le filtrage des journaux pour tous les workflows de votre application logique et suit le layout d’ASP.NET Core pour le filtrage du type de journal.

      {
         "version": "2.0",
         "logging": {
            "applicationInsights": {
               "samplingExcludedTypes": "Request",
               "samplingSettings": {
                  "isEnabled": true
               }
            }
         }
      }
      

      Si l’objet logging ne contient pas d’objet logLevel incluant la propriété Host.Triggers.Workflow, ajoutez ces éléments. Définissez la propriété sur le niveau de gravité du type de trace que vous souhaitez, par exemple :

      {
         "version": "2.0",
         "logging": {
            "applicationInsights": {
               "samplingExcludedTypes": "Request",
               "samplingSettings": {
                  "isEnabled": true
               }
            },
            "logLevel": {
               "Host.Triggers.Workflow": "Information"
            }
         }
      }
      

Tâches post-déploiement

Les sections suivantes décrivent les tâches à effectuer une fois que votre application logique a terminé le déploiement.

Confirmer le déploiement dans le portail Azure

Après avoir déployé votre application logique à partir de Visual Studio Code sur le portail Azure, vérifiez que votre application logique apparaît dans le portail. Les ressources Azure sont organisées et regroupées dans le portail en fonction de leur type de ressource. Pour rechercher les applications logiques Standard, procédez comme suit :

1. Connectez-vous au portail Azure avec votre compte Azure.

2. Dans la zone de recherche de titre Azure, entrez le nom de votre application logique, qui doit apparaître comme résultat dans la section Ressources . Sélectionnez votre application logique pour ouvrir la ressource.

   

3. Dans le menu de l’application logique, sous Workflows, sélectionnez Workflows.

4. Dans la page Flux de travail , sélectionnez votre flux de travail.

5. Dans le menu flux de travail, sous Outils, sélectionnez Concepteur. Vérifiez que le flux de travail s’affiche comme prévu.

   

   Vous pouvez maintenant apporter des modifications à ce flux de travail dans le portail Azure.

6. Veillez à activer l’expérience de supervision pour votre application logique déployée afin de pouvoir afficher l’historique des exécutions de flux de travail, les entrées, les sorties et d’autres informations connexes.

Activer l’expérience de supervision pour l’application logique déployée

Avant de pouvoir passer en revue l’historique des exécutions de flux de travail, les entrées, les sorties et les informations associées pour une ressource d’application logique standard déployée avec l’expérience de supervision dans le portail Azure, vous devez d’abord activer cette expérience sur la ressource d’application logique.

1. Dans le portail Azure, ouvrez la ressource d’application logique standard déployée.

2. Dans le menu des ressources, sous API, sélectionnez CORS.

3. Dans le volet CORS, sous Origines autorisées, ajoutez le caractère générique (*).

4. Lorsque c’est chose faite, dans la barre d’outils CORS, sélectionnez Enregistrer.

   

Activer ou ouvrir Application Insights après le déploiement

Pendant l’exécution du flux de travail, votre flux de travail d’application logique émet des données de télémétrie ainsi que d’autres événements. Vous pouvez utiliser cette télémétrie pour obtenir une meilleure visibilité sur le fonctionnement de votre flux de travail et le fonctionnement du runtime Azure Logic Apps. Application Insights vous permet d’activer la journalisation, le suivi et la surveillance des diagnostics pour votre application logique à l’aide de données de télémétrie en temps quasi réel (métriques actives). Cette fonctionnalité vous permet d’examiner plus facilement les échecs et les problèmes de performances lorsque vous utilisez les données de télémétrie pour diagnostiquer les problèmes, configurer des alertes et créer des graphiques.

• Si vous n’avez pas déjà configuré Application Insights, vous pouvez activer cette fonctionnalité dans le portail Azure après le déploiement d’applications logiques à partir de Visual Studio Code. Vous devez disposer d’une ressource Application Insights dans Azure, mais vous pouvez créer cette ressource séparément à l’avance ou lorsque vous activez cette fonctionnalité après le déploiement.

• Si vous avez précédemment configuré Application Insights pendant le déploiement à partir de Visual Studio Code, vous pouvez simplement ouvrir votre ressource Application Insights à partir de votre application logique dans le portail Azure.

Activer Application Insights pour une application logique déployée

1. Dans le portail Azure, recherchez et ouvrez votre application logique déployée.

2. Dans le menu de l’application logique, sous Surveillance, sélectionnez Application Insights.

3. Dans la page Application Insights , sélectionnez Activer Application Insights.

4. Une fois la page Application Insights mise à jour, dans la section Modifier votre ressource , sélectionnez les options suivantes :

   • Créer une ressource

     Azure crée des ressources pour Application Insights et un espace de travail Log Analytics à l’aide de l’abonnement et du groupe de ressources actuels. Si vous souhaitez utiliser un autre abonnement et un groupe de ressources, consultez Créer une ressource Application Insights, puis revenez à cette page.

     Propriété	Descriptif
     Nouveau nom de la ressource	Acceptez le nom généré ou fournissez un autre nom.
     Lieu	Sélectionnez une région Azure dans le champ Region (Région).
     Espace de travail Log Analytics	Sélectionnez un espace de travail existant, le cas échéant. Sinon, un espace de travail par défaut est créé pour vous. Pour plus d’informations, consultez Vue d’ensemble de l’espace de travail Log Analytics.

   • Sélectionnez une ressource existante :

     1. Sélectionnez l’abonnement Azure pour votre ressource Application Insights.

     2. Sélectionnez votre ressource Application Insights

5. Lorsque vous avez terminé, en bas de la page, sélectionnez Appliquer.

Ouvrir Application Insights à partir de votre application logique

1. Dans le portail Azure, recherchez et ouvrez votre application logique déployée.

2. Dans le menu de l’application logique, sous Surveillance, sélectionnez Application Insights.

3. Dans la page Application Insights , sélectionnez le lien de votre ressource Application Insights.

Après l’ouverture d’Application Insights, vous pouvez passer en revue les différentes métriques de votre application logique. Pour plus d’informations, consultez les articles suivants :

• Azure Logic Apps s’exécutant partout – Superviser avec Application Insights (première partie)
• Azure Logic Apps s’exécutant partout – Superviser avec Application Insights (deuxième partie)

Résoudre les erreurs et les problèmes

Échec de l’ouverture du concepteur

Quand vous essayez d’ouvrir le concepteur, vous recevez cette erreur : « Impossible de démarrer le design-time du workflow » . Si vous avez déjà essayé d’ouvrir le concepteur, mais que vous avez abandonné ou supprimé votre projet, le package d’extensions pourrait ne pas se télécharger correctement. Pour vérifier si cette raison est la cause, procédez comme suit :

1. Dans Visual Studio Code, ouvrez la fenêtre Sortie. Dans le menu Affichage, sélectionnez Sortie.

2. Dans la liste de la barre de titre de la fenêtre Sortie, sélectionnez Azure Logic Apps (standard) pour pouvoir consulter la sortie de l’extension, par exemple :

   

3. Examinez la sortie et vérifiez si ce message d’erreur s’affiche :

   A host error has occurred during startup operation '<operation-ID>'.
   System.Private.CoreLib: The file 'C:\Users\<user-name>\AppData\Local\Temp\Functions\
   ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows\1.1.7\bin\
   DurableTask.AzureStorage.dll' already exists.
   Value cannot be null. (Parameter 'provider')
   Application is shutting down...
   Initialization cancellation requested by runtime.
   Stopping host...
   Host shutdown completed.
   

Pour résoudre cette erreur, supprimez le dossier ExtensionBundles à cet emplacement ...\Users\<user-name>\AppData\Local\Temp\Functions\ExtensionBundles, puis réessayez d’ouvrir le fichier workflow.json dans le concepteur.

De nouveaux déclencheurs et actions sont absents du sélecteur de concepteur pour les workflows créés précédemment

Le service Azure Logic Apps monolocataire prend en charge les actions intégrées pour Azure Function Operations, Liquid Operations et XML Operations, telles que Validation XML et Transformer au format XML. Toutefois, pour les applications logiques créées précédemment, ces actions peuvent ne pas apparaître dans le sélecteur de concepteur pour vous indiquer si Visual Studio Code utilise une version obsolète du pack d’extension, Microsoft.Azure.Functions.ExtensionBundle.Workflows.

En outre, le connecteur Azure Function Operations et les actions n’apparaissent pas dans le sélecteur de concepteur, sauf si vous avez activé ou sélectionné Utiliser les connecteurs d’Azure quand vous avez créé votre application logique. Si vous n’avez pas activé les connecteurs déployés par Azure au moment de la création de l’application, vous pouvez les activer à partir de votre projet dans Visual Studio Code. Ouvrez le menu contextuel workflow.json, puis sélectionnez Utiliser les connecteurs d’Azure.

Pour corriger le pack obsolète, supprimez la version obsolète en procédant comme suit, ce qui fait que Visual Studio Code met automatiquement à jour le pack d’extension vers la version la plus récente.

Remarque

Cette solution s’applique uniquement aux applications logiques que vous créez et déployez à l’aide de Visual Studio Code avec l’extension Azure Logic Apps (Standard), et non les applications logiques que vous créez à l’aide du portail Azure. Voir Des déclencheurs et actions pris en charge sont absents du concepteur dans le portail Azure.

1. Enregistrez tout travail que vous ne souhaitez pas perdre et fermez Visual Studio Code.

2. Sur votre ordinateur, accédez au dossier suivant, qui contient les dossiers de version du pack existant :

   ...\Users\<user-name>\.azure-functions-core-tools\Functions\ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows

3. Supprimez le dossier de version du pack précédent. Par exemple, si vous avez un dossier pour la version 1.1.3, supprimez-le.

4. À présent, accédez au dossier suivant, qui contient les dossiers de version du package NuGet requis :

   ...\Users\<user-name>\.nuget\packages\microsoft.azure.workflows.webjobs.extension

5. Supprimez le dossier de version pour le package existant.

6. Rouvrez Visual Studio Code, votre projet et le fichier workflow.json dans le concepteur.

Les déclencheurs et les actions manquants s’affichent désormais dans le concepteur.

« 400 Demande incorrecte » apparaît sur un déclencheur ou une action

Lorsqu’une exécution échoue et que vous l’examinez dans l’affichage d’analyse, cette erreur peut apparaître avec un déclencheur ou une action dont le nom est plus long, ce qui entraîne le dépassement de la limite de caractères par défaut de la valeur Uniform Resource Identifier (URI) sous-jacente.

Pour résoudre ce problème et ajuster l'URI plus long, modifiez les clés de registre UrlSegmentMaxCount et UrlSegmentMaxLength sur votre ordinateur en suivant ces étapes. Ces valeurs par défaut de clé sont décrites dans cet article ,Http.sys paramètres de Registre pour Windows.

Important

Avant de commencer, vérifiez que vous avez enregistré votre travail. Cette solution nécessite de redémarrer votre ordinateur une fois que vous avez terminé afin d’appliquer les modifications.

1. Sur votre ordinateur, ouvrez la fenêtre Exécuter, puis exécutez la commande regedit, qui ouvre l’éditeur du Registre.

2. Dans la zone Contrôle de compte d'utilisateur, sélectionnez Oui pour autoriser les modifications sur votre ordinateur.

3. Dans le volet gauche, sous Ordinateur, développez les nœuds du chemin d’accès, HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HTTP\Parameters, puis sélectionnez Paramètres.

4. Dans le volet droit, recherchez les clés de Registre UrlSegmentMaxCount et UrlSegmentMaxLength.

5. Augmentez suffisamment ces valeurs de clé pour que les URI puissent prendre en charge les noms que vous souhaitez utiliser. Si ces clés n’existent pas, ajoutez-les au dossier Parameters en procédant comme suit :

   1. Dans le menu contextuel Paramètres, sélectionnez Nouveau>Valeur DWORD 32 bits.

   2. Dans la zone d’édition qui apparaît, entrez UrlSegmentMaxCount comme nom de la nouvelle clé.

   3. Ouvrez le menu contextuel de la nouvelle clé, puis sélectionnez Modifier.

   4. Dans la zone Modification de la chaîne qui apparaît, entrez la valeur de clé Données de la valeur souhaitée au format hexadécimal ou décimal. Par exemple, 400 au format hexadécimal équivaut à 1024 au format décimal.

   5. Pour ajouter la valeur de clé UrlSegmentMaxLength, répétez ces étapes.

   Une fois que vous avez augmenté ou ajouté ces valeurs de clés, l’éditeur du Registre se présente comme suit :

   

6. Lorsque vous êtes prêt, redémarrez votre ordinateur pour appliquer les modifications.

Échec du démarrage de la session de débogage

Quand vous essayez de démarrer une session de débogage, vous recevez l’erreur : « Une erreur existe après l’exécution de preLaunchTask 'generateDebugSymbols' » . Pour résoudre ce problème, modifiez le fichier tasks.json dans votre projet pour ignorer la génération de symboles.

1. Dans votre projet, développez le dossier.vscode** et ouvrez le fichier tasks.json .

2. Dans la tâche suivante, supprimez la ligne, "dependsOn: "generateDebugSymbols", ainsi que la virgule qui termine la ligne précédente, par exemple :

   Avant:

    {
      "type": "func",
      "command": "host start",
      "problemMatcher": "$func-watch",
      "isBackground": true,
      "dependsOn": "generateDebugSymbols"
    }
   

   Après :

    {
      "type": "func",
      "command": "host start",
      "problemMatcher": "$func-watch",
      "isBackground": true
    }
   

Contenu connexe

• Comparaison entre les modèles monolocataire et multilocataire dans Azure Logic Apps
• Gérer les applications logiques dans Visual Studio Code