HITL Task Group Starter

Description

Use the step to create a shared task group ID on the AutomationEdge UI. The step groups related tasks and shows them on the Task Group tab in the AutomationEdge UI.

The step groups related Human-in-the-Loop (HITL) and Reject/Repair tasks that come from different workflow runs. All tasks that share the same ID stay in one group. As a result, reviewers can find and handle related tasks together on the Task Group tab in AutomationEdge UI.

How the Task Group ID works:

The step builds the ID in the following format: prefix : workflowRequestId + timestampNanos

For example: INV:5011717920000000000

• The prefix is the entered value (see the configuration table).
• The workflowRequestId marks the workflow run. In Agent mode, the step uses the workflow's WF_INSTANCE_ID. In Process Studio (PS) mode, the value is 0.
• The timestampNanos is a nanosecond timestamp. The step always moves the value forward, so every ID stays unique even when the system clock is not precise.

Example

A finance team runs a batch of invoices that need manager approval before payment.

1. In Task Group ID prefix, enter INV.
2. In Output as, select Field.
3. Keep Output name as task_group_id.
4. Clear Separate Task Group ID per row, so all invoices in the run share one group.

When the workflow runs, the step creates a task group ID such as INV:5011717920000000000 and shows the group on the Task Group tab. The next HITL step reads task_group_id and sends the invoices to a manager for approval.

Configurations

Field Name	Description
Step name	Specify the unique step name for the workflow. Default Value: HITL Task Group Starter
Task group Id prefix	Specify a prefix that helps reviewers recognize the group. The prefix appears before the generated ID on the Task Group tab AutomationEdge UI. Notes: • The prefix must be 3-32 chars, A-Z, 0-9, hyphen, underscore. • The step checks the prefix and the output name at design time. The prefix can come from a field or a variable, so the step also checks the prefix format at runtime, when the value is ready. The field accepts static, variable and previous field value. The field is mandatory.
Output as	Select how the step sends the task group ID to the next step: • Field – Sends the ID as a row field. • Variable – Sends the ID defined in Task group Id output field as a global PS variable (Global. <name>), for example, Global.task_group_id The field is mandatory.
Task group Id output field	Specify the field that holds the task group ID. The HITL and Reject/Repair steps read the ID from the field. Default value: task_group_id The field is mandatory.
Separate task group Id per row	Select this checkbox to create a separate ID for each row. Leave it clear to keep all rows in one group.