# Benutzerdefinierten Connector verwenden

So importieren Sie den Connector von PDF Blocks aus GitHub als benutzerdefinierten Connector, um Aktionen zu nutzen, bevor sie den veröffentlichten erreichen.

Der veröffentlichte Connector **PDF Blocks** in Power Automate ist von Microsoft
zertifiziert: Neue Aktionen und Parameter erreichen ihn daher im Prüfrhythmus von
Microsoft und nicht in unserem. Wenn Sie eine Funktion brauchen, die bereits in der
Definition des Connectors steckt, aber noch nicht in den veröffentlichten Connector
ausgerollt ist (die Aktionen zum Aufteilen und Neuanordnen, die
[Seitenauswahl](/docs/power-automate/extract-pages-from-pdf) oder die Optionen zur
Verschlüsselung), können Sie die neueste Definition selbst als **benutzerdefinierten
Connector** installieren, indem Sie sie aus GitHub importieren.

Die Definition des Connectors ist Open Source und liegt im Repository
[PowerPlatformConnectors](https://github.com/microsoft/PowerPlatformConnectors) von
Microsoft. Power Automate kann daraus direkt einen benutzerdefinierten Connector
bauen, sodass Sie nie Dateien von Hand kopieren.

<Note>
  Ein benutzerdefinierter Connector liegt in einer einzigen Umgebung von Power
  Platform und ist nicht zertifiziert. Er funktioniert genau wie der veröffentlichte
  Connector (dieselben Aktionen, derselbe API-Schlüssel), aber Sie pflegen ihn
  selbst: Importieren Sie ihn erneut, um spätere Updates zu übernehmen. Sobald der
  veröffentlichte Connector aufgeholt hat, können Sie Ihre Flows wieder zu ihm
  wechseln.
</Note>

## Bevor Sie beginnen

- Ein kostenpflichtiger Plan für Power Automate (pro Benutzer oder pro Flow),
  dieselbe Voraussetzung wie beim veröffentlichten Connector.
- Die Berechtigung, in Ihrer Umgebung benutzerdefinierte Connectors zu erstellen.
  Wenn Sie **Benutzerdefinierte Connectors** (*Custom connectors*) nicht sehen,
  fragen Sie Ihren Administrator für Power Platform.
- Ihr API-Schlüssel von PDF Blocks, bereit für den Moment, in dem Sie die
  Verbindung erstellen. Siehe [Erste
  Schritte](/docs/power-automate/getting-started), falls Sie noch keinen haben.

## Den Connector importieren

<Steps>

<Step title="Benutzerdefinierte Connectors öffnen">
  Klappen Sie in [Power Automate](https://make.powerautomate.com) das linke Menü auf,
  wählen Sie **Mehr** (*More*) und öffnen Sie **Benutzerdefinierte Connectors**.
  (Dieselbe Seite erreichen Sie auch im Maker-Portal von Power Apps unter **Alle
  entdecken → Benutzerdefinierte Connectors**.)
</Step>

<Step title="Einen neuen Connector aus GitHub starten">
  Wählen Sie die Option **+ Neuer benutzerdefinierter Connector** (*+ New custom
  connector*) und dann **Aus GitHub importieren** (*Import from GitHub*).

  <Frame caption="Neuer benutzerdefinierter Connector → Aus GitHub importieren.">
    <img
      src="/images/power-automate/use-a-custom-connector/01-new-custom-connector-menu.png"
      alt="Das Menü Neuer benutzerdefinierter Connector mit der Option Aus GitHub importieren"
    />
  </Frame>
</Step>

<Step title="Den Connector von PDF Blocks auswählen">
  Im Dialog **Aus GitHub importieren**:

  - Setzen Sie **Verbindertyp** (*Connector Type*) auf **Certified**: Damit wird aus
    dem Ordner der zertifizierten Connectors im Open-Source-Repository gelesen, wo
    PDF Blocks liegt.
  - Wählen Sie eine **Verzweigung** (*Branch*). Nehmen Sie die Verzweigung, die das
    gewünschte Update trägt (zum Beispiel `dev` für die neueste oder eine
    Release-Verzweigung für eine feste Version).
  - Setzen Sie **Connector** auf **PDF Blocks**.

  Wählen Sie **Weiter** (*Continue*).

  <Frame caption="Certified wählen, eine Verzweigung nehmen und den Connector von PDF Blocks auswählen.">
    <img
      src="/images/power-automate/use-a-custom-connector/02-import-from-github-dialog.png"
      alt="Der Dialog Aus GitHub importieren mit ausgewähltem Certified, der Verzweigung dev und dem Connector von PDF Blocks"
    />
  </Frame>

  <Tip>
    Über den Link **Click here to explore the open source repository** im Dialog
    sehen Sie sich die genaue Definition an, bevor Sie importieren.
  </Tip>
</Step>

<Step title="Den Connector erstellen">
  Power Automate lädt die Definition des Connectors in den Editor. Sie müssen nichts
  ändern. Gehen Sie bei Bedarf die Registerkarten **Allgemein** (*General*),
  **Sicherheit** (*Security*) und **Definition** durch, um sie zu prüfen, und wählen
  Sie dann oben rechts **Connector erstellen** (*Create connector*). Geben Sie ihm
  einen wiedererkennbaren Namen (zum Beispiel *PDF Blocks Next*), damit Sie ihn vom
  veröffentlichten Connector unterscheiden können.
</Step>

<Step title="Eine Verbindung erstellen">
  Wenn Sie zum ersten Mal eine Aktion aus Ihrem benutzerdefinierten Connector zu
  einem Flow hinzufügen, fragt Power Automate dieselben Parameter der Verbindung ab
  wie der veröffentlichte Connector: einen **Connection Name**, Ihren **API Key** und
  einen optionalen **Server Hostname**. Siehe [Erste
  Schritte](/docs/power-automate/getting-started#schritt-2-verbindung-erstellen)
  dafür, was jeder davon bedeutet.
</Step>

<Step title="Die neuen Aktionen verwenden">
  Fügen Sie in einem Flow eine Aktion hinzu und suchen Sie nach dem Namen, den Sie
  Ihrem benutzerdefinierten Connector gegeben haben. Seine Aktionen (darunter die,
  die noch nicht im veröffentlichten Connector sind, etwa [Nach Seitenanzahl
  aufteilen](/docs/power-automate/split-pdf-by-page-count) und [Seiten neu
  anordnen](/docs/power-automate/reorder-pages-of-pdf)) erscheinen neben allem
  anderen, bereit zum Konfigurieren.
</Step>

</Steps>

## Auf dem neuesten Stand halten

Ein benutzerdefinierter Connector ist eine Momentaufnahme der Definition zum
Zeitpunkt des Imports. Wenn wir weitere Updates ausliefern, wiederholen Sie **Aus
GitHub importieren** für denselben Connector (oder importieren und erstellen Sie ihn
neu), um ihn aufzufrischen. Da der benutzerdefinierte Connector und der
veröffentlichte Connector unabhängig sind, können Sie beide installiert lassen und
jeden Flow überführen, wenn Sie so weit sind.

## Siehe auch

<CardGroup cols={2}>

<Card title="Erste Schritte" href="/docs/power-automate/getting-started">
  Richten Sie Ihre erste Verbindung mit PDF Blocks und Ihren API-Schlüssel ein.
</Card>

<Card title="Dokumente zusammenführen" href="/docs/power-automate/merge-pdf-documents">
  Beginnen Sie mit einer zentralen Aktion, sobald Ihr Connector installiert ist.
</Card>

</CardGroup>