Get Task from Queue#

Gets a Task from the specified Queue.

When "Take to Work" is enabled, the block retrieves only Tasks with the New status ("Created" in Orchestrator). A Task with the Failed (Application) status will not be retrieved even if that status is included in the filter. This may result in Task not found. With this property disabled, the block can retrieve a Task with the selected status without changing it.

To process a Task again after an application error, use auto-retry in the Queue settings. Each retry is created as a separate Task with the New status.

PropertyDescription
GUID/Queue Name[Text] GUID or name of the Queue.
Task GUID[Text] Filter for Task GUID.
Task Name[Text] Filter for Task name. Wildcard usage is possible.
Task Status

Filter by Task status. Possible values:

  • New - New;
  • InProgress - In Progress;
  • Success - Completed;
  • Failed (Application) - Error (Application);
  • Failed (Business) - Error (Business);
  • Postponed - Postponed;
  • Abandoned - Abandoned.
Task Priority

Filter by Task priority. Possible values:

  • Low - low;
  • Normal - normal;
  • High - high.
Offset[Number] Offset from the beginning of the Queue.
Tag Filter

[Text] Tag filter. The separator is a semicolon.

When using the "+" symbol before a tag, it must be present in the Task.

When using "-" - the tag must be absent in the Task. For example: "+Tag1;-Tag2".

Created Later

[Date and time/Text] If this property is filled, only those Tasks will be returned where CreatedAt is greater than or equal to the value of this field.

When specifying a date in text format, the format "dd.MM.yyyy HH:mm:ss" must be used.

Take to WorkIf selected, the block retrieves a Task only with the New status and immediately changes it to "In Progress". Disable this property to retrieve Tasks with other statuses without changing their status.
Overwrite Parameter Object

If enabled, the already specified parameter object will be overwritten.

Relevant for data tables if the parameters in the Task are a table. Otherwise, a new object will be created in the output parameter variable.

Error on No TasksIf this property is enabled and the Task is not found, an error will be generated; otherwise, an empty string will be returned in the "Task Object" property.
Timeout[Number] Timeout in seconds.
Task GUID[Text] Returns the Task GUID.
Name[Text] Returns the Task name.
Parameters[Text/Table/Dictionary] Returns the Task parameters.
Task Object[Object] Task Object. An example of using the object can be viewed in the expression editor.
Error Handling Level

Select the error handling level.

Possible values:

  • "Default" - by default;
  • "Ignore" - errors are ignored;
  • "Handle" - errors are handled.

If "Default" is selected, the value of the "Start" block of this diagram will be used.

Message Level

Select the message level that blocks will output during operation. Possible values:

  • "Default" - by default;
  • "Release" - output is disabled;
  • "Debug" - main information output;
  • "Detailed" - detailed information output.

If "Default" is selected, the value of the "Start" block of this diagram will be used.

Error Text[Text] Returns detailed information about the error in case of incorrect execution of the block's work.