Create Form Task

UiPath.Persistence.Activities.FormTask.CreateFormTask

Description

Cria uma ação de formulário em instâncias de nuvem e locais do Action Center. Ele também cria uma tarefa de formulário no On-Premises Orchestrator versão 21.4 e inferior.

Pré-requisitos

• Instale o pacote UiPath.FormActivityLibrary na versão 2.0.7 ou superior para habilitar o designer de formulários.
• As tarefas de formulário têm um limite de 1 MB. Para se adequar a esse limite de 1 MB, você precisa incorporar imagens dentro dos formulários, usando apenas os Buckets de armazenamento. Além disso, sugerimos o uso de imagens do tipo base64 apenas para logotipos e ícones menores que 2 KB.

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Windows, Windows - configuração herdada

Painel do Designer

• TítuloDaTarefa - O título da ação que você deseja criar. Este campo é compatível apenas com strings e variáveis String .
• PrioridadeDaTarefa — 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.Alta, TaskPriority.Critical.
• 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 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".

• DadosDoFormulário - Uma coleção de dados de negócios no formulário Dictionary<String,Argument> que você deseja exibir em um formulário dentro da caixa de entrada de Ações. Modificar os argumentos Out e In/Out os mapeia de volta para o fluxo de trabalho após a tarefa ser concluída. Este campo é compatível apenas com objetos Dictionary<String,Argument> .
• ObjetoDaTarefa(Saída) — o objeto da tarefa que é retornado do Orchestrator como um objeto FormTaskData após a ação ser criada. Este objeto pode ser passado para a atividade Wait for Form Task and Resume para suspender a execução do fluxo de trabalho até que a ação seja concluída.
  Observação:

  ObjetoDaTarefa tem vários atributos que contêm informações sobre o objeto de ação de saída. Por exemplo, o atributo TaskUrl fornece o URL para a ação dentro da guia Ações no Orchestrator On-Premises, enquanto o atributo ActionUrl fornece o URL para a ação dentro da guia Ações no Automation Cloud. Para acessar a ação a partir do Action Center local, adicione /actions_/tasks/taskID ao URL de base do Action Center, por exemplo: https://laptop-name:port-number/actions_/tasks/taskID.

Clicar no botão Abrir designer de formulário abre o assistente do designer de formulário, que permite personalizar o formulário que você deseja usar em seu fluxo de trabalho.

O botão Abrir designer de formulários em massa fica disponível quando a propriedade Habilitar Edição em Massa é selecionada. Essa opção abre o Designer de formulário em massa, permitindo que você crie ações de formulário que podem ser editadas ou concluídas em massa na guia Ações da instância correspondente do Action Center.

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 esta atividade estiver incluída em Try Catch e o valor da propriedade Continuar com erro for Verdadeiro, nenhum erro será capturado quando o projeto for executado.

• 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

• Habilitar formulários avançados - habilita funcionalidades aprimoradas e opções de personalização para renderização de formulário e lógica, como:

  • Modelos personalizáveis para Editar grades.
  • Botões que funcionam como Eventos.
  • A capacidade de personalizar formulários usando ES6 e JavaScript moderno.
  • A disponibilidade das variáveis instance e options para personalizar formulários.

• Habilitar edição em massa - se selecionado, o botão Abrir criador de formulário em massa fica disponível no corpo da atividade. Esta opção permite gerarações de formulário que podem ser editadas em massa ou concluídas na guia Ações na Action Center.

  

• DadosDoFormulário - Uma coleção de dados de negócios no formulário Dictionary<String,Argument> que você deseja exibir em um formulário dentro da caixa de entrada de Ações. Modificar os argumentos Out e In/Out os mapeia de volta para o fluxo de trabalho após a tarefa ser concluída. Este campo é compatível apenas com objetos Dictionary<String,Argument> .

• GerarCamposDeEntrada - Se estiver selecionado, todas as entradas da coleta de dados do formulário são geradas como componentes no Designer de formulários. Deixá-lo vazio não adiciona campos de formulário adicionais ao designer.

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

• Caminho da pasta do Orchestrator — o caminho para a pasta do Orchestrator que você deseja usar com esta atividade. Se deixado vazio, a pasta atual do Orchestrator será usada. Esse campo é compatível apenas com strings e variáveis String.

  Observação:

  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. Veja mais informações sobre Permissões de pasta.

• Referência — o nome usado como referência para filtragem futura das ações. Este campo suporta apenas valores de string.

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

• PrioridadeDaTarefa — 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.Alta, TaskPriority.Critical.

• TítuloDaTarefa - O título da ação que você deseja criar. Este campo é compatível apenas com strings e variáveis String .

• Usar arquivo de formulário local - Permite a criação de ações de formulário usando um arquivo de formulário JSON, especificado na execução. Este campo suporta apenas valores Boolean . Quando você habilitá-la, o campo de propriedade Caminho do arquivo de formulário aparece no corpo da atividade, onde você especifica o caminho para o arquivo JSON, onde um determinado layout de formulário é armazenado.

Depois de selecionar Use Local Form File, clique em Abrir Form Designer, selecione Novo e comece a criar um formulário. Quando terminar, selecione Salvar como e salve-o dentro da pasta do projeto correspondente. Agora você tem o formulário que criou anteriormente armazenado dentro de um arquivo JSON. Insira o caminho para este arquivo JSON dentro do campo Caminho do arquivo do formulário para usar esse formulário no runtime.

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 FormTaskData após a ação ser criada. Este objeto pode ser passado para a atividade Wait for Form Task and Resume para suspender a execução do fluxo de trabalho até que a ação seja concluída.

