Personalwesen

Menschliche Knoten zum Anhalten eines Prozesses und Zuweisen einer Aufgabe zur Überprüfung, Genehmigung oder Eingabe durch Menschen.

Der Knoten Mensch hält den Prozess an und weist einer Person eine Aufgabe zu. Er setzt den Prozess dann fort, sobald sie abgeschlossen ist. Verwenden Sie sie, wenn ein Prozess eine menschliche Überprüfung, Genehmigung oder Eingaben erfordert, bevor er fortgesetzt werden kann.

Wann Human vs. Entscheidung verwendet werden sollte

Verwenden Sie den Knoten „Mensch“ , wenn eine Person Informationen überprüfen und antworten muss, bevor der Prozess fortgesetzt wird. Verwenden Sie den Entscheidungsknoten , wenn die Verzweigung automatisch aus vorhandenen Daten ohne menschliche Beteiligung aufgelöst werden kann.

Der menschliche Knoten leitet das vom Beauftragten gewählte Ergebnis über seine eigenen Ausgabe-Handles weiter. Greifen Sie nach einer Entscheidung, wenn die Verzweigung aus vorhandenen Daten anstelle einer Person folgt.

Menschliche Knotentypen

Die dem Menschen präsentierte Aufgabe kann über zwei Mechanismen erstellt werden: Schnellformular und Aktions-App.

Schnellformular

Erstellen und debuggen Sie ein einfaches Formular direkt auf dem Knoten. Sie definieren die Felder, die der Beauftragte sieht, die Eingaben, die er bereitstellen muss, und die Ergebnisse, die er wählen kann. Dies ist der Standardwert und eignet sich am besten für Genehmigungen und die einfache Datenerfassung.

Aktions-App

Aktions-Apps bieten eine umfassendere, vollständig angepasste Benutzeroberfläche für die dem Menschen zugewiesene Aufgabe. Sie können visuell in UiPath App Studio oder Studio Web oder als codierte Aktions-App – eine benutzerdefinierte React- oder Angular-Anwendung – erstellt werden. Unter Aktions-App wird eine codierte App ausgewählt, deren Eingaben zum Zeitpunkt der Konfiguration zugeordnet werden. Siehe Über codierte Aktions-Apps.

	Schnellformular	Aktions-App
UI definiert	Auf dem Knoten, versioniert mit dem Prozess	Separate App, die für Orchestrator bereitgestellt wird
Wiederverwenden über Prozesse hinweg	Ja, durch Kopieren und Einfügen von JSON	Ja
Kosten	Keine zusätzlichen Einheiten, keine Apps-Abhängigkeit	Erfordert eine App-Bereitstellung
Layout	Ermöglicht mehrspaltige Layouts mit mehreren Breiten, Feldverhalten	volle Kontrolle
Daten zur Rendernzeit	Nur gebundene Prozessvariablen/-ausdrücke	SDK: Assets, Buckets, Verbindungen, Data Fabric, Trigger-Prozesse
Tests	Inline-Debugging über die Canvas	Erstellen → Bereitstellen → Ausführen
Build-Fähigkeiten erforderlich	Keine	App Studio oder React/Angular für codierte Apps

Tipp:

Beginnen Sie mit einem Schnellformular. Wechseln Sie zu einer Aktion-App, wenn Sie dieselbe Schnittstelle für verschiedene Prozesse wiederverwenden müssen, Daten anzeigen, die der Prozess noch nicht enthält, oder eine Benutzeroberfläche erstellen müssen, die ein Formular nicht ausdrücken kann.

Das Erstellen der App selbst wird in der Action Apps-Dokumentation behandelt. Ab diesem Zeitpunkt behandelt diese Seite den Aufgabentyp „Schnellformular“ . Eine praktische Anleitung finden Sie unter Hinzufügen einer menschlichen Genehmigung zu einem Workflow.

Konfiguration

Feld	Erforderlich	Standard	Beschreibung
Zuweisungskriterien	Ja	Einzelner Benutzer	Steuert, wie der menschliche Knoten die Person auswählt, die die Aufgabe erhält. Wählen Sie zwischen Einzelner Benutzer, Alle Benutzer, Roundrobin, Workload oder Benutzerdefiniert aus.
Schema	Ja	„Submit“-Ergebnis	Formularstruktur, einschließlich Felder, die der Beauftragte sieht oder ausfüllt, und Ergebnisse, die er auswählen kann. Die vollständige Struktur finden Sie unter Schema .
Bereitstellungskanäle	–	Auf Mandantenebene festlegen	Schreibgeschützt auf dem Knoten – Die verfügbaren Kanäle werden von der Konfiguration auf Mandantenebene geerbt und als deaktivierte Kontrollkästchen angezeigt. Weitere Informationen finden Sie unter Bereitstellungskanäle .
Aufgabentitel	Nein	Keine	Titel, der dem Beauftragten in seiner Aufgabenliste angezeigt wird.
Priorität	Nein	Keine	In Action Center angezeigte Priorität: Niedrig, Mittel oder Hoch.
Beschriftungen	Nein	Keine	Durch Kommas getrennte Bezeichnungen zum Organisieren von Aufgaben, z. B. finance,approval.

