> For the complete documentation index, see [llms.txt](https://kb.stoque.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.stoque.com.br/zeev/como-construir-processos/como-criar-formularios/como-criar-tabelas-multivaloradas.md).

# Como criar tabelas multivaloradas

## Visão geral

Uma tabela multivalorada é uma estrutura organizada em linhas e colunas, criada para armazenar e exibir múltiplos dados. Cada linha na tabela representa um registro (dado), enquanto as colunas representam o tipo de registro que deve ser preenchido.

Imagine que você está realizando um pedido de compra, e cada item que você deseja comprar é registrado em uma linha da tabela. Para adicionar um novo item ao seu pedido, você simplesmente insere uma nova linha à tabela. Cada coluna na linha corresponde a um detalhe específico do item, como nome, quantidade, preço unitário, etc.

| Item    | Quantidade | Preço Unitário |
| ------- | ---------- | -------------- |
| Camisa  | 2          | R$ 50,00       |
| Sapatos | 1          | R$ 120,00      |
| Laptop  | 1          | R$ 2.000,00    |

Utilizando uma tabela, você tem uma visão clara de todos os itens do seu pedido em um único lugar. Isso facilita a organização e visualização das informações, além de permitir a rápida adição ou remoção de itens conforme necessário.

## Regras e limitações de uma tabela

* Ela é um elemento de interface do construtor de formulários e possui um comportamento semelhante a um grupo. Sendo assim, não é possível adicionar campos soltos após uma multivalorada, é necessário criar um grupo abaixo dela e depois inserir os campos nesse grupo;
* A limitação de colunas da tabela está atrelado ao plano Zeev:
  * BUSINESS: Suporta no máximo 16 campos;
  * PRO e ADVANCED: Suporta no máximo 36 campos;
* Não suporta campos do tipo radio, checkbox, nps e arquivo visualizador.

<figure><img src="/files/kCmM8vAQ5oLKHsGd1w1W" alt=""><figcaption><p>Exemplo de criação de uma tabela</p></figcaption></figure>

{% hint style="info" %}
Se a tabela multivalorada tiver pelo menos um campo definido como editável na tarefa do processo, os botões "Inserir" e "Excluir" da tabela estarão habilitados para toda a tabela.
{% endhint %}

## Como criar uma tabela no construtor de formulários

Para criar uma tabela multivalorada no construtor, basta clicar em elementos de interface, arrastar o elemento tabela multivalorada para a tela do formulário e, após isso, arrastar e soltar os campos que devem compor a tabela, um ao lado do outro. Após renomear os campos, sua tabela multivalorada estará pronta.

1. Clicar em elementos de interface;
2. Arrastar o elemento tabela multivalorada para a tela do formulário;
3. Arrastar e soltar os campos que devem compor a tabela, um ao lado do outro;
4. Renomear os campos

## Demonstração prática

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

## Como criar tabela multivalorada no antigo construtor de formulários

Para criar uma tabela multivalorada no antigo construtor de formulários basta:

1. Alterar o "Visual" do formulário para "Editor";
2. Acessar a aba "Editor";
3. Clicar no icone de tabela no editor de texto rico;
4. Inserir uma tabela com no mínimo 2 linhas, uma para o cabeçalho e outra pra os valores;
5. Marcar o o check box "Tabela multivalorada";
6. Salvar o componente de tabela;
7. Inserir tokens dos campos de formulário em cada uma das colunas da tabela.
8. Salvar a visualização do modo editor.

## Demonstração prática

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