Utiliser un connecteur personnalisé dans un flux de travail d’application logique

Nonte

Cet article fait partie d’une série de tutoriels sur la création et l’utilisation de connecteurs personnalisés dans Azure Logic Apps, Microsoft Power Automate et Microsoft Power Apps, et sur l’utilisation de connecteurs activés par l’IA dans Microsoft Copilot Studio. Assurez-vous de lire la présentation du connecteur personnalisé pour comprendre le processus.

Accédez à Utiliser les connecteurs Power Platform dans Copilot Studio pour savoir comment appeler les connecteurs en tant qu’actions de connecteur dans votre assistant Microsoft Copilot.

Dans cet article, vous allez créer un exemple de workflow d’application logique de consommation qui montre comment utiliser le connecteur personnalisé que vous avez créé dans un didacticiel précédent. Cet exemple de flux de travail se déclenche quand un élément est ajouté à une liste SharePoint Online. Le flux de travail utilise ensuite le connecteur personnalisé pour appeler l’API Analyse de texte Cognitive Services. Le connecteur renvoie le score de sentiment (0 à 1) pour le texte dans l’élément de liste et le flux de travail réécrit le score dans la liste.

L’exemple suivant montre le flux de travail de l’application logique terminée :

Prérequis

• Un abonnement Office 365 Business Premium ou inscrivez-vous à un essai gratuit.

• Un compte et un abonnement Azure.

• Expérience de base en matière de création d’applications logiques. Pour en savoir plus, consultez Créer votre premier flux de travail d’application logique.

• Le connecteur personnalisé que vous avez créé dans l’un de ces articles :

  • Créer un connecteur personnalisé à partir d’une définition OpenAPI
  • Créer un connecteur personnalisé à partir d’une définition Postman

• (Si votre connecteur personnalisé accède aux ressources locales en utilisant la passerelle de données locale) Configurez l’installation de la passerelle pour autoriser l’accès sortant aux adresses IP sortantes des connecteurs prédéfinis correspondants. Toutes les applications logiques de la même région utilisent les mêmes plages d’adresses IP.

  Pour en savoir plus, consultez Ajuster les paramètres de communication pour la passerelle de données locale et Configurer les paramètres de proxy pour la passerelle de données locale.

Créer la liste SharePoint Online

Tout d’abord, créez une liste à trois colonnes dans SharePoint Online. Cette liste stocke les données de critiques de films que le flux de travail de l’application logique analyse pour connaître le sentiment. Pour en savoir plus sur les listes SharePoint Online, consultez Introduction aux listes.

1. Dans votre site SharePoint Online, sélectionnez Nouveau>Liste pour créer une nouvelle liste.

2. Dans le champ Nom, entrez Critiques de films

3. Sélectionnez Créer.

   Par défaut, SharePoint Online crée la liste avec une colonne Titre.

4. Sélectionnez le signe plus >Une seule ligne de texte.

5. Entrez le nom Critique et sélectionnez Enregistrer.

6. Pour ajouter une autre colonne en utilisant Nom comme type de données et Score comme nom, répétez les étapes 3 et 4.

Créer une ressource d’application logique

Maintenant que vous disposez d’une liste, créez une ressource d’application logique de consommation dans le portail Azure.

1. Connectez-vous au portail Azure à l’aide des informations d’identification de votre compte Azure.

2. Dans la zone de recherche du portail, entrez application logique, puis sélectionnez Applications logiques.

3. Sélectionnez le plan Consommation.

4. Entrez les informations suivantes pour votre ressource d’application logique :

   Property	Valeur	Description
   Subscription	<Azure-subscription-name>	Nom de votre abonnement Azure.
   Groupe de ressources	<resource-group-name>	Nom du groupe de ressources Azure utilisé pour organiser les ressources connexes. Cet exemple utilise My-First-LA-RG.
   Nom de l’application logique	<logic-app-name>	Nom de votre application logique. Cet exemple utilise SentimentAnalysis.
   Région	<Azure-region>	Région Azure pour héberger votre application logique. Remarque : votre ressource d’application logique et votre connecteur personnalisé doivent exister dans la même région. Cet exemple utilise East US 2.
   Activer l’analyse des journaux	Non	Maintenir la journalisation des diagnostics désactivée

