Workflow Tasks: Overview of Methods
Workflows can create tasks for participants to gather additional information from them. For example, a task can be used to approve a document in accounting, authorize a vacation with a manager, or request a contract from a lawyer. Users can see their tasks in Bitrix24 and receive notifications.
There are four types of tasks:
- Document approval
- Document acknowledgment
- Request for additional information
- Request for additional information with rejection
Quick navigation: all methods and events
User documentation: Workflow Tasks
Complete Task
You can complete a workflow task by its identifier using the bizproc.task.complete method. To obtain the task identifier TASK_ID, use the bizproc.task.list method. You can only complete your own tasks.
Tasks that request additional information contain fields that the user must fill out. To complete such a task, pass the field values in the FIELDS object in the format {"field_1": "value_1", ... , "field_N": "value_N"}
field_N— symbolic identifier of the task fieldvalue_N— field value
You can find out which fields need to be filled out from the response of the bizproc.task.list method. The object "PARAMETERS": "Fields" contains descriptions of all task fields.
Delegate Task
A task can be delegated to another employee using the bizproc.task.delegate method. To do this, specify the task identifier TASK_IDS and the user identifiers:
- current assignee
FROM_USER_ID - new assignee
TO_USER_ID
You can obtain the task identifier using the bizproc.task.list method, and the user identifier using the user.get method.
Overview of Methods
Scope:
bizprocWho can execute the method: any user
|
Method |
Description |
|
Retrieves a list of workflow tasks |
|
|
Completes a workflow task |
|
|
Delegates a workflow task |