Tutoriais em vídeo
O vídeo está em inglês (narração e legendas).
Um template é uma lista salva e reutilizável das colunas que você deseja extrair de um documento. Depois de salvar um, cada lote 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 se torna uma coluna na tabela resultante. O template em si é apenas o contêiner salvo para essa lista, para que o mesmo conjunto de colunas possa ser aplicado a lote após lote sem redigitá-lo.
Esta é a diferença entre um template e uma execução única:
- Template salvo — um conjunto de colunas nomeado e reutilizável. Ele permanece na sua conta e pode ser alternado em qualquer lote, ou reutilizado através dos outros pontos de entrada listados mais abaixo nesta página.
- Execução única — as colunas existem apenas para aquela execução única 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. Através da API, você também pode passar uma lista de colunas para apenas uma solicitação, sem criar um template primeiro.
Criando, alternando e editando modelos
Os modelos são gerenciados no painel Data Columns no painel de controle (modo To Table). O cabeçalho do painel mostra o modelo selecionado atualmente e três ações:
| Ação | O que faz |
|---|---|
| New | Abre a caixa de diálogo New Template. Dê um nome ao modelo e, opcionalmente, baseie-o em um modelo existente para copiar as colunas desse modelo. Você também pode navegar pela Preset Library para começar com um conjunto pronto. |
| Switch | Abre a caixa de diálogo Switch Template, que lista seus modelos. Cada linha oferece Select, Settings, Share e Delete. |
| Settings | Abre o Template Settings para o modelo atual — consulte Configurações do modelo abaixo. |
Para adicionar uma coluna, digite o nome na caixa abaixo do título do modelo e clique em Add Column. Se nenhum modelo 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: o nome da coluna e, opcionalmente, um 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 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 o 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ções aparece ao lado do nome na lista para que você possa ler a instrução sem abrir a caixa de diálogo de edição. Uma coluna sem Format Requirement simplesmente extrai o valor diretamente.
A página de 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 modelo. Para alterar essa ordem, arraste uma coluna pela sua alça de arraste 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 modelo
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 ao modelo inteiro, em vez de a uma única coluna:
- Global Format Requirement — uma instrução que se aplica a todas as colunas do modelo, além do Format Requirement de cada coluna. Use-a 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 só. Esse é o mesmo recurso descrito na página Multi-Page Merge.
AI-Suggested Columns
Quando você começa a processar um lote Para Tabela cujo modelo 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 suas 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 modelo e começar o processamento.
- Se a sugestão falhar, escolha Retry ou Define manually.
A sugestão é ignorada quando o modelo já tem colunas, ou quando o lote tem apenas um arquivo — nesses casos, o processamento começa diretamente.
Quantos modelos você pode ter
Uma conta pode armazenar até 30 templates. Quando você tenta criar um novo template após atingir esse limite, o aplicativo mostra esta mensagem e o novo template não é criado:
Você atingiu o limite de 30 templates. Exclua um existente primeiro.
Para liberar um espaço, abra o diálogo Switch Template e exclua um template que você não precisa 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 um 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, então 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 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 para outra pessoa, que o cola na caixa de nome de coluna e clica em Add Column para importar as colunas e configurações para a própria conta dela.