Obter tarefas do aplicativo

Atividade GetAppTasks que recupera tarefas do aplicativo do Action Center usando as opções de consulta do OData para filtrar, classificar e selecionar propriedades da tarefa.

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, para cobrir os cenários que exigem que outro fluxo de trabalho aguarde nas tarefas, diferente do fluxo de trabalho que criou essas tarefas (por exemplo, criar uma recuperação fluxo de trabalho 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 tarefas 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

Janelas | Plataforma cruzada

Configuração do Windows

Painel do Designer

• 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

• DisplayName - 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 esta atividade. Se deixado vazio, a pasta atual do Orchestrator será usada. 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.
• Nome do Catálogo de Tarefas — o nome do catálogo da ação que foi definido usando a atividade.

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

• 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

• 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

• 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.
• 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.
• Nome do Catálogo de Tarefas — o nome do catálogo da ação que foi definido usando a atividade.
• Referência - A referência da ação que foi definida usando a atividade.
• 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

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

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"