Ajouter des métadonnées pour rechercher des artefacts B2B dans des flux de travail pour Azure Logic Apps

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

Pour aider votre flux de travail à trouver rapidement les artefacts b2B (business-to-business) appropriés à utiliser lors de l’exécution, vous pouvez ajouter des métadonnées personnalisées en tant que paires clé-valeur à des artefacts tels que des partenaires commerciaux, des contrats, des schémas et des mappages. Les métadonnées personnalisées pour les artefacts vous aident à atteindre les objectifs ou tâches suivants :

• Imposer des conventions de nommage.
• Prendre en charge la réutilisation et éviter les définitions dupliquées.
• Acheminer les charges utiles vers les étapes d’encodage ou de décodage correctes.
• Donnez davantage de contrôle sur le déplacement d’artefacts par le biais du développement, du test et de la production.
• Appliquez la validation ou la transformation correcte sans logique codée en dur.
• Facilitez le suivi, la traçabilité, la gouvernance et l’audit.
• Faciliter la migration de BizTalk Server vers Azure Logic Apps.

La liste suivante décrit des exemples de métadonnées utiles, basées sur le type d’artefact :

À des fins de suivi et en alimentant des tables ou tableaux de bord de suivi B2B, les métadonnées utiles incluent des propriétés de corrélation telles que le numéro d’échange, le numéro de groupe, l’ID de jeu de transactions, ainsi que les ID d’exécution du flux de travail, les ID de partenaire et les ID de contrat, l’état et les horodatages.

Ce guide montre comment ajouter des métadonnées à un artefact dans un compte d’intégration, rechercher l’artefact à l’aide de l’action intégrée compte d’intégration nommée recherche d’artefact de compte d’intégration et référencer les métadonnées d’artefact dans votre flux de travail.

Prerequisites

• Un compte et un abonnement Azure. Obtenez un compte Azure gratuit.

• Ressource et flux de travail d’application logique dans lesquels vous souhaitez obtenir et utiliser les métadonnées d’artefact.

  Votre flux de travail peut commencer par n’importe quel déclencheur et a besoin d’une action qui fonctionne avec les métadonnées après la récupération. Cet exemple utilise le déclencheur de requête nommé Lorsqu’une requête HTTP est reçue, ce qui peut transmettre dynamiquement le nom de l’artefact à partir d’une requête HTTPS entrante.

  Pour plus d’informations, consultez :

  • Créer un flux de travail de consommation dans Azure Logic Apps

  • Créer un flux de travail Standard dans Azure Logic Apps

• Ressource de compte d’intégration qui contient les artefacts dans lesquels vous souhaitez ajouter des métadonnées.

  Vous pouvez ajouter des métadonnées personnalisées aux artefacts suivants :

  • Partenaire
  • Contrat
  • Schéma
  • Map

  L’exemple de ce guide utilise un artefact partenaire nommé TradingPartner1.

  • Votre compte d’intégration et votre ressource d’application logique doivent exister dans le même abonnement Azure et la même région Azure.

  • Avant d’utiliser l’action Recherche d’artefacts du compte d’intégration , vous devez lier votre application logique Consommation ou votre application logique Standard au compte d’intégration. Vous pouvez lier un compte d’intégration à plusieurs ressources d’application logique Consommation ou Standard pour partager les mêmes artefacts.

Ajouter des métadonnées à un artefact

Suivez ces étapes pour ajouter des métadonnées personnalisées pour un artefact B2B dans votre compte d’intégration.

1. Dans le portail Azure, accédez à votre ressource de compte d’intégration.

2. Dans la barre latérale des ressources, sous Paramètres, sélectionnez la catégorie d’artefact.

   Cet exemple ajoute des métadonnées à un artefact de partenaire commercial. Dans ce scénario, l’exemple sélectionne partenaires.

3. Dans la page de catégorie d’artefact, sélectionnez l’artefact, puis sélectionnez Modifier.

   L’exemple suivant montre la page de modification d’un artefact partenaire nommé TradingPartner1.

   

4. Sous Métadonnées, dans les colonnes Clé et Valeur , entrez vos métadonnées personnalisées en tant que paire clé-valeur. Quand vous avez terminé, sélectionnez OK.

   L’exemple suivant montre des exemples de métadonnées sous forme de paires clé-valeur :

   

5. Pour afficher ces métadonnées dans la définition JSON (JavaScript Object Notation) de l’artefact, en regard de Modifier, sélectionnez Modifier en tant que JSON à la place.

   

Rechercher l’artefact

Suivez ces étapes pour rechercher l’artefact et les métadonnées associées dans votre compte d’intégration. L’exemple identifie un artefact spécifique de partenaire commercial.

1. Dans le portail Azure, ouvrez votre ressource d’application logique. Ouvrez le flux de travail dans le concepteur.

2. Dans le concepteur, suivez ces étapes générales pour ajouter l’action intégrée compte d’intégration nommée recherche d’artefact de compte d’intégration, qui recherche l’artefact et les métadonnées spécifiés.

