Criar tarefa do aplicativo

UiPath.Persistence.Activities.UserAction.CreateUserAction

Description

Cria uma tarefa do aplicativo no Action Center. As propriedades da Ação são criadas adicionando um controle da Ação dentro do Aplicativo, que define os campos de entrada, enquanto o Apps fornece a interface visual para renderizar a tarefa no Action Center.

Observação:

As tarefas do aplicativo estão disponíveis na versão 2022.10 do Studio ou posterior.

Compatibilidade do projeto

Windows | Multiplataforma

Configuração do Windows

Painel do Designer

• Título - O título da ação que você deseja criar. Este campo é compatível apenas com strings e variáveis String .
• Prioridade — insira o nível de prioridade da ação como um argumento do tipo UiPath.Persistence.Activities.Model.Task.TaskPriority. Defina o parâmetro de valor Padrão do argumento usando o valor TaskPriority Enum . As seguintes opções estão disponíveis: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.
• Apps - Escolha o aplicativo da Ação que você criou e implantou dentro da instância do Apps de sua organização e do tenant, enquanto usa o Studio.

  Após escolher um aplicativo da Ação, as propriedades da ação se tornarão acessíveis como propriedades na atividade. Crie variáveis e variáveis de entrada para cada campo adequadamente.

  Se você atualizar o aplicativo de ação, uma propriedade Atualizar , ao lado do campo Nome da Definição de Ação, será exibida, que você pode usar para atualizar a atividade com as últimas alterações.

  Observação: o menu suspenso Apps exibe apenas aplicativos que são implantados e têm ações.
• Caminho da pasta do Orchestrator — o caminho para a pasta do Orchestrator na qual você deseja criar a tarefa e onde implantou o aplicativo correspondente. O caminho da pasta deve ser o mesmo em que o aplicativo selecionado anteriormente foi implantado. Esse campo é preenchido automaticamente quando você seleciona uma opção na lista suspensa Apps , correspondendo à pasta em que o aplicativo selecionado está implantado. Depois de preenchido, o campo fica no modo somente leitura e não pode ser alterado.

Painel de Propriedades

Entrada

• TaskCatalog - Uma classificação comercial opcional de itens de tarefa. Este campo suporta apenas strings e variáveis String.
  Importante: certifique-se de que o catálogo da ação 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."
• Rótulos - O robô adiciona os rótulos inseridos à ação, permitindo filtragem futura. Este campo é compatível apenas com valores de string e tem 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.

Diversos

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

Saída

• ObjetoDaTarefa(Saída) — o objeto da tarefa que é retornado do Orchestrator como um objeto UserActionData após a ação ser criada. Esse objeto pode ser passado para a atividade Wait For App Task And Resume para suspender a execução do fluxo de trabalho até a ação ser concluída.

Notificação acionável

Observação: atualmente, o Outlook é o único canal de notificação que suporta notificações acionáveis.

Pré-requisitos: para que as notificações acionáveis funcionem como o esperado, você precisa:

• Habilite uma conexão do Microsoft Outlook 365 no Integration Service dentro do tenant ao qual sua automação do Studio está vinculada.
• Verifique se o usuário atribuído à notificação acionável está inscrito no evento de notificação Ação atribuída .

Se você quiser que o destinatário da tarefa receba uma notificação acionável em vez de um e-mail normal, habilite Notificação acionável no painel de propriedades da atividade.

Para habilitar notificações acionáveis, siga estas etapas:

1. No painel Propriedades da atividade, selecione Mostrar opções adicionais.
2. Expanda Notificação acionável e habilite a opção usando o botão de alternância.
3. Selecione o canal desejado para notificações acionáveis.
4. Configure o conteúdo da notificação adicionando novos campos Tarefa ou botões acionáveis se necessário.

Configuração multiplataforma

Painel do Designer

• Título - O título da ação que você deseja criar. Este campo é compatível apenas com strings e variáveis String .
• Prioridade — insira o nível de prioridade da ação como um argumento do tipo UiPath.Persistence.Activities.Model.Task.TaskPriority. Defina o parâmetro de valor Padrão do argumento usando o valor TaskPriority Enum . As seguintes opções estão disponíveis: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.
• Apps - Selecione um aplicativo de ação que você criou e implantou dentro da instância do Apps de sua organização e do tenant, enquanto usa o Studio. Após escolher um aplicativo da Ação, as propriedades da ação se tornarão acessíveis como propriedades na atividade. Crie variáveis e valores de entrada para cada campo adequadamente.

  Se você atualizar o aplicativo de ação, uma propriedade Atualizar , ao lado do campo Nome da Definição de Ação, será exibida, que você pode usar para atualizar a atividade com as últimas alterações.

  • Se sua atividade fizer parte de uma solução no Studio Web, selecione + Recurso para acessar um aplicativo de Ação gerado automaticamente. Aqui, você pode estabelecer um esquema de ação e configurar o aplicativo.
  Observação: a lista suspensa Apps exibe apenas aplicativos que são implantados e têm ações. No entanto, para fluxos de trabalho que fazem parte de uma solução dentro do Studio Web, a lista suspensa Apps também exibe aplicativos de ação local dessa solução, mesmo que ainda não tenham sido implantados.
• Caminho da pasta do Orchestrator — o caminho para a pasta do Orchestrator na qual você deseja criar a tarefa e onde implantou o aplicativo correspondente. O caminho da pasta deve ser o mesmo em que o aplicativo selecionado anteriormente foi implantado. Esse campo é preenchido automaticamente quando você seleciona uma opção na lista suspensa Apps , correspondendo à pasta em que o aplicativo selecionado está implantado. Depois de preenchido, o campo fica no modo somente leitura e não pode ser alterado.

Painel de Propriedades

Entrada

• TaskCatalog - Uma classificação comercial opcional de itens de tarefa. Este campo suporta apenas strings e variáveis String.
  Importante: certifique-se de que o catálogo da ação 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."
• Rótulos - O robô adiciona os rótulos inseridos à ação, permitindo filtragem futura. Este campo é compatível apenas com valores de string e tem 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.

Diversos

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

Saída

• ObjetoDaTarefa(Saída) — o objeto da tarefa que é retornado do Orchestrator como um objeto UserActionData após a ação ser criada. Esse objeto pode ser passado para a atividade Wait For App Task And Resume para suspender a execução do fluxo de trabalho até a ação ser concluída.

Notificação acionável

Observação: atualmente, o Outlook é o único canal de notificação que suporta notificações acionáveis.

Pré-requisitos: para que as notificações acionáveis funcionem como o esperado, você precisa:

• Habilite uma conexão do Microsoft Outlook 365 no Integration Service dentro do tenant ao qual sua automação do Studio está vinculada.
• Verifique se o usuário atribuído à notificação acionável está inscrito no evento de notificação Ação atribuída .

Se você quiser que o destinatário da tarefa receba uma notificação acionável em vez de um e-mail normal, habilite Notificação acionável no painel de propriedades da atividade.

Para habilitar notificações acionáveis, siga estas etapas:

1. No painel Propriedades da atividade, selecione Mostrar opções adicionais.
2. Expanda Notificação acionável e habilite a opção usando o botão de alternância.
3. Selecione o canal desejado para notificações acionáveis.
4. Configure o conteúdo da notificação adicionando novos campos Tarefa ou botões acionáveis se necessário.