Nœuds du connecteur

Nœuds de connecteur qui intègrent des services tiers directement sur la zone de dessin avec des opérations pré-construites.

Ce qu'ils sont

Les nœuds du connecteur vous permettent de travailler avec d’autres applications directement à partir du canevas sans configurer vous-même des requêtes HTTP. Chaque connecteur fournit des nœuds prêts à l'emploi pour une application, telle que GitHub, Salesforce, Slack ou Microsoft 365, avec des entrées et des sorties saisies et une connexion qui gère la connexion pour vous.

Les nœuds de connecteur se trouvent dans la catégorie Connecteur du panneau Ajouter un nœud . La catégorie commence par la requête HTTP, qui appelle n'importe quelle adresse Web, suivie des applications, depuis Act! 365). Chaque application ouvre la liste de ses actions.

Connecteurs disponibles

Les connecteurs disponibles dépendent de votre organisation et la catégorie Connecteur du panneau Ajouter un nœud les répertorie tous. Elles couvrent des applications telles que Salesforce, ServiceNow et Slack. Les connecteurs populaires sont liés aux plus courants, et les connecteurs du guide d'Integration Service documentent chacun d'eux, avec sa configuration, sa connexion et ses opérations.

How they work

Le panneau Ajouter un nœud répertorie les connecteurs disponibles dans votre organisation. Chaque nœud de connecteur correspond à une opération d'API spécifique sur le service cible.

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.

Configuration

Connexion (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.

Entrées spécifiques au nœud

Chaque nœud de connecteur a ses propres champs d'entrée en fonction de l'opération d'API qu'il englobe. Le panneau Propriétés les affiche dynamiquement. Vous verrez différents champs pour un nœud « Créer un problème » que pour un nœud « Répertorier les référentiels », même dans le même connecteur.

Tous les champs d'entrée prennent en charge les expressions de variables ($vars.<nodeName>.<property>).

Sortie

La sortie du nœud de connexion est disponible à $vars.<nodeName>.output. La forme de la sortie dépend du nœud spécifique et de l'API qu'il appelle.

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

Gestion des erreurs

Les nœuds de connecteur prennent en charge les gestions des erreurs. Si l'appel d'API échoue et qu'une gestion des erreurs est connectée, l'exécution se poursuit sur le chemin de l'erreur avec l'objet d'erreur standard au niveau de $vars.<nodeName>.error.

La gestion des erreurs contient des détails.

Déclencheurs du connecteur

Certains connecteurs fournissent également des déclencheurs : des événements de démarrage qui se déclenchent lorsque quelque chose se produit dans le service externe (par exemple, un nouvel e-mail arrive, un formulaire est envoyé). Les déclencheurs du connecteur apparaissent dans la section Déclencheurs de la palette de nœuds.

Les entrées du déclencheur sont la propriété du déclencheur et sont accessibles en tant que $vars.<triggerName>.output.<inputName>. Le déclencheur a les détails.

Quand utiliser un connecteur par rapport à une demande HTTP

Utilisez un nœud de connecteur lorsque...	Utiliser la demande HTTP lorsque...
Un connecteur existe pour votre service cible	Aucun connecteur n'existe pour le service
Vous souhaitez des entrées et des sorties typées sans configuration manuelle	Vous avez besoin d'un contrôle total sur les en-têtes, les paramètres de requête et le corps
Vous souhaitez qu’une connexion gère la connexion pour vous	L'API utilise un schéma d'authentification non standard
Vous souhaitez un processus maintenable qui s'adapte aux modifications de l'API	Vous créez un prototype à partir d'une API nouvelle ou interne

Règle de base : la palette de nœuds est le premier endroit où il faut chercher un connecteur. La demande HTTP est la solution de secours lorsqu'aucun connecteur n'existe pour le service cible.

Prochaines étapes

• Connecteurs populaires: les applications les plus courantes, avec un lien vers chaque connecteur
• Create a connection: create a connection from the node
• Nœud de demande HTTP : appels d'API à usage général lorsqu'aucun connecteur n'existe
• Déclencheurs : déclencheurs basés sur des connecteurs et autres types de déclencheurs
• Gestion des erreurs : gestion des échecs des nœuds du connecteur
• Variables et flux de données : accès à la sortie du connecteur avec $vars