- Notas de Versão
- Antes de começar
- Introdução
- Atividades
- Projetando fluxos de trabalho de longa duração
- Start Job And Get Reference
- Wait for Job and Resume
- Add Queue Item And Get Reference
- Wait For Queue Item And Resume
- Create Form Task
- Wait for Form Task and Resume
- Resume After Delay
- Assign Tasks
- Create External Task
- Wait For External Task and Resume
- Complete Task
- Forward Task
- Get Form Tasks
- Get Task Data
- Add Task Comment
- Update Task Labels
- Ações
- Processos
- Notificações
Create Form Task
UiPath.Persistence.Activities.FormTask.CreateFormTask
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.
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 argumentosOut
eIn/Out
os mapeia de volta ao fluxo de trabalho após a conclusão da tarefa. Este campo suporta apenas objetosDictionary<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 .
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.
- 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
eoptions
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 argumentosOut
eIn/Out
os mapeia de volta ao fluxo de trabalho após a conclusão da tarefa. Este campo suporta apenas objetosDictionary<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.
- 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.
- 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.
- 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 argumentosOut
eIn/Out
os mapeia de volta ao fluxo de trabalho após a conclusão da tarefa. Este campo suporta apenas objetosDictionary<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 .
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.
- 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
eoptions
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.
- 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.
- 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
.
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:
- Abra o Designer de formulário.
- Edite qualquer componente dentro do formulário e, em seguida, salve as alterações.
- Salve o formulário inteiro.
- 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.