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

• TaskTitle - O título da ação que você deseja criar. Este campo suporta apenas strings e variáveis String .
• TaskPriority - 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.High, TaskPriority.Critical.
• TaskCatalog - Uma classificação comercial opcional de itens de tarefa. Este campo suporta apenas strings e variáveis String .
• TaskData - Uma coleção de dados de negócios, no formato Dictionary<String,Argument>, que você deseja armazenar em uma determinada ação. A modificação dos argumentos Out e In/Out os mapeia de volta ao fluxo de trabalho após a conclusão da ação. Este campo suporta apenas objetos Dictionary<String,Argument> .
• ObjetoDaTarefa(Saída) — o objeto da tarefa que é retornado do Orchestrator como um objeto ExternalTaskData após a criação das Actions . Esse objeto pode ser passado para a atividade Wait for External Task and Resume para suspender a execução do fluxo de trabalho até as Actions serem concluídas.

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

• Marca Externa - Uma marca que pode ser usada para identificar o sistema externo que é a fonte dos dados na ação especificada. Este campo suporta apenas strings e variáveis String .
• 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 nomeação.

Observação: para permitir a rotulagem de ações automáticas por meio de atividades de persistência, a conta do robô que executa o fluxo de trabalho precisa das permissões Visualizar, Criare Excluir em Tags.

• Caminho da pasta do Orchestrator — o caminho para uma pasta do Orchestrator diferente daquela em que 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 pode ser usada apenas com Robôs Flutuantes e somente 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 é suportada. Este campo é compatível apenas com strings e variáveis String .

Observação: a propriedade CaminhoDaPasta deve ser usada apenas se a tarefa precisar ser 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. Veja mais informações sobre Permissões de pastas aqui.

• TaskCatalog - Uma classificação comercial opcional de itens de tarefa. Este campo suporta apenas strings e variáveis String .

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: "Não existe nenhum catálogo de tarefas com o nome [action_catalog_name] Código de erro: 2451".

• TaskData - Uma coleção de dados de negócios, no formato Dictionary<String,Argument>, que você deseja armazenar em uma determinada ação. A modificação dos argumentos Out e In/Out os mapeia de volta ao fluxo de trabalho após a conclusão da ação. Este campo suporta apenas objetos Dictionary<String,Argument> .
• TaskPriority - 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.High, TaskPriority.Critical.
• TaskTitle - O título da ação que você deseja criar. Este campo suporta apenas 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 criação das Actions . Esse objeto pode ser passado para a atividade Wait for External Task and Resume para suspender a execução do fluxo de trabalho até as Actions serem concluídas.

Configuração multiplataforma

• TaskTitle - O título da ação que você deseja criar. Este campo suporta apenas strings e variáveis String .
• TaskPriority - 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.High, TaskPriority.Critical.
• TaskCatalog - Uma classificação comercial opcional de itens de tarefa. Este campo suporta apenas strings e variáveis String .

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: "Não existe nenhum catálogo de tarefas com o nome [action_catalog_name] Código de erro: 2451".

• TaskData - Uma coleção de dados de negócios, no formato Dictionary<String,Argument>, que você deseja armazenar em uma determinada ação. A modificação dos argumentos Out e In/Out os mapeia de volta ao fluxo de trabalho após a conclusão da ação. Este campo suporta apenas objetos Dictionary<String,Argument> .
• ObjetoDaTarefa(Saída) — o objeto da tarefa que é retornado do Orchestrator como um objeto ExternalTaskData após a criação das Actions . Esse objeto pode ser passado para a atividade Wait for External Task and Resume para suspender a execução do fluxo de trabalho até as Actions serem concluídas.

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

• 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 nomeação.

Observação: para permitir a rotulagem de ações automáticas por meio de atividades de persistência, a conta do robô que executa o fluxo de trabalho precisa das permissões Visualizar, Criare Excluir em Tags.

• Caminho da pasta do Orchestrator — o caminho para uma pasta do Orchestrator diferente daquela em que 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 pode ser usada apenas com Robôs Flutuantes e somente 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 é suportada. Este campo é compatível apenas com strings e variáveis String .

Observação: a propriedade CaminhoDaPasta deve ser usada apenas se a tarefa precisar ser 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. Veja mais informações sobre Permissões de pastas aqui.

• Referência - Uma tag que você pode usar para identificar o sistema externo que é a fonte dos dados na ação especificada. Este campo suporta apenas strings e variáveis String .

Criando ações externas

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

1. Adicione uma atividade Criar Tarefa Externa em seu fluxo de trabalho e forneça informações para os seguintes campos de propriedade:

   • Título da Tarefa
   • Prioridade da Tarefa
   • Dados da tarefa (coleção)
   • Marca externa - Especifique uma marca para identificar exclusivamente lotes de tarefas externas que você deseja recuperar de um sistema de terceiros. Você pode usar esta 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 realiza 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.
   • Cria 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 orquestrador): 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 respostas da API no Swagger. Para acessar seu tenant dentro do Swagger, siga o procedimento de Acesso ao seu arquivo Swagger .

Concluindo ações externas

Chame a seguinte API para concluir uma tarefa externa, usando o ID da tarefa e o ID da unidade de organização (o ID da pasta do orquestrador): 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