Utiliser un connecteur personnalisé
Comment importer le connecteur PDF Blocks depuis GitHub en tant que connecteur personnalisé, pour utiliser des actions avant qu’elles n’arrivent dans le connecteur publié.
Le connecteur PDF Blocks publié dans Power Automate est certifié par Microsoft : les nouvelles actions et les nouveaux paramètres y arrivent donc au rythme de révision de Microsoft, et non au nôtre. Lorsque vous avez besoin d’une capacité déjà présente dans la définition du connecteur mais qui n’a pas encore été déployée dans le connecteur publié, comme les actions de division et de réorganisation, la sélection de pages ou les options de chiffrement, vous pouvez installer vous-même la définition la plus récente sous forme de connecteur personnalisé en l’important depuis GitHub.
La définition du connecteur est open source et vit dans le dépôt PowerPlatformConnectors de Microsoft. Power Automate peut construire un connecteur personnalisé directement à partir de celui-ci, si bien que vous n’avez jamais à copier de fichiers à la main.
Un connecteur personnalisé vit dans un seul environnement Power Platform et n’est pas certifié. Il fonctionne exactement comme le connecteur publié, avec les mêmes actions et la même clé d’API, mais c’est vous qui le maintenez : réimportez-le pour récupérer les mises à jour ultérieures. Lorsque le connecteur publié aura rattrapé son retard, vous pourrez y ramener vos flux.
Avant de commencer
- Un plan Power Automate payant (par utilisateur ou par flux), la même exigence que pour le connecteur publié.
- L’autorisation de créer des connecteurs personnalisés dans votre environnement. Si vous ne voyez pas Connecteurs personnalisés (Custom connectors), demandez à votre administrateur Power Platform.
- Votre clé d’API PDF Blocks, prête pour le moment où vous créerez la connexion. Consultez Prise en main si vous n’en avez pas.
Importer le connecteur
Dans Power Automate, déployez le menu de gauche, choisissez Plus (More) et ouvrez Connecteurs personnalisés. (Vous pouvez aussi atteindre la même page depuis le portail de création Power Apps, sous Découvrir tout → Connecteurs personnalisés.)
Sélectionnez + Nouveau connecteur personnalisé (+ New custom connector), puis choisissez Importer à partir de GitHub (Import from GitHub).
Dans la boîte de dialogue Importer à partir de GitHub :
- Réglez Type de connecteur (Connector Type) sur Certified : la lecture se fait alors dans le dossier des connecteurs certifiés du dépôt open source, là où se trouve PDF Blocks.
- Choisissez une Branche (Branch). Prenez la branche qui porte la mise à jour
dont vous avez besoin (par exemple
devpour la plus récente, ou une branche de publication pour une version figée). - Réglez Connecteur (Connector) sur PDF Blocks.
Sélectionnez Continuer (Continue).
Utilisez le lien Click here to explore the open source repository de la boîte de dialogue pour parcourir la définition exacte avant de l’importer.
Power Automate charge la définition du connecteur dans l’éditeur. Vous n’avez rien à modifier : parcourez les onglets Général (General), Sécurité (Security) et Définition (Definition) pour la vérifier si vous le souhaitez, puis sélectionnez Créer un connecteur (Create connector) en haut à droite. Donnez-lui un nom reconnaissable (par exemple PDF Blocks Next) pour le distinguer du connecteur publié.
La première fois que vous ajoutez à un flux une action de votre connecteur personnalisé, Power Automate vous demande les mêmes paramètres de connexion que le connecteur publié : un Connection Name, votre API Key et un Server Hostname facultatif. Consultez Prise en main pour savoir ce que signifie chacun d’eux.
Dans un flux, ajoutez une action et recherchez le nom que vous avez donné à votre connecteur personnalisé. Ses actions, y compris celles qui ne sont pas encore dans le connecteur publié, comme Diviser un PDF par nombre de pages et Réorganiser les pages d’un PDF, apparaissent à côté de tout le reste, prêtes à être configurées.
Le maintenir à jour
Un connecteur personnalisé est un instantané de la définition au moment de l’importation. Lorsque nous publierons d’autres mises à jour, répétez Importer à partir de GitHub sur le même connecteur (ou réimportez-le et recréez-le) pour le rafraîchir. Comme le connecteur personnalisé et le connecteur publié sont indépendants, vous pouvez garder les deux installés et faire migrer chaque flux quand vous êtes prêt.