Get Form Tasks

UiPath.Persistence.Activities.FormTask.GetFormTasks

Description

Ajuda você a consultar uma única ação ou um conjunto de ações filtradas por critérios específicos, ou seja, as propriedades DTO da ação:

• Status
• Título
• ID
• Prioridade
• Task Catalog Name
• AssignedToUser
• CreatorUser
• LastModifierUser
• Hora de Criação
• LastModificationTime
• OrganizationUnitID

O objeto de saída da atividade Get Form Tasks pode ser usado em qualquer outra atividade de persistência, por exemplo, Wait For Form Task And Resume, para abranger os cenários que exigem que outro fluxo de trabalho aguarde as Actionsdiferentes do fluxo de trabalho que criou essas Actions ( por exemplo, criar um fluxo de trabalho de recuperação caso o trabalho atual falhe). Você também pode passar o objeto de saída para um processo diferente como entrada, para não precisar esperar todas as Actions serem concluídas até o processo inicial ser retomado.

Observação: * Filtrar e consultar as ações usa a sintaxe OData , com base nos metadados da ação.

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Windows, Windows - configuração herdada

Painel do Designer

• Nome do catálogo de tarefas — o nome do catálogo da ação que foi definido usando a atividade Criar tarefa de formulário .
• Referência — a referência das Actions que foi definida usando a atividade Criar tarefa de formulário .
• Filtro - A opção OData filter , usada para filtrar as ações recuperadas pelos critérios especificados. Este campo suporta apenas strings e variáveis String. Por exemplo, Status in ('Pending', 'Unassigned'), and Priority eq 'High'.
• Selecionar — a opção select do OData, usada para recuperar um subconjunto das propriedades das Actions. Você é obrigado a inserir a opção de ID. Portanto, se você quiser recuperar os Catálogos de Actions , a consulta que você usaria é "Id, TaskCatalogName". Esse campo é compatível apenas com strings e variáveis String.
• Objetos de Tarefa (Saída) - A lista de objetos de saída que correspondem aos critérios definidos na atividade. A saída é retornada do Orchestrator como um objeto List<FormTaskData> . Use este objeto para criar um fluxo de trabalho de recuperação ou para passá-lo como entrada para um processo diferente.

Painel de Propriedades

Comum

• ContinuarComErro — especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.

Observação: se essa atividade estiver incluída na atividade Try Catch e o valor da propriedade ContinuarComErro for True, nenhum erro será capturado quando o projeto for executado.

• NomeDeExibição - o nome de exibição da atividade.
• TempoLimiteEmMs - Especifica o período de tempo (em milissegundos) para aguardar que a atividade seja executada antes de gerar um erro. O valor padrão é de 30.000 milissegundos (30 segundos).

Entrada

• Caminho da pasta do Orchestrator - O caminho para a pasta do Orchestrator que você deseja usar com essa atividade. Se for deixado em branco, será usada a pasta atual do Orchestrator. Esse campo é compatível apenas com strings e variáveis String.
• Referência — a referência das Actions que foi definida usando a atividade Criar tarefa de formulário .
• Nome do catálogo de tarefas — o nome do catálogo da ação que foi definido usando a atividade Criar tarefa de formulário .

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Opções de Consulta do OData

Opção de Consulta OData	Description	Tipo de dados do campo	Exemplo
Expandir	A opção OData expand , usada para exibir as entidades relacionadas de um critério.	String	"AssignedUser"
Filtro	A opção OData filter , usada para filtrar as ações recuperadas pelos critérios especificados.	String	Status in ('Pending', 'Unassigned') and Priority eq 'High'
Ordenar por	A opção OData orderby , usada para ordenar as ações recuperadas crescente (asc) ou decrescente (desc) por um critério especificado.	String	"Title asc" "ID desc"
Selecionar	A opção OData select , usada para recuperar um subconjunto das propriedades da ação.	String	"ID, Status, TaskCatalogName"
Pular	A opção OData skip , usada para evitar que várias ações sejam recuperadas.	Int32	2
Superior	A opção OData top , usada para definir o número de registros a serem recuperados, limitada a 1000 registros por vez. Se deixado em branco, os 100 principais registros serão recuperados.	Int32	20

