Certifier un connecteur personnalisé

  • 6 minutes

Pour mettre un connecteur personnalisé à la disposition de tous les utilisateurs dans Logic Apps, Power Automate et Power Apps en tant que connecteur certifié, envoyez votre connecteur à Microsoft pour certification. Microsoft examine le connecteur et l’approuve pour publication s’il satisfait aux critères de certification. Une fois le connecteur publié, il est ajouté à la liste complète des connecteurs accessibles au public.

Cette unité étudie chaque étape, notamment certaines étapes générales, du processus de certification. Ces mêmes étapes s’appliquent également aux mises à jour ultérieures, mais en fonction de l’étendue de la mise à jour, elles peuvent être considérablement plus rapides.

Schéma du processus de certification avec les étapes de planification, de développement, de création open source, d’envoi, de certification, de test, de déploiement et de support.

Planification

La planification est la première étape du processus de certification lorsque vous commencez à imaginer à quoi ressemblera votre connecteur. La création d’un connecteur que d’autres utiliseront doit impliquer une certaine planification.

La première étape consiste à vérifier qu’un connecteur n’existe pas déjà. S’il en existe un, vous devez envisager de contribuer au connecteur existant avec les modifications que vous proposez, car Microsoft ne certifiera pas plusieurs connecteurs pour la même API.

Voici quelques facteurs clés de planification à prendre en compte :

  • Identifiez les déclencheurs et actions disponibles initialement. Vous n’avez pas besoin de couvrir l’intégralité de votre API, mais l’ensemble initial de déclencheurs et d’actions doit être un ensemble utile. Si l’offre de votre version initiale est trop limitée, les utilisateurs seront frustrés par l’absence de fonctionnalités pour des scénarios courants. Envisagez d’écrire ou d’esquisser un ou plusieurs flux de travail pouvant être créés dans Microsoft Power Automate à l’aide de votre connecteur. Cette approche peut vous aider à choisir les API à inclure dans le connecteur.

  • Évaluez les modifications qu’il pourrait être nécessaire d’apporter à l’API pour prendre en charge des déclencheurs ou améliorer d’une autre manière la capacité de fournir un connecteur convivial.

  • Tenez compte de la gestion de l’authentification et de l’adaptation nécessaire entre la manière dont votre API s’authentifie actuellement et les fonctionnalités prises en charge des connecteurs personnalisés.

  • Prenez en compte la façon dont les utilisateurs souhaitant utiliser le connecteur obtiendront une clé, si votre API utilise des clés API.

  • Examinez les modèles de stratégie de connecteur pour déterminer si l’implémentation de modèles contribuerait à la convivialité de votre connecteur.

  • Vérifiez l’applicabilité des extensions OpenAPI prises en charge. Par exemple, la connexion de test est généralement implémentée par des connecteurs certifiés. En outre, le recours à des extensions de valeur dynamique peut être utile si vous disposez de paramètres avec des listes de valeurs à choisir.

De plus, vous n’avez pas à attendre la fin du développement d’un nouveau connecteur pour l’enregistrer pour certification. Pour en savoir plus, consultez le Processus de certification des éditeurs vérifiés ou le Processus de certification des éditeurs indépendants. Attendez-vous à recevoir une communication d’un représentant Microsoft, qui vous aidera à mieux comprendre votre connecteur personnalisé, vous expliquera la progression de votre développement et vous guidera tout au long du processus de certification.

Pour les mises à jour d’un connecteur certifié, l’élément clé de la planification consiste à ne pas perturber les utilisateurs existants. Cette question est abordée plus en détail dans une unité ultérieure.

Développement

L’objectif principal de l’étape de développement est de préparer votre API et la définition de votre connecteur personnalisé pour envoi. Avant de passer à l’étape suivante, vous devez vous assurer que la définition de votre connecteur personnalisé est nettoyée et possède tous les noms appropriés que vous souhaitez publier.

Créer un connecteur open source

