Criar tarefa do aplicativo

Atividade Create App Task que cria uma tarefa de aplicativo no Action Center.

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 de Ação que você criou e implantou dentro da instância do Apps de sua organização e tenant, enquanto usa o Studio. Depois de escolher um aplicativo de 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 será exibida ao lado do campo Nome da definição de ação , a qual você pode usar para atualizar a atividade com as alterações mais recentes.
  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 onde você deseja criar a tarefa e onde você implantou o aplicativo correspondente. O caminho da pasta deve ser o mesmo que o caminho em que o aplicativo selecionado anteriormente foi implantado. Esse campo é preenchido automaticamente quando você seleciona uma opção na lista suspensa Aplicativos , correspondendo à pasta na qual o aplicativo selecionado está implantado. Após ter sido preenchido, o campo ficará no modo somente leitura e não poderá ser alterado.

Painel de Propriedades

Entrada

• CatálogoDeTarefas - Uma classificação de negócios opcional de itens de tarefa. Esse campo é compatível apenas com strings e variáveis String.
  Importante:

  Certifique-se de que o catálogo de ações exista antes da criação das ações. Caso contrário, a criação de ações falha com a seguinte mensagem de erro: "Nenhum catálogo de tarefas existe 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 suporta apenas 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 Persistence, a conta do robô que executa o fluxo de trabalho precisa das permissões Visualizar, Criar e 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. Este objeto pode ser passado para a atividade Wait For App Task And Resume para suspender a execução do fluxo de trabalho até que a ação seja 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 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 acionável .

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 de notificação adicionando novos campos de tarefa ou botões acionáveis, se necessário.

   

Temporizador da tarefa

Defina um temporizador do contrato de nível de serviço (SLA) para a tarefa na seção Temporizador da tarefa do painel de propriedades. Um temporizador é aplicado quando a Duração do temporizador tem um valor.

Observação:

A configuração de um temporizador de tarefas está disponível no Studio Web e no Studio STS versão 26.0.188 ou superior.

• Critérios de início - O evento que inicia o temporizador: Tarefa criada ou Tarefa atribuída.
• Critérios de término - O evento que interrompe o temporizador: Tarefa atribuída ou Tarefa concluída. O padrão das novas atividades é Task completed. Os temporizadores que terminam na Tarefa atribuída não são exibidos no Action Center. Eles continuam a ser executados, e o resultado configurado ainda é disparado quando expiram.
• Duração do temporizador - A duração do temporizador, no formato 0d 00h 00m . Este campo também é compatível com expressões. Uma duração vazia significa que nenhum temporizador foi definido.
• Resultado - A ação disparada quando o temporizador decorrido: Destinatário do Alerta, Reatribuir, Cancelar atribuição ou Conclusão automática. Uma tarefa não carrega um temporizador após ser reatribuída, cancelada da atribuição ou concluída automaticamente.
• Critérios de atribuição em caso de violação - Como a tarefa é atribuída quando o Resultado é Reatribuir: Usuário (o padrão), Todos os usuários no grupo, Carga de trabalho baseado ou Round Robin. Os critérios do grupo têm os mesmos pré-requisitos da atribuição de grupos na atividade Assign Tasks .
• Reatribuir ao usuário - O usuário ao qual a tarefa é reatribuída, quando os critérios de atribuição em violação são Usuário. Pesquise um usuário ou forneça um valor ou uma variável.
• Reatribuir a grupo - O grupo ao qual a tarefa é reatribuída. Este campo é exibido quando os critérios de atribuição em violação são qualquer opção diferente de Usuário e não pode estar vazio.

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 da sua organização e do tenant, enquanto usa o Studio. Depois de escolher um aplicativo de 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 será exibida ao lado do campo Nome da definição de ação , a qual você pode usar para atualizar a atividade com as alterações mais recentes.
  • 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 onde você deseja criar a tarefa e onde você implantou o aplicativo correspondente. O caminho da pasta deve ser o mesmo que o caminho em que o aplicativo selecionado anteriormente foi implantado. Esse campo é preenchido automaticamente quando você seleciona uma opção na lista suspensa Aplicativos , correspondendo à pasta na qual o aplicativo selecionado está implantado. Após ter sido preenchido, o campo ficará no modo somente leitura e não poderá ser alterado.

Painel de Propriedades

Entrada

• CatálogoDeTarefas - Uma classificação de negócios opcional de itens de tarefa. Esse campo é compatível apenas com strings e variáveis String.
  Importante:

  Certifique-se de que o catálogo de ações exista antes da criação das ações. Caso contrário, a criação de ações falha com a seguinte mensagem de erro: "Nenhum catálogo de tarefas existe 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 suporta apenas 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 Persistence, a conta do robô que executa o fluxo de trabalho precisa das permissões Visualizar, Criar e 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. Este objeto pode ser passado para a atividade Wait For App Task And Resume para suspender a execução do fluxo de trabalho até que a ação seja 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 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 acionável .

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 de notificação adicionando novos campos de tarefa ou botões acionáveis, se necessário.

   

Temporizador da tarefa

Defina um temporizador do contrato de nível de serviço (SLA) para a tarefa na seção Temporizador da tarefa do painel de propriedades. Um temporizador é aplicado quando a Duração do temporizador tem um valor.

Observação:

A configuração de um temporizador de tarefas está disponível no Studio Web e no Studio STS versão 26.0.188 ou superior.

• Critérios de início - O evento que inicia o temporizador: Tarefa criada ou Tarefa atribuída.
• Critérios de término - O evento que interrompe o temporizador: Tarefa atribuída ou Tarefa concluída. O padrão das novas atividades é Task completed. Os temporizadores que terminam na Tarefa atribuída não são exibidos no Action Center. Eles continuam a ser executados, e o resultado configurado ainda é disparado quando expiram.
• Duração do temporizador - A duração do temporizador, no formato 0d 00h 00m . Este campo também é compatível com expressões. Uma duração vazia significa que nenhum temporizador foi definido.
• Resultado - A ação disparada quando o temporizador decorrido: Destinatário do Alerta, Reatribuir, Cancelar atribuição ou Conclusão automática. Uma tarefa não carrega um temporizador após ser reatribuída, cancelada da atribuição ou concluída automaticamente.
• Critérios de atribuição em caso de violação - Como a tarefa é atribuída quando o Resultado é Reatribuir: Usuário (o padrão), Todos os usuários no grupo, Carga de trabalho baseado ou Round Robin. Os critérios do grupo têm os mesmos pré-requisitos da atribuição de grupos na atividade Assign Tasks .
• Reatribuir ao usuário - O usuário ao qual a tarefa é reatribuída, quando os critérios de atribuição em violação são Usuário. Pesquise um usuário ou forneça um valor ou uma variável.
• Reatribuir a grupo - O grupo ao qual a tarefa é reatribuída. Este campo é exibido quando os critérios de atribuição em violação são qualquer opção diferente de Usuário e não pode estar vazio.

Problemas conhecidos

No Studio Desktop, selecionar Limpar valor para duração do temporizador deixa o valor anterior visível no campo, embora a tarefa seja executada sem temporizador anexado. Isso afeta as atividades de persistência V1.12.0. O Studio Web não é afetado.

Para aplicar um temporizador novamente após limpar o valor, exclua o conteúdo de Duração do temporizador e insira a duração novamente.