Obter tarefas do aplicativo

UiPath.Persistence.Activities.UserAction.GetAppTasks

Description

Recupera uma única tarefa do aplicativo ou um conjunto de tarefas do aplicativo, filtrado por critérios específicos, ou seja, as propriedades DTO da tarefa:

• 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 App Tasks pode ser usado em qualquer outra atividade de persistência, por exemplo, Wait For App Task And Resume, para abranger os cenários que exigem que outro fluxo de trabalho aguarde as tarefas, diferente do fluxo de trabalho que criou essas tarefas ( 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 todas as tarefas 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 | Multiplataforma

Configuração do Windows

Painel do Designer

• 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

• NomeDeExibição - o nome de exibição da atividade.

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 Create App Task .
• Nome do catálogo de tarefas — o nome do catálogo da ação que foi definido usando a atividade Criar tarefa do aplicativo .

Diversos

• 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.

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

• 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).

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/OR també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

• 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.
• 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.
• Nome do catálogo de tarefas — o nome do catálogo da ação que foi definido usando a atividade Criar tarefa do aplicativo .
• Referência — a referência da ação que foi definida usando a atividade Create App Task .
• 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

Diversos

• 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).

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 do aplicativo ou como inspiração para outras consultas:

1. Obtenha os IDs das Tarefas Obter Aplicativo 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 ações, onde todas as Tarefas Obter Aplicativo que estão Não atribuídas e de Prioridade Média estã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"