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 oferece suporte apenas a valores de string e possui restrições de nomenclatura.

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 orquestrador - o caminho para uma pasta do orquestrador 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 Classic , esta propriedade só pode ser usada 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 suporta apenas strings e variáveis String .

Nota: A propriedade FolderPath deve ser usada apenas se a tarefa deve ser criada ou consultada a partir de uma pasta diferente da atual. Se o usuário que executa esta 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 pasta 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 falhará 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 falhará 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 oferece suporte apenas a valores de string e possui restrições de nomenclatura.

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 orquestrador - o caminho para uma pasta do orquestrador 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 Classic , esta propriedade só pode ser usada 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 suporta apenas strings e variáveis String .

Nota: A propriedade FolderPath deve ser usada apenas se a tarefa deve ser criada ou consultada a partir de uma pasta diferente da atual. Se o usuário que executa esta 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 pasta 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 Actionsexternas 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 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 locatário dentro do Swagger, siga o procedimento Acessando 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 amostra