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} é substituído pelo valor real que você mapeou no workflow.
Exemplo
Um template com: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
Usando Templates em Workflows
- Adicione um nó Generate Document ao seu workflow
- Faça upload do seu template
.docx - O Tela extrai automaticamente todos os placeholders do template
- Mapeie cada placeholder para uma variável do workflow ou saída de um passo anterior
- Defina o nome do arquivo de saída
- 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.