Formulaire rapide

Pause a workflow and ask a human to review, approve, or fill in a form that you build on the node, then continue with their answer.

Quick Form pauses the workflow and assigns a task to a human: a form that you build directly on the node. The human reviews it, fills it in, and selects an outcome, such as Approve or Reject, and the workflow continues on that outcome's path. It's in the Human category of the Add node panel.

Use Quick Form for approvals and straightforward data collection. When you need a richer interface, reuse one across workflows, or show data the workflow doesn't already carry, use an Action App instead. Add human approval to a workflow walks through a Quick Form step by step.

When to use Quick Form vs Decision

Use Quick Form when a human needs to review information and respond before the workflow continues. Use Decision when the branch can be resolved automatically from existing data, without a human.

Configuration

Champ	Requis	Default	Description
Critères d’attribution	Oui (Yes)	Utilisateur unique	Contrôle la façon dont le nœud sélectionne l'utilisateur 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	Form structure, including fields the assignee sees or fills in and outcomes they can select. The Schema section describes the full structure.
Canaux de livraison	—	Set by your administrator	Read-only on the node. The available channels come from your administrator's settings and show as disabled checkboxes. The Delivery channels section has details.
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

Assignment criteria controls which users receive the task. Selecting a criterion changes the second field to match — a user picker for Single User, a group picker for the group-based criteria.

Critères	Qui obtient la tâche	Utilisez-le lorsque
Utilisateur unique	One named user.	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 qui se 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.	Eligibility changes per run — skipping users who are out of office, off shift, or outside the right role or region.

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.

In debug, group assignment doesn't work. A test run creates the task where only you can see it, so group members can't open it. The task stays Unassigned, and no notifications go out. This is expected. To test group assignment, deploy the workflow and start a run. Single-user assignment works normally in debug.

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

The Schema can also be edited directly as JSON. The full JSON schema reference is in Quick Form tasks. In the Form view, each field has these settings:

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.

Each outcome adds its own output handle to the node. When the assignee selects an outcome, the process continues from that outcome's handle, so you can route each outcome to a different path. The Branching on the result section shows how.

Canaux de livraison

Les tâches sont livrées à:

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

Important :

Seul un administrateur peut modifier les canaux de livraison dans Paramètres d’administration. Les cases à cocher sur le nœud sont désactivées et affichent les paramètres actuels.

Slack et Microsoft Teams ont besoin d’une connexion. Les notifications exploitables couvrent 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

Each outcome you define adds an output handle to the node. When the assignee completes the task, the process continues from the handle for the outcome they selected. Connect each outcome handle to the node that should run for that path. You don't need a Decision node to split on the outcome.

Quick Form
  ├─ 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

Confirm each outcome's output handle is connected to the node you intend. Each outcome you define in the schema has its own handle on the node.

Remarques

Remarque :

To test without a real assignee, use Mock output to simulate a status and output response. Add human approval to a workflow has the steps.

• Si le destinataire est un groupe, n'importe quel membre de ce groupe peut revendiquer et terminer la tâche.
• For a richer interface than a form, use an Action App instead.

Prochaines étapes

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