Créer et gérer des comptes d’intégration pour des flux de travail B2B dans Azure Logic Apps à l’aide d’Enterprise Integration Pack

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

Avant de pouvoir générer des flux de travail d’intégration B2B et d’entreprise à l’aide d’Azure Logic Apps, vous devez créer une ressource compte d’intégration. Ce compte est un conteneur cloud évolutif dans Azure, qui simplifie le stockage et la gestion des artefacts B2B que vous définissez et utilisez dans vos flux de travail pour les scénarios B2B, par exemple :

• Partenaires commerciaux
• Contrats
• Maps
• Schémas
• Certificats

Vous avez également besoin d’un compte d’intégration pour échanger par voie électronique des messages B2B avec d’autres organisations. Lorsque d’autres organisations utilisent des protocoles et des formats de message différents de ceux de votre organisation, vous devez convertir ces formats de façon à ce que le système de votre organisation puisse traiter ces messages. Avec Azure Logic Apps, vous pouvez créer des flux de travail qui prennent en charge les protocoles standard suivants :

• AS2
• EDIFACT
• RosettaNet
• X 12

Cet article explique comment accomplir les tâches suivantes :

• Créer un compte d’intégration.
• Lier votre compte d’intégration à une ressource d’application logique.
• Modifiez le niveau tarifaire de votre compte d’intégration.
• Dissocier votre compte d’intégration d’une ressource d’application logique.
• Déplacer un compte d’intégration vers un autre groupe de ressources ou abonnement Azure.
• Supprimer un compte d’intégration.

Notes

Si vous utilisez un environnement de service d’intégration (ISE) et que vous devez créer un compte d’intégration à utiliser avec cet ISE, consultez Créer des comptes d’intégration dans un environnement ISE.

Si vous débutez dans la création de flux de travail d’intégration d’entreprise B2B dans Azure Logic Apps, consultez la documentation suivante :

• Qu’est-ce qu’Azure Logic Apps
• Workflows d’intégration d’entreprise B2B avec Azure Logic Apps et Enterprise Integration Pack

Prérequis

• Un compte et un abonnement Azure. Si vous n’avez pas d’abonnement Azure, inscrivez-vous pour bénéficier d’un compte Azure gratuit. Veillez à utiliser le même abonnement Azure pour votre compte d’intégration et votre ressource d’application logique.

• Que vous travailliez sur un flux de travail d’application logique Consommation ou Standard, votre ressource d’application logique doit déjà exister pour que vous puissiez lier votre compte d’intégration.

  • Pour les ressources d’application logique Consommation, ce lien est requis pour que vous puissiez utiliser les artefacts de votre compte d’intégration avec votre flux de travail. Bien que vous puissiez créer vos artefacts sans ce lien, celui-ci est requis lorsque vous êtes prêt à utiliser ces artefacts.

  • Pour les ressources d’application logique Standard, ce lien est facultatif, en fonction de votre scénario :

    • Si vous disposez d’un compte d’intégration avec les artefacts dont vous avez besoin ou que vous souhaitez utiliser, vous pouvez lier le compte d’intégration à chaque ressource d’application logique Standard dans laquelle vous souhaitez utiliser les artefacts.

    • Certains connecteurs de compte d’intégration hébergés par Azure, tels que AS2, EDIFACT et X12, vous permettent de créer une connexion à votre compte d’intégration. Si vous ne faites qu’utiliser ces connecteurs, vous n’avez pas besoin du lien.

    • Les connecteurs intégrés nommés Liquid et Flat File vous permettent de sélectionner des mappages et des schémas que vous avez précédemment chargés dans votre ressource d’application logique ou dans un compte d’intégration lié.

      Si vous n’avez pas ou n’avez pas besoin de compte d’intégration, vous pouvez utiliser l’option de chargement. Sinon, vous pouvez utiliser l’option de liaison, ce qui signifie également que vous n’avez pas besoin de charger des mappages et des schémas sur chaque ressource d’application logique. Quoi qu’il en soit, vous pouvez utiliser ces artefacts dans tous les flux de travail enfants au sein de la même ressource d’application logique.

