Create External Task

UiPath.Persistence.Activities.ExternalTask.CreateExternalTask

Description

Cria uma Ação Externa com os dados fornecidos, título da tarefa, prioridade da tarefa e catálogo de tarefas.

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Windows, Windows - configuração herdada

Painel do Designer

• TítuloDaTarefa - O título da ação que você deseja criar. Este campo é compatível apenas com strings e variáveis String .
• PrioridadeDaTarefa — permite selecionar o nível de prioridade da ação. Por padrão, essa propriedade é definida como TaskPriority.Medium. As seguintes opções estão disponíveis: TaskPriority.Low, TaskPriority.Medium, TaskPriority.Alta, TaskPriority.Critical.
• TaskCatalog - An optional business classification of task items. This field supports strings and String variables only.
• TaskData - A collection of business data, in the form Dictionary<String,Argument>, that you want to store in a given action. Modifying Out and In/Out arguments maps them back to the workflow after the action is completed. This field supports Dictionary<String,Argument> objects only.
• ObjetoDaTarefa(Saída) — o objeto da tarefa que é retornado do Orchestrator como um objeto ExternalTaskData após a ação ser criada. Este objeto pode ser passado para a atividade Wait for External Task and Resume para suspender a execução do fluxo de trabalho até que a ação seja concluída.

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

• External Tag - A tag that can be used to identify the external system which is the source for the data in the given action. This field supports strings and String variables only.
• Rótulos – O robô adiciona os rótulos inseridos à ação, permitindo filtragem futura. Este campo suporta apenas valores de string e tem restrições de nomenclatura.

Observação:

To allow automatic actions labeling through Persistence activities, the robot account executing the workflow needs View, Create, and Delete permissions on Tags.

• Caminho da pasta do Orchestrator — o caminho para uma pasta do Orchestrator diferente daquele no qual o processo atual opera, onde você deseja criar a tarefa. Para ler mais sobre pastas do Orchestrator, acesse aqui. Para pastas Clássicas , essa propriedade só pode ser usada com Floating Robots e apenas se o usuário atual tiver os privilégios de tarefa corretos na pasta de destino. Para pastas Modernas , a substituição do caminho da pasta não é compatível. Este campo é compatível apenas com strings e variáveis String .

Observação:

A propriedade FolderPath deve ser usada apenas se a tarefa tiver que criada ou consultada de uma pasta diferente da atual. Se o usuário executando essa ação não tiver as permissões necessárias para a pasta de destino, a criação da tarefa falhará e gerará um erro crítico. Você pode ver mais informações sobre permissões de pastas aqui.

• TaskCatalog - An optional business classification of task items. This field supports strings and String variables only.

Observação:

Certifique-se de que o catálogo de ações exista antes da criação da ação. Caso contrário, a criação da ação falha com a seguinte mensagem de erro: "Nenhum catálogo de tarefas existe com o nome [action_catalog_name] Código de erro: 2451".

• TaskData - A collection of business data, in the form Dictionary<String,Argument>, that you want to store in a given action. Modifying Out and In/Out arguments maps them back to the workflow after the action is completed. This field supports Dictionary<String,Argument> objects only.
• PrioridadeDaTarefa — permite selecionar o nível de prioridade da ação. Por padrão, essa propriedade é definida como TaskPriority.Medium. As seguintes opções estão disponíveis: TaskPriority.Low, TaskPriority.Medium, TaskPriority.Alta, TaskPriority.Critical.
• TítuloDaTarefa - O título da ação que você deseja criar. Este campo é compatível apenas com strings e variáveis String .

Diversos

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

Saída

• ObjetoDaTarefa(Saída) — o objeto da tarefa que é retornado do Orchestrator como um objeto ExternalTaskData após a ação ser criada. Este objeto pode ser passado para a atividade Wait for External Task and Resume para suspender a execução do fluxo de trabalho até que a ação seja concluída.

Configuração multiplataforma

• TítuloDaTarefa - O título da ação que você deseja criar. Este campo é compatível apenas com strings e variáveis String .
• PrioridadeDaTarefa — permite selecionar o nível de prioridade da ação. Por padrão, essa propriedade é definida como TaskPriority.Medium. As seguintes opções estão disponíveis: TaskPriority.Low, TaskPriority.Medium, TaskPriority.Alta, TaskPriority.Critical.
• TaskCatalog - An optional business classification of task items. This field supports strings and String variables only.

Observação:

Certifique-se de que o catálogo de ações exista antes da criação da ação. Caso contrário, a criação da ação falha com a seguinte mensagem de erro: "Nenhum catálogo de tarefas existe com o nome [action_catalog_name] Código de erro: 2451".

