Exercice : créer un connecteur dans une solution

  • 6 minutes

Dans cet exercice, vous allez créer votre premier connecteur personnalisé pour une API existante nommée Contoso Invoicing.

Important

Utilisez un environnement de test avec Microsoft Dataverse approvisionné. Si vous ne disposez pas d’un environnement de test, vous pouvez vous inscrire pour bénéficier de l’offre Community Power Apps.

Tâche 1 : Examiner l’API

Pour examiner l’API, procédez comme suit :

  1. Accédez à Contoso Invoicing.

  2. Cliquez sur le lien vers la documentation.

    Capture d’écran avec une flèche pointant vers le lien vers la documentation de l’API.

  3. Examinez les opérations disponibles.

  4. Sélectionnez chaque opération pour la développer et la passer en revue.

  5. Fermez l’onglet ou la fenêtre de navigateur de la documentation.

  6. Cliquez sur le lien vers la définition OpenAPI.

  7. L’image suivante montre un exemple de la version OpenAPI de ce qui était affiché sur la page de documentation. Cliquez avec le bouton droit et sélectionnez Enregistrer sous.

    Capture d’écran avec une flèche pointant vers le bouton Enregistrer sous.

  8. Enregistrez le fichier localement. Vous utiliserez ce fichier ultérieurement dans l’exercice.

  9. Fermez l’onglet ou la fenêtre de navigateur de la définition.

  10. Cliquez sur le lien Clé API.

  11. Copiez et enregistrez votre clé API, car vous allez en avoir besoin plus tard.

    Capture d’écran de la clé API pour Contoso Invoicing.

  12. Cliquez sur Retour à la page d’accueil.

  13. Cliquez sur Télécharger le logo.

  14. Enregistrez l’image du logo localement afin de l’utiliser ultérieurement.

Tâche 2 : créer une solution

Pour créer une solution, procédez comme suit :

  1. Accédez à Power Apps Maker Portal et veillez à vous trouver dans l’environnement approprié.

  2. Cliquez sur Solutions > + Nouvelle solution.

  3. Entrez Contoso Invoicing pour Nom d’affichage, sélectionnez Éditeur CDS par défaut pour Éditeur, puis cliquez sur Créer. Lorsque vous travaillez sur un vrai projet, il est préférable de créer votre éditeur.

    Capture d’écran de la création d’une solution Contoso Invoicing.

  4. Ne quittez pas cette page après avoir cliqué sur Créer.

Tâche 3 : créer un connecteur

Pour créer un connecteur, procédez comme suit :

  1. Ouvrez la solution Contoso Invoicing que vous avez créée.

  2. Cliquez sur + Nouveau, puis sélectionnez Automatisation > Connecteur personnalisé.

    Capture d’écran avec une flèche pointant vers la création d’une connexion personnalisée.

  3. Entrez Contoso Invoicing pour Nom du connecteur, puis cliquez sur Télécharger l’image.

    Capture d’écran avec une flèche pointant vers le bouton de chargement d’une image.

  4. Sélectionnez le logo du connecteur que vous avez téléchargé lors de la Tâche 1 : examiner l’API.

  5. Saisissez #175497 pour Couleur d’arrière-plan de l’icône.

  6. Saisissez contosoinvoicingtest.azurewebsites.net pour l’Hôte.

  7. Cliquez sur Créer le connecteur.

    Capture d’écran avec une flèche pointant vers le bouton de création d’un connecteur.

  8. Ne quittez pas cette page.

Tâche 4 : importer la définition OpenAPI

Pour importer la définition OpenAPI, procédez comme suit :

  1. Cliquez sur la flèche située en regard de Nom du connecteur.

    Capture d’écran avec une flèche pointant vers le bouton Précédent.

  2. Cliquez sur les points de suspension (…) du connecteur, puis sélectionnez Mettre à jour à partir du fichier OpenAPI.

    Capture d’écran illustrant une flèche pointant vers le bouton Mettre à jour à partir du fichier OpenAPI.

  3. Cliquez sur Importer.

  4. Sélectionnez le fichier swagger.json que vous avez téléchargé à la Tâche 1 : Examiner l’API, puis cliquez sur Ouvrir.

  5. Cliquez sur Continuer.

  6. Renseignez l’URL de l’hôte en spécifiant contosoinvoicingtest.azurewebsites.net, puis cliquez sur Sécurité.

    Capture d’écran avec une flèche pointant vers l’onglet Sécurité.

  7. Notez que le champ est renseigné à partir du fichier importé.

  8. Ne quittez pas cette page.

Tâche 5 : examiner et ajuster les définitions

Pour examiner et ajuster les définitions, procédez comme suit :

  1. Cliquez sur l’onglet Définition.

  2. Prenez quelques minutes pour examiner les opérations importées.

  3. Notez l’icône d’information bleue en regard de GetInvoice qui indique qu’un élément nécessite une attention particulière.

    Capture d’écran avec une flèche pointant vers l’action GetInvoice.

  4. Sélectionnez l’opération GetInvoice.

  5. Notez que l’opération indique qu’il manque un Résumé.

  6. Saisissez Obtenir la facture comme Résumé pour améliorer la convivialité.

    Capture d’écran du résumé de l’action Obtenir la facture.

  7. Notez que l’opération PayInvoice est entourée en bleu, ce qui indique qu’il manque une Description.

  8. Saisissez Payer une facture pour la Description.

  9. Supprimez les deux opérations NewInvoice inutiles.

    Capture d’écran avec une flèche pointant vers le bouton Supprimer.

  10. Sélectionnez l’opération GetInvoiceSchema.

  11. Modifiez l’option Visibilité sur interne afin qu’elle n’apparaisse pas dans la liste d’actions des utilisateurs.

  12. Cliquez sur Mettre à jour le connecteur.

    Capture d’écran avec une flèche pointant vers le bouton Mettre à jour le connecteur.

  13. Ne quittez pas cette page.

Tâche 6 : tester le connecteur

Pour tester le connecteur, procédez comme suit :

  1. Cliquez sur l’onglet Test.

  2. Cliquez sur + Nouvelle connexion.

    Capture d’écran avec une flèche pointant vers le bouton Nouvelle connexion.

  3. Collez la clé API que vous avez enregistrée à la Tâche 1 : Examiner l’API, puis cliquez sur Créer une connexion.

  4. Cliquez sur le bouton Actualiser.

    Capture d’écran avec une flèche pointant vers le bouton Actualiser.

  5. Sélectionnez ListInvoiceTypes > Opération de test.

    Capture d’écran avec une flèche pointant vers le bouton Opération de test.

Vous devez voir des données de facturation affichées dans la zone du corps.