• Connaissances de base en création de flux de travail d’applications logiques. Pour plus d’informations, consultez la documentation suivante :

  • Démarrage rapide : créer un exemple de workflow d'application logique Consommation dans Azure Logic Apps multilocataires

  • Créer un exemple de workflow d’application logique Standard dans Azure Logic Apps à locataire unique

Créer un compte d’intégration

Des comptes d’intégration sont disponibles dans différents niveaux dont la tarification varie. Selon le niveau que vous choisissez, la création d’un compte d’intégration peut occasionner des coûts. Pour plus d’informations, consultez Modèles de tarification et de facturation d’Azure Logic Apps et Tarification d’Azure Logic Apps.

En fonction de vos besoins et scénarios, déterminez le niveau de compte d’intégration approprié à créer. Le tableau suivant décrit les niveaux disponibles :

Niveau	Description
De base	Pour les scénarios où vous souhaitez utiliser la gestion des messages ou agir en tant que petite entreprise partenaire ayant une relation de partenariat commercial avec une entité professionnelle plus importante. Pris en charge par le contrat SLA Azure Logic Apps.
Standard	Pour les scénarios où vous avez des relations B2B plus complexes et un nombre croissant d’entités que vous devez gérer. Pris en charge par le contrat SLA Azure Logic Apps.
Gratuit	Pour les scénarios exploratoires, et non pour les scénarios de production. Ce niveau de service est limité quant à la disponibilité, au débit et à l’utilisation des régions. Par exemple, le niveau Gratuit est disponible uniquement pour les régions publiques dans Azure, par exemple, USA Ouest et Asie Sud-Est, mais pas pour Azure China 21Vianet ni Azure Government. Remarque : non pris en charge par le contrat SLA Azure Logic Apps.

Pour cette tâche, vous pouvez utiliser le portail Azure, Azure CLI ou Azure PowerShell.

Important

Pour pouvoir lier et utiliser correctement votre compte d’intégration avec votre application logique, assurez-vous que les deux ressources existent dans le même abonnement Azure et la même région Azure.

Portail

1. Dans le portail Azure connectez-vous avec les informations d’identification de votre compte Azure.

2. Dans la zone de recherche du portail Azure, entrez integration accounts, puis sélectionnez Integration accounts.

3. Sous Comptes d’intégration, sélectionnez Créer.

4. Dans le volet Créer un compte d’intégration, fournissez les informations suivantes sur votre compte d’intégration :

   Propriété	Obligatoire	Valeur	Description
   Abonnement	Oui	<Azure-subscription-name>	Nom de votre abonnement Azure.
   Groupe de ressources	Oui	<nom-groupe-de-ressources-Azure>	Le nom du groupe de ressources Azure à utiliser pour organiser les ressources connexes. Pour cet exemple, créez un nouveau groupe de ressources nommé FabrikamIntegration-RG.
   Nom de compte d’intégration	Oui	<integration-account-name>	Nom de votre compte d’intégration, qui peut contenir uniquement des lettres, des chiffres, des traits d’union (-) des traits de soulignement (_), des parenthèses (()) et des points (.). Cet exemple utilise Fabrikam-Integration.
   Région	Oui	<Azure-region>	Région Azure dans laquelle stocker les métadonnées de votre compte d’intégration. Sélectionnez l’emplacement de votre ressource d’application logique ou créez vos applications logiques au même emplacement que votre compte d’intégration. Pour cet exemple, utilisez USA Ouest. Remarque: pour créer un compte d’intégration à l’intérieur d’un environnement de service d’intégration (ISE), sélectionnez Associer à l’environnement de service d’intégration, puis choisissez votre ISE comme emplacement. Pour plus d’informations, consultez Créer des comptes d’intégration dans un environnement ISE.
   Niveau tarifaire	Oui	<pricing-level>	Niveau tarifaire pour le compte d’intégration, que vous pouvez modifier par la suite. Dans cet exemple, sélectionnez Gratuit. Pour plus d’informations, consultez la documentation suivante : - Modèle de tarification de Logic Apps - Limites et configuration de Logic Apps - Tarification de Logic Apps
   Activer l’analytique des journaux	Non	Non sélectionné	Pour cet exemple, ne sélectionnez pas cette option.

