# Creating a Task in the Orchestrator

Select a queue from the "Queues" table where you need to create a task and mark it with a flag.

<figure><img src="https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%2Fuploads%2Fgit-blob-dfcab1f1796e6bfc59d48fbeec62f82746e6c02e%2F2025-04-14_21-39-26.png?alt=media" alt=""><figcaption></figcaption></figure>

Next, click the "Create" button in the "Tasks" table and fill out the opened form.

<figure><img src="https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%2Fuploads%2Fgit-blob-4b903f974356e45b2e9de473858dd4faeef36c13%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(211).png?alt=media" alt=""><figcaption></figcaption></figure>

* "Name" field (mandatory);
* "Description" field (if necessary);
* "Comment" field (if necessary);
* "Priority" field (select the task execution priority using the dropdown list).

<figure><img src="https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%2Fuploads%2Fgit-blob-0846c4334a120d0f7bc4537068b704e4d3856689%2F%D0%BF%D1%80%D0%B8%D0%BE%D1%80%D0%B8%D1%82%D0%B5%D1%82.png?alt=media" alt=""><figcaption></figcaption></figure>

* "Tags" field (if necessary);
* "Repeat" field (number of task repetitions).

After filling out the form, click the "OK" button to save the created task.

Each created task has its current status indicated in the "Status" column.

<figure><img src="https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%2Fuploads%2Fgit-blob-881f62e6ce267e809c26730a8f42ec518e88d047%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(244).png?alt=media" alt=""><figcaption></figcaption></figure>

* status "Created" (New) – a new task;
* status "In Progress" (InProgress) – the task is in progress;
* status "Successful" (Success) – the task has been successfully completed;
* status "Failed (Application)" – an error occurred during task execution. This status is assigned to tasks if the problem encountered can be resolved by re-executing the task (for example, due to a system hang that the robot is working with);
* status "Failed (Business)" – an error occurred during task execution. This status is used when the automatic attempt indicates problems with input data or the statuses of external information systems that the robot is working with, and re-executing the task is expected to be unproductive;
* status "Postponed" – the task is postponed. This status is automatically set from the Designer script if we want to postpone the task until a certain time, so that the Orchestrator returns this task back to the queue during that time;
* status "Abandoned" – this status is assigned if the task was taken for work but was not completed for more than 1 day.

When creating a task, the status "Created" is set by default. If necessary, the task status can be changed during its editing. To do this, click the button ![](https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%2Fuploads%2Fgit-blob-f6aab696dd85a80306acbe996e59e553262366c1%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20\(246\).png?alt=media) in the row of the desired task, after which the task editing form will open.

<figure><img src="https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%2Fuploads%2Fgit-blob-ca4d62b7c1c5459c20dce965fa3c83c8d297c97a%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(247).png?alt=media" alt=""><figcaption></figcaption></figure>

In this form, you can change not only the task status but also specify the date and time until which the task is postponed, as well as the deadline date and time if necessary.

You can also set a set of parameters for each task. Thanks to this option, you can convey the essence of the task, for example, specify the document ID that the robot should work with, as well as indicate the path to the folder where the document is located.

To set the task parameters, click the button ![](https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%2Fuploads%2Fgit-blob-2cbc91be3acb9bd5349534aa7dd56b826767224c%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20\(248\).png?alt=media), where three types of data are available:

* Text;
* Table;
* Hash table.

When selecting the "Text" data type, you can save the necessary text as a task parameter in the designated text field.

<figure><img src="https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%2Fuploads%2Fgit-blob-df65af5b3e4513afce67d650c7222fc879eb2b6d%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(249).png?alt=media" alt=""><figcaption></figcaption></figure>

When selecting the "Table" data type, you can create and save a table as a task parameter in the designated table editor.

<figure><img src="https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%2Fuploads%2Fgit-blob-d11d015b1eb034c3f9acebd187efee73ba1cbf82%2F2025-04-14_22-13-08.png?alt=media" alt=""><figcaption></figcaption></figure>

When selecting the "Hash table" data type, you can create and save a hash table (specifying key-value pairs) as a task parameter in the designated fields, where the parameter is the key.

<figure><img src="https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%2Fuploads%2Fgit-blob-187ca5690e22723dd6098c2582b9d6a9f6f27b23%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(250).png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Tasks from the script are accessed by GUID, which is assigned to each created task after its creation. At the end of the task execution, its status needs to be changed again, depending on whether it was completed successfully or unsuccessfully. As long as the task status is not changed to "In Progress," it can be taken by any robot, but with the status "In Progress," the task is assigned to a specific robot.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sherparpa.ru/en/sherpa-rpa/sherpa-orchestrator/rabota-v-sherpa-orchestrator/nachalo-raboty-v-sherpa-orchestrator/sozdanie-zadachi-v-orkestratore.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
