Export documenti

Dove si trova: indirizzo /config/export — voce di menu Configurazione → Export documenti.

A cosa serve

Configura, per ogni tipo documento, il file che gli operatori possono scaricare da un documento validato: il formato (Excel, CSV o JSON) e quali campi esportare, con quali etichette (che diventano i nomi delle colonne o le chiavi nel file). Se per un tipo non configuri alcun campo, l'export include tutti i campi presenti nel documento.

Cosa vedi

• In alto: la tendina Tipo documento e i pulsanti Salva, Esporta config (scarica la configurazione del tipo come file), Carica config (importa una configurazione da file) ed Elimina config.
• Un testo introduttivo che riassume il funzionamento.
• Dopo aver scelto un tipo, tre riquadri:
  • le opzioni generali: l'interruttore Export abilitato per ("Se disattivato, il download è bloccato anche a documento validato") e la tendina Formato in uscita (Excel (.xlsx), CSV, JSON);
  • Campi intestazione: i campi di testata del documento da esportare;
  • Campi riga (items): i campi delle righe del documento da esportare.

Ogni riquadro campi ha i pulsanti Aggiungi campo, Aggiungi statico (solo intestazione) e Aggiungi tutti dallo schema, più una tabella con le colonne:

• Ordine: frecce su/giù per riordinare (l'ordine visivo è l'ordine nel file);
• Statico: interruttore per i campi a valore costante;
• Campo documento / Valore: per i campi normali, la tendina dei campi previsti dallo schema del tipo documento (con ricerca); per i campi statici, il valore costante da scrivere sempre (es. "ANC");
• Tipo: Testo, Numero o Data — indica la natura del valore in uscita (rilevante soprattutto per il formato JSON);
• Etichetta nel file: il nome della colonna (Excel/CSV) o della chiave (JSON); se vuota viene usato il nome del campo;
• il cestino per eliminare la riga.

Cosa puoi fare

Configurare l'export di un tipo documento

1. Scegli il Tipo documento dalla tendina.
2. Attiva o disattiva l'export e scegli il formato.
3. Componi l'elenco dei campi intestazione e dei campi riga:
   • Aggiungi campo: aggiunge una riga vuota; scegli il campo dalla tendina (sono proposti solo i campi dello schema del tipo documento).
   • Aggiungi statico (solo intestazione): aggiunge un campo a valore costante, uguale per tutti i documenti (es. un codice società richiesto dal gestionale).
   • Aggiungi tutti dallo schema: inserisce in un colpo solo tutti i campi previsti dallo schema non ancora presenti.
   • Riordina con le frecce, imposta tipo ed etichetta, elimina col cestino.
4. Clicca Salva. Le righe incomplete vengono scartate automaticamente (un campo normale senza nome, o uno statico senza etichetta).

Scaricare e ricaricare una configurazione

• Esporta config scarica la configurazione del tipo corrente come file, riusabile e condivisibile.
• Carica config importa un file di configurazione e lo applica al tipo selezionato: controlla il risultato e premi Salva per renderlo effettivo (la notifica ricorda "Controlla e premi Salva"). Il file viene sempre agganciato al tipo in editing, così il salvataggio sovrascrive la configurazione di quel tipo.

Eliminare una configurazione

Elimina config (attivo solo se per il tipo esiste una configurazione salvata) chiede conferma e rimuove la configurazione: per quel tipo si torna al comportamento predefinito (tutti i campi, formato Excel).

Buono a sapersi

Il download è disponibile solo a documento validato

L'export si scarica dalla pagina del documento e funziona solo per i documenti validati. Se l'interruttore di abilitazione è spento, il download resta bloccato anche a documento validato.

Nessun campo configurato = tutti i campi

Un riquadro campi vuoto non significa "niente in export": significa che verranno inclusi tutti i campi presenti nel documento. Configura i campi solo quando vuoi controllare esattamente colonne, ordine ed etichette.

Solo campi previsti dallo schema

La tendina dei campi propone esclusivamente i campi dello schema del tipo documento: non si possono digitare nomi liberi. Un campo salvato in passato ma non più a schema resta comunque visibile nella tendina della sua riga.