# 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>

## 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>" %}


---

# 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/como-criar-tabelas-multivaloradas.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.
