Skip to main content

​
Visão Geral

O Document Templater do Tela permite gerar documentos a partir de templates .docx, substituindo placeholders por valores dinâmicos do seu workflow. Você cria o template uma vez e o Tela preenche os dados toda vez que o workflow é executado.

​
Como Funcionam os Placeholders

Placeholders são marcadores dentro do seu template .docx que indicam ao Tela onde inserir valores. Eles usam chaves com o nome do placeholder: 
{nome_do_placeholder}
Quando o documento é gerado, cada {nome_do_placeholder} é substituído pelo valor real que você mapeou no workflow.

​
Exemplo

Um template com: 
Prezado(a) {nome_cliente},

Seu número de fatura é {numero_fatura}, com um total de {valor_total}.

Atenciosamente,
{nome_empresa}
Produzirá: 
Prezado(a) João Silva,

Seu número de fatura é FAT-2026-001, com um total de R$ 1.500,00.

Atenciosamente,
Acme Corp

​
Criando um Template

1

Crie um arquivo .docx

Abra o Microsoft Word, Google Docs (exporte como .docx) ou qualquer editor que suporte o formato .docx.
2

Escreva o conteúdo

Escreva o conteúdo do documento normalmente — formatação, tabelas, cabeçalhos, imagens e estilos são preservados.
3

Adicione placeholders

Onde você deseja valores dinâmicos, digite o nome do placeholder entre chaves: {nome_do_placeholder}.Use nomes descritivos como {nome_cliente}, {data_contrato} ou {valor_total}.
4

Salve como .docx

Salve o arquivo no formato .docx. Outros formatos (.doc, .pdf, .odt) não são suportados.

​
Regras para Placeholders

RegraExemploObservação
Use chaves{nome}Apenas chaves simples
Sem espaços dentro das chaves{nome_cliente}Use underscores no lugar de espaços
Sensível a maiúsculas{Nome} e {nome} são placeholders diferentesSeja consistente
Pode repetirUse {empresa} várias vezesO mesmo valor é inserido em todos os lugares
Funciona em tabelasColoque {valor} dentro de célulasA formatação é preservada

​
Usando Templates em Workflows

  1. Adicione um nó Generate Document ao seu workflow
  2. Faça upload do seu template .docx
  3. O Tela extrai automaticamente todos os placeholders do template
  4. Mapeie cada placeholder para uma variável do workflow ou saída de um passo anterior
  5. Defina o nome do arquivo de saída
  6. Execute o workflow — o documento gerado fica disponível como saída

​
Dicas

Mantenha os placeholders simples

Use nomes curtos e descritivos. Evite caracteres especiais além de underscores.

Teste com dados de exemplo

Antes de usar em produção, execute o workflow com valores de teste para verificar a formatação.

Preserve a formatação

Placeholders herdam a formatação (negrito, itálico, tamanho da fonte) do texto ao redor.

Use tabelas para dados estruturados

Coloque placeholders dentro de células de tabelas para faturas, relatórios ou formulários.