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 - The title of the action you want to create. This field supports strings and String variables only.
• TaskPriority - Enables you to select the priority level of the action. By default, this property is set to TaskPriority.Medium The following options are available: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, 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

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  Observação:

  If this activity is included in Try Catch and the value of the ContinueOnError property is True, no error is caught when the project is executed.

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

• TaskPriority - Enables you to select the priority level of the action. By default, this property is set to TaskPriority.Medium The following options are available: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.

• TaskTitle - The title of the action you want to create. This field supports strings and String variables only.

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

• TaskTitle - The title of the action you want to create. This field supports strings and String variables only.

• TaskPriority - Enables you to select the priority level of the action. By default, this property is set to TaskPriority.Medium The following options are available: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, 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

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  Observação:

  If this activity is included in Try Catch and the value of the ContinueOnError property is True, no error is caught when the project is executed.

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

• Reference - A tag that you can use to identify the external system which is the source for the data in the given action. This field supports strings and String variables only.

Criando ações externas

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

1. Add a Create External Task activity into your workflow and provide information for the following property fields:
   • Título da Tarefa
   • Prioridade da Tarefa
   • Dados da tarefa (coleção)
   • External Tag - Specify a tag to uniquely identify batches of external tasks that you want to retrieve from a third-party system. You can use this tag to sync External Tasks with an external system. Also, you can use this tag to complete tasks based on the actions a user takes in the third party system.
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. Call the following API in Swagger: GET /odata/Tasks/UiPath.Server.Configuration.OData.GetTasksAcrossFolders.

For example: 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

Call the following API to retrieve information about an external task, using the Task Id and the Organization Unit Id (the Id of the Orchestrator folder): GET /tasks/GenericTasks/GetTaskDataById. You can use the retrieved details to create a similar task in a third-party system.

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

Call the following API to complete an external task, using the Task Id and the Organization Unit Id (the Id of the Orchestrator folder): 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