5. Quand vous avez terminé, sélectionnez Vérifier + créer.

   Une fois le déploiement terminé, Azure ouvre votre compte d’intégration.

Azure CLI

Préparation de votre environnement pour Azure CLI

• Utilisez l’environnement Bash dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Bash dans Azure Cloud Shell.

  

• Si vous préférez exécuter les commandes de référence de l’interface de ligne de commande localement, installez l’interface Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Guide pratique pour exécuter Azure CLI dans un conteneur Docker.

  • Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour finir le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour connaître les autres options de connexion, consultez Se connecter avec Azure CLI.

  • Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser des extensions avec Azure CLI.

  • Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.

1. Pour ajouter l’extension az logic integration-account, utilisez la commande az extension add :

   az extension add –-name logic
   

2. Pour créer un groupe de ressources ou utiliser un groupe de ressources existant, exécutez la commande az group create :

   az group create --name myresourcegroup --location westus
   

   Pour répertorier les comptes d’intégration d’un groupe de ressources, utilisez la commande az logic integration-account list :

   az logic integration-account list --resource-group myresourcegroup
   

3. Pour créer un compte d’intégration, exécutez la commande az logic integration-account create :

   az logic integration-account create --resource-group myresourcegroup \
       --name integration_account_01 --location westus --sku name=Standard
   

   Nom de votre compte d’intégration, qui peut contenir uniquement des lettres, des chiffres, des traits d’union [-] des traits de soulignement [ _ ], des parenthèses [( )] et des points [.].

   Pour afficher un compte d’intégration spécifique, utilisez la commande az logic integration-account show :

   az logic integration-account show --name integration_account_01 --resource-group myresourcegroup
   

   Vous pouvez modifier votre SKU ou le niveau tarifaire à l’aide de la commande az logic integration-account update :

   az logic integration-account update --sku name=Basic --name integration_account_01 \
       --resource-group myresourcegroup
   

   Pour plus d’informations sur la tarification, consultez ces ressources :

   • Modèle de tarification d’Azure Logic Apps
   • Limites et configuration d’Azure Logic Apps
   • Tarification d’Azure Logic Apps

Pour importer un compte d’intégration à l’aide d’un fichier JSON, utilisez la commande az logic integration-account import :

az logic integration-account import --name integration_account_01 \
    --resource-group myresourcegroup --input-path integration.json

Créer un lien vers l’application logique

Pour pouvoir lier correctement votre compte d’intégration à votre ressource d’application logique, assurez-vous que les deux ressources utilisent le même abonnement Azure et la même région Azure.

Consommation

Cette section décrit comment effectuer cette tâche à l’aide du portail Azure. Si vous utilisez Visual Studio et que votre application logique se trouve dans un projet Azure Resource Group, vous pouvez lier votre application logique à un compte d’intégration avec Visual Studio.

1. Dans le portail Azure, ouvrez votre ressource d’application logique.

2. Dans le menu de navigation de votre application logique, sous Paramètres, sélectionnez Paramètres de flux de travail. Sous compte d’intégration, ouvrez la liste Sélectionner un compte d’intégration, puis sélectionnez le compte d’intégration de votre choix.

   

3. Pour terminer la liaison, sélectionnez Enregistrer.

   

   Une fois votre compte d’intégration correctement associé, Azure affiche un message de confirmation.

   

Désormais, votre flux de travail d’application logique peut utiliser les artefacts de votre compte d’intégration en plus des connecteurs B2B, tels que la validation XML et l’encodage ou le décodage de fichiers plats.

Standard

Rechercher l’URL de rappel de votre compte d’intégration