Armazenamento

• Nome do Bucket de Armazenamento — o bucket de armazenamento que você deseja usar para arquivos de dados grandes referenciados nos dados do formulário.
• Caminho da pasta de armazenamento — o caminho completo para a pasta no bucket de armazenamento especificado. Este campo é compatível apenas com strings e variáveis String .
  Dica:

  O uso da incorporação de imagens com os Buckets de armazenamento deve ser feito em conjunto com a atividade Upload Storage File . O nome do argumento deve ser sufixado na propriedade FormDataCollection e mapeado para uma imagem no formulário, usando sublinhado (_) em um componente do Elemento HTML . O nome do argumento (<key>_storage) deve ser mapeado para o valor de armazenamento na propriedade Destino da atividade Carregar Arquivo de armazenamento . Observe que os nomes de arquivo de imagem não devem conter mais (+), pois esse caractere é mascarado pelo processo de upload do bucket de armazenamento, resultando em um erro.

Configuração multiplataforma

• TítuloDaTarefa - O título da ação que você deseja criar. Este campo é compatível apenas com strings e variáveis String .
• PrioridadeDaTarefa — 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.Alta, TaskPriority.Critical.
• 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 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".

• DadosDoFormulário - Uma coleção de dados de negócios no formulário Dictionary<String,Argument> que você deseja exibir em um formulário dentro da caixa de entrada de Ações. Modificar os argumentos Out e In/Out os mapeia de volta para o fluxo de trabalho após a tarefa ser concluída. Este campo é compatível apenas com objetos Dictionary<String,Argument> .
• ObjetoDaTarefa(Saída) — o objeto da tarefa que é retornado do Orchestrator como um objeto FormTaskData após a ação ser criada. Este objeto pode ser passado para a atividade Wait for Form Task and Resume para suspender a execução do fluxo de trabalho até que a ação seja concluída.
  Observação:

  ObjetoDaTarefa tem vários atributos que contêm informações sobre o objeto de ação de saída. Por exemplo, o atributo TaskUrl fornece o URL para a ação dentro da guia Ações no Orchestrator On-Premises, enquanto o atributo ActionUrl fornece o URL para a ação dentro da guia Ações no Automation Cloud. Para acessar a ação a partir do Action Center local, adicione /actions_/tasks/taskID ao URL de base do Action Center, por exemplo: https://laptop-name:port-number/actions_/tasks/taskID.

Clicar no botão Abrir designer de formulário abre o assistente do designer de formulário, que permite personalizar o formulário que você deseja usar em seu fluxo de trabalho.

O botão Abrir designer de formulários em massa fica disponível quando a propriedade Habilitar Edição em Massa é selecionada. Essa opção abre o Designer de formulário em massa, permitindo que você crie ações de formulário que podem ser editadas ou concluídas em massa na guia Ações da instância correspondente do Action Center.

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 esta atividade estiver incluída em Try Catch e o valor da propriedade Continuar com erro for Verdadeiro, 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

• Habilitar formulários avançados - habilita funcionalidades aprimoradas e opções de personalização para renderização de formulário e lógica, como:

  • Modelos personalizáveis para Editar grades.
  • Botões que funcionam como Eventos.
  • A capacidade de personalizar formulários usando ES6 e JavaScript moderno.
  • A disponibilidade das variáveis instance e options para personalizar formulários.

• Habilitar edição em massa - se selecionado, o botão Abrir criador de formulário em massa fica disponível no corpo da atividade. Esta opção permite gerarações de formulário que podem ser editadas em massa ou concluídas na guia Ações na Action Center.

  

• Usar arquivo de formulário local - Permite a criação de ações de formulário usando um arquivo de formulário JSON, especificado na execução. Este campo suporta apenas valores Boolean . Quando você habilitá-la, o campo de propriedade Caminho do arquivo de formulário aparece no corpo da atividade, onde você especifica o caminho para o arquivo JSON, onde um determinado layout de formulário é armazenado.

• GerarCamposDeEntrada - Se estiver selecionado, todas as entradas da coleta de dados do formulário são geradas como componentes no Designer de formulários. Deixá-lo vazio não adiciona campos de formulário ao designer.

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

• Caminho da pasta do Orchestrator — o caminho para a pasta do Orchestrator que você deseja usar com esta atividade. Se deixado vazio, a pasta atual do Orchestrator será usada. Esse campo é compatível apenas com strings e variáveis String.

  Observação:

  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. Veja mais informações sobre Permissões de pasta.

• Referência — o nome usado como referência para filtragem futura das ações. Este campo suporta apenas valores de string.

• Caminho do arquivo de formulário - insira o caminho relativo para o arquivo JSON de formulário que você salvou dentro do projeto atual.

Armazenamento

• Nome do Bucket de Armazenamento — o bucket de armazenamento que você deseja usar para arquivos de dados grandes referenciados nos dados do formulário.
• Caminho da pasta de armazenamento — o caminho completo para a pasta no bucket de armazenamento especificado. Este campo é compatível apenas com strings e variáveis String .

Problema conhecido

O Designer de formulários pode não atualizar automaticamente quando uma nova coluna for adicionada aos componentes da grade. Para resolver isso, você pode usar a seguinte solução alternativa:

1. Abra o Designer de formulário.
2. Edite qualquer componente dentro do formulário e, em seguida, salve as alterações.
3. Salve o formulário inteiro.
4. Reabra o formulário, desfaça as alterações anteriores e salve-o novamente. Agora o formulário deve ter sido redefinido e as novas colunas devem estar visíveis.