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 anderen Apps arbeiten, ohne selbst HTTP-Anforderungen einrichten zu müssen. Jeder Connector bietet vorgefertigte Knoten für eine App, z. B. GitHub, Salesforce, Slack oder Microsoft 365, mit typisierten Eingaben und Ausgaben sowie einer Verbindung, die die Anmeldung für Sie übernimmt.

Connector-Knoten befinden sich in der Kategorie Connector des Bereichs Knoten hinzufügen . Die Kategorie beginnt mit HTTP-Anforderung (HTTP Request), die eine beliebige Webadresse aufruft, gefolgt von den Apps von Act! 365 weiter. Jede App öffnet die Liste ihrer Aktionen.

Verfügbare Connectors

Die für Sie verfügbaren Konnektoren hängen von Ihrer Organisation ab. In der Kategorie Konnektoren des Bereichs Knoten hinzufügen werden alle aufgelistet. Sie decken Apps wie Salesforce, ServiceNow und Slack ab. Beliebte Connectors sind Links zu den häufigsten Connectors und Connectors im Integration Service-Handbuch dokumentieren jeden einzelnen mit Setup, Anmeldung und Vorgängen.

How they work

Im Bereich Knoten hinzufügen sind die in Ihrer Organisation verfügbaren Connectors aufgeführt. Jeder Connector-Knoten ist einem bestimmten API-Vorgang auf dem Zieldienst zugeordnet.

When you add a connector node to the canvas, Maestro Orchestrate fetches its input schema and renders a dynamic configuration form in the properties panel. You fill in the required fields, select a connection for authentication, and the node handles the API call at runtime.

Konfiguration

Verbindung (Connection)

Every connector node needs a connection, which signs UiPath in to the app with your account. You select the connection in the properties panel when you set up the node. The connection field lists the existing connections, grouped by folder, with Add new connection to create one without leaving the canvas, and Open connections to review all of them. Create a connection has the steps.

Connections handle token refresh, OAuth workflows, and credential storage automatically. Auth headers and secrets are not managed directly. Connections are managed by Integration Service. Connections in the Integration Service guide describes how to share and manage them.

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

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

Die Fehlerbehandlung enthält die Details.

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.

Triggereingaben befinden sich im Besitz des Triggers und werden als $vars.<triggerName>.output.<inputName> aufgerufen. Trigger hat die Details.

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, dass eine Verbindung die Anmeldung für Sie übernimmt	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.

Nächste Schritte

• Beliebte Connectors: Die gängigsten Apps mit einem Link zu jedem Connector
• Create a connection: create a connection from the node
• 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