Avant de pouvoir lier votre compte d’intégration à une ressource d’application logique Standard, vous devez disposer de l’URL de rappel de votre compte d’intégration.

1. Dans le portail Azure connectez-vous avec les informations d’identification de votre compte Azure.

2. Dans la zone de recherche du portail Azure, recherchez et sélectionnez votre compte d’intégration. Pour parcourir les comptes existants, entrez integration accounts, puis sélectionnez Integration accounts.

3. Dans la liste Integration accounts, sélectionnez votre compte d’intégration.

4. Dans le menu de navigation du compte d’intégration sélectionné, sous Paramètres, sélectionnez URL de rappel.

5. Recherchez la valeur de la propriété URL de rappel générée , copiez la valeur et enregistrez l’URL à utiliser ultérieurement pour la liaison.

Lier un compte d’intégration à une application logique Standard

Portail Azure

1. Dans le portail Azure, ouvrez votre ressource d’application logique Standard.

2. Dans le menu de navigation de votre application logique, sous Paramètres, sélectionnez Configuration.

3. Dans le volet Configuration, vérifiez si le paramètre d’application nommé WORKFLOW_INTEGRATION_ACCOUNT_CALLBACK_URL existe.

4. Si le paramètre d’application n’existe pas, sous la barre d’outils du volet Configuration, sélectionnez Nouveau paramètre d’application.

5. Fournissez les valeurs suivantes pour le paramètre d’application :

   Propriété	Valeur
   Nom	WORKFLOW_INTEGRATION_ACCOUNT_CALLBACK_URL
   Valeur	<integration-account-callback-URL>

6. Quand vous avez terminé, sélectionnez OK. Lorsque vous revenez au volet Configuration, veillez à enregistrer vos modifications. Dans la barre d’outils du volet Configuration, sélectionnez Enregistrer.

Visual Studio Code

1. À partir de votre projet d’application logique Standard dans Visual Studio Code, ouvrez le fichier local.settings.json.

2. Dans l’objet Values, ajoutez un paramètre d’application qui contient les propriétés et les valeurs suivantes, y compris l’URL de rappel précédemment enregistrée :

   Propriété	Valeur
   Nom	WORKFLOW_INTEGRATION_ACCOUNT_CALLBACK_URL
   Valeur	<integration-account-callback-URL>

   Ceci montre comment un exemple de paramètre d’application peut apparaître :

   {
       "IsEncrypted": false,
       "Values": {
           "AzureWebJobStorage": "UseDevelopmentStorage=true",
           "FUNCTIONS_WORKER_RUNTIME": "node",
           "WORKFLOW_INTEGRATION_ACCOUNT_CALLBACK_URL": "https://prod-03.westus.logic.azure.com:443/integrationAccounts/...."
       }
   }
   

3. Lorsque vous avez terminé, enregistrez les modifications.

Changer le niveau tarifaire

Pour augmenter les limites d’un compte d’intégration, vous pouvez procéder à une mise à niveau vers un niveau tarifaire supérieur, le cas échéant. Par exemple, vous pouvez effectuer une mise à niveau à partir du niveau gratuit vers le niveau De base ou Standard. Vous pouvez également passer à un niveau inférieur, le cas échéant. Pour plus d’informations sur la tarification, consultez la documentation suivante :

• Tarification d’Azure Logic Apps
• Modèle de tarification d’Azure Logic Apps

Mettre à niveau le niveau tarifaire

Pour effectuer cette modification, vous pouvez utiliser le portail Azure ou l’interface de ligne de commande Azure.

Portail

1. Connectez-vous au portail Azure avec les informations d’identification de votre compte Azure.

2. Dans la zone de recherche principale Azure, entrez integration accounts et sélectionnez Comptes d’intégration.

   Azure affiche tous les comptes d’intégration dans vos abonnements Azure.

3. Sous Comptes d’intégration, sélectionnez le compte d’intégration à déplacer. Dans le menu de votre compte d’intégration, sélectionnez Vue d’ensemble.

   

