Humain

Nœud humain pour suspendre un processus et affecter une tâche à l'examen, à l'approbation ou à l'entrée d'un humain.

Le nœud humain suspend le processus et attribue une tâche à une personne, puis reprend le processus une fois qu'il est terminé. Utilisez-le lorsqu'un processus nécessite un examen, une approbation ou une entrée humaine avant de pouvoir se poursuivre.

Quand utiliser Human vs Décision

Utilisez le nœud humain lorsqu'une personne doit examiner des informations et répondre avant que le processus ne se poursuive. Utilisez le nœud de décision lorsque la branche peut être résolue automatiquement à partir des données existantes, sans intervention humaine.

Le nœud humain achemine sur le résultat choisi par le bénéficiaire via ses propres gestionnaires de sortie. Rechercher une décision lorsque la branche suit des données existantes au lieu du choix d'une personne.

Types de nœuds humains

La tâche présentées à l'humain peut être créée via deux mécanismes: Formulaire rapide et Application d'action.

Formulaire rapide

Créez et déboguez un formulaire léger directement sur le nœud. Vous définissez les champs affichés par le bénéficiaire, les entrées qu'il doit fournir et les résultats qu'il peut choisir. Il s'agit de la valeur par défaut et de la meilleure adéquation aux approbations et à la collecte de données simple.

Application d’action

Les applications d'actions fournissent une interface plus riche et entièrement personnalisée pour la tâche affectée à l'humain. Ils peuvent être créés visuellement dans UiPath App Studio ou Studio Web, ou bien en tant qu'application d'action codée, une application React ou Angular personnalisée. Une application codée est sélectionnée sous Application d'action et ses entrées sont mappées au moment de la configuration. Reportez-vous à la section À propos des Coded Action Apps.

	Formulaire rapide	Application d’action
Défini par l’IU	Sur le nœud, versionné avec le processus	Application distincte, déployée dans Orchestrator
Réutiliser entre les Processes	Oui, en copiant et en collant JSON	Oui (Yes)
Coût	Aucune unité supplémentaire, aucune dépendance d’Apps	Nécessite le déploiement d'une application
Mise en page	Permet les mises en page multi-colonnes et multi-largeurs, comportement du champ	Contrôle total
Données au moment du rendu	Variables/expressions de processus liées uniquement	SDK: ressources, compartiments, connexions, Data Fabric, processus de déclenchement
Test	Débogage intégré à partir de la zone de dessin	Créer → déployer → exécuter
Compétences requises	Aucun (None)	App Studio, ou React/Angular pour les Apps codées

Astuce :

Commencez par un formulaire rapide. Passez à une application Action lorsque vous devez réutiliser la même interface pour les processus, afficher les données que le processus ne transporte pas déjà ou créer une interface utilisateur qu'un formulaire ne peut pas exprimer.

La création de l'application elle-même est couverte dans la documentation d'Action Apps. À partir de maintenant, cette page couvre le type de tâche Formulaire rapide . Pour obtenir une présentation pratique, reportez-vous à la section Ajouter une approbation humaine à un workflow.

Configuration

Champ	Requis	Default	Description
Critères d’attribution	Oui (Yes)	Utilisateur unique	Contrôle la façon dont le nœud humain sélectionne la personne qui obtient la tâche. Choisissez entre Utilisateur unique, Tous les utilisateurs, Round Robin, Charge de travail ou Personnalisé.
Schéma	Oui (Yes)	Envoyer le résultat	Structure du formulaire, y compris les champs que le bénéficiaire voit ou remplit et les résultats qu'il peut sélectionner. Reportez-vous à Schéma pour obtenir la structure complète.
Canaux de livraison	—	Définir au niveau du locataire	En lecture seule sur le nœud — les canaux disponibles sont hérités de la configuration au niveau du locataire et affichés sous forme de cases à cocher désactivées. Reportez-vous à la section Canaux de livraison pour de plus amples informations.
Titre de la tâche	Non (No)	Aucun (None)	Titre affiché au destinataire dans sa liste de tâches.
Priorité (Priority)	Non (No)	Aucun (None)	Priorité affichée dans Action Center : Faible, Moyenne ou Élevée.
Libellés	Non (No)	Aucun (None)	Libellés séparés par des virgules pour l'organisation des tâches, par exemple finance,approval.

