# 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](/docs/power-automate/extract-pages-from-pdf) 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](https://github.com/microsoft/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.

<Note>
  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.
</Note>

## 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](/docs/power-automate/getting-started) si vous n’en avez pas.

## Importer le connecteur

<Steps>

<Step title="Ouvrez Connecteurs personnalisés">
  Dans [Power Automate](https://make.powerautomate.com), 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**.)
</Step>

<Step title="Démarrez un nouveau connecteur depuis GitHub">
  Sélectionnez **+ Nouveau connecteur personnalisé** (*+ New custom connector*), puis
  choisissez **Importer à partir de GitHub** (*Import from GitHub*).

  <Frame caption="Nouveau connecteur personnalisé → Importer à partir de GitHub.">
    <img
      src="/images/power-automate/use-a-custom-connector/01-new-custom-connector-menu.png"
      alt="Le menu Nouveau connecteur personnalisé affichant l’option Importer à partir de GitHub"
    />
  </Frame>
</Step>

<Step title="Sélectionnez le connecteur PDF Blocks">
  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 `dev` pour 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*).

  <Frame caption="Choisissez Certified, prenez une branche et sélectionnez le connecteur PDF Blocks.">
    <img
      src="/images/power-automate/use-a-custom-connector/02-import-from-github-dialog.png"
      alt="La boîte de dialogue Importer à partir de GitHub avec Certified sélectionné, la branche dev et le connecteur PDF Blocks"
    />
  </Frame>

  <Tip>
    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.
  </Tip>
</Step>

<Step title="Créez le connecteur">
  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é.
</Step>

<Step title="Créez une connexion">
  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](/docs/power-automate/getting-started#étape-2-créer-une-connexion) pour savoir ce
  que signifie chacun d’eux.
</Step>

<Step title="Utilisez les nouvelles actions">
  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](/docs/power-automate/split-pdf-by-page-count) et [Réorganiser les pages d’un
  PDF](/docs/power-automate/reorder-pages-of-pdf), apparaissent à côté de tout le
  reste, prêtes à être configurées.
</Step>

</Steps>

## 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.

## Voir aussi

<CardGroup cols={2}>

<Card title="Prise en main" href="/docs/power-automate/getting-started">
  Configurez votre première connexion PDF Blocks et votre clé d’API.
</Card>

<Card title="Fusionner des documents PDF" href="/docs/power-automate/merge-pdf-documents">
  Commencez par une action essentielle une fois votre connecteur installé.
</Card>

</CardGroup>