Configuração de perfil

Como configurar perfis para definir o processamento de dados, geração de PDF e regras de e-mail.

Perfis são o coração do PDF Mail Engine. Um Perfil cria um conjunto reutilizável de regras para ler seus dados, gerar PDFs e enviar e-mails. Você pode criar múltiplos perfis para diferentes finalidades, como "Faturas Mensais", "Ingressos de Evento" ou "Lembretes de Pagamento".

Configuração principal

Ao criar ou editar um perfil, a seção Core Configuration gerencia as configurações essenciais para começar a gerar arquivos.

Configuração	Descrição
Profile Name	Dê ao perfil um nome único (ex.: "Invoices_2024"). Este nome é usado para organizar arquivos e logs.
Description	Adicione uma nota privada sobre a finalidade deste perfil. É opcional e apenas para sua referência.
Template File	Selecione o arquivo de regras (`.yaml`) que define como o PDF e o e-mail são gerados. Padrão: `templates/template.yaml`
Master Data File	Selecione sua lista de clientes ou catálogo de endereços (CSV ou Excel). Padrão: `data/master_data.csv`
PDF Output Folder	Escolha onde os PDFs gerados devem ser salvos. Padrão: `outputs`

Organização automática

Ao executar um trabalho, o PDF Mail Engine cria automaticamente uma subpasta dentro da PDF Output Folder com o formato ProfileName_Date_Time. Você não precisa criar pastas manualmente a cada execução.

Configuração opcional

Use estas configurações se estiver trabalhando com arquivos Excel específicos ou precisar garantir compatibilidade com ambientes Excel japoneses.

Seleção de planilha Excel

Se seus dados estão em um arquivo Excel (.xlsx), você pode especificar exatamente qual planilha ler.

Import Sheet Name: O nome da planilha Excel contendo seus dados de transação (a lista de itens a processar).
Master Sheet Name: O nome da planilha Excel contendo seus dados mestre de clientes.

Comportamento padrão

Se você deixar esses campos vazios, o PDF Mail Engine lerá automaticamente a primeira planilha do seu arquivo Excel.

Configurações de compatibilidade

Add BOM Output: Marque esta opção se planeja abrir arquivos CSV exportados no Microsoft Excel no Windows. Isso adiciona um marcador especial (BOM) ao arquivo para evitar que caracteres japoneses apareçam como texto ilegível (Mojibake).

Detalhes técnicos

Esta seção é para administradores de sistema ou usuários que configuram perfis por edição direta de arquivos.

Lógica de arquivos e caminhos

Todos os caminhos de arquivo na configuração são relativos à pasta do Workspace do Perfil. Isso permite copiar ou mover a pasta inteira do perfil para outro computador sem quebrar os links.

Campo	Chave interna	Valor padrão	Notas
Profile Name	`profile_name`	(Obrigatório)	Máximo 50 caracteres.
Description	`description`	`null`	Notas internas opcionais.
Template File	`pdf_template_path`	`templates/template.yaml`	Requer formato YAML.
Master Data	`master_csv_path`	`data/master_data.csv`	Suporta CSV, XLSX, XLS.
PDF Output	`pdf_output_base_dir`	`outputs`	Cria subpastas automaticamente.
Import Sheet	`import_sheet_name`	`null` (Primeira planilha)	Para dados de transação.
Master Sheet	`master_sheet_name`	`null` (Primeira planilha)	Para dados mestre.
Root Path	`profile_root_path`	(Gerado automaticamente)	Opcional. Substitui o diretório de dados padrão deste perfil.
BOM Output	`csv_export_with_bom`	`false`	Defina `true` para compatibilidade com Excel/Shift-JIS.