Observação: OperadoresAND/ORtambém são suportados.

Saída

• Objetos de Tarefa (Saída) - A lista de objetos de saída que correspondem aos critérios definidos na atividade. A saída é retornada do Orchestrator como um objeto List<FormTaskData> . Use este objeto para criar um fluxo de trabalho de recuperação ou para passá-lo como entrada para um processo diferente.

Configuração multiplataforma

• Nome do catálogo de tarefas — o nome do catálogo da ação que foi definido usando a atividade Criar tarefa de formulário .
• Referência — a referência das Actions que foi definida usando a atividade Criar tarefa de formulário .
• Filtro - A opção OData filter , usada para filtrar as ações recuperadas pelos critérios especificados. Este campo suporta apenas strings e variáveis String. Por exemplo, Status in ('Pending', 'Unassigned'), and Priority eq 'High'.
• Selecionar — a opção select do OData, usada para recuperar um subconjunto das propriedades das Actions. Você é obrigado a inserir a opção de ID. Portanto, se você quiser recuperar os Catálogos de Actions , a consulta que você usaria é "Id, TaskCatalogName". Esse campo é compatível apenas com strings e variáveis String.
• Objetos de Tarefa (Saída) - A lista de objetos de saída que correspondem aos critérios definidos na atividade. A saída é retornada do Orchestrator como um objeto List<FormTaskData> . Use este objeto para criar um fluxo de trabalho de recuperação ou para passá-lo como entrada para um processo diferente.

Opções avançadas

Comum

• ContinuarComErro — especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.

Observação: se essa atividade estiver incluída na atividade Try Catch e o valor da propriedade ContinuarComErro for True, nenhum erro será capturado quando o projeto for executado.

• TempoLimiteEmMs - Especifica o período de tempo (em milissegundos) para aguardar que a atividade seja executada antes de gerar um erro. O valor padrão é de 30.000 milissegundos (30 segundos).

Entrada

• Caminho da pasta do Orchestrator - O caminho para a pasta do Orchestrator que você deseja usar com essa atividade. Se for deixado em branco, será usada a pasta atual do Orchestrator. Esse campo é compatível apenas com strings e variáveis String.

Opções de Consulta do OData

Opção de Consulta OData	Description	Tipo de dados do campo	Exemplo
Expandir	A opção OData expand , usada para exibir as entidades relacionadas de um critério.	String	"AssignedUser"
Ordenar por	A opção OData orderby , usada para ordenar as ações recuperadas crescente (asc) ou decrescente (desc) por um critério especificado.	String	"Title asc" "ID desc"
Pular	A opção OData skip , usada para evitar que várias ações sejam recuperadas.	Int32	2
Superior	A opção OData top , usada para definir o número de registros a serem recuperados, limitada a 1000 registros por vez. Se deixado em branco, os 100 principais registros serão recuperados.	Int32	20

Exemplos de consulta OData

Use os exemplos a seguir para obter tarefas de formulário ou para se inspirar para outras consultas:

1. Obtenha os IDs das Tarefas de Formulário de Alta prioridade que estão Pendentes, ordenados por seu título em ordem decrescente.
   1. Filtro: "((Priority eq 'High') and (Status eq 'Pending'))"
   2. Ordenar por: "Title desc"
   3. Selecionar: "Id"
2. Obtenha o Catálogo de Actions onde todas as Tarefas de formulário Não atribuídas e de Média prioridade são armazenadas e ordene-as por seu título em ordem crescente.
   1. Filtro: "((Priority eq 'Medium') and (Status eq 'Unassigned'))"
   2. Ordenar por: "Title asc"
   3. Selecionar: "Id, TaskCatalogName"