3. Fournissez les informations suivantes pour l’artefact, en fonction de votre type de flux de travail :

   Paramètre	Obligatoire	Valeur	Descriptif
   - Consommation : artifactName - Standard : Nom de l’artefact	Oui	< nom de l’artefact>	Nom de l’artefact, que vous pouvez entrer en tant que nom codé en dur ou en sortie dynamique du déclencheur ou de l’action précédente dans le flux de travail.
   - Consommation : artifactType - Standard : Type d’artefact	Oui	Contrat, Carte, Partenaire ou Schéma	Le type d’artefact.

   1. Pour fournir le nom de l’artefact en tant que sortie du déclencheur ou de l’action précédente, procédez comme suit :

      1. Sélectionnez dans la zone artifactName ou Artifact name , puis sélectionnez l’icône éclair pour ouvrir la liste de contenu dynamique.

      2. Dans la liste dynamique, sous le nom du déclencheur ou de l’action, sélectionnez la sortie qui spécifie le nom de l’artefact.

   2. Pour type d'artefact ou type d'artefact, sélectionnez le type d’artefact. Dans cet exemple, le type est Partner.

      

4. Enregistrez votre flux de travail.

Référencer les métadonnées d’artefact dans le flux de travail

Suivez ces étapes pour utiliser les métadonnées d’artefact récupérées dans votre flux de travail. L’exemple référence les métadonnées de l’artefact récupéré dans la section précédente.

1. Dans le concepteur, sous l’action Recherche d’artefacts du compte d’intégration, suivez ces étapes générales pour ajouter l’action souhaitée.

   Cet exemple continue avec l’action intégrée HTTP , qui envoie une requête HTTP du flux de travail à une destination spécifiée.

2. Dans le volet Action, fournissez des informations sur la façon dont vous souhaitez utiliser les métadonnées d’artefact.

   Cet exemple utilise les routingUrl métadonnées comme destination de requête HTTP. Le tableau suivant spécifie des exemples de valeurs pour l’action HTTP dans cet exemple :

   Paramètre	Obligatoire	Valeur	Descriptif	Exemple de valeur
   URI	Oui	< destination-URL>	URL du point de terminaison pour laquelle vous souhaitez envoyer la requête.	Pour référencer les métadonnées du routingUrl partenaire, procédez comme suit : 1. Sélectionnez dans la zone URI . 2. Sélectionnez l’icône de fonction pour ouvrir l’éditeur d’expression. 3. Dans l’éditeur, entrez une expression comme l’exemple suivant, en fonction de votre type de flux de travail : Consommation outputs('Integration_Account_Artifact_Lookup')?['properties']?['metadata']['routingUrl'] Standard outputs('Integration_account_artifact_lookup')?['properties']?['metadata']['routingUrl'] 4. Lorsque vous avez terminé, sélectionnez Ajouter.
   Méthode	Oui	< HTTP-method>	Opération HTTP à exécuter.	Cet exemple utilise l’opération GET .
   Headers	Non	< header-values>	Toutes les sorties d’en-tête du déclencheur doivent passer à travers l'action HTTP.	Pour transmettre la valeur Content-Type depuis l'en-tête de déclenchement, sous En-têtes, procédez comme suit pour la première ligne : 1. Dans la première colonne, entrez Content-Type comme le nom de l’en-tête. 2. Dans la deuxième colonne, utilisez l’éditeur d’expression pour entrer l’expression suivante comme valeur d’en-tête : triggeroutputs()?['headers']['Content-Type'] Pour transmettre la valeur de Host depuis l'en-tête du déclencheur, sous En-têtes, suivez ces étapes pour la deuxième ligne : 1. Dans la première colonne, entrez Host comme le nom de l’en-tête. 2. Dans la deuxième colonne, utilisez l’éditeur d’expression pour entrer l’expression suivante comme valeur d’en-tête : triggeroutputs()?['headers']['Host']
   Corps	Non	< body-content>	ATout autre contenu à transmettre via la propriété body de l’action HTTP.	Pour transmettre les valeurs de l'properties artefact à l’action HTTP, procédez comme suit : 1. Sélectionnez à l’intérieur de la zone Corps , puis sélectionnez l’icône éclair pour ouvrir la liste de contenu dynamique. Si aucune sortie n’apparaît, sélectionnez Afficher plus. 2. Dans la liste de contenu dynamique, sous Recherche d’artefact de compte d’intégration, sélectionnez Propriétés.

   Pour l’exemple de scénario, l’action HTTP utilise les exemples de valeurs suivants :

   

3. Pour confirmer les informations de l’action HTTP, affichez la définition JSON sous-jacente de votre flux de travail. Dans la barre d’outils du concepteur, sélectionnez Vue Code.

   La définition JSON sous-jacente du flux de travail s’affiche, par exemple :

   

4. Revenez au concepteur. Dans la barre d’outils de l’affichage du code, sélectionnez Concepteur.

   Toutes les expressions que vous avez entrées dans le concepteur apparaissent désormais résolues, par exemple :

   

Contenu connexe

• Ajouter des contrats entre partenaires