# Trabalho com Tarefas no Sherpa Designer
Do lado do Designer, o trabalho com Tarefas é realizado através dos seguintes blocos da paleta do Orquestrador:
* **Adicionar Tarefa à Fila;**
* **Adicionar Tarefas à Fila;**
* **Obter Tarefa da Fila;**
* **Obter lista de Tarefas da Fila;**
* **Modificar Tarefa;**
* **Remover Tarefa da Fila;**
* **Obter Tarefa;**
* **Obter Tarefa padrão.**
Vamos analisar mais detalhadamente o funcionamento de cada um dos blocos.
## Adicionar Tarefa à Fila
Ao usar o bloco “**Adicionar tarefa à fila**”, na painel de propriedades do bloco, forneça os seguintes dados:
* “**GUID/Nome da Fila**” (campo obrigatório);
* “**Nome\***” – nome da Tarefa (campo obrigatório);
* “**Descrição**” – forneça uma descrição da Tarefa, se necessário;
* “**Parâmetros**” – forneça um dicionário com os parâmetros para a Tarefa;
* “**Atrasar até**” – forneça a data e hora até as quais a Tarefa está atrasada no formato: DD.MM.AAAA horas:minutos;
* “**Prazo**” – forneça a data e hora do prazo para a execução desta Tarefa no formato: DD.MM.AAAA horas:minutos. Caso o horário especificado já tenha passado, a Tarefa receberá a mais alta prioridade na Fila\
(ou seja, quando o Robô obtém a próxima Tarefa da Fila por ordem de prioridade, esta Tarefa será recebida antes das Tarefas com prioridade “Alta”);
* “**Prioridade**” – forneça, se necessário, para filtrar Tarefas por sua prioridade ao serem recebidas. Ao escolher qualquer prioridade, as Tarefas serão recebidas em ordem da prioridade mais alta para a mais baixa;
* “**Lista de tags**” – forneça uma lista de tags da Tarefa separadas por ponto e vírgula;
* “**Comentário**” – forneça um comentário para a Tarefa;
* “**Tempo de espera**” – forneça o tempo de execução da solicitação em segundos.
No final, você receberá o “**GUID da Tarefa**” e o “**Objeto da Tarefa**” do tipo $TaskObject. Com este objeto, você poderá trabalhar em qualquer bloco, expressão, para isso utilize as dicas na janela [“Editar expressão”](https://docs.sherparpa.ru/pt/sherpa-rpa/sherpa-designer/rabota-v-sherpa-designer/paneli-svoistv-i-peremennykh-i-rabota-s-nimi/panel-svoistv)“Exemplos de trabalho com objetos de tarefa TaskObject”.
## Adicionar Tarefas à Fila
Ao usar o bloco “**Adicionar tarefas à fila**”, em suas propriedades na painel de propriedades do bloco, forneça os seguintes dados:
* “**GUID/Nome da Fila**” (campo obrigatório);
* “**Tabela com parâmetros**” – forneça uma tabela com os parâmetros, para cada linha da qual uma nova Tarefa será criada;
* “**Prefixo do nome**” – forneça o prefixo dos nomes das Tarefas. Ao definir um prefixo não vazio, cada Tarefa criada por este bloco receberá um nome que começa com o prefixo especificado. Se o prefixo não for especificado, as tarefas serão nomeadas em ordem, e sua identificação na lista pode ser dificultada;
* “**Índice da coluna com o nome**” – forneça o índice da coluna com os nomes das Tarefas na tabela de entrada;
* “**Número de threads**” – forneça o número de threads para a criação de Tarefas. Se um valor maior que 2 for especificado, o processo de criação de Tarefas será dividido em threads.
* “**Adicionar data e hora**” – marque a opção se você precisar que a data e hora atuais sejam adicionadas ao nome ao serem incluídas;
* “**Descrição**” – descrição das Tarefas (se necessário);
* “**Atrasar até**” – forneça a data e hora até as quais as Tarefas estão atrasadas no formato: DD.MM.AAAA horas:minutos;
* “**Prazo**” – forneça a data e hora do prazo para a execução das Tarefas no formato: DD.MM.AAAA horas:minutos. Caso o horário especificado já tenha passado, as Tarefas receberão a mais alta prioridade na Fila (ou seja, quando o Robô obtém a próxima Tarefa da Fila por ordem de prioridade, essas Tarefas serão recebidas antes das Tarefas com prioridade “Alta”);
* “**Prioridade**” – forneça, se necessário, para filtrar Tarefas por sua prioridade ao serem recebidas. Ao escolher qualquer prioridade, as Tarefas serão recebidas em ordem da prioridade mais alta para a mais baixa;
* “**Lista de tags**” – forneça uma lista de tags das Tarefas separadas por ponto e vírgula;
* “**Tipo de parâmetros**” – escolha o tipo de parâmetros das Tarefas. Valores possíveis: Hashtable (dicionário) e DataTable (tabela de dados com uma linha);
* “**Tempo de espera**” – forneça o tempo de execução da solicitação em segundos.
No final, você receberá uma lista de GUID das Tarefas criadas.
## Obter Tarefa da Fila
Ao usar o bloco “**Obter tarefa da fila**”, em suas propriedades na painel de propriedades do bloco, forneça os seguintes dados:
* “**GUID/Nome da Fila**” (campo obrigatório);
* “**GUID da tarefa**” – forneça, se você precisar de uma Tarefa específica;
* “**Nome da tarefa**” – forneça o nome da Tarefa, se você precisar filtrar as Tarefas por seu nome;
* “**Status da tarefa**” – forneça, se você precisar obter Tarefas apenas com um status específico;
* “**Prioridade da tarefa**” – forneça, se você precisar filtrar as Tarefas por sua prioridade ao serem recebidas. Ao escolher qualquer prioridade, as Tarefas serão recebidas em ordem da prioridade mais alta para a mais baixa.
* “**Deslocamento**” – use esta propriedade se você precisar obter da fila não a primeira Tarefa, mas a n-ésima (5, 10, etc.);
* “**Filtro por tags**” – forneça tags separadas por ponto e vírgula, se você precisar filtrar as Tarefas por elas. Se você precisar que uma tag específica esteja presente na Tarefa, coloque um “+” antes dela, se precisar excluir Tarefas com uma tag específica, coloque um “-” antes dela;
* “**Criadas depois**” – use esta propriedade se você precisar que no resultado apareçam apenas aquelas Tarefas cuja CreatedAt é maior ou igual ao valor deste campo. A data e hora devem ser fornecidas no formato: DD.MM.AAAA horas:minutos;
* “**Pegar para trabalho**” – use esta propriedade se você precisar obter uma Tarefa da Fila e imediatamente pegá-la para trabalho como uma operação atômica. Esta opção é útil caso vários Robôs estejam terminando o trabalho com a Tarefa anterior e tentando pegar a próxima Tarefa da Fila. A flag “Pegar para trabalho” garante que uma Tarefa específica será pega para trabalho por um Robô específico. Se a flag não foi definida e a situação descrita acima ocorrer, uma notificação de erro aparecerá no Designer;
* “**Sobrescrever objeto de parâmetros**” – marque a flag se você precisar que o objeto de parâmetros já especificado seja sobrescrito. Esta propriedade é relevante para a tabela de dados, se uma referência à linha dessa tabela for usada, pois ao ativar a referência à linha não será perdida;
* “**Erro ao não encontrar tarefas**” – marque a flag se você precisar que, caso a Tarefa não seja encontrada, um erro seja gerado. Caso contrário, na propriedade "Objeto da tarefa" será retornada uma string vazia;
* “**Tempo de espera**” – forneça o tempo de execução da solicitação em segundos.
No final, você receberá os seguintes dados:
* **GUID da Tarefa;**
* **Nome;**
* **Parâmetros;**
* **Objeto da tarefa.**
## Obter lista de Tarefas da Fila
Ao usar o bloco “**Obter lista de tarefas da fila**”, em suas propriedades na painel de propriedades do bloco, forneça os seguintes dados:
* “**GUID/Nome da Fila**” (campo obrigatório);
* “**GUID da tarefa**” – forneça, se você precisar de uma Tarefa específica;
* “**Nome da tarefa**” – forneça o nome da Tarefa;
* “**Status da tarefa**” – forneça, se você precisar obter Tarefas apenas com um status específico;\* “**Prioridade da tarefa**” – indique se você precisa filtrar as Tarefas pela sua prioridade, ao serem recebidas. Ao escolher qualquer prioridade, as Tarefas serão recebidas em ordem da prioridade alta para a baixa.
* “**Deslocamento**” – use esta propriedade se você precisar obter da Fila não a primeira tarefa, mas a n-ésima (5, 10, etc.);
* “**Quantidade máxima**” – indique a quantidade máxima de Tarefas que deve ser retornada. Se o parâmetro não for especificado, não será retornado mais do que 100 Tarefas;
* “**Filtro por tags**” – indique as tags separadas por ponto e vírgula, se você precisar filtrar as Tarefas por elas. Se for necessário que uma tag específica esteja presente na Tarefa, coloque um “+” antes dela; se for necessário excluir Tarefas com uma tag específica, coloque um “-” antes dela;
* “**Criadas depois**” – use esta propriedade se você precisar que o resultado inclua apenas aquelas Tarefas cuja CreatedAt seja maior ou igual ao valor deste campo. A data e a hora devem ser especificadas no formato: DD.MM.AAAA horas:minutos;
* “**Pegar para trabalho**” – use esta propriedade se você precisar obter uma Tarefa da Fila e imediatamente pegá-la para trabalho como uma operação atômica. Ao usar o bloco “Obter lista de tarefas da fila”, não é recomendável usar esta função;
* “**Tempo de espera**” – indique o tempo de execução da solicitação em segundos;
* “**Erro na ausência de tarefas**” – ative a flag se você precisar que, caso a lista de Tarefas não seja encontrada, um erro seja gerado; caso contrário, será retornada uma lista vazia.
Na saída, você receberá os seguintes dados:
* **Lista de GUID das tarefas;**
* **Lista de nomes das tarefas;**
* **Lista de objetos das tarefas;**
* **Quantidade de tarefas.**
## Alterar Tarefa
Ao usar o bloco “**Alterar tarefa**” em suas propriedades no painel de propriedades do bloco, indique os seguintes dados:
* “**GUID/Nome da Tarefa**” (campo obrigatório);
* “**Nome**” – indique o nome da Tarefa. Caso o campo “GUID/Nome da Tarefa” contenha o nome da Tarefa, este campo deve ser deixado em branco;
* “**Status**” – indique se você precisa obter a Tarefa apenas com um status específico;
* “**Parâmetros**” – indique um dicionário com os parâmetros para a Tarefa;
* “**Prioridade**” – indique se você precisa filtrar as Tarefas pela sua prioridade, ao serem recebidas. Ao escolher qualquer prioridade, as Tarefas serão recebidas em ordem da prioridade alta para a baixa;
* “**Adiar até**” – indique a data e a hora até as quais a Tarefa está adiada no formato: DD.MM.AAAA horas:minutos;
* “**Prazo**” – indique a data e a hora do prazo para a execução desta Tarefa no formato: DD.MM.AAAA horas:minutos. Caso o horário especificado já tenha passado, a Tarefa receberá a maior prioridade na Fila\
(ou seja, quando o Robô recebe a próxima Tarefa da Fila em ordem de prioridade, esta Tarefa será recebida antes das Tarefas com prioridade “Alta”);
* “**Lista de tags**” – indique a lista de tags da Tarefa separadas por ponto e vírgula;
* “**Comentário**” – indique o comentário da Tarefa;
* “**Tempo de espera**” – indique o tempo de execução da solicitação em segundos.
## Remover Tarefa da Fila
Ao usar o bloco “Remover tarefa da fila” em suas propriedades no painel de propriedades do bloco, indique os seguintes dados:
* “**GUID/Nome da Fila**” (campo obrigatório);
* “**GUID da tarefa**” – indique se você precisa de uma Tarefa específica;
* “**Nome da tarefa**” – indique o nome da Tarefa;
* “**Status da tarefa**” – indique se você precisa receber Tarefas apenas com um status específico;
* “**Prioridade da tarefa**” – indique se você precisa filtrar as Tarefas pela sua prioridade, ao serem recebidas. Ao escolher qualquer prioridade, as Tarefas serão recebidas em ordem da prioridade alta para a baixa;
* “**Filtro por tags**” – indique as tags separadas por ponto e vírgula, se você precisar filtrar as Tarefas por elas. Se for necessário que uma tag específica esteja presente na Tarefa, coloque um “+” antes dela; se for necessário excluir Tarefas com uma tag específica, coloque um “-” antes dela;
* “**Tempo de espera**” – indique o tempo de execução da solicitação em segundos.
Na saída, você receberá o GUID da Tarefa removida.
## Obter Tarefa
Ao usar o bloco “**Obter tarefa**” em suas propriedades no painel de propriedades do bloco, indique os seguintes dados:
* “**GUID/Nome da Tarefa**” (campo obrigatório);
* “**Tempo de espera**” – indique o tempo de execução da solicitação em segundos.
Na saída, você receberá os seguintes dados:
* **Objeto da tarefa;**
* **GUID da tarefa;**
* **Nome da tarefa;**
* **Parâmetros da tarefa;**
* **Prioridade da tarefa;**
* **Status da tarefa;**
* **Quantidade de repetições da tarefa;**
* **Data de criação da tarefa;**
* **Data de alteração da tarefa;**
* **Tarefa adiada até;**
* **Prazo da tarefa;**
* **Tags da tarefa.**
## Obter Tarefa Padrão
O bloco “**Obter tarefa padrão**” obtém a Tarefa definida pelo trabalho atual que o Robô está executando:
Na saída, você receberá os seguintes dados:
* **GUID da Tarefa;**
* **Nome;**
* **Parâmetros;**
* **Objeto da tarefa.**
---
# 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/rabota-s-zadachami-v-sherpa-designer.md?ask=
```
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.
.png?alt=media)