Présentation
Vous pouvez créer un connecteur personnalisé open source et le certifier pour le mettre facilement à disposition de tous les utilisateurs. En le rendant open source, vous vous assurez que votre connecteur est publié dans le référentiel GitHub Microsoft Power Platform. À partir du référentiel, tout utilisateur peut importer votre définition de connecteur personnalisé dans un environnement, puis l’utiliser ou suggérer des modifications à apporter à votre connecteur que vous pouvez envisager d’adopter. Lorsque vous créez un connecteur personnalisé, il est uniquement à disposition de vous-même et des utilisateurs avec lesquels vous le partagez explicitement. Pour qu’un connecteur soit visible dans la liste des connecteurs officiels pour tout utilisateur de Microsoft Power Automate, Microsoft Power Apps ou Microsoft Azure Logic Apps, il doit être certifié.
Quand certifier un connecteur personnalisé
De nombreux motifs justifient la certification de votre connecteur personnalisé, mais la convivialité, la visibilité et l’augmentation de la portée de votre API sont parmi les principaux. Certifiez votre connecteur personnalisé s’il donne accès à une API utile à une large audience et n’est pas réservé à un usage interne. Vous n’êtes pas obligé d’héberger le service sous-jacent de l’API sur des technologies Microsoft. En fait, les connecteurs sont avantageux pour l’intégration de solutions Microsoft Power Platform à des solutions autres que Microsoft. Vous pouvez certifier des connecteurs gratuitement ou avec des API payantes.
Les connecteurs certifiés sont examinés pour s’assurer qu’ils satisfont aux critères de certification avant leur publication. Il existe deux types d’éditeurs de connecteurs : vérifiés et indépendants.
Éditeurs vérifiés : une exigence clé est que vous devez être propriétaire du service sous-jacent ou présenter des droits explicites pour utiliser l’API, puis fournir un scénario utilisateur bien adapté aux produits.
Éditeurs indépendants : ne possèdent pas le service sous-jacent derrière leur connecteur. Par exemple, un utilisateur d’une API non affilié à la société peut envoyer un connecteur pour l’API pour certification. Ce type permet aux membres de la communauté de participer à l’écosystème de connecteurs Power Platform.
La certification initiale et les mises à jour du connecteur sont gratuites. L’unité suivante explique plus en détail le processus de certification.
Quand créer un connecteur personnalisé open source
Tout connecteur personnalisé que vous créez peut devenir open source si vous déterminez que d’autres utilisateurs pourraient en bénéficier. Lorsque vous certifiez un connecteur, votre première étape consiste à rendre la définition open source. Tout d’abord, vérifiez si une définition de connecteur personnalisé existante figure dans le référentiel de l’API que vous créez. Si vous trouvez une définition, nous vous recommandons de suggérer vos modifications pour l’améliorer en soumettant une demande de tirage au lieu de tenter de créer un connecteur en double.
Voici des exemples de cas où la création d’un connecteur personnalisé open source est la plus et la moins recommandée :
| Candidat open source optimal | Candidat open source médiocre |
|---|---|
| Connecteur pour une API accessible à tous | Connecteur pour une API privée disponible uniquement dans le réseau de votre société |
La plupart des contributions exigent que vous acceptiez un contrat de licence contributeur (CLA) déclarant que vous avez le droit d’accorder les droits d’utiliser votre contribution et que vous les accordez réellement. Pour en savoir plus, consultez le Contrat de licence contributeur.
Le référentiel GitHub comporte trois dossiers principaux comportant les connecteurs : custom-connectors, independent-publisher-connectors et certified-connectors.
Le dossier custom-connectors comporte des exemples de connecteurs entièrement fonctionnels pouvant être déployés dans Microsoft Power Platform pour extension et utilisation. Ces exemples peuvent ne pas être des connecteurs certifiés, mais sont créés et gérés par la communauté open source pour offrir des scénarios ou exemples utiles de concepts de connecteur.
Le dossier independent-publisher-connectors comporte des connecteurs envoyés par des éditeurs qui ne possèdent pas le service sous-jacent derrière leur connecteur. Ces connecteurs sont déployés et disponibles dans Power Platform en tant que connecteurs Premium. Tout utilisateur peut envoyer un nouveau connecteur dans ce dossier, ajouter des fonctionnalités aux connecteurs de ce dossier et résoudre les problèmes liés aux connecteurs de ce dossier. Le dossier est géré par la communauté des connecteurs d’éditeurs indépendants, qui comprend des éditeurs indépendants et des coordinateurs de projet. La branche principale est gérée par l’équipe chargée de la certification des connecteurs Microsoft, qui s’assure que la version du connecteur est identique à celle déployée dans Power Platform. La branche de développement est gérée par le(s) gestionnaire(s) du connecteur et l’équipe chargée de la certification des connecteurs Microsoft pour permettre le développement communautaire du connecteur avant la certification et le déploiement d’une version.
Le dossier certified-connectors comporte des connecteurs certifiés déjà déployés et utilisables, prêts à l’emploi, dans Microsoft Power Platform. Une exigence du programme de certification des connecteurs Microsoft est que les nouveaux connecteurs certifiés doivent être open source pour les contributions communautaires. L’équipe chargée de la certification des connecteurs Microsoft gère le dossier certified-connectors pour garantir que, dans la branche principale, la version du connecteur est identique à celle déployée dans Microsoft Power Platform. La branche de développement est gérée par le propriétaire du connecteur et l’équipe chargée de la certification des connecteurs Microsoft pour permettre le développement communautaire du connecteur avant la certification et le déploiement d’une version.
Pour contribuer au référentiel GitHub, commencez par prendre votre copie (ou créer une duplication) du référentiel. Les étapes sont expliquées dans la documentation Création d’une duplication. Après avoir créé une duplication, vous êtes prêt à préparer votre connecteur pour contribution à l’aide d’une demande de tirage. Vous pouvez télécharger les ressources de votre connecteur à l’aide de la CLI des connecteurs Microsoft Power Platform.
Télécharger à l’aide de la CLI des connecteurs Microsoft Power Platform
Préparez les fichiers nécessaires à la création d’un connecteur open source à l’aide de la commande paconn download à partir de la CLI des connecteurs Microsoft Power Platform.
Téléchargez les fichiers de connecteur personnalisé en exécutant la commande suivante :
paconn download
Lorsque vous exécutez cette commande, elle passe par une connexion de périphérique pour permettre à paconn d’accéder à votre environnement Microsoft Power Platform en votre nom. Une fois que vous avez été authentifié, paconn vous fournit une liste d’environnements à sélectionner, suivie d’une liste de connecteurs à sélectionner.
Si vous connaissez l’ID de votre environnement et l’ID de votre connecteur, vous pouvez utiliser la syntaxe de ligne de commande suivante pour éviter de recevoir une invite :
paconn download -e [Microsoft Power Platform Environment GUID] -c [Connector ID]
Le téléchargement comprend quatre fichiers :
apiDefintion.swagger.json : définition OpenAPI pour votre connecteur comprenant par exemple l’ensemble des déclencheurs et actions.
apiProperties.json : définit les modèles de stratégie et d’autres propriétés de connecteur étendues ne faisant pas partie des spécifications OpenAPI.
icon.png : petite icône permettant de représenter le service dans le concepteur lors de l’utilisation du connecteur.
settings.json : utilisé au lieu de fournir des paramètres à paconn.
Rendre votre connecteur personnalisé open source, puis le certifier permet à votre API de gagner en visibilité. En contribuant à la définition du connecteur dans le référentiel open source, votre connecteur personnalisé devient disponible pour d’autres utilisateurs. Lorsqu’une personne utilise un connecteur certifié, elle utilise une définition mise à jour automatiquement lorsque vous publiez des mises à jour. Lors de l’utilisation de la définition du connecteur open source, les utilisateurs doivent appliquer des mises à jour à leur propre copie. Le reste de ce module examine comment certifier votre connecteur personnalisé et comment gérer son cycle de vie au fil de son évolution.