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

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

  Importante: 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 falhará 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".
• FormData - Uma coleção de dados de negócios no formulário Dictionary<String,Argument> que você deseja exibir em um formulário na caixa de entrada Actions. A modificação dos argumentos Out e In/Out os mapeia de volta ao fluxo de trabalho após a conclusão da tarefa. Este campo suporta apenas objetos Dictionary<String,Argument> .
• ObjetoDaTarefa(Saída) — o objeto da tarefa que é retornado do Orchestrator como um objeto FormTaskData após a criação das Actions . Esse objeto pode ser passado para a atividade Wait for Form Task and Resume para suspender a execução do fluxo de trabalho até a conclusão das Actions .

Observação: TaskObject 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 Actions no Orchestrator On-Premises, enquanto o atributo ActionUrl fornece o URL para a ação dentro da guia Actions no Automation Cloud. Para acessar a ação do Action Center no local, adicione /actions_/tasks/taskID à URL 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 essa atividade estiver incluída na atividade Try Catch e o valor da propriedade ContinuarComErro for True, nenhum erro será capturado quando o projeto for executado.

• 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

• Habilitar formulários avançados — habilita recursos aprimorados e opções de personalização para a renderização de formulários e lógica, como:
  • Modelos personalizáveis para Editar grades.
  • Botões funcionando 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.
  
  

  

  
  
• FormData - Uma coleção de dados de negócios no formulário Dictionary<String,Argument> que você deseja exibir em um formulário na caixa de entrada Actions. A modificação dos argumentos Out e In/Out os mapeia de volta ao fluxo de trabalho após a conclusão da tarefa. Este campo suporta apenas objetos Dictionary<String,Argument> .
• GenerateInputFields - Se selecionado, todas as entradas da Coleta de Dados de Formulário são geradas como componentes no Designer de Formulário. 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 cadeia de caracteres e possui 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.

• Caminho da pasta do Orchestrator - O caminho para a pasta do Orchestrator que você deseja usar com essa atividade. Se for deixado em branco, será usada a pasta atual do Orchestrator. Esse campo é compatível apenas com strings e variáveis String.

Observação: se o usuário que executa esta ação não tiver as permissões necessárias para a pasta de destino, a criação da tarefa falha e gera 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.

• 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 de ações exista antes da criação da ação. Caso contrário, a criação da ação falhará 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".
• 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 .
• Use Local Form File - permite a criação de Form Actions usando um arquivo de formulário JSON, especificado na execução. Este campo suporta apenas valores Boolean . Ao habilitá-lo, o campo de propriedade Form File Path 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 Open Form Designer, selecione Newe comece a criar um formulário. Ao terminar, selecione Salvar comoe salve-o dentro da pasta do projeto correspondente. Agora você tem o formulário que criou anteriormente armazenado em um arquivo JSON. Insira o caminho para este arquivo JSON dentro do campo Form File Path para usar esse formulário em tempo de execução.

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 criação das Actions . Esse objeto pode ser passado para a atividade Wait for Form Task and Resume para suspender a execução do fluxo de trabalho até a conclusão das Actions .

Armazenamento

• Storage Bucket Name - O depósito de armazenamento que você deseja usar para grandes arquivos de dados referenciados nos dados do formulário.
• Caminho da pasta de armazenamento - o caminho completo para a pasta no depósito de armazenamento especificado. Este campo suporta apenas 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 Carregar arquivo de armazenamento . O nome do argumento deve ser sufixado na propriedade ColeçãoDeDadosDoFormulário e mapeado para uma imagem no formulário, usando o sublinhado (_) em um componente de Elemento HTML .

  O nome do argumento (<key>_storage) deve ser mapeado para o valor de armazenamento na propriedade Destination da atividade Upload Storage File .

  Observe que os nomes dos arquivos de imagem não devem conter mais (+), pois esse caractere é mascarado pelo processo de upload do depósito de armazenamento, resultando em um erro.

Configuração multiplataforma

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

  Importante: 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 falhará 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".
• FormData - Uma coleção de dados de negócios no formulário Dictionary<String,Argument> que você deseja exibir em um formulário na caixa de entrada Actions. A modificação dos argumentos Out e In/Out os mapeia de volta ao fluxo de trabalho após a conclusão da tarefa. Este campo suporta apenas objetos Dictionary<String,Argument> .
• ObjetoDaTarefa(Saída) — o objeto da tarefa que é retornado do Orchestrator como um objeto FormTaskData após a criação das Actions . Esse objeto pode ser passado para a atividade Wait for Form Task and Resume para suspender a execução do fluxo de trabalho até a conclusão das Actions .

Observação: TaskObject 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 Actions no Orchestrator On-Premises, enquanto o atributo ActionUrl fornece o URL para a ação dentro da guia Actions no Automation Cloud. Para acessar a ação do Action Center no local, adicione /actions_/tasks/taskID à URL 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 essa atividade estiver incluída na atividade Try Catch e o valor da propriedade ContinuarComErro for True, 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 recursos aprimorados e opções de personalização para a renderização de formulários e lógica, como:
  • Modelos personalizáveis para Editar grades.
  • Botões funcionando 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 gerar ações de formulário que podem ser editadas em massa ou concluídas na guia Ações na Action Center.
  
  

  

  
  
• Use Local Form File - permite a criação de Form Actions usando um arquivo de formulário JSON, especificado na execução. Este campo suporta apenas valores Boolean . Ao habilitá-lo, o campo de propriedade Form File Path aparece no corpo da atividade, onde você especifica o caminho para o arquivo JSON, onde um determinado layout de formulário é armazenado.
• GenerateInputFields - Se selecionado, todas as entradas da Coleta de Dados de Formulário são geradas como componentes no Designer de Formulário. 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 cadeia de caracteres e possui 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.

• Caminho da pasta do Orchestrator - O caminho para a pasta do Orchestrator que você deseja usar com essa atividade. Se for deixado em branco, será usada a pasta atual do Orchestrator. Esse campo é compatível apenas com strings e variáveis String.

Observação: se o usuário que executa esta ação não tiver as permissões necessárias para a pasta de destino, a criação da tarefa falha e gera 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.
• Form File Path - insira o caminho relativo para o arquivo JSON de formulário que você salvou dentro do projeto atual.

Armazenamento

• Storage Bucket Name - O depósito de armazenamento que você deseja usar para grandes arquivos de dados referenciados nos dados do formulário.
• Caminho da pasta de armazenamento - o caminho completo para a pasta no depósito de armazenamento especificado. Este campo suporta apenas 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.