Critères d’attribution

Les critères d'affectation contrôlent la ou les personnes qui reçoivent la tâche. La sélection d'un critère modifie le deuxième champ pour qu'il corresponde — un sélecteur d'utilisateur pour Utilisateur unique, un sélecteur de groupe pour les critères basés sur les groupes.

Critères	Qui obtient la tâche	Utilisez-le lorsque
Utilisateur unique	Une personne nommée.	Une personne spécifique est propriétaire de cette décision: un approbateur nommé, un réviseur unique
Tous les utilisateurs	Chaque membre du groupe à la fois. La première personne qui la termine ferme la tâche pour tout le monde.	Vous vous souciez de la vitesse de propriété. Celui qui est libre le récupère
Charge de travail	Le membre du groupe avec le moins de tâches ouvertes	Vous souhaitez que la file d'attente soit répartie uniformément au sein d'une équipe
Round Robin	Membres du groupe à leur tour, parcourant la liste des membres	Vous souhaitez que chaque membre puisse recevoir une part égale, quelle que soit la vitesse de travail
Personnalisé	Le membre ayant le moins de tâches ouvertes, choisi dans une liste d'utilisateurs que vous fournissez au moment du runtime plutôt que parmi l'adhésion complète à un groupe.	Modifications de l’éligibilité par exécution — ignorer les personnes qui sont absentes du bureau, en dehors de l’affectation ou qui se situe en dehors du rôle ou de la région approprié(e).

Exigences et limites

Important :

La charge de travail et Round Robin nécessitent un groupe local. Les groupes Active Directory sont rejetés pour les deux. Utilisez Utilisateur unique ou Tous les utilisateurs si vos bénéficiaires font partie d'un groupe Active Directory.

Dans le débogage, l'attribution de groupe ne fonctionne pas à partir d'un espace de travail personnel. Les exécutions de Debug créent la tâche dans votre espace de travail personnel, auquel les membres du groupe ne peuvent pas accéder — de sorte que la tâche est créée mais reste Non affectée et qu'aucune notification ne expire. Cela est attendu, et non un défaut. Déployez la solution dans un dossier partagé pour tester correctement l'attribution des groupes. L'affectation à un utilisateur unique fonctionne normalement dans le débogage.

Erreurs que vous pouvez voir:

Erreur	Signification
NoUsersFoundInLocalGroup	Le groupe sélectionné ne comprend aucun membre.
NoEligibleUsersFoundInGroup	Chaque membre a été exclu, il ne reste donc plus personne à affecter.

Schéma

Le schéma définit ce que voit le bénéficiaire et ce qu'il renvoie au processus. Il comporte deux parties: les champs et les résultats.

Champs

Le schéma peut également être modifié directement au format JSON. Reportez-vous à Tâches rapides pour obtenir la référence complète du schéma JSON. Dans la vue Formulaire, chaque champ a ces paramètres:

Paramètre	Ce qu’il fait
Label	Le nom complet affiché pour le bénéficiaire.
Saisie de texte	Contrôle la validation et le rendu de l’entrée. Types disponibles: Texte, Nombre, Nombre décimal, Date, Date et heure, Oui ou non, Sélection unique, Sélection multiple, Tableau, Fichier.
Liaison	Une expression qui préremplit le champ, par exemple $vars.requestAmt. Accepte toute expression de workflow, et pas seulement une référence de variable.
Modifiable	Le cadenas à côté de la valeur. Verrouillé signifie que le bénéficiaire peut lire la valeur mais pas la modifier.
Variable	Affiché sous la forme d'un badge (x) à côté du nom du champ. Générée automatiquement à partir des champs Libellé pour la sortie et Entrée/Sortie, exposant la valeur sous forme de variable de processus nommée en plus de $vars.<nodeName>.output.<fieldId>. Non présent dans les champs d'entrée.

Directions du champ

Les champs transportent des données dans et hors de la tâche. Chaque champ a une direction.

• Les champs Entrée constituent un contexte en lecture seule pour le destinataire, lié à une valeur de processus, par exemple $vars.start.output.employeeName.
• Les champs Sortie sont remplis par le destinataire et renvoyés au processus.
• Les champs In/Out font les deux : ils affichent au destinataire une valeur de processus comme point de départ et il peut la modifier avant qu'elle ne soit renvoyée au processus.

