- Notas de Versão
- Antes de começar
- Introdução
- Instalação e atualização
- Atividades
- Projetando fluxos de trabalho de longa duração
- Start Job And Get Reference
- Wait for Job and Resume
- Add Queue Item And Get Reference
- Wait For Queue Item And Resume
- Create Form Task
- Wait for Form Task and Resume
- Resume After Delay
- Assign Tasks
- Create External Task
- Wait For External Task and Resume
- Complete Task
- Forward Task
- Get Form Tasks
- Get Task Data
- Add Task Comment
- Update Task Labels
- Ações
- Processos
- Solução de problemas
![](https://docs.uipath.com/_next/static/media/grid.05ebd128.png?w=3840&%3Bq=100)
Create External Task
UiPath.Persistence.Activities.ExternalTask.CreateExternalTask
Cria uma Ação Externa com os dados fornecidos, título da tarefa, prioridade da tarefa e catálogo de tarefas.
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 argumentosOut
eIn/Out
os mapeia de volta ao fluxo de trabalho após a conclusão da ação. Este campo suporta apenas objetosDictionary<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.
- 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.
- 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
.
- 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 argumentosOut
eIn/Out
os mapeia de volta ao fluxo de trabalho após a conclusão da ação. Este campo suporta apenas objetosDictionary<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.
- 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 argumentosOut
eIn/Out
os mapeia de volta ao fluxo de trabalho após a conclusão da ação. Este campo suporta apenas objetosDictionary<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.
- 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.
- 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
.
- 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:
-
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.
- 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.
-
Crie um objeto dentro de um sistema externo, como:
- Crie um problema no Jira.
- Crie um contato no Salesforce.
-
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
.
/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 .
/tasks/GenericTasks/CompleteTask
.
Visite o procedimento Concluir tarefa externa no guia da API do Orchestrator para obter mais detalhes.