Data de publicação: 02/07/2026
🎯 Objetivo
Orientar como executar a reimportação de leiautes de relatórios no Protheus em cenários de sistema no banco de dados, especialmente quando os leiautes não foram migrados corretamente. (TDN)
🧩 Ambiente
Frameworksp – Configurador | Relatórios.
O material da TOTVS trata do cenário Sistema no Banco de Dados / Reimportação de leiautes de relatórios. (TDN)
🔎 Visão geral
Segundo a TOTVS, alguns clientes tiveram problemas na migração para o sistema no banco de dados porque os leiautes de relatórios não foram migrados. Para esse cenário, foi disponibilizado um programa que força a reimportação do conteúdo do arquivo de leiautes, aproveitando o fato de o conteúdo do arquivo treport.spf ser isolado. (TDN)
Na prática, a rotina permite reconstruir no banco os leiautes existentes no arquivo /profile/treport.spf, desde que o procedimento seja executado corretamente e no ambiente com a lib mínima exigida. (TDN)
⚙️ Como funciona a reimportação
A TOTVS informa que, durante esse processo:
os dados da tabela de leiautes no banco de dados serão excluídos;
os dados existentes no arquivo /profile/treport.spf serão importados para essa tabela;
não é realizado backup dos leiautes anteriores. (TDN)
Por isso, a própria TOTVS recomenda que, em caso de dúvida sobre quais leiautes serão importados, seja feito backup da base antes da execução. (TDN)
🛠️ Passo a passo
1. Validar a lib mínima
A funcionalidade está disponível a partir da lib 20200214. (TDN)
2. Disponibilizar a rotina no menu
Adicione no menu do Configurador a opção:
Reimportação de Leiautes Treport
com o programa:
APCFGLAYTR. (TDN)
A TOTVS também informa que essa opção pode ser usada pelo menu padrão atualizado da release 27, no caminho:
Ambiente / Cadastros / Reimportação de Leiautes TReport. (TDN)
3. Posicionar o arquivo de leiautes
Coloque o arquivo treport.spf que contém os leiautes para reimportação na pasta:
/profile/. (TDN)
4. Executar a rotina
Acesse a opção de reimportação no menu e execute o processamento. O caminho padrão informado pela TOTVS é:
Ambiente / Cadastros / Reimportação de Leiautes TReport. (TDN)
5. Confirmar o processamento
Leia as informações exibidas pela rotina e confirme as perguntas apresentadas para concluir o processamento. (TDN)
6. Validar os relatórios
Após a execução, acesse relatórios conhecidos e verifique se os leiautes foram importados corretamente. (TDN)
⚠️ Pontos de atenção
Esse procedimento exige cuidado porque a rotina apaga os dados atuais da tabela de leiautes e substitui pelo conteúdo do arquivo treport.spf, sem gerar backup automático. (TDN)
Antes de executar, vale validar:
se o arquivo treport.spf realmente contém os leiautes esperados;
se o ambiente já está na lib 20200214 ou superior;
se existe backup da base para retorno, caso necessário. Essa recomendação decorre do comportamento informado pela TOTVS. (TDN)
✅ Resultado esperado
Ao final do processo, os leiautes existentes no arquivo /profile/treport.spf serão reimportados para a tabela correspondente no banco de dados, permitindo recuperar relatórios personalizados que não tenham sido migrados corretamente. (TDN)
💡 Boas práticas
manter uma cópia do arquivo treport.spf antes da execução;
gerar backup da base antes da reimportação;
testar primeiro em homologação, quando possível;
conferir se a opção APCFGLAYTR está corretamente configurada no menu;
validar os principais relatórios logo após o processamento. Essas práticas são compatíveis com o fluxo técnico descrito pela TOTVS. (TDN)
❓ FAQ
1. Em que cenário essa rotina costuma ser usada?
Quando houve migração para o sistema no banco de dados e os leiautes de relatórios não foram migrados corretamente. (TDN)
2. Qual arquivo é usado na reimportação?
O arquivo /profile/treport.spf. (TDN)
3. Qual programa executa a rotina?
O programa APCFGLAYTR. (TDN)
4. A partir de qual lib essa funcionalidade está disponível?
A partir da lib 20200214. (TDN)
5. O sistema faz backup automático dos leiautes antigos?
Não. A TOTVS informa que não é realizado backup dos leiautes anteriores. (TDN)
👤 Autor
Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga
“Conectamos tecnologia, processos e pessoas para acelerar resultados com excelência em sistemas TOTVS.”