Zuweisungskriterien

Zuweisungskriterien steuern, welche Person oder Personen die Aufgabe erhalten. Durch die Auswahl eines Kriteriums wird das zweite Feld entsprechend geändert – eine Benutzerauswahl für Einzelbenutzer und eine Gruppenauswahl für die gruppenbasierten Kriterien.

Kriterien	Wer erhält die Aufgabe	Verwenden Sie sie, wenn
Einzelner Benutzer	Eine benannte Person.	Eine bestimmte Person ist Eigentümer dieser Entscheidung – ein benannter Genehmiger, ein einzelner Prüfer
Alle Benutzer	Jedes Mitglied der Gruppe auf einmal. Die erste Person, die sie abschließt, schließt die Aufgabe für alle.	Ihnen ist Geschwindigkeit wichtiger als Eigentum. Wer frei ist, nimmt sie auf
Workload	Das Gruppenmitglied mit den wenigsten offenen Aufgaben	Die Warteschlange soll gleichmäßig über ein Team verteilt werden
Round-Robin	Gruppenmitglieder wiederum wechseln durch die Mitgliederliste	Sie möchten, dass jedes Mitglied einen gleichen Anteil erhält, unabhängig davon, wie schnell es arbeitet
Benutzerdefiniert	Das Mitglied mit den wenigsten offenen Aufgaben, das aus einer Liste von Benutzern ausgewählt wurde, die Sie zur Laufzeit bereitstellen, anstatt aus der Vollmitgliedschaft einer Gruppe.	Berechtigungsänderungen pro Ausführung – Überspringen von Personen, die abwesend sind, nicht im Dienst sind oder außerhalb der richtigen Rolle oder Region sind.

Anforderungen und Limits

Wichtig:

Workload und Roundrobin erfordern eine lokale Gruppe. Active Directory-Gruppen werden für beide abgelehnt. Verwenden Sie einzelnen Benutzer oder Alle Benutzer , wenn sich Ihre Beauftragten in einer Active Directory (AD)-Gruppe befinden.

Beim Debuggen funktioniert die Gruppenzuweisung nicht über einen persönlichen Arbeitsbereich. Debug-Ausführungen erstellen die Aufgabe in Ihrem persönlichen Arbeitsbereich, auf den Gruppenmitglieder nicht zugreifen können – also wird die Aufgabe erstellt, bleibt aber Unassigned und es werden keine Benachrichtigungen ausgegeben. Dies ist erwartbar, kein Fehler. Stellen Sie die Lösung in einem freigegebenen Ordner bereit, um die Gruppenzuweisung ordnungsgemäß zu testen. Die Zuweisung eines einzelnen Benutzers funktioniert beim Debuggen normal.

Fehler, die möglicherweise angezeigt werden:

Fehler (Error)	Bedeutung
NoUsersFoundInLocalGroup	Die ausgewählte Gruppe hat keine Mitglieder.
NoEligibleUsersFoundInGroup	Jedes Mitglied wurde ausgeschlossen, sodass niemand mehr zugewiesen werden konnte.

Schema

Das Schema definiert, was der Beauftragte sieht und was er an den Prozess zurückgibt. Er besteht aus zwei Teilen: Feldern und Ergebnissen.

Felder

Das Schema kann auch direkt als JSON bearbeitet werden. Eine vollständige Referenz für das JSON-Schema finden Sie unter Schnellformularaufgaben . In der Formularansicht hat jedes Feld die folgenden Einstellungen:

Einstellung	Was es tut
Label	Der Anzeigename, der dem Beauftragten angezeigt wird.
Typ	Steuert die Validierung und wie die Eingabe gerendert wird. Verfügbare Typen: Text, Zahl, Dezimalzahl, Datum, Datum und Uhrzeit, Ja oder Nein, Einzelauswahl, Mehrfachauswahl, Array, Datei.
Bindung	Ein Ausdruck, der das Feld vorab ausfüllt, z. B. $vars.requestAmt. Akzeptiert jeden Workflow-Ausdruck, nicht nur einen Variablenverweis.
Bearbeitbar	Das Vorhängeschloss neben dem Wert. Gesperrt bedeutet, dass der Beauftragte den Wert lesen, aber nicht ändern kann.
Variable	Wird als Abzeichen (x) neben dem Feldnamen angezeigt. Automatisch von den Feldern Beschriftung für Ausgabe und In/Out abgeleitet, wodurch der Wert als benannte Prozessvariable zusätzlich zu $vars.<nodeName>.output.<fieldId> verfügbar gemacht wird. In Eingabefeldern nicht vorhanden.

