reply

Workflows that contain human tasks remain in EXEC status until the assigned user provides confirmation. You can use the reply command to confirm either a specific human task or multiple tasks in one step.

Overview

A human task is a structured unit of work that relies on associated forms. These forms act as the primary interface for user interaction and consist of various field types and buttons designed to capture specific data. You can configure a form by adding either a single field type or multiple field types with one or more buttons.

The reply command is supported on human tasks that contain forms without any field types and forms that only contain Markdown field type. It also functions with other field types, provided they are not mandatory. To confirm a human task using the reply command, include a button value from the form in the command.

Syntax and command line options

Type the command as follows:
ocli plan [reply | rep] [[queue_prefix]-[queue_number]] [form_button_value] noask
The details that are required with each parameter are as follows:
[queue_prefix]-[queue_number]
Specify the prefix and the queue number of the human task queue separated by a hyphen (-). If you want to run multiple tasks on the same queue, use wildcard characters.
[form_button_value]
Specify the button value in the form assigned to the human task. If the value contains blank spaces, enclose it in quotes and slashes.
In PowerShell, enclose the value in single quotes and then double quotes. For example:
ocli plan replay MT "'Accept now'"
In the command line, enclose the value in double quotes and then back slashes.
ocli plan replay MT \"Accept now"\
noask
Use this optional attribute if you want to confirm multiple instances of human tasks without asking permission for each instance.

The use of wildcard characters in the command handles various scenarios. To confirm all tasks assigned to a single user that share the same button value, provide a wildcard and the button value in the command. The scenarios are explained in the following examples.

Examples

  1. The workflow GOLD contains the human task DOLLAR. The task is added to the Queue 2026 with the prefix Monday and 41 as the queue number. The values assigned to the form button is accept. Run the command as follows to complete the human task:
    ocli plan reply Monday-41 accept
  2. The workflow SALARY contains the human task YEAR_2026. The task is added to the Queue JUNE with the prefix MADHAV. The value assigned to the form button is accept. To complete multiple instances of the task in the queue, run the command as follows:
    ocli plan reply M@ accept
  3. To confirm all tasks assigned to a single user with accept as the button value, run the command as follows:
    ocli plan reply @ accept