# Como criar formulários

### 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 processo 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, pois, dentro das configurações de [tarefas humanas](/zeev/como-construir-processos/como-desenhar-processos/o-que-sao-atividades/como-configurar-atividades-humanas.md), você irá definir quais 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 processo rodar.  E esse formulário poderá ser quebrado em múltiplas visões, ao longo das tarefas.

Porém, os valores de campos do formulário também podem ser preenchidos automaticamente, através de outros elementos do desenho do processo:

* As [tarefas de regras de negócio](/zeev/como-construir-processos/como-desenhar-processos/o-que-sao-atividades/o-que-e-atividade-de-regra-de-negocio.md#modificar-o-valor-de-um-campo-de-formulario-a-partir-da-execucao-de-uma-regra-de-negocio) podem executar [regras de negócio](/zeev/outras-configuracoes-avancadas/o-que-sao-regras-de-negocio.md) cujo valor de retorno são armazenados em campos do formulário;
* As [tarefas de serviço](/zeev/como-construir-processos/como-desenhar-processos/o-que-sao-atividades/tarefa-de-servico.md#consultar-dados-de-um-sistema-externo) podem executar [integrações](/zeev/integracoes/como-criar-integracoes.md) cujos retornos são armazenados em campos do formulário.

O construtor de formulário do Zeev foi criado para entregar uma experiência melhor ao construir formulários de maneira dinâmica e produtiva.

As principais funcionalidades que melhoram essa experiência, são:

* *Drag and drop* / Arrastar e soltar todos os elementos do construtor;
* Automação de campos;&#x20;
* Exclusão de campos em aplicativos publicados;
* Configuração de campos diretamente na interface ou em suas propriedades;
* Além de um melhor layout e navegabilidade.

## Componentes do construtor

A barra de componentes do construtor possui duas abas:

### Campos

Essa aba possui a lista de campos disponíveis. Os principais se encontram no início da lista, e os demais estão ordenados alfabeticamente.&#x20;

Os campos sempre representam uma caixa de informação que deverá ser preenchida ou selecionada pelo usuário final. Isso dará sentido a solicitação enviada no aplicativo, possibilitando análises, tomada de decisão e o acompanhamento do histórico nos relatórios, além de gerar indicadores.

### Elementos de interface

Essa aba contém os elementos que podem compor a estrutura do formulário. Os elementos são utilizados para organizar o formulário e incluir textos, links, etc.&#x20;

Os elementos disponíveis são:

1. **Grupo**: utilizado para organizar os campos em agrupamentos (Ex: Dados da compra, Dados do endereço);
2. **Tabela multivalorada**: utilizada para organizar os campos na horizontal, e possui o funcionamento parecido com uma tabela do Excel, onde você pode inserir mais linhas conforme a quantidade de itens (Ex: Tabela de orçamentos, Tabela de compras);
3. **Componentes para inserção de textos**:
   1. **H1** (Título): utilizado para inserir títulos no formulário;
   2. **H2** (Subtítulo): utilizado para inserir subtítulos no formulário;
   3. **H3** (Subtítulo 2): utilizado para inserir subtítulos no formulário;
   4. **Texto rico**: utilizado para inserir textos no formulário. Esse elemento possui um editor de texto amigável, possibilitando a estilização do texto de maneira simples (Negrito, itálico, sublinhado, centralização e organização em listas). Para realizar outras customizações, como alterar cores, utilize o "[Editor de Estilos](/zeev/customizacoes/customizacoes-de-formulario.md#editor-de-estilos)" do formulário;
4. **Link**: utilizado para disponibilizar um link do formulário. O usuário final poderá visualizá-lo na tarefa em que o elemento estiver habilitado e acessar o link.&#x20;
5. **Componente externo:** utilizado para incorporar no formulário do Zeev uma página/conteúdo externo. Para mais informações, acesse o item [Como utilizar o elemento "Componente externo"](/zeev/como-construir-processos/como-criar-formularios/como-utilizar-o-elemento-componente-externo.md).

<div data-full-width="false"><figure><img src="/files/uClDnoMcikvqgC4uCM0M" alt=""><figcaption></figcaption></figure></div>

#### **Substituição de campos**

Caso você utilize um campo de determinado tipo, porém, em determinada altura da construção ou utilização do processo, perceba a necessidade de substituí-lo por outro tipo, basta você selecionar no menu "Tipo de campo".

<div data-full-width="false"><figure><img src="/files/2iTyYzf89EYLUzyvVVo4" alt=""><figcaption></figcaption></figure></div>

### Recomendação de limite de campos do formulário

Para uma melhor performance e uso eficiente do Zeev, recomendamos que os formulários criados ou importados contenham, no máximo, **150 campos**. Essa orientação é válida para qualquer cenário de uso de formulários, seja durante a importação de um processo ou na construção de um formulário durante a modelagem.

É importante ressaltar que essa recomendação é uma boa prática para a utilização da ferramenta. Não há, no entanto, **nenhuma restrição técnica** que impeça a criação de formulários com mais de 150 campos.

{% hint style="warning" %}
Caso opte por configurar um formulário com mais de 150 campos, esteja ciente de que essa escolha pode aumentar o risco de problemas, como: **diminuição de performance, lentidão na execução do formulário e dificuldades na renderização dos campos durante as operações.**
{% endhint %}

{% hint style="danger" %}
Vale destacar que a quantidade máxima de campos recomendados estende-se a campos utilizados em tabelas multivaloradas.\
Por exemplo: Caso a tabela multivalorada possua 5 colunas (5 campos) e seja inserida 50 linhas, o total de campos contabilizados será a soma destes campos.&#x20;Ou seja: "Quantidade de Campos" vezes a "Quantidade de Linhas" (5 x 50 = 250), resultando em total de 250 campos.
{% endhint %}

## Demonstração prática do construtor de formulários

Confira no vídeo a seguir a demonstração de como criar formulários no construtor oficial do Zeev.

{% embed url="<https://www.youtube.com/watch?v=qr2fZfFIJXM>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.stoque.com.br/zeev/como-construir-processos/como-criar-formularios.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
