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 de connecteur vous permettent d'interagir avec des services tiers directement à partir de la zone de dessin, sans configuration HTTP manuelle. Chaque connecteur fournit des nœuds pré-construits pour un service spécifique (par exemple, GitHub, Salesforce, Slack, Microsoft 365), avec des entrées typées, des sorties typées et une authentification automatique via Integration Service.

Les nœuds de connecteur apparaissent dans la palette de nœuds sous la catégorie Connecteur, regroupés par service.

How they work

Les nœuds de connecteur sont chargés dynamiquement à partir d'Integration Service d'UiPath. Les connecteurs disponibles dépendent de ce qui est configuré dans votre organisation Automation Cloud. Chaque nœud de connecteur correspond à une opération d'API spécifique sur le service cible.

Lorsque vous ajoutez un nœud de connecteur à la zone de dessin, Flow récupère son schéma d'entrée et affiche un formulaire de configuration dynamique dans le panneau Propriétés. Vous remplissez les champs requis, sélectionnez une connexion pour l'authentification et le nœud gère l'appel d'API lors du runtime.

Configuration

Connexion (Connection)

Chaque nœud de connecteur nécessite une connexion, un identifiant d'authentification préconfiguré géré dans Integration Service. La connexion est sélectionnée dans le panneau Propriétés lors de la configuration du nœud.

Les connexions gèrent automatiquement l'actualisation des jetons, les flux OAuth et le stockage des identifiants. Les en-têtes d'authentification et les secrets ne sont pas gérés directement.

Remarque :

Les connexions sont configurées dans le portail UiPath Automation Cloud sous Integration Service. Reportez-vous à la documentation d'Integration Service pour obtenir des instructions de configuration.

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 gestionnaires d'erreurs. Si l'appel d'API échoue et que le gestionnaire d'erreurs est connecté, l'exécution est acheminée vers le chemin d'erreur avec l'objet d'erreur à $vars.<nodeName>.error.

Reportez-vous à la section Gestion des erreurs pour plus de 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 détenues par le déclencheur et accessibles sous le nom de $vars.<triggerName>.output.<inputName>. Reportez-vous à la section Déclencheurs pour plus de 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 l'authentification automatique via Integration Service	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.

Connecteurs disponibles

La liste complète des connecteurs disponibles dépend de votre organisation Automation Cloud et de la configuration d'Integration Service. Pour obtenir une documentation spécifique au connecteur, y compris la configuration, l'authentification et les nœuds disponibles, reportez-vous à la documentation d'UiPath Integration Service :

Documentation des connecteurs Integration Service

Pages liées

• 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