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 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 von Microsoft. Power Automate kann daraus direkt einen benutzerdefinierten Connector bauen, sodass Sie nie Dateien von Hand kopieren.
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.
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, falls Sie noch keinen haben.
Den Connector importieren
Klappen Sie in Power Automate 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.)
Wählen Sie die Option + Neuer benutzerdefinierter Connector (+ New custom connector) und dann Aus GitHub importieren (Import from GitHub).
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
devfür die neueste oder eine Release-Verzweigung für eine feste Version). - Setzen Sie Connector auf PDF Blocks.
Wählen Sie Weiter (Continue).
Über den Link Click here to explore the open source repository im Dialog sehen Sie sich die genaue Definition an, bevor Sie importieren.
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.
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 dafür, was jeder davon bedeutet.
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 und Seiten neu anordnen) erscheinen neben allem anderen, bereit zum Konfigurieren.
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.