5. Terminez la création de votre application logique.

6. Une fois que Azure a déployé votre application, sélectionnez Accéder à la ressource.

   Vous pouvez également rechercher et sélectionner votre application logique en entrant son nom dans la zone de recherche Azure.

Ajouter un déclencheur

Comme première étape de votre flux de travail, ajoutez un déclencheur SharePoint. Ce déclencheur s’exécute quand un élément est ajouté à la liste SharePoint Online spécifiée.

1. Dans le menu de l’application logique, sous Outils de développement, sélectionnez Concepteur d’applications logiques, si ce n’est pas déjà fait.

2. Dans le concepteur, sélectionnez Ajouter un déclencheur.

3. Dans la zone de recherche du volet de la galerie de connecteurs, entrez SharePoint et sélectionnez le déclencheur SharePoint nommé Quand un élément est créé. Si le déclencheur n’apparaît pas dans la liste, dans le coin supérieur droit de la liste des déclencheurs SharePoint, sélectionnez Voir plus.

   

4. Une fois que le volet Créer une connexion s’ouvre, connectez-vous avec vos informations d’identification SharePoint.

5. Fournissez les informations suivantes pour le déclencheur SharePoint :

   Paramètre	Valeur
   Adresse du site	<SharePoint-site-address>
   Nom de la liste	Critiques de films

6. Développez la section intitulée À quelle fréquence souhaitez-vous rechercher des éléments pour terminer la configuration du déclencheur :

   Paramètre	Valeur
   Intervalle	10
   Fréquence	Second

   Lorsque vous avez terminé, votre déclencheur ressemble à l’exemple suivant :

   

Ajouter une action à partir du connecteur personnalisé

Après le déclencheur, vous pouvez ajouter une ou plusieurs actions à effectuer. Pour ajouter une action à partir de votre connecteur personnalisé, procédez comme suit :

1. Sous le déclencheur, sélectionnez le signe plus (+) et sélectionnez Ajouter une action.

2. Dans la zone de recherche du volet de la galerie de connecteurs, entrez le nom de votre connecteur personnalisé, à savoir SentimentDemo dans cet exemple, puis sélectionnez l’action souhaitée.

   Astuce

   Pour faciliter la recherche, sous Exécution, sélectionnez Personnalisé.

   

   Le nom et la description de l’action proviennent des informations fournies lors de la création du connecteur.

3. Attribuez un nom pour la connexion et la clé API.

   Paramètre	Valeur
   Nom de connexion	Un nom pour la connexion, par exemple, SentimentDemoConnection.
   Clé API	Clé API pour l’API d’analyse de texte. Pour en savoir plus, consultez Obtenir une clé API.

4. Fournissez les informations relatives à l’action, par exemple :

   Paramètre	Valeur
   ID des documents	1 Cette valeur est obligatoire car le connecteur peut gérer plusieurs documents. Cet exemple envoie un document à la fois. Toutefois, en production, les valeurs Langue des documents et ID des documents peuvent provenir d’une liste ou d’une autre source de données.
   langue des documents	en
   texte des documents	Champ Critique SharePoint. Pour entrer cette valeur, procédez comme suit : 1. Sélectionnez dans la zone Texte des documents, puis sélectionnez l’icône en forme d’éclair pour ouvrir la liste de contenu dynamique. 2. Dans la liste, dans la section du déclencheur SharePoint, sélectionnez Critique.

