Connector-Knoten

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

Was sie sind

Mit Connector-Knoten können Sie direkt über die Arbeitsfläche mit Diensten von Drittanbietern interagieren, ohne manuelle HTTP-Konfiguration. 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, gruppiert nach Dienst.

How they work

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

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

Konfiguration

Verbindung (Connection)

Jeder Connectorknoten benötigt eine Verbindung, ein vorkonfiguriertes Anmeldeinformationen für die Authentifizierung, das im Integration Service verwaltet wird. Die Verbindung wird im Eigenschaftenbereich beim Konfigurieren des Knotens ausgewählt.

Verbindungen verarbeiten Tokenaktualisierungen, OAuth-Flows und Credential-Speicher automatisch. Authentifizierungsheader und Geheimnisse werden nicht direkt verwaltet.

Hinweis:

Verbindungen werden im UiPath Automation Cloud Portal unter Integration Service konfiguriert. Anweisungen zur Einrichtung finden Sie in der Dokumentation zum Integration Service .

Knotenspezifische Eingaben

Jeder Connectorknoten hat seine eigenen Eingabefelder, die auf dem API-Vorgang basieren, den er umschließt. Der Eigenschaftenbereich zeigt diese dynamisch an. Sie sehen andere Felder für einen „Problem erstellen“-Knoten als für einen „Repositorys auflisten“-Knoten, auch innerhalb desselben Connectors.

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

Ausgabe

Die Ausgabe des Connectorknotens ist unter $vars.<nodeName>.output verfügbar. Die Form der Ausgabe hängt vom spezifischen Knoten und der von ihm aufgerufenen API ab.

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

Fehlerbearbeitung

Connectorknoten unterstützen Fehlerhandles. Wenn der API-Aufruf fehlschlägt und ein Fehlerhandle verbunden ist, wird die Ausführung an den Fehlerpfad mit dem Standardfehlerobjekt unter $vars.<nodeName>.error weitergeleitet.

Weitere Informationen dazu finden Sie unter Fehlerbearbeitung .

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, ein Formular wird übermittelt). Connector-Trigger werden im Abschnitt Trigger der Knotenpalette angezeigt.

Triggereingaben befinden sich im Besitz des Triggers 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

Connector-Knoten verwenden, wenn …	HTTP-Anforderung verwenden, 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 volle Kontrolle über Header, Abfrageparameter und Textkörper
Sie möchten eine automatische Authentifizierung über den Integration Service	Die API verwendet ein nicht standardmäßiges Authentifizierungsschema
Sie möchten einen wartbaren Prozess, der sich an API-Änderungen anpasst	Sie erstellen ein Prototyp für eine neue oder interne API

Regel: Die Knotenpalette ist der erste Ort, an dem Sie nach einem Connector suchen können. HTTP-Anforderung ist das Fallback, wenn für den Zieldienst kein Connector vorhanden ist.

Verfügbare Connectors

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

Dokumentation zu Integration Service-Connectors

Zugehörige Seiten

• HTTP-Anforderungsknoten: Allgemeine API-Aufrufe, wenn kein Connector vorhanden ist
• Trigger: Connector-basierte Trigger und andere Triggertypen
• Fehlerbehandlung: Bearbeiten von Fehlern von Connectorknoten
• Variablen und Datenflow: Zugriff auf die Connector-Ausgabe mit $vars