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 - 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 only strings and String variables.
  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".

• FormData - A collection of business data in the form Dictionary<String,Argument> that you want to display in a form within the Actions inbox. Modifying Out and In/Out arguments maps them back to the workflow after the task is completed. This field supports Dictionary<String,Argument> objects only.
• 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

• 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

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

  

• FormData - A collection of business data in the form Dictionary<String,Argument> that you want to display in a form within the Actions inbox. Modifying Out and In/Out arguments maps them back to the workflow after the task is completed. This field supports Dictionary<String,Argument> objects only.

• GenerateInputFields - If selected, all the entries from the Form Data Collection are generated as components in the Form Designer. Leaving it empty does not add additional form fields to the 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:

  To allow automatic actions labeling through Persistence activities, the robot account executing the workflow needs View, Create, and Delete permissions on Tags.

• Orchestrator Folder Path - The path to the Orchestrator Folder you want to use with this activity. If left empty, the current Orchestrator folder is used. This field supports only strings and String variables.

  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.

• Reference - The name used as reference for future filtering of the actions. This field supports string values only.

• TaskCatalog - An optional business classification of task items. This field supports only strings and String variables.

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

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

• Use Local Form File - enables the creation of Form Actions using a JSON form file, specified at execution. This field supports Boolean values only. When you enable it, the Form File Path property field appears in the body of the activity, where you specify the path to the JSON file, where a certain form layout is stored.

After you select Use Local Form File, click Open Form Designer, select New, and start building a form. When you finish , select Save As, and save it inside the corresponding project folder. Now you have the form that you previously created stored inside a JSON file. Input the path to this JSON file inside the Form File Path field to use that form at 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

• Storage Bucket Name - The storage bucket you want to use for large data files referenced in the form data.
• Storage Folder Path - The full path to the folder in the specified storage bucket. This field supports strings and String variables only.
  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

• 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 only strings and String variables.
  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".

• FormData - A collection of business data in the form Dictionary<String,Argument> that you want to display in a form within the Actions inbox. Modifying Out and In/Out arguments maps them back to the workflow after the task is completed. This field supports Dictionary<String,Argument> objects only.
• 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

• 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

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

  

• Use Local Form File - enables the creation of Form Actions using a JSON form file, specified at execution. This field supports Boolean values only. When you enable it, the Form File Path property field appears in the body of the activity, where you specify the path to the JSON file, where a certain form layout is stored.

• GenerateInputFields - If selected, all the entries from the Form Data Collection are generated as components in the Form Designer. Leaving it empty does not add form fields to the 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:

  To allow automatic actions labeling through Persistence activities, the robot account executing the workflow needs View, Create, and Delete permissions on Tags.

• Orchestrator Folder Path - The path to the Orchestrator Folder you want to use with this activity. If left empty, the current Orchestrator folder is used. This field supports only strings and String variables.

  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.

• Reference - The name used as reference for future filtering of the actions. This field supports string values only.

• Form File Path - input the relative path to the form JSON file that you saved inside the current project.

Armazenamento

• Storage Bucket Name - The storage bucket you want to use for large data files referenced in the form data.
• Storage Folder Path - The full path to the folder in the specified storage bucket. This field supports strings and String variables only.

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.