L’unité d’introduction a couvert une vue d’ensemble de la création d’un connecteur open source. Vous allez placer le connecteur certifié de l’éditeur vérifié dans le dossier certified-connectors et les connecteurs de l’éditeur indépendant dans le dossier independent-publisher-connectors. Avant d’envoyer une demande de tirage, veillez à effectuer les tâches suivantes :

  • Modifiez vos fichiers de connecteur pour ajouter les métadonnées requises spécifiques. Vos fichiers de connecteur doivent contenir des métadonnées spécifiques qui décrivent le connecteur et son service final.

  • Exécutez la commande paconn validate sur votre connecteur téléchargé, puis corrigez les erreurs.

Pour exécuter la validation, utilisez la commande suivante :

paconn validate --api-def [Location of apiDefinition.swagger.json]

Une fois la validation réussie, vous pouvez envoyer votre demande de tirage à la branche de développement du référentiel GitHub. Cette action entraîne le lancement d’un processus automatisé qui effectue la validation initiale de votre demande de tirage et s’assure que vous disposez d’un contrat de contribution approprié. Une fois la validation automatisée terminée, votre demande de tirage est affectée à Microsoft pour examen initial. Si les réviseurs identifient des problèmes à résoudre, ils saisissent des commentaires sur la demande de tirage, puis vous devez les résoudre et renvoyer la demande de tirage. Lorsque tout semble acceptable, votre demande de tirage est fusionnée dans le référentiel.

Envoi à un éditeur indépendant

Si vous publiez un connecteur d’éditeur indépendant, votre prochaine étape consiste à envoyer les artefacts de connecteur avec la demande de tirage que vous avez créée lorsque vous avez proposé le connecteur, renseigner la liste de contrôle dans le modèle de demande de tirage et supprimer « Proposition - » du titre de votre demande de tirage. Un ingénieur de certification Microsoft fournira des commentaires sous une ou deux semaines après votre demande initiale. Si les commentaires nécessitent une mise à jour du connecteur, vous devrez envoyer une mise à jour de la demande de tirage. Une fois que vous

Envoi à un éditeur vérifié

L’étape suivante consiste à envoyer votre connecteur pour certification dans ISV Studio après avoir été invité à le faire par votre contact Microsoft. ISV Studio est un portail dédié à la gestion du reste du processus de certification qui vous indique l’intégrité de votre connecteur après son déploiement.

Dans le cadre du processus d’envoi à ISV Studio pour certification, vous devez être prêt à fournir les éléments suivants :

  • Des informations de test sur le connecteur, par exemple une clé API, d’autres détails d’authentification ou tout autre détail qui aiderait un testeur à utiliser le connecteur.

  • Un fichier Intro.md contenant des informations à inclure dans la documentation publique dédiée au connecteur. Un modèle est disponible dans la documentation Envoi à ISV Studio.

Au fur et à mesure que la certification progresse, vous recevez des mises à jour dans le portail et un e-mail du contact principal. Si des problèmes surviennent, vous devez les résoudre avant que la certification ne se poursuive. Une fois que le connecteur a passé la certification, il est planifié pour un déploiement dans la région « Aperçu » à des fins de test.

Tests

Dans le cadre du processus de certification, votre connecteur est déployé dans la région « Version préliminaire » à des fins de test. Il s’agit de l’occasion idéale pour vous assurer que le connecteur déployé fonctionne correctement avant son déploiement dans toutes les régions du monde. Veillez à tester toutes les fonctionnalités de votre connecteur dans Power Apps, Power Automate et Logic Apps.

Pour en savoir plus, consultez Instructions sur les tests de votre connecteur dans le cadre de la certification.

Déploiement

À l’issue des tests, votre connecteur est déployé dans toutes les régions publiques. Ce processus devrait prendre sept à dix jours ouvrables, car Microsoft effectue un déploiement incrémentiel dans ses régions du monde entier. Vous recevez des notifications à mesure que chaque région est déployée.

Support

Maintenant que votre connecteur est rendu public, pour les connecteurs d’éditeur vérifié, vous pouvez suivre ses performances à partir d’ISV Studio. Assurez-vous que votre personnel de support sait comment votre connecteur peut être utilisé avec Power Apps ou Power Automate afin qu’il puisse aider les utilisateurs qui rencontrent des problèmes.