Tâche humaine

Suspendez un processus pour affecter une tâche à l'examen, à l'approbation ou à l'entrée d'un humain.

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

Cette page couvre le type de tâche Formulaire rapide , où vous créez le formulaire directement sur le nœud. Pour obtenir une présentation pratique, reportez-vous à la section Ajouter une approbation humaine à un workflow.

Quand utiliser Human Task vs Décision

Utilisez le nœud Tâche humaine 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 Tâche humaine achemine sur le résultat choisi par le bénéficiaire via ses propres gestions de sortie. Rechercher une décision lorsque la branche suit des données existantes au lieu du choix d'une personne.

Types de tâches

Le champ Type contrôle la façon dont la tâche est présentée au bénéficiaire.

Formulaire rapide

Créez le formulaire directement sur le nœud. Vous définissez les champs affichés par le bénéficiaire 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. Le reste de cette page documente le formulaire Quick Form.

Application personnalisée

Retournez la tâche avec une application d'action codée pour une interface personnalisée plus riche. Sélectionnez l'application sous Action App (Application d'action) et mappez ses entrées. La création de l'application elle-même est couverte dans la documentation d'Action Apps.

Configuration

Champ	Requis	Default	Description
Saisie de texte	Oui (Yes)	Formulaire rapide	Mode de présentation de la tâche. Quick Form présente un formulaire défini sur le nœud; L'application personnalisée présente une application d'action codée.
Canaux de livraison	Oui (Yes)	Action Center et l'e-mail, attribués à un groupe	Destinations de livraison de tâches et bénéficiaire. Les canaux pris en charge sont Action Center, E-mail, Slack et Microsoft Teams; Slack et Microsoft Teams nécessitent une connexion Integration Service.
Schéma de la tâche	Oui (Yes)	Soumettre 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 au Schéma: champs et résultats de la structure complète.
Titre de la tâche	Non (No)	Aucun (None)	Titre affiché pour le bénéficiaire 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)	Des libellés séparés par des virgules pour organiser les tâches, par exemple finance,approval.

Schéma: champs et résultats

Le schéma de tâche 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

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

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

Chaque champ contient un type. Types disponibles:

• text
• number
• date
• boolean
• file

Résultats

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

Chaque résultat ajoute sa propre gestion de sortie au nœud. Lorsque le bénéficiaire sélectionne un résultat, le processus se poursuit à partir du contrôle de ce résultat, vous permettant d’acheminer chaque résultat vers un chemin différent. Référez-vous à Brancher sur le résultat.

Sortie

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

sortie

Le résultat de la tâche: un objet contenant les valeurs soumises par le bénéficiaire, clés par champ de sortie. Lire un seul champ avec $vars.<nodeName>.output.<fieldId>. L’objet comporte également une propriété Action définie sur le résultat sélectionné.

statut

Le résultat sélectionné par le bénéficiaire, par exemple Approve. Branchez-vous sur cette valeur pour acheminer le processus.

Ramification sur le résultat

Chaque résultat que vous définissez ajoute une gestion de sortie au nœud Human Task (Tâche humaine). 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 Task
  ├─ 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 en tant que $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 bénéficiaire

Vérifiez que le bénéficiaire, 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 dans la sortie

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

Un résultat mène au chemin incorrect

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 son propre handle sur le nœud Human Task (Tâche humaine).

Remarques

Remarque :

Pour tester sans bénéficiaire réel, utilisez la sortie simulée pour simuler une réponse status et output . Référez-vous à la section Ajouter une approbation humaine à un workflow pour connaître les étapes.

• Si le bénéficiaire est un groupe, tout membre de ce groupe peut demander et terminer la tâche.
• Pour obtenir une interface plus enrichie qu'un formulaire, définissez le type sur Application personnalisée et backez la tâche avec une application d'action.

Pages liées

• Ajouter une approbation humaine à un workflow
• Décision
• Terminate