Partager via


Utiliser un connecteur personnalisé à partir d’une application logique

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. Veillez à lire la présentation du connecteur personnalisé pour comprendre le processus.

Dans ce sujet, vous créez une application logique de base qui utilise le connecteur personnalisé que vous avez créé dans une rubrique précédente. L’application logique est déclenchée lorsqu’un élément est ajouté à une liste SharePoint, l’application logique 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 l’application logique réécrit le score dans la liste. L’image suivante montre l’application logique terminée :

Application logique d’analyse des sentiments terminée

Conditions préalables

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 l’application logique analyse pour les sentiments. Pour plus d’informations sur les listes SharePoint, voir Présentation des listes dans la documentation de SharePoint.

  1. Sur votre site SharePoint Online, choisissez Nouveau, puis Liste.

    Créer une liste SharePoint

  2. Entrez le nom « Critiques de films », puis cliquez sur Créer.

    Spécifier le nom de la nouvelle liste

    La liste est créée, avec le champ Titre par défaut.

    Liste Demandes de projet

  3. Cliquez sur Nouvel élément, puis sur Une ligne de texte.

    Ajouter un champ Une ligne de texte

  4. Entrez le nom « Critique », puis cliquez sur Enregistrer.

  5. 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 une application logique

Maintenant que vous avez une liste avec laquelle travailler, vous créez une application logique dans le portail Azure.

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

  2. Dans le menu Azure principal, choisissez Nouveau > Intégration d’entreprise > Application logique.

    Créer une application logique

  3. Sous Créer une application logique, fournissez des détails sur votre application logique comme indiqué ici. Ensuite, cliquez sur Épingler au tableau de bord > Créer.

    Fournir les détails de l’application logique

    Paramètre valeur Description
    Nom SentimentAnalysis Nom de votre application logique
    Abonnement <your-Azure-subscription-name> Nom de votre abonnement Azure
    Groupe de ressources My-First-LA-RG Nom du groupe de ressources Azure utilisé pour organiser les ressources connexes
    Emplacement Est des États-Unis 2 Région où stocker les informations de votre application logique

    Remarque : votre application logique et votre connecteur personnalisé doivent exister dans la même région.

    Log Analytics Désactivée Gardez le paramètre Désactivé pour l’enregistrement des diagnostics.
  4. Une fois qu’Azure a déployé votre application, le Concepteur Logic Apps s’ouvre et affiche une page avec une vidéo d’introduction et des déclencheurs couramment utilisés. Sous Modèles, cliquez sur Application logique vide.

    Choisissez le modèle d’application logique vide

Ajoutez le déclencheur et le connecteur personnalisé

Avec l’application logique créée, ajoutez un déclencheur qui se met en action lorsqu’un élément est ajouté à la liste SharePoint. Vous ajoutez ensuite une action à effectuer en fonction de l’élément ajouté.

  1. Dans le Concepteur Logic Apps, recherchez ou sélectionnez SharePoint, puis le déclencheur SharePoint - lorsqu’un élément est créé.

    Déclencheur Créer un élément SharePoint

  2. Si vous y êtes invité, connectez-vous avec vos informations d’identification de SharePoint.

  3. Entrez des valeurs pour le déclencheur SharePoint.

    Paramètres du déclencheur Créer un élément SharePoint

    Paramètre valeur
    Adresse du site <your-SharePoint-site-address>
    Nom de la liste Critiques de films
    Intervalle 10
    Fréquence Second
  4. Sélectionnez Nouvelle étape, puis Ajouter une action.

  5. Recherchez le connecteur personnalisé SentimentDemo que vous avez créé, puis choisissez l’action associée à ce connecteur.

    Choisir l’action SentimentDemo

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

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

    Nom de connexion et clé API

    Paramètre valeur
    Nom de connexion Nom, par exemple SentimentDemoConnection.
    Clé API Clé API pour l’API d’analyse de texte. Pour en savoir plus, accédez à la obtenir clé API.
  7. Entrez des valeurs pour tous les champs.

    Paramètres du connecteur

    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, nous envoyons un document à la fois. Dans une application logique de production, les valeurs Langue et ID peuvent provenir d’une liste ou d’une autre source de données.

  8. Sélectionnez Nouvelle étape, puis Ajouter une action.

  9. Ajouter l’action SharePoint - Mettre à jour l’élément et entrez des valeurs pour tous les champs.

    Action Mettre à jour l’élément de liste

    Paramètre valeur
    Adresse du site <your-SharePoint-site-address>
    Nom de la liste Critiques de films
    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 Logic Apps ajoute un conteneur Pour chacun, car il reconnaît que le connecteur personnalisé accepte plusieurs documents. Votre connecteur n’en envoie qu’un à la fois, mais c’est pratique que l’application logique corresponde aux capacités du connecteur.

    Appliquer à chacun

    L’application logique finie doit maintenant ressembler à l’image suivante :

    Application logique d’analyse des sentiments terminée

  10. En haut du Concepteur Logic Apps, cliquez sur Exécuter.

Tester l’application logique

Maintenant que l’application logique est terminée, il est temps de le tester en ajoutant des critiques à la liste SharePoint et en observant la réponse de l’application logique.

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

    Modification rapide de la liste SharePoint

  2. Ajoutez deux critiques à la liste (un négatif et un positif), puis choisissez Terminé.

    Modification rapide terminée

    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
  3. De retour dans le portail Azure, choisissez Aperçu pour consulter l’historique d’exécution de cette application logique. Il doit y avoir deux exécutions : une pour chaque critique ajoutée à la liste. Pour enregistrer les ressources Azure une fois que vous avez terminé avec cette application logique, choisissez Désactiver.

    Historique des exécutions

  4. De retour sur la page de liste SharePoint, actualisez le navigateur pour voir les scores ajoutés par l’application logique.

    Scores ajoutés depuis l’application logique

Vous avez terminé ! Il s’agit d’une simple application logique, 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.