Feldrichtungen

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

• Eingabefelder stellen dem Beauftragten schreibgeschützten Kontext bereit, 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, den er bearbeiten kann, bevor er an den Prozess zurückgegeben wird.

Die Richtung eines Felds ist keine separate Einstellung. Es ist das Ergebnis von zwei Steuerelementen: Ob das Feld gebunden ist, bestimmt, ob es vorausgefüllt ankommt, und ob es entsperrt ist, bestimmt, ob der Beauftragte es ändern kann.

Bindung	Vorhängeschloss	Richtung	Beauftragter sieht	Bearbeitbar & zurückgegeben wird
Set (Satz)	Gesperrt 🔒	Eingabe	Der gebundene Wert	Nein
Set (Satz)	Entsperrt 🔓	Ein/Aus	Der gebundene Wert	Ja
Keine	Entsperrt 🔓	Ausgabe	Ein leeres Feld	Ja
Keine	Gesperrt 🔒	Nicht gültig	Ein leeres Feld	Nein

Ergebnisse

Ergebnisse sind die Schaltflächen, mit denen der Beauftragte die Aufgabe abschließt, z. B. „Genehmigen“ und „Ablehnen“. Das Standardschema hat ein einziges „Submit“-Ergebnis. Das erste Ergebnis ist als primäre Aktion gekennzeichnet.

Jedes Ergebnis fügt dem Knoten sein eigenes Output-Handle hinzu. Wenn der Beauftragte ein Ergebnis auswählt, wird der Prozess über den Handle dieses Ergebnisses fortgesetzt, sodass Sie jedes Ergebnis an einen anderen Pfad weiterleiten können. Siehe „Verzweigen anhand des Ergebnisses“.

Bereitstellungskanäle

Aufgaben werden übermittelt an:

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

Wichtig:

Bereitstellungskanäle können nur auf Mandantenebene über die Administratoreinstellungen geändert werden. Die Kontrollkästchen auf dem Knoten sind deaktiviert und spiegeln die aktuelle Mandantenkonfiguration wider.

Slack und Microsoft Teams erfordern eine Integration Service-Verbindung. Weitere Informationen für die Connector-Einrichtung finden Sie unter Umsetzbare Benachrichtigungen .

Ausgabe

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

Ausgabe

Das Aufgabenergebnis: ein Objekt, das die vom Beauftragten übermittelten Werte enthält, wobei das Ausgabefeld als Schlüssel dient. Lesen Sie ein einzelnes Feld mit $vars.<nodeName>.output.<fieldId>. Das Objekt enthält außerdem eine Action-Eigenschaft, die auf das ausgewählte Ergebnis gesetzt ist.

Status

Das vom Beauftragten ausgewählte Ergebnis, z. B. Approve. Verzweigen Sie anhand dieses Werts, um den Prozess weiterzuleiten.

Verzweigen anhand des Ergebnisses

Jedes Ergebnis, das Sie definieren, fügt dem Human-Knoten ein Ausgabe-Handle hinzu. Wenn der Beauftragte die Aufgabe abschließt, wird der Prozess mit dem Handle für das ausgewählte Ergebnis fortgesetzt. Verbinden Sie jedes Ergebnis-Handle mit dem Knoten, der für diesen Pfad ausgeführt werden soll. Sie benötigen keinen Entscheidungsknoten, um das Ergebnis zu teilen.

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, falls Sie es in einem Ausdruck benötigen.

Häufige Probleme

Aufgabe wird für den Beauftragten nicht angezeigt

Überprüfen Sie, ob der Beauftragte – ein Benutzer oder eine Gruppe – korrekt ist und Zugriff auf Action Center hat.

Ein Ausgabewert fehlt

Bestätigen Sie, dass das Feld im Schema mit Richtung Ausgabe definiert ist.

Ein Ergebnis wird an den falschen Pfad weitergeleitet

Bestätigen Sie, dass das Ausgabe-Handle jedes Ergebnisses mit dem gewünschten Knoten verbunden ist. Jedes Ergebnis, das Sie im Schema definieren, hat ein eigenes Handle für den Menschenknoten.

Hinweise

Hinweis:

Um ohne einen echten Beauftragten zu testen, verwenden Sie die Mock-Ausgabe, um eine status- und output-Antwort zu simulieren. 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 übernehmen und abschließen.
• Für eine umfangreichere Schnittstelle als ein Formular unterstützen Sie die Aufgabe mit einer Aktions-App anstelle eines Schnellformulars.

Zugehörige Seiten

• Eine menschliche Genehmigung zu einem Workflow hinzufügen
• Entscheidung
• Terminate
• Schnellformularaufgaben