# Filas

**Filas** – é uma maneira de agrupar Tarefas semelhantes, bem como criar fluxos de Tarefas.

As filas podem ser vistas como uma forma de "armazenar uma lista de dados" que precisam ser processados. Agrupamentos desse tipo são usados para que um sistema externo (ou Robôs) adicione Tarefas à Fila, enquanto outros Robôs executam os itens da Fila de Tarefas, ou seja, extraem Tarefas de uma determinada Fila e realizam Trabalhos. Assim, um longo e complexo processo de negócios pode ser dividido em um conjunto de processos simples, cada um dos quais será executado por um Robô ou Grupo de robôs específico.

As Tarefas são adicionadas à Fila de três maneiras:

* manualmente pelo Usuário através do Orquestrador;
* por um Robô usando o bloco “Adicionar Tarefa à Fila”;
* através de chamadas de API.

A tela “Filas” contém duas tabelas: “Filas” e “Tarefas”.

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

Para trabalhar com Filas, a tela possui os seguintes botões:

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

<table><thead><tr><th width="222.111083984375"></th><th width="482.888916015625"></th></tr></thead><tbody><tr><td><strong>Nome do botão</strong></td><td><strong>Descrição</strong></td></tr><tr><td>Criar</td><td>Permite ao Usuário criar uma nova Fila. Ao clicar, um formulário é aberto para inserir os dados necessários e configurar os parâmetros da nova Fila.</td></tr><tr><td>Atualizar</td><td>Permite atualizar as informações sobre a Fila selecionada.</td></tr><tr><td>Excluir selecionado</td><td>Permite excluir uma ou mais Filas selecionadas.</td></tr><tr><td>Importar de CSV</td><td>Permite ao Usuário carregar dados sobre Filas de um arquivo no formato CSV. Ao escolher esta opção, uma janela de diálogo é aberta para carregar o arquivo com os dados necessários.</td></tr><tr><td>Exportar para CSV</td><td>Permite salvar informações sobre Filas em um arquivo no formato CSV.</td></tr><tr><td>Exportar para XLSX</td><td>Permite exportar dados sobre Filas para um arquivo no formato XLSX.</td></tr></tbody></table>

Para trabalhar com Tarefas, a tela possui os seguintes botões:

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

<table data-header-hidden><thead><tr><th width="219.55560302734375"></th><th width="484.2222900390625"></th></tr></thead><tbody><tr><td><strong>Nome do botão</strong></td><td><strong>Descrição</strong></td></tr><tr><td>Criar</td><td>Permite ao Usuário criar uma nova Tarefa. Ao clicar, um formulário é aberto para inserir os dados necessários e configurar os parâmetros da nova Tarefa.</td></tr><tr><td>Atualizar</td><td>Permite atualizar as informações sobre a Tarefa selecionada.</td></tr><tr><td>Alterar status</td><td><p>Permite alterar o status de uma ou mais Tarefas selecionadas. Opções disponíveis:</p><ul><li>Criada;</li><li>Em processo;</li><li>Bem-sucedida;</li><li>Falhou;</li><li>Adiada até;</li><li>Abandonada.</li></ul></td></tr><tr><td>Clonar tarefa</td><td>Permite criar uma cópia da Tarefa selecionada com a transferência automática de todas as suas propriedades e parâmetros.</td></tr><tr><td>Excluir selecionado</td><td>Permite excluir uma ou mais Tarefas selecionadas.</td></tr><tr><td>Importar de CSV</td><td>Permite ao Usuário carregar dados sobre Tarefas de um arquivo no formato CSV. Ao escolher esta opção, uma janela de diálogo é aberta para carregar o arquivo com os dados necessários.</td></tr><tr><td>Exportar para CSV</td><td>Permite salvar informações sobre Tarefas em um arquivo no formato CSV.</td></tr><tr><td>Exportar para XLSX</td><td>Permite exportar dados sobre Tarefas para um arquivo no formato XLSX.</td></tr><tr><td>Mostrar diagrama</td><td>Permite visualizar dados sobre Tarefas na forma de um diagrama para análise dos status das Tarefas.</td></tr></tbody></table>

## **Criando uma nova Fila**

Para criar uma nova Fila, é necessário clicar no botão “Criar” na tabela “Filas” e preencher o formulário que se abre:

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