5. Ajoutez l’action SharePoint nommée Mettre à jour l’élément à votre flux de travail et fournissez les valeurs suivantes :

   Paramètre	Valeur
   Adresse du site	< SharePoint-site-address>
   Nom de la liste	Critiques de films
   ID	Champ ID SharePoint
   Titre	La sortie du déclencheur SharePoint nommée Titre. Pour entrer cette valeur, procédez comme suit : 1. Sélectionnez dans la zone Titre, puis sélectionnez l’icône en forme d’éclair pour ouvrir la liste de contenu dynamique. 2. Dans la liste, dans la section du déclencheur SharePoint, sélectionnez Titre.

6. Dans le volet d’action Mettre à jour l’élément, ouvrez la liste Paramètres avancés, sélectionnez les paramètres souhaités, qui varient en fonction de la liste SharePoint Online, pour les ajouter à l’action. Pour chaque paramètre ajouté, ouvrez la liste de contenu dynamique et sélectionnez la sortie correspondante à partir du déclencheur SharePoint nommé Quand un élément est créé et de l’action du connecteur personnalisé.

   Cet exemple ajoute les paramètres suivants et les sorties de déclencheur et d’action correspondantes :

   Paramètre avancé	Sortie de déclencheur ou d’action
   Réviser	La sortie du déclencheur SharePoint nommée Critique
   Score	Sortie de l’action du connecteur personnalisé nommée score. Lorsque vous sélectionnez la sortie du déclencheur pour l’utiliser dans ce champ, le concepteur ajoute automatiquement une action Pour chacun, car l’action du connecteur personnalisé peut accepter plusieurs documents. Bien que l’action du connecteur personnalisé n’envoie qu’un seul document à la fois, le concepteur correspond aux capacités du connecteur.

   Lorsque vous avez terminé, l’action Mettre à jour l’élément ressemble à l’exemple suivant :

   

7. Lorsque vous avez terminé, enregistrez votre workflow. Dans la barre d’outils du concepteur, sélectionnez Enregistrer.

Tester le flux de travail

Pour tester le flux de travail, ajoutez des critiques à votre liste SharePoint Online et vérifiez comment le flux de travail répond.

1. Dans la barre d’outils du concepteur, sélectionnez Exécuter>Exécuter.

2. Dans votre liste SharePoint Online, choisissez Modification rapide.

3. Ajoutez deux critiques à la liste, un négatif et un positif, en fonction des valeurs suivantes, puis sélectionnez Terminé.

   Paramètre	Valeur suggérée
   Titre (positif)	Mon film préféré
   Critique (positive)	J’ai apprécié ce nouveau film après une longue journée.
   Titre (négatif)	Un autre film
   Critique (négative)	Le pire film que j’ai vu depuis des décennies.

4. Dans le portail Azure, dans le menu de l’application logique, choisissez Vue d’ensemble pour consulter l’historique des exécutions de flux de travail. Sur la page Vue d’ensemble, sélectionnez Historique des exécutions.

   L’onglet Historique des exécutions affiche deux exécutions de flux de travail, une pour chaque critique que vous avez ajoutée à la liste.

5. Pour économiser sur la consommation de ressources une fois que vous avez terminé avec ce flux de travail, dans la barre d’outils de la page Vue d’ensemble, choisissez Désactiver.

6. De retour sur la page de liste SharePoint Online, actualisez le navigateur pour voir les scores ajoutés par le flux de travail.

   

Félicitations ! Bien que cet exemple soit un workflow de base, le connecteur personnalisé ajoute des fonctionnalités puissantes avec la possibilité d’appeler Cognitive Services.

Contenu associé

Vous pouvez partager votre connecteur personnalisé au sein de votre organisation, ou vous pouvez obtenir le connecteur certifié pour que les personnes externes à votre organisation puissent l’utiliser :

• Partager votre connecteur
• Certifier votre connecteur

Fournir des commentaires

Nous apprécions grandement les commentaires sur les problèmes liés à notre plate-forme de connecteurs ou les idées de nouvelles fonctionnalités. Pour fournir des commentaires, accédez à Soumettre des problèmes ou obtenir de l’aide avec les connecteurs et sélectionnez votre type de commentaire.