4. Dans le volet Vue d’ensemble, sélectionnez Mettre à niveau le niveau tarifaire pour afficher la liste des niveaux supérieurs disponibles. Lorsque vous sélectionnez un niveau, la modification prend effet immédiatement.

   

Azure CLI

1. Si ce n’est pas déjà fait, installez les composants requis de l’interface de ligne de commande Azure.

2. Dans le portail Azure, ouvrez l’environnement Azure Cloud Shell.

   

3. À l’invite de commandes, entrez la commande az resource, puis définissez skuName sur le niveau le plus élevé souhaité.

   az resource update --resource-group {ResourceGroupName} --resource-type Microsoft.Logic/integrationAccounts --name {IntegrationAccountName} --subscription {AzureSubscriptionID} --set sku.name={SkuName}
   

   Par exemple, si vous avez le niveau De base, vous pouvez définir skuName sur Standard :

   az resource update --resource-group FabrikamIntegration-RG --resource-type Microsoft.Logic/integrationAccounts --name Fabrikam-Integration --subscription XXXXXXXXXXXXXXXXX --set sku.name=Standard
   

Passage à un niveau tarifaire inférieur

Pour effectuer cette modification, utilisez l’interface de ligne de commande Azure.

1. Si ce n’est pas déjà fait, installez les composants requis de l’interface de ligne de commande Azure.

2. Dans le portail Azure, ouvrez l’environnement Azure Cloud Shell.

   

3. À l’invite de commandes, entrez la commande az resource, puis définissez skuName sur le niveau le plus bas souhaité.

   az resource update --resource-group <resourceGroupName> --resource-type Microsoft.Logic/integrationAccounts --name <integrationAccountName> --subscription <AzureSubscriptionID> --set sku.name=<skuName>
   

   Par exemple, si vous avez le niveau Standard, vous pouvez définir skuName sur Basic :

   az resource update --resource-group FabrikamIntegration-RG --resource-type Microsoft.Logic/integrationAccounts --name Fabrikam-Integration --subscription XXXXXXXXXXXXXXXXX --set sku.name=Basic
   

Dissocier de l’application logique

Consommation

Si vous voulez lier votre application logique à un autre compte d’intégration, ou ne plus utiliser un compte d’intégration avec votre application logique, supprimez la liaison à l’aide d’Azure Resource Explorer.