• TaskData - A collection of business data, in the form Dictionary<String,Argument>, that you want to store in a given action. Modifying Out and In/Out arguments maps them back to the workflow after the action is completed. This field supports Dictionary<String,Argument> objects only.
• ObjetoDaTarefa(Saída) — o objeto da tarefa que é retornado do Orchestrator como um objeto ExternalTaskData após a ação ser criada. Este objeto pode ser passado para a atividade Wait for External Task and Resume para suspender a execução do fluxo de trabalho até que a ação seja concluída.

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

• Rótulos – O robô adiciona os rótulos inseridos à ação, permitindo filtragem futura. Este campo suporta apenas valores de string e tem restrições de nomenclatura.

Observação:

To allow automatic actions labeling through Persistence activities, the robot account executing the workflow needs View, Create, and Delete permissions on Tags.

• Caminho da pasta do Orchestrator — o caminho para uma pasta do Orchestrator diferente daquele no qual o processo atual opera, onde você deseja criar a tarefa. Para ler mais sobre pastas do Orchestrator, acesse aqui. Para pastas Clássicas , essa propriedade só pode ser usada com Floating Robots e apenas se o usuário atual tiver os privilégios de tarefa corretos na pasta de destino. Para pastas Modernas , a substituição do caminho da pasta não é compatível. Este campo é compatível apenas com strings e variáveis String .

Observação:

A propriedade FolderPath deve ser usada apenas se a tarefa tiver que criada ou consultada de uma pasta diferente da atual. Se o usuário executando essa ação não tiver as permissões necessárias para a pasta de destino, a criação da tarefa falhará e gerará um erro crítico. Você pode ver mais informações sobre permissões de pastas aqui.

• Referência - Uma tag que você pode usar para identificar o sistema externo que é a origem dos dados na ação determinada. Este campo é compatível apenas com strings e variáveis String .

Criando ações externas

Para criar uma Ação Externa escolha entre os seguintes procedimentos:

1. Adicione uma atividade Create External Task ao seu fluxo de trabalho e forneça informações para os seguintes campos de propriedades:
   • Título da Tarefa
   • Prioridade da Tarefa
   • Dados da tarefa (coleção)
   • Tag externa — especifique uma tag para identificar exclusivamente lotes de tarefas externas que você deseja recuperar de um sistema de terceiros. Você pode usar essa tag para sincronizar Tarefas Externas com um sistema externo. Além disso, você pode usar essa tag para concluir tarefas com base nas ações que um usuário adota no sistema de terceiros.
2. Criar ação externa usando APIs.

Sincronizar ações externas com ferramentas de terceiros

Para sincronizar ações externas com outros sistemas externos, você precisa primeiro criar um objeto correspondente para ele dentro do sistema externo e, em seguida, recuperar a tarefa, ou lote de tarefas, criado pelo sistema de terceiros, usando uma chamada de API.

1. Crie um objeto dentro de um sistema externo, como:

   • Crie um problema no Jira.
   • Crie um contato no Salesforce.

2. Chame a seguinte API no Swagger: GET /odata/Tasks/UiPath.Server.Configuration.OData.GetTasksAcrossFolders.

   Por exemplo: GET <ORCH_URL>/odata/Tasks/UiPath.Server.Configuration.OData.GetTasksAcrossFolders?$filter=(Type eq 'ExternalTask') and (IsDeleted eq false) and (ExternalTag eq 'JiraTasks') and (Status ne 'Completed')&$count=true.

Recuperando ações externas

Chame a seguinte API para recuperar informações sobre uma tarefa externa, usando o ID da tarefa e o ID da unidade organizacional (o ID da pasta do Orchestrator): GET /tasks/GenericTasks/GetTaskDataById. Você pode usar os detalhes recuperados para criar uma tarefa semelhante em um sistema de terceiros.

As capturas de tela abaixo mostram os parâmetros e as respostas da API no Swagger. Para acessar seu tenant dentro do Swagger, siga o procedimento Acesso ao seu arquivo Swagger .

Concluindo ações externas

Chame a API a seguir para concluir uma tarefa externa, usando o ID da tarefa e o ID da Unidade organizacional (o ID da pasta do Orchestrator): POST /tasks/GenericTasks/CompleteTask.

Visite o procedimento Concluir tarefa externa no guia da API do Orchestrator para obter mais detalhes.

Exemplo de fluxo de trabalho

Para um exemplo ou referência futura, confira o projeto de exemplo