Generatore Documenti da Excel

Istruzioni per usare la webapp, organizzare i file e gestire i profili.

Avvio Consigliato

Per usare caricamento automatico di template, configurazioni e profili, avvia la webapp tramite server locale.

Fai doppio click su AvviaGeneratoreDocumenti.bat.
Il browser aprira automaticamente http://127.0.0.1:8765/GeneratoreDocumenti.html.
Lascia aperta la finestra del server mentre usi l'app.

Se apri document-generator.html con doppio click come file locale, i pulsanti basati su percorsi predefiniti e la sezione Profili non sono disponibili.

Struttura Cartelle

Cartella	Cosa contiene	Esempi
`dati/`	File Excel usati come sorgente dati. Ogni riga dell'Excel diventa una voce da cui generare un documento.	`dati/dipendenti.xlsx` `dati/clienti.xlsx` `dati/pratiche.xlsx`
`templates/`	Template dei documenti. I DOCX usano segnaposti tra graffe, i PDF devono contenere campi compilabili.	`templates/template_lettera.docx` `templates/template_modulo.pdf`
`configurazioni/`	File JSON con mappature e profili predefiniti. I profili possono caricare automaticamente Excel, template e mappature.	`configurazioni/config-mappatura.json` `configurazioni/config-mappatura_pdf.json` `configurazioni/profili.json`
`documenti_generati/`	Cartella suggerita per conservare i documenti prodotti. La webapp puo salvare anche in una cartella scelta al momento.	`documenti_generati/modulo_Mario.docx` `documenti_generati/modulo_Mario.pdf`

Uso Base

Carica il file Excel.
Scegli il tipo di template: DOCX o PDF.
Carica il template manualmente oppure, se sei su server locale, usa il template predefinito.
Carica una configurazione oppure mappa manualmente ogni segnaposto/campo con una colonna Excel.
Seleziona una o piu voci dalla lista.
Controlla l'anteprima. La visualizzazione rispecchia solo in parte il risultato finale.
Clicca Genera Documenti.

Template DOCX

Nel file Word inserisci i segnaposti usando le graffe. Il nome dentro le graffe verra mostrato nella mappatura.

{Nome}
{Cognome}
{Email}
{Data Assunzione}

La webapp sostituira ogni segnaposto con il valore della colonna Excel scelta.

Template PDF

Il PDF deve avere campi compilabili. Il nome del campo PDF deve essere mappato con una colonna Excel.

Esempio: campo PDF Nome collegato alla colonna Excel Nome.

Configurazioni

Una configurazione salva il tipo di template e la mappatura tra segnaposti/campi e colonne Excel.

{
  "version": "1.0",
  "file_type": "docx",
  "template_name": "template_lettera.docx",
  "template_path": "templates/template_lettera.docx",
  "config_path": "configurazioni/config-mappatura.json",
  "mappings": {
    "Nome": "Nome",
    "Cognome": "Cognome",
    "Email": "Email"
  }
}

Il pulsante Carica configurazione predefinita legge automaticamente il JSON corretto dalla cartella configurazioni/, ma solo quando la pagina e aperta da server locale.

Profili

I profili sono disponibili solo quando la webapp e aperta da server locale. Un profilo puo caricare automaticamente:

file Excel da dati/;
template da templates/;
tipo documento;
mappature.

{
  "id": "lettera-docx-demo",
  "name": "Lettera DOCX demo",
  "file_type": "docx",
  "excel_path": "dati/dipendenti.xlsx",
  "template_path": "templates/template_lettera.docx",
  "mappings": {
    "Nome": "Nome",
    "Cognome": "Cognome"
  }
}

Azioni disponibili

Carica profilo: carica Excel, template e mappature del profilo selezionato.
Salva come profilo: crea un nuovo profilo dalla configurazione corrente.
Aggiorna: sostituisce il profilo selezionato con la configurazione corrente.
Elimina: rimuove il profilo selezionato.

Con il server statico il browser non puo modificare direttamente configurazioni/profili.json. Le azioni Salva, Aggiorna ed Elimina scaricano un nuovo profili.json: sostituiscilo manualmente nella cartella configurazioni/.

Avvio Manuale del Server

Se non vuoi usare il file BAT, puoi avviare il server da PowerShell:

cd "C:\Users\User\Documents\ProgettiGoogleCLI\CompilatoreDocumenti"
python -m http.server 8765 --bind 127.0.0.1

Poi apri:

http://127.0.0.1:8765/document-generator.html