Como configurar formulário

Em uma tarefa humana, para cada campo do formulário, você irá informar se ele é visível, editável e/ou manipulável nessa tarefa em específico.

Visão geral

Os formulários são alguns dos principais elementos dentro de um aplicativo de processo. Apesar de nem todos os aplicativos possuírem formulários (ex.: um aplicativo de documentos), a maioria utiliza este recurso como método de estruturação das informações digitadas pelos solicitantes e participantes do processo. Assim, na maior parte das vezes, você irá criar um formulário associado a um aplicativo de processo.

Cada aplicativo de processo pode possuir somente um formulário. Mas, não se preocupe! Dentro das configurações de tarefas humanas, você irá definir quais campos ou grupo de campos do formulário serão visíveis e quais serão editáveis. Ou seja, no Zeev, você irá construir um grande formulário que inclui todas as informações necessárias para seu aplicativo rodar. E esse formulário poderá ser quebrado em múltiplas visões, ao longo das tarefas

Como configurar

Dentro das configurações de uma tarefa humana, você terá acesso a uma tabela com todos os campos e grupos do formulário do aplicativo. Se não existir nenhum campo ainda, quer dizer que você ainda não criou o formulário.

Para cada campo ou grupo de campos do formulário, você irá informar, por padrão, se ele é visível e/ou editável, nessa tarefa em específico.

Ao clicar no botão da engrenagem, você também determinará se esse campo é programável e se seus identificadores serão exibidos ou ocultados. Ao habilitar as opções os itens são exibidos e ao desabilitar são ocultados.

Visível

Ao informar que o campo ou o grupo de campos é visível, você está informando que, nesta tarefa, o responsável poderá ver o valor do campo. Esse valor poderá estar em branco ou virá preenchido com algum valor preenchido em uma etapa anterior do processo.

Editável

Ao informar que o campo é editável, você está informando que o campo está habilitado para ter seu valor modificado pelo responsável pela tarefa. Caso o campo já tenha sido preenchido antes, ele já virá pré-preenchido.

Se o campo é editável, ele será obrigatoriamente visível e também manipulável.

Ser editável não significa que ele é obrigatório, ou seja, não significa que é obrigatório preenchê-lo. A obrigatoriedade ou não do campo será definida:

  • No cadastro do campo, se ele foi configurado como obrigatório;

  • No botão de ação que finaliza a tarefa, se o botão foi configurado para validar a obrigatoriedade do preenchimento do formulário ou não;

Programável

Ao informar que o campo é programável, você está informando que o valor do campo pode ser modificado via customizações usando javascript. Essa é uma opção avançada, e se você não é um programador, não se preocupe com isso.

Localizar campos

Para facilitar a localização dos campos, temos um seletor com busca textual. Ao se deparar com um processo com muitos campos de formulário pode ser importante buscar o campo por seu título.

Identificadores dos campos

Ao escolher exibir os identificadores do campo, esta informação será exibida em um botão e um ícone de "copiar" também será exibido. Ao clicar sobre o identificador de algum campo do formulário, o identificador é copiado para a área de transferência.

Definir o valor padrão

É possível definir o valor padrão do campo em uma tarefa, ou seja, preenchê-lo previamente com um valor fixo ou dinâmico. Esse valor irá sobrepor qualquer outro valor que tenha sido antes preenchido em outra tarefa.

Para isso, clique no botão disponível junto a configuração do campo na configuração do formulário na atividade humana.

Na tela que será aberta, digite um valor fixo ou um valor dinâmico (usando tokens), ou uma combinação de ambos. Alguns exemplos:

  • {Requester.Name} irá preencher o campo do formulário com o nome do solicitante;

  • {Instance.Id} irá preencher o campo do formulário com o ID da solicitação;

  • {Form.data} irá preencher o campo do formulário com o valor de outro campo do formulário cujo identificador é "data";

  • Insumos tecnológicos irá preencher o campo do formulário com o valor fixo "Insumos tecnológicos";

Ao invés de digitar os tokens, você pode selecioná-los em uma lista apresentada ao clicar nas chaves { } ao lado do campo.

Dica: esse recurso apresenta limitações se você está no evento de início. Algumas variáveis ainda não foram inicializadas no evento de início e os tokens poderão estar em branco. Veja mais detalhes como usar uma tarefa de regra de negócio após o evento de início para resolver isso.

Atualizado