1. Ouvrez la fenêtre de votre navigateur, puis accédez à Azure Resource Explorer (https://resources.azure.com). Connectez-vous avec les mêmes informations d’identification de votre compte Azure.

   

2. Dans la zone de recherche, entrez le nom de votre application logique, puis recherchez et sélectionnez votre application logique.

   

3. Dans la barre de titre de l’explorateur, sélectionnez Lecture/écriture.

   

4. Sous l’onglet Données, sélectionnez Modifier.

   

5. Dans l’éditeur, recherchez l’objet integrationAccount, puis supprimez-le. Son format est le suivant :

   {
      // <other-attributes>
      "integrationAccount": {
         "name": "<integration-account-name>",
         "id": "<integration-account-resource-ID>",
         "type": "Microsoft.Logic/integrationAccounts"  
      },
   }
   

   Par exemple :

   

6. Sous l’onglet Données, sélectionnez Put pour enregistrer vos modifications.

   

7. Dans le Portail Azure, ouvrez votre application logique. Dans le menu de votre application logique, sous Paramètres de flux de travail, vérifiez que la propriété Compte d’intégration apparaît désormais vide.

   

Standard

Portail Azure

1. Dans le portail Azure, ouvrez votre ressource d’application logique Standard.

2. Dans le menu de navigation de votre application logique, sous Paramètres, sélectionnez Configuration.

3. Dans le volet Configuration, recherchez le paramètre d’application nommé WORKFLOW_INTEGRATION_ACCOUNT_CALLBACK_URL.

4. Dans la colonne Supprimer, sélectionnez Supprimer (icône de la corbeille).

5. Dans la barre d’outils du volet Configuration, sélectionnez Enregistrer.

Visual Studio Code

1. À partir de votre projet d’application logique Standard dans Visual Studio Code, ouvrez le fichier local.settings.json.

2. Dans l’objet Values, recherchez et supprimez le paramètre d’application qui a les propriétés et valeurs suivantes :

   Propriété	Valeur
   Nom	WORKFLOW_INTEGRATION_ACCOUNT_CALLBACK_URL
   Valeur	<integration-account-callback-URL>

3. Lorsque vous avez terminé, enregistrez les modifications.

Déplacer un compte d’intégration

Vous pouvez déplacer votre compte d’intégration vers un autre groupe de ressources Azure ou un abonnement Azure. Lorsque vous déplacez des ressources, Azure crée de nouveaux ID de ressource. Veillez donc à utiliser les nouveaux ID et à mettre à jour tous les scripts ou outils associés aux ressources déplacées. Si vous souhaitez modifier l’abonnement, vous devez également spécifier un groupe de ressources nouveau ou existant.

Pour cette tâche, vous pouvez utiliser le Portail Azure en suivant les étapes décrites dans cette section ou l’interface de ligne de commande Azure.

1. Connectez-vous au portail Azure avec les informations d’identification de votre compte Azure.

2. Dans la zone de recherche principale Azure, entrez integration accounts et sélectionnez Comptes d’intégration.

   Azure affiche tous les comptes d’intégration dans vos abonnements Azure.

3. Sous Comptes d’intégration, sélectionnez le compte d’intégration à déplacer. Dans le menu de votre compte d’intégration, sélectionnez Vue d’ensemble.

4. Dans le volet Vue d’ensemble, en regard de Groupe de ressources ou de Nom d’abonnement, sélectionnez Modifier.

   

5. Sélectionnez les ressources associées que vous souhaitez également déplacer.

6. En fonction de votre sélection, procédez comme suit pour modifier le groupe de ressources ou l’abonnement :

   • Groupe de ressources : Dans la liste Groupe de ressources, sélectionnez le groupe de ressources de destination. Ou, pour créer un groupe de ressources différent, sélectionnez Créer un groupe de ressources.

   • Abonnement : Dans la liste Abonnement, sélectionnez l’abonnement de destination. Dans la liste Groupe de ressources, sélectionnez le groupe de ressources de destination. Ou, pour créer un groupe de ressources différent, sélectionnez Créer un groupe de ressources.

7. Pour confirmer que tous les scripts ou outils associés aux ressources déplacées ne fonctionneront pas tant que vous ne les aurez pas mis à jour avec les nouveaux ID de ressource, sélectionnez la zone de confirmation, puis sélectionnez OK.

8. Une fois que vous avez terminé, veillez à mettre à jour tous les scripts avec les nouveaux ID de ressource pour vos ressources déplacées.

Supprimer un compte d’intégration

Pour cette tâche, vous pouvez utiliser le Portail Azure en suivant les étapes de cette section, l’interface de ligne de commande Azure ou Azure PowerShell.

Portail

1. Connectez-vous au portail Azure avec les informations d’identification de votre compte Azure.

2. Dans la zone de recherche principale Azure, entrez integration accounts et sélectionnez Comptes d’intégration.

   Azure affiche tous les comptes d’intégration dans vos abonnements Azure.

3. Sous Comptes d’intégration, sélectionnez le compte d’intégration à supprimer. Dans le menu de votre compte d’intégration, sélectionnez Vue d’ensemble.

   

4. Dans le volet Vue d’ensemble, sélectionnez Supprimer.

   

5. Pour confirmer que vous souhaitez supprimer votre compte d’intégration, sélectionnez Oui.

   

Azure CLI

Vous pouvez supprimer un compte d’intégration à l’aide de la commande az logic integration-account delete :

az logic integration-account delete --name integration_account_01 --resource-group myresourcegroup

Étapes suivantes

• Créer des partenaires commerciaux dans votre compte d’intégration
• Créer des accords entre partenaires dans votre compte d’intégration