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

The output object of the Get Form Tasks activity can be used in any other persistence activity, for example Wait For Form Task And Resume, to cover the scenarios that require another workflow to wait on the Actions, different than the workflow that created those Actions (for example, building a recovery workflow in case the current job fails). You can also pass the output object to a different process as input, so that you don't need to wait for all the Actions to be completed until the initial process resumes.

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

• Task Catalog Name - The action's catalog name that was set using the Create Form Task activity.
• Reference - The Action reference that was set using the Create Form Task activity.
• Filter - The OData filter option, used to filter the retrieved actions by the specified criteria. This field supports only strings and String variables. For example, Status in ('Pending', 'Unassigned'), and Priority eq 'High'.
• Selecionar - A opção select OData, usada para recuperar um subconjunto de propriedades da ação. Você é solicitado a inserir a opção de ID. Portanto, se você quiser recuperar os Catálogos de ações, a consulta que você usaria é "Id, TaskCatalogName". Esse campo é compatível apenas com strings e variáveis String.
• Task Objects (Output) - The list of output objects that match the criteria set in the activity. The output is returned from Orchestrator as a List<FormTaskData> object. Use this object to create a recovery workflow or to pass it as input to a different process.

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 esta atividade estiver incluída em Try Catch e o valor da propriedade Continuar com erro for Verdadeiro, nenhum erro será capturado quando o projeto for executado.

• DisplayName - 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 esta atividade. Se deixado vazio, a pasta atual do Orchestrator será usada. Esse campo é compatível apenas com strings e variáveis String.
• Reference - The Action's reference that was set using the Create Form Task activity.
• Task Catalog Name - The action's catalog name that was set using the Create Form Task activity.

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:

Os operadores AND/ORtambém são suportados.

Saída

• Task Objects (Output) - The list of output objects that match the criteria set in the activity. The output is returned from Orchestrator as a List<FormTaskData> object. Use this object to create a recovery workflow or to pass it as input to a different process.

Configuração multiplataforma

• Task Catalog Name - The action's catalog name that was set using the Create Form Task activity.
• Reference - The Action reference that was set using the Create Form Task activity.
• Filter - The OData filter option, used to filter the retrieved actions by the specified criteria. This field supports only strings and String variables. For example, Status in ('Pending', 'Unassigned'), and Priority eq 'High'.
• Selecionar - A opção select OData, usada para recuperar um subconjunto de propriedades da ação. Você é solicitado a inserir a opção de ID. Portanto, se você quiser recuperar os Catálogos de ações, a consulta que você usaria é "Id, TaskCatalogName". Esse campo é compatível apenas com strings e variáveis String.
• Task Objects (Output) - The list of output objects that match the criteria set in the activity. The output is returned from Orchestrator as a List<FormTaskData> object. Use this object to create a recovery workflow or to pass it as input to a different process.

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 esta atividade estiver incluída em Try Catch e o valor da propriedade Continuar com erro for Verdadeiro, 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 esta atividade. Se deixado vazio, a pasta atual do Orchestrator será usada. 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"