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 outro fluxo de trabalho para aguardar as ações, diferente do fluxo de trabalho que criou essas ações ( 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 que não precise esperar que todas as ações sejam concluídas até que o processo inicial seja 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 de ação 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 da ação 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 de ação 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"