Scheda Dati

Guida di riferimento per la gestione di mappature, calcoli e sorgenti dati nel Template Designer.

La scheda Data (Dati) nel Template Designer è dove si definisce la logica del documento. Connette il design visuale alle sorgenti dati effettive (Excel/CSV) e gestisce la logica aziendale come calcoli e raggruppamento.

Panoramica delle sezioni

La scheda Dati è organizzata nelle seguenti sezioni:

  1. Mappings (Mappature): Connette le colonne del file dati alle variabili del modello.
  2. Calculations (Calcoli): Crea nuove variabili tramite formule.
  3. Grouping (Raggruppamento) (obbligatorio): Definisce come le righe vengono suddivise in documenti PDF separati.
  4. Data Linking (Collegamento dati): Unisce i dati transazionali con i dati master (stile VLOOKUP).
  5. Output Configuration (Configurazione output): Imposta la convenzione di denominazione dei file PDF generati.
  6. Data Sources (Sorgenti dati): Carica dati di esempio per anteprima e mappatura.

1. Mappature

Le mappature consentono al modello di "leggere" i valori dalle colonne del file sorgente.

  • Source Data (dati transazionali) (icona ricevuta): Rappresenta i dati principali (es. fatture, righe di vendita). Questi dati variano tipicamente per ogni riga.
  • Master Data (dati master) (icona persona): Rappresenta i dati di riferimento (es. elenco clienti, catalogo prodotti). Questi dati sono spesso statici o collegati tramite un ID.

Quando si carica una sorgente dati (veda Sorgenti dati sotto), le mappature vengono spesso create automaticamente. È possibile anche aggiungerle manualmente.

2. Calcoli

I calcoli consentono di creare nuove variabili derivate dai dati esistenti. Li utilizzi per calcolare importi, IVA o combinare campi di testo.

Esempio: Per calcolare un prezzo totale da UnitPrice e Quantity:

  • Name: TotalAmount
  • Formula: {{UnitPrice}} * {{Quantity}}

Una volta creata, {{TotalAmount}} diventa disponibile come variabile nel design.

Aggregazione (Sum)

Per i totali a livello di gruppo, è possibile utilizzare il tipo sum anziché una formula. Questo somma automaticamente un campo su tutte le righe del gruppo:

  • Type: sum
  • Field: La variabile da sommare (es. TotalAmount)

Utile per calcolare subtotali, totali generali o altri valori aggregati dalle voci di dettaglio.

Arrotondamento

I calcoli supportano un'opzione Rounding per controllare l'arrotondamento dei risultati numerici:

  • floor: Arrotonda per difetto (es. 10,9 → 10)
  • ceil: Arrotonda per eccesso (es. 10,1 → 11)
  • round: Arrotondamento standard (es. 10,5 → 11)

Particolarmente utile per i calcoli dell'IVA e la formattazione valutaria.

3. Raggruppamento

Questa impostazione è obbligatoria. Il Group Key determina come vengono elaborate le righe multiple.

  • Modalità riga singola: Se ogni riga dei dati rappresenta un documento unico, selezioni una colonna ID univoca (es. InvoiceID).
  • Modalità multi-riga: Se i dati contengono più righe per un singolo documento (es. una fattura con 5 voci), selezioni la colonna che identifica il documento (es. InvoiceID). Il motore raggrupperà queste 5 righe in un unico PDF.

4. Collegamento dati

Utilizzi questa sezione per unire i dati master ai dati transazionali, in modo simile a un VLOOKUP in Excel.

  • Match Value (Import Data): La colonna nei dati transazionali che funge da "chiave esterna" (es. CustomerID).
  • Lookup Key (Master Data): La colonna ID univoca nei dati master (es. CustomerID).

Perché utilizzarlo? Se i dati transazionali contengono solo CustomerID "C001", ma si vuole stampare l'indirizzo completo del cliente sulla fattura, colleghi i dati master. Il sistema recupererà automaticamente l'indirizzo associato a "C001".

5. Configurazione output

  • PDF Naming Rule: Definisce il nome del file PDF generato.
  • Predefinito: {{InvoiceNo}}.pdf

È possibile utilizzare variabili per creare nomi file dinamici, come Invoice_{{InvoiceNo}}_{{Date}}.pdf.

6. Sorgenti dati

Questa sezione aiuta a verificare le mappature e l'anteprima della connessione. La mappatura manuale è possibile, ma caricare i file dati effettivi riduce significativamente gli errori.

Formati supportati

  • File CSV (.csv)
  • File Excel (.xlsx, .xls)

Come utilizzare

  1. Clicchi Load Source Data o Load Master Data.
  2. Selezioni il file dal selettore file.
  3. Apparirà un dialogo Data Preview.
  4. Verifichi i dati e clicchi Load. Il sistema proporrà automaticamente le mappature per tutte le colonne trovate nel file.