Connector-Knoten

Connector-Knoten, die Dienste von Drittanbietern direkt auf der Arbeitsfläche mit vorgefertigten Vorgängen integrieren.

Was sie sind

Connector-Knoten ermöglichen es Ihnen, direkt über die Arbeitsfläche mit Diensten von Drittanbietern zu interagieren, ohne eine manuelle HTTP-Konfiguration vornehmen zu müssen. Jeder Connector bietet vorgefertigte Knoten für einen bestimmten Dienst (z. B. GitHub, Salesforce, Slack, Microsoft 365) mit typisierten Eingaben, typisierten Ausgaben und automatischer Authentifizierung über Integration Service.

Connector-Knoten werden in der Knotenpalette unter der Kategorie „Connector“ angezeigt und nach Dienst gruppiert.

How they work

Connector-Knoten werden dynamisch aus dem Integration Service von UiPath geladen. Die verfügbaren Connectoren hängen davon ab, was in Ihrer Automation Cloud-Organization konfiguriert ist. Jeder Connector-Knoten ist einem bestimmten API-Vorgang im Zieldienst zugeordnet.

Wenn Sie der Arbeitsfläche einen Connector-Knoten hinzufügen, ruft Flow dessen Eingabeschema ab und rendert ein dynamisches Konfigurationsformular im Eigenschaftenbereich. Sie füllen die erforderlichen Felder aus, wählen eine Verbindung für die Authentifizierung aus, und der Knoten führt den API-Aufruf zur Runtime aus.

Konfiguration

Verbindung (Connection)

Jeder Connector-Knoten erfordert eine Verbindung, also vorkonfigurierte Anmeldeinformationen für die Authentifizierung, die in Integration Service verwaltet werden. Die Verbindung wird bei der Konfiguration des Knotens im Eigenschaftenbereich ausgewählt.

Verbindungen übernehmen automatisch die Token-Aktualisierung, OAuth-Flows und die Speicherung der Anmeldeinformationen. Authentifizierungs-Header und Geheimnisse werden nicht direkt verwaltet.

Hinweis:

Verbindungen werden im UiPath Automation Cloud Portal unter Integration Service konfiguriert. Einrichtungsanweisungen finden Sie in der Integration Service-Dokumentation.

Knotenspezifische Eingaben

Jeder Connector-Knoten verfügt über eigene Eingabefelder, die auf dem API-Vorgang basieren, den er kapselt. Der Eigenschaftenbereich rendert diese dynamisch. Für einen „Create Issue“-Knoten werden andere Felder angezeigt als für einen „List Repositories“-Knoten, auch innerhalb desselben Connectors.

Alle Eingabefelder unterstützen Variablenausdrücke ($vars.<nodeName>.<property>).

Ausgabe

Die Ausgabe des Connector-Knotens ist unter $vars.<nodeName>.output verfügbar. Die Struktur der Ausgabe hängt vom jeweiligen Knoten und der von ihm aufgerufenen API ab.

// Access the output of a GitHub connector node named "listBranches1"
$vars.listBranches1.output

Fehlerbearbeitung

Connector-Knoten unterstützen Error-Handles. Wenn der API-Aufruf fehlschlägt und ein Error-Handle verbunden ist, wird die Ausführung mit dem Standard-Fehlerobjekt unter $vars.<nodeName>.error an den Error-Pfad weitergeleitet.

Weitere Informationen finden Sie unter Fehlerbehandlung.

Connector-Trigger

Einige Connectors bieten auch Trigger: Startereignisse, die ausgelöst werden, wenn etwas im externen Dienst passiert (z. B. eine neue E-Mail eintrifft oder ein Formular übermittelt wird). Connector-Trigger werden im Abschnitt „Trigger“ der Knotenpalette angezeigt.

Trigger-Eingaben gehören zum Trigger und werden als $vars.<triggerName>.output.<inputName> aufgerufen. Weitere Informationen dazu finden Sie unter Trigger.

Wann ein Connector im Vergleich zu HTTP Request verwendet werden sollte

Verwenden Sie einen Connector-Knoten, wenn …	Verwenden Sie HTTP Request, wenn …
Für Ihren Zieldienst ist ein Connector vorhanden.	Für den Dienst ist kein Connector vorhanden.
Sie möchten typisierte Eingaben und Ausgaben ohne manuelle Konfiguration.	Sie benötigen die vollständige Kontrolle über Header, Abfrageparameter und das Body-Format.
Sie möchten eine automatische Authentifizierung über Integration Service.	Die API verwendet ein nicht standardmäßiges Authentifizierungsschema.
Sie möchten einen wartbaren Prozess, der sich an API-Änderungen anpasst.	Sie erstellen einen Prototyp für eine neue oder interne API.

Faustregel: Die Knotenpalette ist der erste Ort, an dem Sie nach einem Connector suchen sollten. HTTP Request ist der Fallback, wenn kein Connector für den Zieldienst vorhanden ist.

Verfügbare Connectors

Die vollständige Liste der verfügbaren Connectoren hängt von Ihrer Automation Cloud-Organization und Ihrer Konfiguration in Integration Service ab. Connector-spezifische Dokumentation, einschließlich Einrichtung, Authentifizierung und verfügbaren Knoten, finden Sie in der UiPath Integration Service-Dokumentation:

Dokumentation zu Integration Service-Connectors

Zugehörige Seiten

• HTTP Request-Knoten: Allgemeine API-Aufrufe, wenn kein Connector vorhanden ist
• Trigger: Connector-basierte Trigger und andere Trigger-Typen
• Fehlerbehandlung: Behandlung von Fehlern in Connector-Knoten
• Variablen und Datenfluss: Zugriff auf die Connector-Ausgabe mit $vars