Personalwesen

Human node for pausing a process and assigning a task for human review, approval, or input.

The Human node pauses the process and assigns a task to a person, then resumes the process once they complete it. Use it when a process needs human review, approval, or input before it can continue.

When to use Human vs Decision

Use the Human node when a person needs to review information and respond before the process continues. Use the Decision node when the branch can be resolved automatically from existing data, without human involvement.

The Human node routes on the assignee's chosen outcome through its own output handles. Reach for a Decision when the branch follows from existing data instead of a person's choice.

Human node types

The task presented to the human can be created via two mechanisms: Quick form and Action app.

Schnellformular

Build and debug a lightweight form directly on the node. You define the fields the assignee sees, the inputs they need to provide and the outcomes they can choose. This is the default and the best fit for approvals and straightforward data collection.

Action app

Action apps provide a richer, fully customized interface for the task assigned to the human. They can be built visually in UiPath App Studio or Studio Web, or as a Coded Action App—a custom React or Angular application. A coded app is selected under Action App, and its inputs are mapped at configuration time. Refer to About Coded Action Apps.

	Schnellformular	Action app
UI defined	On the node, versioned with the process	Separate app, deployed to Orchestrator
Reuse across processes	Yes, by copying and pasting JSON	Ja
Kosten	No additional units, no Apps dependency	Requires app deployment
Layout	Allows multi-column, multi-width layouts, Field behavior	Full control
Data at render time	Bound process variables/expressions only	SDK: assets, buckets, connections, Data Fabric, trigger processes
Tests	Inline debug from canvas	Build → deploy → run
Build skills required	Keine	App Studio, or React/Angular for coded Apps

Tipp:

Start with a Quick form. Move to an Action app when you need to reuse the same interface across processes, show data the process does not already carry, or build a UI a form cannot express.

Building the app itself is covered in the Action Apps documentation. From this point onward, this page covers the Quick form task type. For a hands-on walkthrough, refer to Add human approval to a workflow.

Konfiguration

Feld	Erforderlich	Standard	Beschreibung
Assignment criteria	Ja	Single User	Controls how the Human node picks the person who gets the task. Choose between Single User, All users, Round Robin, Workload, or Custom.
Schema	Ja	Ergebnis übermitteln	Form structure, including fields the assignee sees or fills in and outcomes they can select. Refer to Schema for the full structure.
Bereitstellungskanäle	–	Set at tenant level	Read-only on the node — the available channels are inherited from tenant-level configuration and shown as disabled checkboxes. Refer to Delivery channels for details.
Aufgabentitel	Nein	Keine	Titel, der dem Beauftragten in seiner Aufgabenliste angezeigt wird.
Priorität	Nein	Keine	Im Action Center angezeigte Priorität: Niedrig, Mittel oder Hoch.
Beschriftungen	Nein	Keine	Durch Kommas getrennte Beschriftungen zum Organisieren von Aufgaben, z. B. finance,approval.

Assignment criteria

Assignment criteria controls which person or people 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.

Kriterien	Who gets the task	Verwenden Sie sie, wenn
Single User	One named person.	A specific individual owns this decision — a named approver, a single reviewer
All users	Every member of the group at once. The first person to complete it closes the task for everyone.	You care about speed over ownership. Whoever is free picks it up
Workload	The one group member with the fewest open tasks	You want the queue spread evenly across a team
Round Robin	Group members in turn, cycling through the membership list	You want each member to take an equal share regardless of how fast they work
Benutzerdefiniert	The member with the fewest open tasks, chosen from a list of users you supply at runtime rather than from a group's full membership.	Eligibility changes per run — skipping people who are out of office, off shift, or outside the right role or region.

Anforderungen und Limits

Wichtig:

Workload and Round Robin require a local group. Active Directory groups are rejected for both. Use Single User or All users if your assignees are in an Active Directory (AD) group.

In debug, group assignment does not work from a personal workspace. Debug runs create the task in your personal workspace, which group members cannot access — so the task is created but stays Unassigned, and no notifications go out. This is expected, not a defect. Deploy the solution to a shared folder to test group assignment properly. Single-user assignment works normally in debug.

Errors you may see:

Fehler (Error)	Bedeutung
NoUsersFoundInLocalGroup	The selected group has no members.
NoEligibleUsersFoundInGroup	Every member was excluded, so there is nobody left to assign to.

Schema

The Schema defines what the assignee sees and what they return to the process. It has two parts: fields and outcomes.

Felder

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