La direction d'un champ n'est pas un paramètre distinct. Elle est le résultat de deux contrôles: si le champ est lié détermine s'il arrive pré-rempli, et s'il est déverrouillé détermine si le bénéficiaire peut le modifier.

Liaison	Verrouillez	Direction	Voir le bénéficiaire	Modifiable et amp; Retourné
Ensemble	Verrouillé 🔃	Entrée	La valeur liée	Non (No)
Ensemble	Déverrouillé 🔓	Entrée/Sortie	La valeur liée	Oui (Yes)
Aucun (None)	Déverrouillé 🔓	Sortie	Un champ vide	Oui (Yes)
Aucun (None)	Verrouillé 🔃	Non valide	Un champ vide	Non (No)

Résultats

Les résultats sont les boutons que le destinataire utilise pour terminer la tâche, par exemple Approuver et Rejeter. Le schéma par défaut a un seul résultat Envoyer. Le premier résultat est marqué comme action primaire.

Chaque résultat ajoute son propre gestionnaire de sortie au nœud. Lorsque le destinataire sélectionne un résultat, le processus se poursuit à partir du gestionnaire de ce résultat, afin que vous puissiez acheminer chaque résultat vers un chemin différent. Reportez-vous à la section Ramification sur le résultat.

Canaux de livraison

Les tâches sont livrées à:

• Action Center
• E-mail (Email)
• Slack
• Microsoft Teams

Important :

Les canaux de livraison ne peuvent être modifiés qu’au niveau du locataire, à partir des paramètres d’administration. Les cases à cocher sur le nœud sont désactivées et reflètent la configuration actuelle du locataire.

Slack et Microsoft Teams nécessitent une connexion Integration Service. Reportez-vous à la section Notifications exploitables pour la configuration du connecteur.

Sortie

Accédez à la sortie du nœud dans $vars.<nodeName>.output et au résultat sélectionné dans $vars.<nodeName>.status.

sortie

Le résultat de la tâche : un objet contenant les valeurs que le destinataire a envoyées, classées par champ de sortie. Lisez un seul champ avec $vars.<nodeName>.output.<fieldId>. L'objet transporte également une propriété Action définie sur le résultat sélectionné.

statut

Le résultat que le destinataire a sélectionné, par exemple Approve. Ramifiez sur cette valeur pour acheminer le processus.

Branchement sur le résultat

Chaque résultat que vous définissez ajoute une gestion de sortie au nœud humain. Lorsque le bénéficiaire termine la tâche, le processus se poursuit à partir du gestionnaire pour le résultat qu'il a sélectionné. Connectez chaque gestion de résultat au nœud qui doit s’exécuter pour ce chemin. Vous n'avez pas besoin d'un nœud de décision pour diviser le résultat.

Human
  ├─ Approve → continue processing
  └─ Reject  → notify the requester and terminate

Lisez un champ soumis dans n'importe quel nœud en aval avec $vars.<nodeName>.output.<fieldId> :

// In a Script node on one of the outcome paths
return $vars.approval.output.comment;

Le résultat sélectionné est également disponible comme $vars.<nodeName>.status si vous en avez besoin dans une expression.

Problèmes couramment rencontrés

La tâche n'apparaît pas pour le destinataire

Vérifiez que le destinataire, qu'il s'agisse d'un utilisateur ou d'un groupe, est correct et a accès à Action Center.

Une valeur de sortie est manquante

Confirmez que le champ est défini dans le schéma avec la direction Sortie.

Un résultat est acheminé vers le mauvais chemin

Confirmez que la gestion de sortie de chaque résultat est connectée au nœud souhaité. Chaque résultat que vous définissez dans le schéma a sa propre gestion sur le nœud humain.

Remarques

Remarque :

Pour tester sans destinataire réel, utilisez une sortie simulée pour simuler une réponse status et une réponse output. Reportez-vous à la section Ajouter une approbation humaine à un workflow pour les étapes.

• Si le destinataire est un groupe, n'importe quel membre de ce groupe peut revendiquer et terminer la tâche.
• Pour obtenir une interface plus enrichie qu'un formulaire, reportez-vous à la tâche avec une application Action au lieu d'un formulaire rapide.

Pages liées

• Ajouter une approbation humaine à un workflow
• Décision
• Terminate
• Tâches de formulaire rapides