# Configurando tabelas multivaloradas em um template

**Para criar estruturas de textos que podem ser repetidas, conforme as linhas de uma tabela multivalorada ou campos múltipla escolha do formulário é necessário estar atento às regras abaixo:**

* Os campos de uma tabela multivalorada devem **obrigatoriamente** estar dentro de um mesmo agrupamento exclusivo para a tabela;
* O campo do tipo múltipla escolha deverá **obrigatoriamente** estar dentro de um mesmo agrupamento e exclusivo para o campo em questão;
* As expressões detalhadas nesse artigo devem estar, sempre, dentro de uma célula de uma tabela.

Apesar da última regra acima, isso não significa que você somente consegue representar as repetições em formato tabular. Você pode, por exemplo, criar uma tabela com 1 linha e 1 coluna (e, portanto, uma célula), e sem bordas, e incluir os comandos de repetição, com texto livre pré-formatado. A aparência final será de blocos de textos repetidos.

### Para repetir blocos de textos

1. No Word, crie uma tabela com uma célula e uma coluna, e tire as bordas da tabela;
2. Dentro da célula (agora invisível) da tabela, aperte CTRL+F9, e entre com o seguinte comando:

```
{ MERGEFIELD  TableStart:identificadorAgrupamento  \* MERGEFORMAT}
```

*3. identificadorAgrupamento* refere-se ao título do agrupamento do formulário onde os campos da tabela multivalorada estão agrupados';

4\. Após esse comando, adicione o bloco de texto que você quer repetir, que pode incluir referências a campos dinâmicos ou outras expressões.  

```
{ MERGEFIELD  TableStart:identificadorAgrupamento  \* MERGEFORMAT}
O nome dele é { nome_dependente }  e ele tem {dependente_anos} anos
```

5\. Por fim, ao final do texto, e ainda dentro da célula, conclua com um comando de fechamento, conforme o exemplo abaixo:

```
{ MERGEFIELD  TableStart:identificadorAgrupamento  \* MERGEFORMAT}
O nome dele é { nome_dependente }  e ele tem {dependente_anos} anos
  { MERGEFIELD  TableEnd:identificadorAgrupamento  \* MERGEFORMAT}
```

### Para repetir linhas de uma tabela ou itens de um campo múltipla escolha

O procedimento é muito similar ao do tópico anterior.

1. Você irá criar, a princípio, uma tabela com 2 linhas e "n" colunas, sendo "n" a quantidade de informações que você quer colocar na tabela
2. Na primeira linha, digite os títulos das colunas da sua tabela
3. Formate a tabela, incluindo cores e largura de colunas, como desejar
4. No início da primeira célula da segunda linha, adicione o comando de início de repetição:

```
{ MERGEFIELD  TableStart:identificadorAgrupamento  \* MERGEFORMAT}
```

5\. Em cada célula, adiciono comandos para mostrar as variáveis do formulário: 

```
{identificador_do_campo}
```

6\. No final da última célula da segunda linha, adicione o comando de fechamento da repetição:

```
{ MERGEFIELD  TableEnd:identificadorAgrupamento  \* MERGEFORMAT}
```

Veja um exemplo abaixo:

| Nome                                                                             | Idade                                                                |
| -------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| <p>{ MERGEFIELD TableStart:repeat \*MERGEFORMAT }</p><p>{ nome\_dependente }</p> | { idade\_dependente }{ MERGEFIELD TableEnd:repeat \\\* MERGEFORMAT } |

### Identificador do agrupamento

Conforme visto acima foi utilizado o código TableStart:identificadorAgrupamento onde o Identificador do Agrupamento é o nome do mesmo em formato *Camel Case* e sem caracteres especiais como acentos, cedilha, espaços, barras, etc. Isso é necessário pois toda a estrutura do formulário é convertida para XML e um nome de um grupo contendo espaços ou caracteres especiais seria inválido conforme este padrão. Veja abaixo exemplos de identificadores de agrupamentos no modo Original e no modo *Camel Case*.

| Agrupamento original        | Camel Case              |
| --------------------------- | ----------------------- |
| Dependentes                 | dependentes             |
| Dependentes Locais          | dependentesLocais       |
| Nome do Empregado da Filial | nomeDoEmpregadoDaFilial |
| Advertência ou Suspensão    | advertenciaOuSuspensao  |
| DADOS DO PROPRIETÁRIO       | dadosDoProprietario     |

Visando te ajudar ainda mais na configuração do template, compartilhamos abaixo um modelo DOCX com os marcadores configurados em uma tabela multivalorada:

{% file src="/files/P3GAdiCH7K0ofNQJs3xW" %}

### Demonstração prática

Nos vídeos abaixo você pode conferir uma demonstração prática do recurso:

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

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


---

# 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/geracao-automatica-de-documentos/como-configurar-um-template/configurando-tabelas-multivaloradas-em-um-template.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.