Einstellung	Was es tut
Label	The display name shown to the assignee.
Typ	Controls validation and how the input renders. Available types: Text, Number, Decimal number, Date, Date and time, Yes or no, Single select, Multi-select, Array, File.
Binding	An expression that pre-populates the field, for example $vars.requestAmt. Accepts any workflow expression, not only a variable reference.
Bearbeitbar	The padlock next to the value. Locked means the assignee can read the value but not change it.
Variable	Shown as an (x) badge next to the field name. Auto-derived from the Label for Output and In/Out fields, exposing the value as a named process variable in addition to $vars.<nodeName>.output.<fieldId>. Not present on Input fields.

Field directions

Felder übertragen Daten in die Aufgabe und aus ihr heraus. Jedes Feld hat eine Richtung.

• Eingabefelder sind ein schreibgeschützter Kontext für den Beauftragten, der an einen Prozesswert gebunden ist, z. B. $vars.start.output.employeeName.
• Ausgabefelder werden vom Beauftragten ausgefüllt und an den Prozess zurückgegeben.
• In/Out- Felder erfüllen beides: Sie zeigen dem Beauftragten einen Prozesswert als Ausgangspunkt an, und der Beauftragte kann ihn bearbeiten, bevor er an den Prozess zurückgegeben wird.

A field's direction is not a separate setting. It is the result of two controls: whether the field is bound determines if it arrives pre-filled, and whether it is unlocked determines if the assignee can change it.

Binding	Padlock	Richtung	Assignee sees	Editable & returned
Set (Satz)	Locked 🔒	Eingabe	The bound value	Nein
Set (Satz)	Unlocked 🔓	Ein/Aus	The bound value	Ja
Keine	Unlocked 🔓	Ausgabe	An empty field	Ja
Keine	Locked 🔒	Not valid	An empty field	Nein

Ergebnisse

Ergebnisse sind die Schaltflächen, die der Beauftragte zum Abschließen der Aufgabe verwendet, z. B. Genehmigen und Ablehnen. Das Standardschema hat ein einziges Einreichungsergebnis . Das erste Ergebnis ist als primäre Aktion markiert.

Jedes Ergebnis fügt dem Knoten ein eigenes Ausgabe-Handle hinzu. Wenn der Beauftragte ein Ergebnis auswählt, wird der Prozess ab dem Handle dieses Ergebnisses fortgesetzt, sodass Sie jedes Ergebnis an einen anderen Pfad weiterleiten können. Siehe Verzweigung für das Ergebnis.

Delivery channels

Tasks are delivered to:

• Action Center
• E-Mail
• Slack
• Microsoft Teams

Wichtig:

Delivery channels can only be modified at the tenant level, from Admin settings. The checkboxes on the node are disabled and reflect the current tenant configuration.

Slack and Microsoft Teams require an Integration Service connection. Refer to Actionable notifications for connector setup.

Ausgabe

Greifen Sie auf die Ausgabe des Knotens unter $vars.<nodeName>.output und das ausgewählte Ergebnis unter $vars.<nodeName>.status zu.

Ausgabe

Das Aufgabenergebnis: ein Objekt, das die vom Beauftragten übermittelten Werte enthält, verschlüsselt durch das Ausgabefeld. Lesen Sie ein einzelnes Feld mit $vars.<nodeName>.output.<fieldId>. Das Objekt verfügt auch über eine Action -Eigenschaft, die auf das ausgewählte Ergebnis festgelegt ist.

Status

Das Ergebnis, das der Beauftragte ausgewählte, z. B. Approve. Verzweigen Sie diesen Wert, um den Prozess weiterzuleiten.

Verzweigung für das Ergebnis

Each outcome you define adds an output handle to the Human 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.

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

Lesen Sie ein übermitteltes Feld in einem beliebigen nachgelagerten Knoten mit $vars.<nodeName>.output.<fieldId>:

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

Das ausgewählte Ergebnis ist auch als $vars.<nodeName>.status verfügbar, wenn Sie es in einem Ausdruck benötigen.

Häufige Probleme

Aufgabe wird für den Beauftragten nicht angezeigt

Stellen Sie sicher, dass der Beauftragte, ob ein Benutzer oder eine Gruppe, korrekt ist und Zugriff auf das Action Center hat.

An output value is missing

Confirm the field is defined in the Schema with direction Output.

Ein Ergebnis leitet den falschen Pfad ein

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 Human node.

Hinweise

Hinweis:

Um ohne einen echten Beauftragten zu testen, simulieren Sie mithilfe der Pseudo-Ausgabe eine status und output -Antwort. Die Schritte finden Sie unter Hinzufügen einer menschlichen Genehmigung zu einem Workflow .

• Wenn der Beauftragte eine Gruppe ist, kann jedes Mitglied dieser Gruppe die Aufgabe anfordern und abschließen.
• For a richer interface than a form, back the task with an Action app instead of a Quick form.

Zugehörige Seiten

• Fügen Sie einem Workflow eine menschliche Genehmigung hinzu
• Entscheidung
• Terminate
• Schnellformularaufgaben