Configurazione profilo

Come configurare i profili per definire l'elaborazione dati, la generazione PDF e le regole email.

I profili sono il cuore di PDF Mail Engine. Un profilo crea un insieme ripetibile di regole per leggere i dati, generare PDF e inviare email. È possibile creare più profili per scopi diversi, come "Fatture Mensili", "Biglietti Evento" o "Solleciti di Pagamento".

Configurazione base

Quando si crea o modifica un profilo, la sezione Core Configuration gestisce le impostazioni essenziali per iniziare a generare file.

Impostazione	Descrizione
Profile Name	Assegni un nome univoco al profilo (es. "Invoices_2024"). Questo nome viene usato per organizzare file e log.
Description	Aggiunga una nota privata sullo scopo del profilo. Opzionale, solo per riferimento interno.
Template File	Selezioni il file di regole (`.yaml`) che definisce come vengono generati PDF ed email. Predefinito: `templates/template.yaml`
Master Data File	Selezioni l'elenco clienti o rubrica (CSV o Excel). Predefinito: `data/master_data.csv`
PDF Output Folder	Scelga dove salvare i PDF generati. Predefinito: `outputs`

Organizzazione automatica

Quando si esegue un processo, PDF Mail Engine crea automaticamente una sotto-cartella nella PDF Output Folder con il formato ProfileName_Data_Ora. Non è necessario creare manualmente nuove cartelle per ogni esecuzione.

Configurazione opzionale

Utilizzi queste impostazioni se lavora con file Excel specifici o necessita di compatibilità con ambienti Excel giapponesi.

Selezione foglio Excel

Se i dati sono in un file Excel (.xlsx), è possibile specificare esattamente quale foglio leggere.

Import Sheet Name: Il nome del foglio Excel contenente i dati transazionali (l'elenco degli elementi da elaborare).
Master Sheet Name: Il nome del foglio Excel contenente i dati master dei clienti.

Comportamento predefinito

Se questi campi vengono lasciati vuoti, PDF Mail Engine leggerà automaticamente il primo foglio del file Excel.

Impostazioni di compatibilità

Add BOM Output: Selezioni questa opzione se prevede di aprire i file CSV esportati in Microsoft Excel su Windows. Aggiunge un marcatore speciale (BOM) al file per evitare la visualizzazione errata dei caratteri.

Dettagli tecnici

Questa sezione è destinata agli amministratori di sistema o agli utenti che configurano i profili tramite modifica diretta dei file.

Logica di file e percorsi

Tutti i percorsi dei file nella configurazione sono relativi alla cartella Profile Workspace. Questo consente di copiare o spostare l'intera cartella del profilo su un altro computer senza interrompere i collegamenti.

Campo	Chiave interna	Valore predefinito	Note
Profile Name	`profile_name`	(Obbligatorio)	Max 50 caratteri.
Description	`description`	`null`	Note interne opzionali.
Template File	`pdf_template_path`	`templates/template.yaml`	Formato YAML richiesto.
Master Data	`master_csv_path`	`data/master_data.csv`	Supporta CSV, XLSX, XLS.
PDF Output	`pdf_output_base_dir`	`outputs`	Crea automaticamente sotto-cartelle.
Import Sheet	`import_sheet_name`	`null` (Primo foglio)	Per dati transazionali.
Master Sheet	`master_sheet_name`	`null` (Primo foglio)	Per dati master.
Root Path	`profile_root_path`	(Auto-generato)	Opzionale. Sovrascrive la directory dati predefinita per questo profilo.
BOM Output	`csv_export_with_bom`	`false`	Impostare `true` per compatibilità Excel/Shift-JIS.