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édéfinies.

Ce qu'ils sont

Les nœuds de connecteur vous permettent d’interagir avec des services tiers directement à partir du canevas sans configuration HTTP manuelle. Chaque connecteur fournit des nœuds prédéfinis pour un service spécifique (par exemple, GitHub, Salesforce, Slack, Microsoft 365), avec des entrées saisies, des sorties saisies et une authentification automatique via Integration Service.

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

How they work

Les nœuds de connecteur sont chargés dynamiquement depuis Integration Service d'UiPath. Les connecteurs disponibles dépendent de ce qui a été 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 au moment du runtime.

Configuration

Connexion (Connection)

Chaque nœud de connecteur nécessite une connexion, des informations d’identification d’authentification préconfigurées gérées 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 informations d’identification. Les en-têtes et les clés secrètes d’authentification ne sont pas gérées directement.

Remarque :

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

Entrées spécifiques aux nœuds

Chaque nœud de connecteur a ses propres champs d'entrée en fonction de l'opération d'API qu'il encapsule. Le panneau Propriétés les restitue dynamiquement. Vous verrez des champs différents pour un nœud « Créer un problème» par rapport à un nœud « Répertorier les référentiels», même au sein du 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 du connecteur est disponible au niveau de $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 d'erreur est connectée, l'exécution est redirigée vers le chemin d'erreur avec l'objet d'erreur standard au niveau de $vars.<nodeName>.error.

Reportez-vous à la section Gestion des erreurs pour de plus amples informations.

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 soumis). Les déclencheurs du connecteur apparaissent dans la section Déclencheurs de la palette des 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>. Reportez-vous à la section Déclencheurs pour de plus amples informations.

Quand utiliser un connecteur vs requête HTTP

Utiliser un nœud de connecteur lorsque...	Utiliser la requête HTTP quand...
Un connecteur existe pour votre service cible	Aucun connecteur n’existe pour le service
Vous souhaitez des entrées et des sorties saisies 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 une 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 réalisez le prototypage par rapport à une API nouvelle ou interne

Règle de base: la palette de nœuds est le premier endroit où vérifier un connecteur. La requête HTTP est le recours 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 la documentation spécifique au connecteur, y compris la configuration, l'authentification et les nœuds disponibles, reportez-vous à la documentation de UiPath Integration Service:

Documentation des connecteurs Integration Service

Pages liées

• Nœud de requête 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éder à la sortie du connecteur avec $vars