# Criação de Tarefa no Orquestrador

Selecione na tabela “Filas” a fila na qual você precisa criar uma tarefa e marque-a com a bandeira.

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

Em seguida, clique no botão “Criar” na tabela “Tarefas” e preencha o formulário que se abrir.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%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>

* campo “Nome” (obrigatório);
* campo “Descrição” (se necessário);
* campo “Comentário” (se necessário);
* campo “Prioridade” (use a lista suspensa para selecionar a prioridade da tarefa).

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%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>

* campo “Tags” (se necessário);
* campo “Repetir” (número de repetições da tarefa).

Após preencher o formulário, clique no botão “OK” para salvar a tarefa criada.

Cada tarefa criada tem seu status atual indicado na coluna “Status”.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%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 “Criada” (New) – nova tarefa;
* status “Em andamento” (InProgress) — a tarefa está em execução;
* status “Bem-sucedida” (Success) — a tarefa foi concluída com sucesso;
* status “Falhou (Aplicativo)” Failed (Application) — um erro foi encontrado durante a execução da tarefa. Este status é atribuído às tarefas se o problema encontrado pode ser resolvido com a reexecução da tarefa (por exemplo, em caso de travamento do sistema com o qual o robô está trabalhando);
* status “Falhou (Negócio)” Failed (Business) — um erro foi encontrado durante a execução da tarefa. Este status é utilizado quando a tentativa automática sinaliza problemas com os dados de entrada ou com os status de sistemas de informação externos com os quais o robô está trabalhando, e a reexecução da tarefa provavelmente será infrutífera;
* status “Adiada até” (Postponed) – a tarefa foi adiada. Este status é definido automaticamente a partir do script do Designer caso queiramos adiar a tarefa até um determinado momento, para que o Orquestrador retorne essa tarefa à fila durante esse tempo;
* status “Abandonada” (Abandoned) – este status é atribuído se a tarefa foi iniciada, mas não foi concluída em mais de 1 dia.

Ao criar uma tarefa, o status “Criada” é atribuído por padrão. Se necessário, o status da tarefa pode ser alterado durante sua edição. Para isso, clique no botão ![](https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%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) na linha da tarefa desejada, após o que o formulário de edição da tarefa será aberto.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%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>

Neste formulário, você pode alterar não apenas o status das tarefas, mas também especificar a data e a hora até as quais a tarefa está adiada, a data e a hora do prazo, se necessário.

Além disso, para cada tarefa, você pode definir um conjunto de parâmetros. Graças a esta opção, é possível transmitir a essência da tarefa, por exemplo, especificar o ID do documento com o qual o robô deve trabalhar, bem como indicar o caminho para a pasta onde o documento está localizado.

Para definir os parâmetros da tarefa, clique no botão ![](https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%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), onde três tipos de dados estão disponíveis:

* Texto;
* Tabela;
* Tabela hash.

Ao escolher o tipo de dado “Texto”, você pode salvar o texto necessário como um parâmetro da tarefa no campo de texto destinado a isso.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%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>

Ao escolher o tipo de dado “Tabela”, você pode criar e salvar uma tabela como um parâmetro da tarefa no editor de tabela destinado a isso.

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

Ao escolher o tipo de dado “Tabela hash”, você pode criar e salvar uma tabela hash (especificar pares chave-valor) como um parâmetro da tarefa nos campos destinados a isso, onde o parâmetro é a chave.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%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" %}
As tarefas do script são acessadas por GUID, que é atribuído a cada tarefa criada após sua criação. Ao final da execução da tarefa, seu status deve ser alterado novamente, dependendo de ter sido concluída com sucesso ou não. Enquanto o status da tarefa não for alterado para “Em andamento”, qualquer robô pode pegá-la, mas com o status “Em andamento”, a tarefa é vinculada a um robô específico.
{% 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/pt/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.
