JK6 - Per chi amministra

JK6.1 - Importare i modelli legacy

In una frase. I modelli di stampa del gestionale storico si portano in GPEnext tutti insieme, dall'elenco dei modelli, senza ridisegnarli.

Anni di documenti già impaginati non si buttano. L'importazione li trasforma in modelli di GPEnext: da quel momento si aprono nel designer e si ritoccano come gli altri.

Attenzione. L'importazione funziona solo se sul server c'è la cartella con i dati del vecchio programma delle stampe. Se manca, la finestra lo dice e non elenca niente: va chiesto a chi gestisce il server.

  1. Apri l'importazione. Nella pagina Modelli di stampa premi Strumenti e scegli Import MDL. Si apre la finestra «Import massivo da GPE» e parte da sola la ricerca nella cartella del server.

  2. Guarda cosa ha trovato. Per ogni modello vedi nome, descrizione e quali file ha accanto: il modello, lo schema dei dati, un esempio di dati. Una colonna dice se è già stato importato.

  3. Scegli e avvia. Spunta i modelli che vuoi, o tutti insieme con la casella in alto. Avvia e aspetta la fine senza chiudere la finestra.

  4. Leggi il riepilogo. Dice quanti modelli sono entrati, quanti sono stati saltati e quali hanno un avviso. Un avviso vuol dire che una parte del vecchio modello non è stata convertita: apri il modello nel designer e controllala.

  5. Controlla un documento importante. Genera l'anteprima e confrontala con la stampa di sempre, prima di metterlo in uso.

Se un modello c'è già

Importare di nuovo un modello già presente non lo sovrascrive. Con la spunta su «Aggiorna già importati» il modello riceve una bozza: la versione in uso resta attiva finché non pubblichi. Vedi Pubblicare.

Nota. Serve il livello Utente avanzato. Una schermata della finestra non è ancora in questa raccolta.

Per chi sviluppa.
• La cartella si indica al servizio con la variabile GPE_DATA_ROOT; nell'installazione con i container è la cartella dell'host GPE_DATA_DIR, montata in sola lettura.
• I vecchi modelli sono file .mdl, con accanto lo schema .xsd e un file di esempio .xml.
• Passi di installazione: devops/deploy/README.md, paragrafo 3.7.

Per approfondire.
• Import MDL e file XSL-FO per l'ERP: docs/guide/gpe-next/staff/10-import-mdl.md

JK6.2 - Il catalogo dei modelli base

In una frase. I modelli base sono i modelli standard, uguali per tutte le installazioni: arrivano in un pacchetto che GPEnext carica da solo all'avvio.

Chi installa ADSWnext non deve ridisegnare fatture e bolle. Trova i modelli standard già pronti, e quando ne esce una versione nuova la riceve senza perdere le proprie modifiche.

Attenzione. Sul server di prova il catalogo non è ancora caricato: il meccanismo c'è, il pacchetto è da mettere al suo posto.

Come funziona

  1. Chi mantiene i modelli standard li pubblica e ne esporta il catalogo: un solo file, con un numero di versione.

  2. Il file si mette in una cartella del server, quella indicata nell'installazione.

  3. All'avvio GPEnext lo legge. Se il contenuto è diverso dall'ultimo caricato, aggiorna i modelli base. Se è lo stesso, non fa niente.

  4. Le personalizzazioni restano. Chi ha una copia personalizzata di un modello base la tiene. Sulla copia compare l'avviso che c'è un aggiornamento disponibile, oppure obbligatorio.

Cosa c'è dentro

Il pacchetto porta i modelli base pubblicati (mai le bozze), le loro versioni, gli schemi dei dati, i file di esempio e le immagini che i modelli usano.

Cosa controllare

Per chi sviluppa.
• Il file si chiama catalogo-gpe.json.gz e sta nella cartella indicata da GPE_CATALOGO_DIR.
• Il controllo è un'impronta del contenuto: all'avvio viene ricalcolata e confrontata con quella dichiarata.
• Stato: GET /api/gpe/catalogo/stato. Esportazione, solo per lo staff: POST /api/gpe/catalogo/esporta.
• Codice: nel servizio backend/middleware/it_gsba_gpe_next, pacchetto «catalogo».

Per approfondire.
• Catalogo dei modelli base di GPE-NEXT: docs/gpe-next/CATALOGO.md

JK6.3 - Se qualcosa non va

In una frase. I problemi più comuni con le stampe, come «vedo questo, faccio questo», e le parole da sapere.

Quasi sempre il gestionale dice già cosa non va: il pulsante grigio ha un suggerimento, l'avviso ha un motivo. Qui trovi cosa fare dopo averlo letto.

Quando stampi

Nel designer

Loghi e ditte

Per chi amministra

Parole da sapere

Per chi sviluppa. Per una stampa da SBHweb che non riesce: Opzioni › Strumenti › Trace del protocollo e filtra le righe della stampa. Dicono documento, stato e codice di ogni tentativo. Installazione e variabili: devops/deploy/README.md, paragrafo 3.7.