<table data-header-hidden><thead><tr><th width="57"></th><th width="283.22222900390625"></th><th width="380.77783203125"></th></tr></thead><tbody><tr><td><strong>№ p/p</strong></td><td><strong>Elemento da interface</strong></td><td><strong>Descrição</strong></td></tr><tr><td>1.</td><td>campo de texto “Nome”</td><td>Nome da Fila. Campo obrigatório.</td></tr><tr><td>2.</td><td>campo de texto “Descrição”</td><td>Descrição da Fila.</td></tr><tr><td>3.</td><td>campo de texto “Pasta de acesso”</td><td>Permite especificar a Pasta de acesso para a Fila a ser criada.</td></tr><tr><td>4.</td><td>campo de texto “Transferir para o status 'Abandonada' tarefas que estão no status 'Criada' por mais do que o número especificado de minutos”</td><td>Permite especificar o número de minutos após os quais uma Tarefa no status <strong>Criada</strong> será transferida para o status <strong>Abandonada</strong>.</td></tr><tr><td>5.</td><td>campo de texto “Transferir para o status 'Abandonada', tarefas que estão no status 'Em processo' por mais do que o número especificado de minutos”</td><td>Permite especificar o número de minutos após os quais uma Tarefa no status <strong>Em processo</strong> será transferida para o status <strong>Abandonada</strong>.</td></tr><tr><td>6.</td><td>flag “Autoalterar o status da tarefa, que está<br>“Em processo” para “Falhou (Aplicativo)”, se o Trabalho relacionado mudou para o status “Falhou/Parado/Interrompido”</td><td>Permite ativar a função de autoalteração do status da Tarefa de <strong>Em processo</strong> para <strong>Falhou</strong> <strong>(Aplicativo)</strong>, se o Trabalho relacionado mudou para o status <strong>Falhou</strong>/<strong>Parado</strong>/<strong>Interrompido</strong>.</td></tr><tr><td>7.</td><td>flag “Repetição automática de tarefas no status Falhou (Aplicativo)”</td><td>Permite ativar a função de repetição automática de Tarefas que estão no status <strong>Falhou (Aplicativo)</strong>.</td></tr><tr><td>8.</td><td>flag “Repetição automática de tarefas no status Falhou (Negócio)”</td><td>Permite ativar a função de repetição automática de Tarefas que estão no status <strong>Falhou (Negócio)</strong>.</td></tr><tr><td>9.</td><td>flag “Repetição automática de tarefas no status Abandonada”</td><td>Permite ativar a função de repetição automática de Tarefas que estão no status <strong>Abandonada</strong>.</td></tr><tr><td>10.</td><td>campo de texto “Número máximo de repetições”</td><td>Permite especificar o número máximo de repetições das Tarefas.</td></tr><tr><td>11.</td><td>flag “Proibir a adição de tarefas com nomes duplicados”</td><td>Permite ativar a função de proibição de adição à Fila de Tarefas com nomes duplicados.</td></tr></tbody></table>

## **Editando uma Fila criada anteriormente**

Para visualizar e editar as propriedades de uma Fila específica, é necessário selecioná-la na lista e clicar no ícone ![](https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-690447737878822a051c1768d4d44828fa21d624%2F2025-03-19_21-36-15.png?alt=media). Após isso, um formulário com as configurações da Fila será aberto, onde é possível fazer as alterações necessárias:

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

Além dos campos preenchidos ao criar a Fila, ao editar, o formulário exibe o **GUID** (identificador único atribuído à Fila após sua criação) no campo "GUID do registro". Este campo não pode ser editado.

## **Criando uma nova Tarefa**

Para criar uma nova Tarefa, é necessário clicar no botão “Criar” na tabela “Tarefas” e preencher o formulário que se abre:

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

{% hint style="warning" %}
Para que a tabela “Tarefas” exiba a lista de Tarefas, é necessário ativar a flag em uma das Filas.
{% endhint %}

O formulário contém os seguintes elementos:

<table data-header-hidden><thead><tr><th width="56"></th><th width="195"></th><th></th></tr></thead><tbody><tr><td><strong>№ p/p</strong></td><td><strong>Elemento da interface</strong></td><td><strong>Descrição</strong></td></tr><tr><td>1.</td><td>campo de texto “Nome”</td><td>Nome da Tarefa. Campo obrigatório.</td></tr><tr><td>2.</td><td>campo de texto “Descrição”</td><td>Descrição da Tarefa.</td></tr><tr><td>3.</td><td>campo de texto “Comentário”</td><td>Comentário sobre a Tarefa.</td></tr><tr><td>4.</td><td>campo “Prioridade”</td><td><p>Prioridade de execução da Tarefa. Opções possíveis:</p><ul><li>Baixa;</li><li>Normal;</li><li>Alta;</li><li>Prazo.</li></ul></td></tr><tr><td>5.</td><td>campo de texto “Tags”</td><td>Tags da Tarefa.</td></tr><tr><td>6.</td><td>campo de texto “Repetições”</td><td>Quantidade de repetições da execução da Tarefa.</td></tr></tbody></table>

## **Edição de uma Tarefa já criada**

Para visualizar e editar as propriedades de uma Tarefa específica, é necessário selecioná-la na lista e clicar no ícone ![](https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-690447737878822a051c1768d4d44828fa21d624%2F2025-03-19_21-36-15.png?alt=media). Após isso, abrirá um formulário com as configurações da Tarefa, onde é possível fazer as alterações necessárias:

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

<table data-header-hidden><thead><tr><th width="55"></th><th width="208"></th><th width="483.7777099609375"></th></tr></thead><tbody><tr><td><strong>№ p/p</strong></td><td><strong>Elemento da interface</strong></td><td><strong>Descrição</strong></td></tr><tr><td>1.</td><td>campo de texto “GUID”</td><td>Identificador único atribuído à Tarefa após sua criação. Este campo não pode ser editado.</td></tr><tr><td>2.</td><td>campo de texto “Status”</td><td><p>Status da Tarefa. Opções possíveis:</p><ul><li>Criado;</li><li>Em andamento;</li><li>Bem-sucedido;</li><li>Falhou (Aplicativo);</li><li>Falhou (Negócio);</li><li>Adiado até;</li><li>Abandonado.</li></ul></td></tr><tr><td>3.</td><td>campo “Adiado até”</td><td><p>Data e hora até a qual a Tarefa está adiada no formato: DD.MM.AAAA horas:minutos.<br></p><p>Ao chegar a data e hora “Adiado até”, a Tarefa é considerada de acordo com sua prioridade e executada na ordem da Fila.</p></td></tr><tr><td>4.</td><td>campo “Prazo”</td><td>Data e hora do prazo para a execução desta Tarefa.</td></tr><tr><td>5.</td><td>campo “Criada”</td><td>Data e hora em que a Tarefa foi criada. Este campo não pode ser editado.</td></tr><tr><td>6.</td><td>campo “Atualizada”</td><td>Data e hora em que a Tarefa foi atualizada. Este campo não pode ser editado.</td></tr></tbody></table>

## **Parâmetros da Tarefa**

Para Tarefas já criadas, estão disponíveis os “Parâmetros da Tarefa”. Para abrir o formulário de parâmetros, é necessário clicar no ícone ![](https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-82771284993ac0f983a8e7b7d7e2e79bf3ef7afb%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20\(313\).png?alt=media). Para especificar os parâmetros da Tarefa, estão disponíveis três tipos de dados:

* **Texto**;
* **Tabela**;
* **Tabela hash**.

O tipo de dado **Texto** permite salvar o texto necessário como 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-556b207271bb4aa817572021f3fc50c1dffc58b3%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(311).png?alt=media" alt=""><figcaption></figcaption></figure>

O tipo de dado **Tabela** permite criar e salvar uma tabela como parâmetro da Tarefa no editor de tabelas 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-3e68ff83cf73ca7563b03a0f06294bd257691828%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(312).png?alt=media" alt=""><figcaption></figcaption></figure>

O tipo de dado **Tabela hash** permite criar e salvar uma tabela hash (especificar pares chave-valor) como 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-6dc9a36516c571a9eb3afa96b00bcc0a26f2dadb%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(310).png?alt=media" alt=""><figcaption></figcaption></figure>

[Trabalho com Tarefas no Sherpa Designer está descrito aqui.](https://docs.sherparpa.ru/pt/sherpa-rpa/sherpa-orchestrator/rabota-v-sherpa-orchestrator/nachalo-raboty-v-sherpa-orchestrator/sozdanie-zadachi-v-orkestratore/rabota-s-zadachami-v-sherpa-designer)


---

# 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/ekrany/ocheredi.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.