Utiliser un connecteur personnalisé à partir d’un flux
Notes
Cette rubrique fait partie d’une série de tutoriels sur la création et l’utilisation de connecteurs personnalisés dans Azure Logic Apps, Power Automate, et Power Apps. Assurez-vous de lire la présentation du connecteur personnalisé pour comprendre le processus.
Dans ce sujet, vous créez un flux de base qui utilise le connecteur personnalisé que vous avez créé dans un sujet précédent. Le flux est déclenché lorsqu'un élément est ajouté à une liste SharePoint, le flux utilise ensuite le connecteur personnalisé pour appeler l'API d'analyse de texte Cognitive Services. Le connecteur renvoie le score de sentiment (0 à 1) pour le texte de l'élément de liste et le flux réécrit le score dans la liste. L'image suivante montre le flow terminé :
Conditions préalables
- Inscrivez-vous à Office 365 Business Premium ou à un essai gratuit
- Expérience de base en matière de création de flux. Pour plus d’informations, consultez Créer un flux de zéro.
- Le connecteur personnalisé que vous avez créé dans l’une de ces rubriques :
Créer la liste SharePoint
Vous créez d'abord une simple liste à trois colonnes dans SharePoint Online ; cette liste stocke les données de critiques de films que le flux analyse pour les sentiments. Pour plus d'informations sur les listes SharePoint, voir Présentation des listes dans la documentation de SharePoint.
Sur votre site SharePoint Online, choisissez Nouveau, puis Liste.
Entrez le nom Critiques de films, puis cliquez sur Créer.
La liste est créée, avec le champ Titre par défaut.
Cliquez sur
, puis sur Une ligne de texte.
Entrez le nom Critique, puis cliquez sur Enregistrer.
Répétez les étapes 3. et 4. pour ajouter une colonne à la liste : utilisez le type de données Nombre, ainsi que le nom Score.
Créer un flux à partir de la liste
SharePoint Online offre la possibilité de créer des flux directement à partir d'une liste, nous allons donc utiliser cette approche. Vous pouvez créer le même flux à partir de flow.microsoft.com.
Dans la liste SharePoint, choisissez Flux, puis Créer un flux.
Dans le volet droit, choisissez Afficher plus.
Choisissez le modèle Lorsqu'un nouvel élément est ajouté dans SharePoint, effectuez une action personnalisée.
Dans ce cas, l'action personnalisée appelle l'API via le connecteur personnalisé.
Assurez-vous que vous êtes connecté à SharePoint avec le bon compte, puis choisissez Continuer.
Dans flow.microsoft.com, choisissez Modifier. Vous devriez voir le site et la liste SharePoint à partir desquels vous avez lancé le processus Créer un flux.
Ajouter le connecteur personnalisé
Power Automate a créé un flux de base avec un déclencheur qui se met en action lorsqu’un élément est ajouté à la liste SharePoint. Vous ajoutez maintenant des actions à effectuer en fonction de l'élément ajouté.
Sélectionnez Nouvelle étape, puis Ajouter une action.
Recherchez le connecteur que vous avez créé, puis choisissez l'action associée à ce connecteur.
Le nom et la description de l'action proviennent des informations que vous avez fournies lors de la création du connecteur.
Entrez des valeurs pour tous les champs.
Paramètre valeur Langage « en » ID « 1 » Texte Dans le champ Critiques de SharePoint (dans la boîte de dialogue Contenu dynamique) L’ID est nécessaire, car le connecteur peut gérer plusieurs documents ; dans nos exemples, vous envoyez un document à la fois. Dans un flux de production, les valeurs Langue et ID peuvent provenir d'une liste ou d'une autre source de données.
Sélectionnez Nouvelle étape, puis Ajouter une action.
Ajouter l'action SharePoint - Mettre à jour l'élément et entrez des valeurs pour tous les champs.
Paramètre valeur Adresse du site Adresse du site SharePoint Online à partir desquels vous avez lancé le processus Créer un flux Nom de la liste La liste à partir de laquelle vous avez lancé le processus Créer un flux ID Champ ID SharePoint Titre Champ Titre SharePoint Réviser Champ Critique SharePoint Score Champ Score du connecteur personnalisé Lorsque vous ajoutez le contenu dynamique du champ Score, notez que Power Automate ajoute un conteneur Appliquer à chaque, car il reconnaît que le connecteur personnalisé accepte plusieurs documents. Votre flux n'en envoie qu'un à la fois, mais c'est pratique que le flux corresponde aux capacités du connecteur.
Le flux fini doit maintenant ressembler à l'image suivante :
Donnez un nom à votre flux, comme Analyse des sentiments, puis choisissez Créer un flux et Terminé.
Tester le flux
Maintenant que le flux est terminé, il est temps de le tester en ajoutant des critiques à la liste SharePoint et en observant la réponse du flux.
Dans votre liste SharePoint Online, choisissez Modification rapide.
Ajoutez deux critiques à la liste (un négatif et un positif), puis choisissez 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 » Dans flow.microsoft.com, choisissez Mes flux, puis choisissez le flux que vous avez créé.
Consultez l'HISTORIQUE DES EXÉCUTIONS : il doit y avoir deux exécutions, une pour chaque critique ajoutée à la liste.
De retour sur la page de liste SharePoint, actualisez le navigateur pour voir les scores ajoutés par le flux.
Vous avez terminé ! Il s’agit d’un simple flux, mais dotée de fonctionnalités puissantes grâce à sa capacité d’appeler Cognitive Services via un connecteur personnalisé.
Étapes suivantes
Partagez le connecteur au sein de votre organisation ou le faire certifier afin que les personnes extérieures à votre organisation puissent l’utiliser :
Fournir des commentaires
Nous apprécions grandement les commentaires sur les problèmes liés à notre plateforme 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.