# Templates e Colunas: Configurações de Extração Reutilizáveis

> Um template é uma lista salva e reutilizável de colunas de extração; esta página explica como o nome de uma coluna e o Format Requirement funcionam, quantos templates uma conta pode armazenar e onde os templates são reutilizados.

Um [**template**](/docs/reference/glossary#template) é uma lista salva e reutilizável das [colunas](/docs/reference/glossary#column) que você quer extrair de um documento. Depois de salvar um, todo [lote](/docs/reference/glossary#batch) futuro pode reutilizá-lo em vez de descrever as mesmas colunas novamente.

## O que é um template

Um template contém a lista de colunas que serão extraídas. Cada coluna vira uma coluna na tabela resultante. O template em si é apenas o contêiner salvo para essa lista, então o mesmo conjunto de colunas pode ser aplicado a lote após lote sem redigitar.

Esta é a diferença entre um template e uma execução única:

- **Template salvo** — um conjunto de colunas nomeado e reutilizável. Ele fica na sua conta e pode ser aplicado a qualquer lote, ou reutilizado pelos outros pontos de entrada listados mais abaixo nesta página.
- **Execução única** — as colunas existem apenas para aquela execução e não são salvas para reutilização. No aplicativo web, isso acontece quando o template selecionado não tem colunas definidas: a IA infere a estrutura da tabela a partir do próprio documento. Pela API, você também pode enviar uma lista de colunas para uma única solicitação, sem criar um template antes.

## Criando, alternando e editando templates

Os templates são gerenciados no painel **Data Columns** do dashboard (modo To Table). O cabeçalho do painel mostra o template selecionado atualmente e três ações:

| Ação | O que faz |
| --- | --- |
| New | Abre o diálogo New Template . Dê um nome ao template e, opcionalmente, baseie-o em um template existente para copiar as colunas desse template. Você também pode navegar pela Preset Library para começar com um conjunto pronto. |
| Switch | Abre o diálogo Switch Template , que lista seus templates. Cada linha oferece Select , Settings , Share e Delete . |
| Settings | Abre o Template Settings do template atual — veja Configurações do template abaixo. |

Para adicionar uma coluna, digite o nome dela na caixa abaixo do título do template e clique em **Add Column**. Se nenhum template estiver selecionado ainda, um será criado automaticamente para você. Para alterar uma coluna, clique no ícone de edição na lista; para removê-la, clique no ícone de exclusão.

## Do que uma coluna é feita

Cada coluna tem exatamente duas partes: seu **column name** e, opcionalmente, um [**Format Requirement**](/docs/reference/glossary#format-requirement). Ambos são enviados juntos quando o documento é processado.

| Parte | O que controla |
| --- | --- |
| Column name | O rótulo da coluna de saída e a instrução para o que encontrar no documento — por exemplo, Invoice Number ou Total Amount . O nome também é o que a IA procura, então ele deve descrever os dados que você deseja. |
| Format Requirement (opcional) | Uma instrução extra para como o valor dessa coluna deve retornar — por exemplo, converter um valor em um número simples, remover um símbolo de moeda ou normalizar uma data para um formato fixo. Aplica-se apenas a esta coluna. Se você deixar vazio, o valor é retornado como aparece no documento. |

Se uma coluna tiver um Format Requirement, um ícone de informação aparece ao lado do nome dela na lista para que você possa ler a instrução sem abrir o diálogo de edição. Uma coluna sem Format Requirement simplesmente extrai o valor diretamente.

A página [Custom Columns](/docs/concepts/custom-columns) explica as diferentes maneiras pelas quais o valor de uma coluna pode ser produzido — lido diretamente do documento, calculado a partir de outros valores ou inferido do contexto.

## Alterando a ordem das colunas

As colunas são extraídas e retornadas na ordem em que aparecem no template. Para alterar essa ordem, arraste uma coluna pela sua alça de arrastar na lista. A nova ordem é salva imediatamente, e a tabela de saída a segue. Isso é útil quando você quer que a planilha resultante comece com uma coluna específica.

## Configurações do template

A caixa de diálogo **Template Settings** (aberta com a ação Settings no painel Data Columns, ou por linha na caixa de diálogo Switch Template) contém configurações que se aplicam a todo o template, em vez de uma única coluna:

- **Global Format Requirement** — uma instrução que se aplica a todas as colunas do template, além do Format Requirement de cada coluna. Use quando a mesma regra de formatação (por exemplo, um estilo de data ou um formato de número) se aplica de forma geral.
- **Merge Multiple Results** — combina várias linhas extraídas em uma. Esse é o mesmo recurso descrito na página [Multi-Page Merge](/docs/concepts/multi-page-merge).

## AI-Suggested Columns

Ao começar a processar um lote Para Tabela cujo template selecionado ainda não tem colunas, e o lote contém pelo menos dois arquivos, o aplicativo web pode propor uma lista de colunas para você. Alguns dos arquivos são amostrados, a IA os lê, e a caixa de diálogo **AI-Suggested Columns** abre com as sugestões.

- Revise os nomes de colunas sugeridos, edite qualquer um deles, adicione os seus próprios ou exclua os que você não quiser.
- Clique em **Apply & Process** para salvar a lista no template e iniciar o processamento.
- Se a sugestão falhar, escolha **Retry** ou **Define manually**.

A sugestão é ignorada quando o template já tem colunas, ou quando o lote tem apenas um arquivo — nesses casos, o processamento começa diretamente.

## Quantos templates você pode ter

Uma conta pode armazenar até **30 templates**. Quando você tenta criar um novo template depois de alcanzar esse limite, o app mostra esta mensagem e o novo template não é criado:

> Você alcanzó el límite de 30 templates. Elimine uno existente primero.

Para liberar um espaço, abra o diálogo **Switch Template** e elimine um template que você não precise mais.

## Onde os templates podem ser reutilizados

Um template não está vinculado a um único lote. O mesmo conjunto de colunas salvo pode ser aplicado a partir de qualquer destes pontos de entrada:

- **Web app** — selecione o template no painel Data Columns e processe qualquer lote com ele.
- **Google Sheets add-on** — a barra lateral usa os mesmos templates salvos, portanto um template criado no site também está disponível lá.
- **API** — passe o identificador do template ao iniciar um lote, em vez de listar colunas na solicitação. Consulte a [referência de API Templates & Fields](/developers/reference/templates-fields) para os detalhes voltados a desenvolvedores.

Os templates também podem ser compartilhados como texto: a ação **Share** no diálogo Switch Template produz um bloco que você pode enviar a outra pessoa, que o cola na caixa de nome de coluna e clica em **Add Column** para importar as colunas e configurações na sua própria conta.

---

Source: https://imagetotable.ai/pt/docs/concepts/templates-and-columns