JK - GPEnext
Disegnare i modelli dei documenti e produrre i PDF.
Cosa ci guadagni. Un documento si ridisegna da soli, senza toccare il programma, e da ogni tabella nasce un PDF impaginato.
- JK1 - A cosa serve
- JK2 - Stampare
- JK2.1 - Da una tabella: PDF ed Excel
- JK2.2 - Da SBHweb con l'uscita GPE_NEXT_PDF
- JK2.3 - Se manca il modello
- JK2.4 - Modificare il modello dal PDF
- JK3 - Il designer
- JK3.1 - L'elenco dei modelli
- JK3.2 - Il foglio: testi, tabelle, immagini
- JK3.3 - Proprietà e formati
- JK3.4 - Anteprima
- JK3.5 - Scorciatoie
- JK4 - Modelli nuovi
- JK5 - Ditte e loghi
- JK6 - Per chi amministra
JK1 - A cosa serve
JK1.1 - Modello più dati uguale documento
In una frase. GPEnext è il servizio delle stampe: prende i dati, li mette dentro un modello e ti dà un PDF impaginato.
Un documento stampato è fatto di due cose. I dati cambiano ogni volta: le righe di un ordine, gli importi, le date. Il modello resta: dice dove va il logo, come è fatta la tabella, dove stanno i totali.
Nel gestionale di sempre le due cose erano legate dentro il programma. Per spostare una colonna serviva un programmatore. Con GPEnext sono separate: il programma manda solo i dati, l'aspetto sta nel modello e il modello lo cambi tu, con il mouse.
Il meccanismo: i dati arrivano dal gestionale, l'aspetto dal modello, logo e nome dalla ditta
GPEnext ha due parti. Il designer è la pagina dove si disegnano i modelli. Il servizio delle stampe unisce modello e dati e produce il PDF.
Cosa ci guadagni.
• Un documento si ridisegna da soli. Sposti una colonna, cambi un titolo, aggiungi un totale: lo fai nel designer e la stampa dopo esce già cambiata. Il programma non si tocca.
• Da ogni tabella nasce un PDF impaginato, in pochi clic. Scegli le colonne, dai un nome e il modello esce già fatto: intestazione con logo, tabella con totali, piè di pagina.
• Gli stessi modelli per l'ERP nuovo e per l'ERP legacy/COBOL. Le pagine nuove e le pagine storiche stampano con lo stesso servizio. I loghi delle ditte si caricano in un posto solo.
Qui sotto un documento nato da una schermata con una testata e due tabelle. Nessuno l'ha impaginato a mano: è il modello di partenza, così come esce.
Un documento nato da una schermata: logo, scheda della testata, due tabelle con i totali, piè di pagina. Documento di prova con dati finti
Per chi sviluppa. Il servizio è backend/middleware/it_gsba_gpe_next, il designer è frontend/gpe-next/src. Le pagine chiamano la stampa attraverso il contratto in frontend/core/src/stampa. Il PDF lo produce direttamente il servizio delle stampe.
JK1.2 - Dove sta nella mappa
In una frase. GPEnext è uno dei servizi di ADSWnext: sta dietro il Gateway e ha un archivio tutto suo per i modelli.
Sapere dove sta aiuta a capire due cose: perché per stampare basta il tuo accesso di sempre, e dove finiscono i modelli che disegni.
La mappa di ADSWnext con accesi GPEnext (Stampe) e il suo archivio, Modelli di stampa
Chi lo chiama. Le pagine nuove di SIGEAnext, quando da una tabella premi il pulsante della stampa. Le pagine storiche di SBHweb, quando stampi in PDF una funzione dell'ERP legacy/COBOL. In tutti e due i casi la richiesta passa dal Gateway, come ogni altra.
Chi chiama lui. Solo il suo archivio, Modelli di stampa: lì stanno i modelli, le loro versioni, le ditte e i loghi. GPEnext non va a leggere i dati aziendali: i dati del documento glieli manda chi chiede la stampa.
Cosa vuol dire per te. Non c'è un secondo accesso e non ci sono password fra un servizio e l'altro: vale chi sei tu e il livello che hai. Se GPEnext è spento, il resto del gestionale lavora lo stesso: i pulsanti della stampa diventano grigi e dicono perché.
Per chi sviluppa.
• Il Gateway manda a GPEnext tutte le richieste che cominciano per /api/gpe.
• L'archivio sul server di prova si chiama GPENEXT2. Le tabelle le crea il servizio al primo avvio.
• Il designer si apre dentro l'applicazione, all'indirizzo /gpe.
• Installazione: devops/deploy/README.md, paragrafo 3.7.
JK2 - Stampare
JK2.1 - Da una tabella: PDF ed Excel
In una frase. Ogni tabella del gestionale si esporta in Excel o si stampa in PDF dalla stessa finestra, «Esporta e stampa».
Non devi chiedere un report a nessuno. Quello che vedi nella tabella diventa un file o un documento impaginato, con le colonne che scegli tu.
Apri la finestra. Nella barra della tabella premi
GPE-NEXT, oppure uno dei pulsanti CSV, Excel, PDF in fondo alla barra. Si apre sempre la stessa finestra, con il formato già scelto.I pulsanti dell'analisi e della stampa nella barra della tabella e nella barra in alto della pagina
Scegli formato, titolo e colonne. Spunta le colonne che vuoi e trascinale per cambiare l'ordine. In Righe scegli tutte, solo le filtrate o solo le selezionate.
La finestra «Esporta e stampa» con il formato Excel e quattro colonne scelte su undici. Pagina di prova con dati finti
Per un file, premi Esporta. Excel, CSV e PDF semplice si scaricano subito. Il PDF semplice è un elenco senza impaginazione.
Per un documento impaginato, scegli
GPE-NEXT. La finestra mostra i Modelli per questi dati: quelli già creati per questa schermata. Scegline uno e premi Stampa. Il PDF si apre in un'altra scheda.Il formato della stampa con GPEnext: i modelli già pronti per questi dati e, sotto, il nome di un modello nuovo
Se il modello non c'è ancora, crealo da qui. Scrivi un nome in Nuovo modello e premi Crea e apri il designer. Come nasce lo trovi in Da una griglia.
Nota. Per stampare con un modello basta il livello Lettore. Per creare o modificare un modello serve il livello Utente base. Se il pulsante è grigio, la finestra dice perché.
Attenzione. La stampa usa le righe che la tabella ha caricato, fino a 20.000. I documenti del gestionale storico si stampano dal gestionale, non da qui.
Per chi sviluppa. La finestra è la stessa per le tabelle di SIGEAnext, per quelle disegnate con ADEnext e per le griglie di SBHweb. Il contratto è in frontend/core/src/stampa.
Per approfondire.
• Esportare e stampare da una griglia: docs/guide/tabella/esporta-e-stampa/README.md
• Creare un documento dai tuoi dati: docs/guide/gpe-next/cliente/13-documenti-dai-tuoi-dati.md
• Stampare con i tuoi dati: docs/guide/gpe-next/cliente/14-stampa-con-i-tuoi-dati.md
JK2.2 - Da SBHweb con l'uscita GPE_NEXT_PDF
In una frase. Una stampa dell'ERP legacy/COBOL esce come PDF impaginato da GPEnext, se all'avvio scegli l'uscita GPE_NEXT_PDF.
Il programma storico continua a fare il suo lavoro: prepara i dati. L'impaginazione la fa GPEnext, con un modello che si può ridisegnare. Così anche le stampe di sempre prendono un aspetto curato, senza riscrivere il programma.
Attenzione. Il PDF nasce solo se il server manda a SBHweb i dati della stampa, non la stampa già impaginata. Dipende da come sono configurate le stampanti sul server. Se non li manda, vedi la stampa com'era sempre e, sopra, una riga che dice «PDF con GPE-NEXT non fatto» e perché: è da chiedere a chi gestisce il server.
Una stampa storica con sopra la riga «PDF con GPE-NEXT non fatto»: il server l'ha mandata già impaginata. Nomi coperti, logo finto
Scegli l'uscita. Apri la funzione dal menu di SBHweb. Nel pannello di avvio, al punto 3 Uscita, premi
GPE_NEXT_PDF, poi Avvia. La scelta vale solo per questo lancio: la volta dopo va rifatta. Lo stesso vale per ANALISI.Il punto 3 del pannello di avvio con l'uscita GPE_NEXT_PDF scelta
Lancia la stampa come sempre. Dentro la funzione usi gli stessi pulsanti di prima.
La funzione dei mezzi flotta con i due pulsanti dei report
Il PDF si apre a video. In basso compare un messaggio di attesa, poi il documento. Sopra il PDF una riga dice con quale modello è stato fatto. Da lì lo stampi, lo scarichi o lo affianchi alle maschere.
Il PDF nel visualizzatore di SBHweb, con la riga che nomina il modello usato
Dietro le quinte succede questo.
Chi parla con chi quando stampi in PDF da SBHweb
L'uscita GPE_NEXT_PDF c'è su ogni voce del menu, anche dove un modello non esiste ancora: vedi Se manca il modello. È grigia solo se GPEnext non risponde o se il tuo livello non permette di stampare.
Per chi sviluppa.
• I dati della stampa partono dal browser e arrivano a GPEnext passando dal Gateway, con l'accesso dell'utente. Non ci sono segreti fra servizi e il Ponte col COBOL non conosce GPEnext.
• Il modello si cerca per nome della stampa: prima il nome esatto con la sequenza, poi quello senza.
• Il codice della sessione è in frontend/sbh-web/src/session.
Per approfondire.
• Stampare in PDF con GPE-NEXT dalla sessione SBH: docs/guide/moduli/sbh-stampa-gpe-next/README.md
• Stampare dal gestionale: docs/guide/gpe-next/cliente/10-stampare-dal-gestionale.md
JK2.3 - Se manca il modello
In una frase. Se per una stampa di SBHweb non c'è ancora un modello, non perdi niente: resta la stampa com'è arrivata e puoi creare il modello in quel momento.
La prima volta che una stampa passa da GPEnext il suo modello può non esistere. Il gestionale te lo dice e ti dà la strada per farlo nascere dai dati veri di quella stampa.
Leggi il messaggio. A video resta la stampa grezza e un avviso dice che per quel documento non c'è ancora un modello. Nell'avviso c'è il nome del documento.
La stampa dei mezzi della flotta senza modello: l'avviso con Crea il modello in
GPE-NEXTe Riprova, sotto i dati della stampaPremi
Crea il modello in GPE-NEXT. Il pulsante c'è se hai il livello Utente avanzato. Si apre il designer in un'altra scheda, con un modello di partenza fatto dai dati di questa stampa. Il modello prende il nome esatto della stampa: così le volte dopo viene trovato da solo. In testa al documento va il titolo della stampa.Il modello nato dalla stampa dei mezzi: in testa i dati della testata, sotto una scheda per ogni mezzo. Dati veri del server di prova, nomi e targhe coperti
Le etichette dei campi sono quelle che leggi nella schermata da cui hai lanciato la stampa: «Targa», «KM Iniz», «Scad.Bollo».
Se la stampa ha pochi campi per riga, il modello è una tabella. Se ne ha troppi per stare in un foglio orizzontale, come i mezzi della flotta con i loro 39 campi, ogni riga diventa una scheda con i campi su tre colonne, su un A4 in piedi.
Sistema il modello e premi Pubblica. Finché non è pubblicato, la stampa non lo usa.
La finestra che si apre con «Pubblica» nel designer
Torna a SBHweb e premi Riprova. L'avviso sparisce e si apre il PDF.
Il PDF fatto con quel modello, prima di ogni ritocco. Dati veri del server di prova, nomi e targhe coperti
Se non puoi creare modelli, il messaggio ti dice di chiedere a chi gestisce le stampe. Con Mostra XML vedi comunque i dati della stampa.
Quando i modelli sono più d'uno
Il gestionale dà a ogni stampa un nome e un numero di sequenza. Se non c'è il modello con quel numero ma ce ne sono per altre sequenze dello stesso documento, si apre una finestra con l'elenco: scegli quale usare. Con Ricorda la scelta per questa stampa non te lo chiede più. Per cambiare idea usa Cambia modello, sopra il PDF.
Nota. La scelta ricordata resta nel browser. Su un altro computer si rifà.
Attenzione. Le etichette del modello di partenza sono i titoli che leggi nella schermata da cui è partita la stampa: le intestazioni delle colonne della griglia (per esempio «KM Iniz») e le etichette dei campi in testa. Valgono solo dove il campo della stampa ha lo stesso nome di quella colonna o di quel campo. Gli altri campi tengono un'etichetta fatta dal nome tecnico (per esempio «Resd menn»): si cambiano nel designer, una volta sola. Una stampa riaperta dall'archivio non porta i titoli della schermata.
Per chi sviluppa. L'ordine di ricerca è: nome esatto (programma e sequenza), nome senza sequenza, scelta fra le varianti, nessun modello. Per chiedere aiuto: in SBHweb Opzioni › Strumenti › Trace del protocollo, filtrando le righe della stampa.
Per approfondire.
• Stampare in PDF con GPE-NEXT dalla sessione SBH: docs/guide/moduli/sbh-stampa-gpe-next/README.md
JK2.4 - Modificare il modello dal PDF
In una frase. Guardi il PDF, vedi una cosa da cambiare, apri il modello da lì, lo correggi e rigeneri il documento.
È il giro più corto fra «questa colonna è stretta» e il documento giusto. Non devi cercare il modello nell'elenco: il PDF sa con quale modello è stato fatto.
Premi Modifica il modello. In SBHweb il pulsante è sopra il PDF, accanto alla riga che nomina il modello. Nella finestra «Esporta e stampa» compare dopo la stampa, accanto all'esito. Il modello si apre nel designer, in un'altra scheda. Il PDF resta dov'è.
Il PDF della stampa dei mezzi in SBHweb: sopra, il modello usato con «Modifica il modello» e «Rigenera». Dati veri del server di prova, nomi e targhe coperti
Cambia il modello. Nel designer fai la modifica e salva. Se il modello è di quelli che si pubblicano, premi anche Pubblica: vedi Pubblicare.
Torna indietro e premi Rigenera. Il PDF si rifà con gli stessi dati e il modello cambiato.
La finestra «Esporta e stampa» dopo la stampa: «Modifica il modello» accanto all'esito e «Rigenera» al posto di «Stampa». Pagina di prova con dati finti
I due pulsanti ci sono solo per chi ha il livello Utente base o più. Chi ha il livello Lettore stampa e basta.
Se il modello è uno di quelli standard
Con il livello Utente base un modello standard non si cambia: è uguale per tutti. Il pulsante diventa Personalizza il modello e ne fa una copia tua. Messa in uso la copia, Rigenera stampa con quella.
Nota. In SBHweb usato da solo, fuori dall'applicazione completa, sopra il PDF c'è solo il nome del modello: i pulsanti non ci sono.
Per chi sviluppa. «Rigenera» rimanda a GPEnext gli stessi dati della prima stampa, senza rilanciare la funzione COBOL. Il visualizzatore è in frontend/sbh-web/src/session/components/sbh-doc-viewer.
Per approfondire.
• Stampare in PDF con GPE-NEXT dalla sessione SBH: docs/guide/moduli/sbh-stampa-gpe-next/README.md
• Ritoccare una stampa prima di stamparla: docs/guide/gpe-next/cliente/07-ritoccare-una-stampa.md
JK3 - Il designer
JK3.1 - L'elenco dei modelli
In una frase. La pagina Modelli di stampa è il punto di partenza del designer: qui trovi un modello, lo apri, lo duplichi o ne crei uno nuovo.
Tutti i modelli dell'installazione stanno in un elenco solo: quelli nati dalle tue tabelle, quelli delle stampe del gestionale storico, quelli standard. Con la ricerca arrivi a quello giusto in pochi secondi, anche quando sono centinaia.
Apri Modelli di stampa. Accanto al titolo leggi quanti modelli e quanti documenti ci sono. Ogni scheda è un documento, cioè un tipo di stampa, con i suoi modelli.
Modelli di stampa: una scheda per documento, con la ricerca in alto
Cerca. Scrivi nella casella Cerca per nome, descrizione o documento. L'elenco si restringe mentre scrivi e il conteggio accanto al titolo segue la ricerca.
Apri un modello. Gestisci su una scheda mostra i modelli di quel documento. Se preferisci una riga per modello, premi Tabella in alto a destra: il doppio clic sulla riga apre il designer.
L'elenco a tabella dopo la ricerca «mezzi»: nome, descrizione, documento e azioni
Usa le azioni della riga. La matita apre il modello, i due fogli lo duplicano, il cestino lo elimina.
Crea o importa. Nuovo modello parte da zero. Strumenti raccoglie i lavori di gruppo, come l'importazione dei modelli del gestionale storico: vedi Importare i modelli legacy.
Nota. L'elenco completo lo vede chi ha il livello Utente avanzato. Con il livello Utente base arrivi ai tuoi modelli dalla finestra «Esporta e stampa» o dal PDF.
Per chi sviluppa. La pagina è all'indirizzo /gpe/templates. Il codice è in frontend/gpe-next/src/studio/templates.
Per approfondire.
• Il designer di GPE-NEXT: elenco dei modelli e foglio: docs/guide/gpe-next/designer/README.md
• Orientarsi nella lista dei modelli: docs/guide/gpe-next/staff/01-orientamento.md
JK3.2 - Il foglio: testi, tabelle, immagini
In una frase. Nel designer il modello è un foglio: ci trascini sopra i campi dei dati e ci metti testi, tabelle e immagini, vedendo subito come verrà.
Lavori sul documento com'è, non su un elenco di istruzioni. Quello che vedi sul foglio è quello che uscirà in stampa, con dati di esempio al posto di quelli veri.
Le tre zone
A sinistra ci sono i Dati: i campi del documento, da trascinare sul foglio. Al centro c'è il foglio, diviso in Testa, Corpo e Piede: testa e piede si ripetono su ogni pagina, il corpo scorre con i dati. A destra ci sono le Proprietà di ciò che hai scelto.
Il designer con un modello aperto: i dati a sinistra, il foglio al centro, le proprietà a destra
Cosa dice un campo
Nei Dati ogni campo ha il suo nome e, accanto, l'etichetta. Fermati col mouse su un campo: si apre una finestrella con quello che si sa di lui. In alto l'etichetta. Sotto la descrizione, se c'è, il nome del campo e il tipo (testo, numero, data).
Per i campi che vengono da una griglia l'etichetta è il titolo della colonna e la descrizione è il suggerimento che la colonna mostra al passaggio del mouse. Così sai da quale colonna arriva il campo prima di trascinarlo sul foglio.
Il mouse fermo su un campo dei Dati: la finestrella con etichetta, nome del campo e tipo
Cosa puoi mettere sul foglio
Sopra il foglio c'è la riga Aggiungi elemento.
- Testo. Una scritta fissa, un campo dei dati, o tutti e due insieme.
- Tabella. Una riga di intestazione, una riga che si ripete per ogni riga dei dati, una riga di totali. Le colonne si allargano e si stringono con il mouse.
- Immagine. Un'immagine fissa oppure il logo della ditta: vedi Loghi nelle stampe.
- Barcode e Grafico. Un codice a barre da un campo, un grafico dai dati di una tabella.
Scegliere e cambiare
Clicca un elemento: il pannello Proprietà dice in alto cosa hai scelto (Testo, Tabella, Cella) e la barra sopra il foglio mostra i suoi comandi. Su una cella trovi Filtra, Totale, + Riga, + Colonna, l'allineamento e lo stile.
Una cella di tabella scelta: sopra il foglio i comandi della cella, a destra le sue proprietà
Salva in alto a destra salva il modello. Se sbagli, annulli con Ctrl+Z.
Cosa ci guadagni. Aggiungere il totale di una colonna è un clic su Totale. Nel gestionale storico era una modifica al programma.
Per chi sviluppa. Fra gli elementi c'è anche XSLT: un blocco di codice per i casi particolari, che il designer conserva com'è scritto. Il codice del designer è in frontend/gpe-next/src/studio/designer.
Per approfondire.
• Il designer di GPE-NEXT: elenco dei modelli e foglio: docs/guide/gpe-next/designer/README.md
• Il designer: le basi: docs/guide/gpe-next/staff/04-designer-base.md
• Tabelle: tipi di riga, colonne, bordi, condizioni, filtri e totali: docs/guide/gpe-next/staff/05-tabelle.md
• Elementi: testi, macro, immagini, barcode e codice XSLT: docs/guide/gpe-next/staff/06-elementi.md
JK3.3 - Proprietà e formati
In una frase. Il pannello di destra decide com'è fatta la pagina: formato, orientamento, margini, altezza di testa e piede, modo di scrivere i numeri.
Sono le scelte che valgono per tutto il documento. Si fanno una volta e si vedono subito sul foglio.
Togli la selezione. Clicca un punto vuoto fuori dal foglio, o premi Esc. Il pannello Proprietà passa a «Pagina e modello».
Il pannello Proprietà senza niente di scelto: descrizione del modello, pagina, margini, sezioni, numeri
Scegli orientamento e formato. Verticale o Orizzontale; A4, Letter oppure Custom, con larghezza e altezza in millimetri. Custom serve per un'etichetta o un modulo fuori misura. Il foglio cambia subito.
Imposta i margini. In Margini pagina (mm) scrivi i quattro margini. Sotto, Dimensioni sezioni dice quanto restano alte testa, corpo e piede.
Regola testa e piede. Clicca l'etichetta grigia Testa o Piede a sinistra del foglio e scrivi l'altezza, oppure trascina il bordo della sezione.
Scegli come si scrivono i numeri. In Numeri scegli lo stile italiano (1.234,56) o anglosassone (1,234.56). Vale per importi e quantità di tutto il documento.
Aggiungi una pagina, se serve. Con il + accanto a «Pagina 1» il modello prende una seconda pagina, con un'impaginazione sua.
Il logo della ditta
Un'immagine può essere il logo della ditta del documento. Sceglila sul foglio e, nel pannello Proprietà, in Sorgente scegli Logo ditta: a ogni stampa l'immagine diventa il logo che la ditta ha nel centro ditte. In Esempio sul canvas scegli una ditta per vederne il logo mentre disegni; posizione e dimensioni restano tue.
Il pannello Proprietà di un'immagine con la sorgente «Logo ditta» e l'esempio della ditta di prova. Logo finto
Attenzione. Se dopo un cambio di orientamento una tabella non ci sta più, il designer la segna «oltre la pagina». Sceglila e premi Adatta, oppure stringi le colonne.
Nota. La barra in fondo al foglio dice sempre dove sei: pagina, formato, sezione. Da lì accendi e spegni griglia, righelli e guide.
Per chi sviluppa. Ogni pagina del modello può essere legata a una parte dei dati (il campo «XPath pagina»): la pagina si ripete per ogni elemento trovato.
Per approfondire.
• La pagina: formato, margini, testa, piede e più pagine: docs/guide/gpe-next/staff/07-pagina.md
JK3.4 - Anteprima
In una frase. Con Genera vedi il PDF vero del modello, fatto dal servizio delle stampe con i dati di esempio, senza uscire dal designer.
Il foglio è già molto vicino al risultato, ma solo il PDF ti dice come vanno a capo le righe lunghe e dove cade il cambio pagina. L'anteprima te lo mostra prima che il documento arrivi a chi lo usa.
Premi Genera, in alto a destra. Se ci sono modifiche non salvate, il designer salva prima. Il PDF si apre al posto del foglio.
L'anteprima dentro il designer: il PDF del modello con i dati di esempio
Leggi il PDF. Usi i comandi del visualizzatore: ingrandisci, scorri le pagine, scarichi, stampi.
Correggi e rigenera. Chiudi con la ×, fai la modifica sul foglio e premi di nuovo Genera. Oppure, a pannello aperto, Genera anteprima.
Ritocca, se serve. Ritocca e stampa lavora su questo PDF soltanto: il modello non cambia.
Esporta i dati. Esporta scarica i dati del documento in Excel o CSV.
Con quali dati
L'anteprima usa il file di esempio scelto in alto a sinistra, nel pannello Dati. Un modello nato da una tabella porta con sé i dati della tabella da cui è nato. Se il modello non ha dati di esempio, Genera ti chiede di caricarne uno.
Nota. L'anteprima veloce non sa per quale ditta stai stampando: il logo della ditta può restare vuoto. Lo vedi nella stampa vera.
Per chi sviluppa. L'anteprima chiama lo stesso servizio della stampa vera: quello che vedi è quello che uscirà. Il tasto P apre e chiude l'anteprima.
Per approfondire.
• Anteprima, export e vista BI: docs/guide/gpe-next/staff/08-anteprima-ed-export.md
JK3.5 - Scorciatoie
In una frase. I tasti che fanno risparmiare più tempo nel designer, in tre gruppi.
Chi disegna modelli tutti i giorni usa la tastiera per le cose ripetute: spostare di poco, duplicare, annullare, guardare l'anteprima. Dentro il designer il tasto ? (o F1) apre l'elenco completo.
Muoversi sul foglio
| Tasto | Cosa fa |
|---|---|
| Ctrl+0 | mostra la pagina intera |
| Ctrl+1 | torna al 100% |
| Ctrl+2 | ingrandisce su ciò che hai scelto |
| Ctrl + rotellina | ingrandisce dove sta il mouse |
| Spazio + trascina | sposta la vista |
Scegliere e modificare
| Tasto | Cosa fa |
|---|---|
| Maiusc + clic | sceglie più elementi |
| Esc | toglie la selezione |
| Frecce | sposta di mezzo millimetro |
| Maiusc + frecce | sposta di 5 millimetri |
| Ctrl + frecce | sposta di un decimo di millimetro |
| Ctrl+C, Ctrl+V | copia e incolla |
| Ctrl+D | duplica |
| Canc | elimina |
| Ctrl+Z, Ctrl+Y | annulla e ripete |
| Ctrl+S | salva |
Aiuti e pannelli
| Tasto | Cosa fa |
|---|---|
| G | accende e spegne la griglia |
| R | accende e spegne i righelli |
| W | mostra i contorni di celle, elementi e margini |
| P | apre e chiude l'anteprima |
| ? oppure F1 | apre l'elenco delle scorciatoie |
Nota. Con una tabella scelta le frecce cambiano i suoi margini, non la posizione.
Per chi sviluppa. Ci sono anche le scorciatoie per l'ordine degli elementi, l'allineamento con Alt e il trascinamento dei campi da tastiera: sono nell'elenco completo.
Per approfondire.
• Scorciatoie da tastiera del designer: docs/guide/gpe-next/staff/12-scorciatoie.md
JK4 - Modelli nuovi
JK4.1 - Da una griglia
In una frase. Da una tabella qualsiasi crei un modello nuovo in tre mosse, e il modello esce già impaginato.
È il modo più veloce per avere un elenco stampabile: non parti da un foglio bianco. Scegli le colonne, dai un nome e hai un documento con intestazione, tabella e totali. Poi lo ritocchi solo se vuoi.
Apri la finestra «Esporta e stampa» dalla barra della tabella e scegli il formato
GPE-NEXT. Come si apre lo trovi in Da una tabella: PDF ed Excel.Scegli le colonne e scrivi il nome. Spunta solo le colonne che servono: saranno quelle del modello. In Nuovo modello scrivi il nome: una spunta verde dice se è libero. Se è già usato, la finestra te ne propone uno.
Modello nuovo dalla griglia dei mezzi della flotta in SBHweb: dodici colonne scelte su quarantaquattro e il nome del modello
Premi Crea e apri il designer. Il modello nasce e si apre nel designer, in un'altra scheda. Puoi usarlo così o ritoccarlo.
Stampa. Torna alla finestra: il modello nuovo è già nell'elenco Modelli per questi dati, scelto. Premi Stampa.
Il PDF del modello nato dalla griglia dei mezzi: logo e nome della ditta, titolo, tabella con i totali, piè di pagina. Dati veri del server di prova, targhe e nomi coperti, logo finto
Come esce il modello
- Intestazione, ripetuta su ogni pagina: logo e ragione sociale della ditta, titolo, data di stampa.
- Tabella: testata a fondo pieno, righe alterne, testo a sinistra, numeri a destra con i loro decimali, date al centro.
- Totali sotto le colonne che si sommano (importi, quantità). Non sotto codici, anni e prezzi.
- Pagina in verticale se le colonne ci stanno, altrimenti in orizzontale.
- Piè di pagina: nome della funzione, utente, data e ora, numero di pagina.
Nota. Serve il livello Utente base. Un modello regge al massimo 40 colonne per tabella.
Per chi sviluppa. Le colonne senza valori e gli identificativi tecnici restano fuori dalla tabella, ma sono fra i campi a sinistra nel designer.
Per approfondire.
• Creare un documento dai tuoi dati: docs/guide/gpe-next/cliente/13-documenti-dai-tuoi-dati.md
JK4.2 - Da un form
In una frase. Da una schermata senza tabella, come un'anagrafica, nasce una scheda: i campi a video diventano un documento ordinato per sezioni.
La scheda di un cliente o di un mezzo serve spesso su carta: da allegare, da firmare, da portare in riunione. Qui la ottieni senza disegnarla: l'ordine è quello che hai già a video.
Apri la funzione e porta a video la scheda che vuoi stampare.
Apri «Esporta e stampa». Nelle pagine nuove premi
GPE-NEXTnella barra in alto della pagina. In SBHweb: Opzioni › Questa schermata ›GPE-NEXT: stampa e modelli. Su una schermata senza tabella la finestra è più corta: titolo, modelli e nome del modello nuovo.Modello nuovo dal form di un'anagrafica: solo il titolo e il nome del modello
Scrivi il nome e premi Crea e apri il designer. Il modello nasce dai campi del form.
Stampa. Dalla stessa finestra, scegliendo il modello appena creato.
Il PDF di una scheda nata da un form: sezioni con titolo, etichetta in piccolo e valore in evidenza. Documento di prova con dati finti
Come esce la scheda
- Per ogni sezione del form, un titolo con la sua riga sotto.
- I campi su tre colonne (quattro se la pagina è in orizzontale): l'etichetta in piccolo e, sotto, il valore in evidenza.
- I campi lunghi, come le note, prendono più spazio, fino a tutta la larghezza.
- Un campo senza valore mostra un trattino. I sì/no diventano «Sì» e «No».
- Intestazione e piè di pagina sono gli stessi dei modelli nati da una griglia.
Nota. In SBHweb il modello prende i nomi dei campi così come li chiama il gestionale storico. Le etichette si cambiano nel designer.
Per approfondire.
• Creare un documento dai tuoi dati: docs/guide/gpe-next/cliente/13-documenti-dai-tuoi-dati.md
JK4.3 - Da una schermata intera
In una frase. Se la schermata ha una testata e una o più tabelle, un solo modello le prende tutte: prima la scheda, poi una sezione per ogni tabella.
Un ordine con le sue righe e le sue scadenze è un documento solo. Non servono tre stampe da mettere insieme: il modello nasce già con le tre parti nell'ordine giusto.
Apri «Esporta e stampa» dalla schermata e scegli il formato
GPE-NEXT.Scegli i dati. Sotto il nome del modello nuovo scegli Tutte le griglie e il form della schermata. La scelta compare solo se la schermata ha altro oltre alla tabella da cui sei partito. Dalla barra in alto della pagina, se tabelle e form sono più d'uno, scegli quali prendere.
Premi Crea e apri il designer. Nel designer trovi a sinistra i campi raggruppati per parte della schermata, e sul foglio il documento già composto.
Il modello di una schermata intera nel designer: a sinistra testata, righe e scadenze; sul foglio la scheda e le due tabelle
Stampa. Dalla finestra, con il modello nuovo.
Il PDF di una schermata con testata e due tabelle, ognuna con il suo titolo e il suo totale. Documento di prova con dati finti
Cosa puoi ritoccare
Nel designer ogni parte si sceglie e si cambia come in qualsiasi modello. L'intestazione e il piè di pagina sono tabelle di una riga. I totali sono l'ultima riga di ogni tabella. Ragione sociale, utente, data e ora sono campi del gruppo «Dati di stampa».
Attenzione.
• Un modello regge al massimo 12 tabelle.
• La tabella che segue una tabella lunga più di una pagina comincia a pagina nuova.
• Nel designer il piè di pagina del modello nuovo può essere segnato «oltre la pagina»: va lasciato così, nel PDF è giusto.
Per approfondire.
• Creare un documento dai tuoi dati: docs/guide/gpe-next/cliente/13-documenti-dai-tuoi-dati.md
JK4.4 - Pubblicare
In una frase. Pubblicare vuol dire mettere in uso un modello: finché non lo pubblichi, le stampe continuano a usare la versione di prima.
Così puoi lavorare su un modello con calma. Chi stampa non vede le tue prove a metà, e ogni pubblicazione lascia una versione a cui si può tornare.
Quali modelli si pubblicano
- I modelli nati da una tabella, da un form o da una schermata non si pubblicano: salvi e stampi subito dalla finestra «Esporta e stampa».
- I modelli delle stampe del gestionale storico e i modelli base, quelli standard, si pubblicano. La stampa da SBHweb usa solo modelli pubblicati.
Come si fa
Salva. Dopo il salvataggio, in alto compare il segno Bozza: ci sono modifiche che le stampe non usano ancora.
Premi Pubblica, in alto a destra. Si apre una finestra.
La finestra della pubblicazione: versione minima del gestionale, etichetta, migrazione obbligatoria
Compila e conferma. In Versione min. ERP scrivi la versione minima del gestionale che serve, con quattro numeri (per esempio 6.10.0.0). In Etichetta versione scrivi due parole sulla modifica. Poi Pubblica versione: il segno Bozza sparisce.
Controlla la cronologia. L'icona con l'orologio, accanto a Pubblica, elenca le versioni. Passando il mouse su una versione puoi rivederne il PDF o usare Ripristina come bozza.
Se ci ripensi
Per buttare via una bozza clicca la × accanto a Bozza: torni all'ultima versione pubblicata. Ripristinare una versione vecchia non cancella quelle venute dopo: la carica come bozza nuova, da pubblicare.
Nota. Con Aggiornamento obbligatorio per le copie personalizzate chi ha una copia del modello deve prendere la versione nuova; senza, la vede come aggiornamento disponibile.
Per approfondire.
• Pubblicare un modello e gestirne le versioni: docs/guide/gpe-next/staff/09-pubblicazione.md
JK5 - Ditte e loghi
JK5.1 - Il centro ditte
In una frase. Il centro ditte è la pagina di GPEnext dove ogni ditta ha il suo codice, il suo logo e i dati che finiscono sui documenti.
Se l'azienda ha più ditte, ognuna vuole la sua intestazione. Qui la prepari una volta: da quel momento ogni documento prende da solo il logo e la ragione sociale della ditta per cui è stampato.
Sulla pagina il titolo è Le mie aziende: «azienda» e «ditta» qui sono la stessa cosa.
Apri la pagina. Ogni scheda è una ditta: vedi il logo, il nome e il codice che ha nel gestionale. Se non c'è ancora nessuna ditta, la pagina lo dice e propone Aggiungi la prima azienda.
«Le mie aziende» con una ditta di prova, il suo logo e il menu dei tre puntini aperto. Ditta di prova con logo finto
Aggiungi una ditta. Premi Aggiungi azienda. Se il gestionale ha già mandato documenti, la finestra propone i codici che ha trovato: scegli quello giusto. Se non ne ha mandati, o il codice manca, scrivilo tu in Codice azienda nel gestionale. Dai un nome che riconosci e premi Crea.
Carica il logo. Sulla scheda premi Carica logo, trascina l'immagine o sceglila e conferma con Carica. Vanno bene PNG, JPG e SVG, fino a 5 MB. Da lì in poi il pulsante si chiama Cambia logo.
Compila i dati per le stampe. Dal menu dei tre puntini scegli Dati dell'azienda sulle stampe: ragione sociale, sedi, partita IVA, telefono. In fondo alla finestra vedi come compariranno nell'intestazione. I campi lasciati vuoti non vengono stampati.
«Dati dell'azienda sulle stampe»: in fondo l'anteprima dell'intestazione. Dati di prova
Rinomina o disattiva. Rinomina è sulla scheda, Disattiva nel menu dei tre puntini. Una ditta disattivata non viene più usata nelle stampe.
Attenzione. Il codice deve essere uguale, carattere per carattere, a quello che il gestionale scrive nei documenti. È da lì che GPEnext capisce quale logo usare.
Nota. La pagina la apre chi ha il livello Utente avanzato.
Per chi sviluppa.
• La pagina è all'indirizzo /gpe/ditte. Il codice è in frontend/gpe-next/src/studio/client/pages/ditte-settings.
• Da qui si scarica anche il file custom_tag.xml, con i dati delle ditte per le stampe che restano all'ERP legacy/COBOL.
• Ditte e loghi stanno nell'archivio Modelli di stampa.
Per approfondire.
• Gestire le tue aziende: logo e dati aziendali: docs/guide/gpe-next/cliente/08-le-mie-aziende.md
• Le aziende (ditte) di un cliente: docs/guide/gpe-next/admin/03-aziende-del-cliente.md
JK5.2 - Loghi nelle stampe
In una frase. Il logo si carica una volta nel centro ditte e arriva da solo su tutti i documenti: quelli nuovi e le stampe del gestionale storico.
Prima il logo era un file in una cartella di ogni server: cambiarlo voleva dire copiarlo dappertutto. Adesso sta in un posto solo e lo cambia chi ha il permesso, dal browser.
Il logo sta nel centro ditte: lo usano i documenti nuovi e le stampe storiche
Nei modelli nuovi
Un modello nato da una tabella, da un form o da una schermata ha già il logo e la ragione sociale nell'intestazione. Se nel centro ditte c'è una sola ditta, usa quella; altrimenti usa l'azienda dell'installazione.
L'intestazione di un documento nato da una tabella: logo, ragione sociale, titolo e data di stampa. Documento di prova con dati finti
In un modello qualsiasi
Nel designer aggiungi un elemento Immagine e, nelle sue proprietà, scegli come origine Logo ditta. A ogni stampa l'immagine diventa il logo della ditta del documento. Per un'immagine fissa, uguale per tutti, scegli invece un file dalla galleria immagini.
Nelle stampe di SBHweb
In SBHweb la finestra Stampe › Loghi delle ditte (sotto Opzioni › Avanzate) mostra il logo di ogni ditta. Quando GPEnext è acceso, in alto compare la riga «Loghi gestiti dal centro ditte»: i loghi sono quelli del centro, uguali per ogni server. Da lì si possono anche caricare e togliere.
La finestra «Stampe › Loghi delle ditte» con il logo della ditta di prova preso dal centro ditte. Logo finto
Le stampe storiche impaginate dal server prendono lo stesso logo, senza toccare la cartella condivisa.
Una stampa storica (costo dei trasporti) con in testa il logo caricato nel centro ditte. Logo finto, nomi coperti
Attenzione.
• Il posto per il logo c'è se la ditta ha già un logo quando il modello nasce. Se lo carichi dopo, l'immagine «Logo ditta» si aggiunge dal designer.
• La finestra dei loghi in SBHweb è per gli amministratori del gestionale storico. Per cambiare un logo serve anche il livello Utente base.
• Se il centro ditte non risponde, la finestra lo dice e non mostra altri loghi al suo posto.
Per chi sviluppa. SBHweb legge e scrive i loghi passando dal Gateway, con l'accesso dell'utente. Senza GPEnext i loghi restano nei file del Ponte col COBOL, uno per server. Il codice è in frontend/sbh-web/src/session/services/sbh-spm-logos.service.ts.
Per approfondire.
• Usare la galleria immagini: docs/guide/gpe-next/cliente/09-galleria-immagini.md
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 non elenca niente e dice quale delle due cose non va: la cartella non è indicata al servizio, oppure è indicata ma dentro non ci sono i modelli. In tutti e due i casi va chiesto a chi gestisce il server.
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.
La finestra «Import massivo da GPE» su un server dove la cartella dei vecchi modelli è indicata ma vuota
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.
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.
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.
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. La schermata viene da un ambiente di prova senza i vecchi modelli: dove ci sono, al posto dell'avviso compare l'elenco.
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
Chi mantiene i modelli standard li pubblica e ne esporta il catalogo: un solo file, con un numero di versione.
Il file si mette in una cartella del server, quella indicata nell'installazione.
All'avvio GPEnext lo legge. Se il contenuto è diverso dall'ultimo caricato, aggiorna i modelli base. Se è lo stesso, non fa niente.
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
- Cartella vuota o file assente: nessun modello base, ma il servizio parte lo stesso.
- File alterato o incompleto: GPEnext se ne accorge e non parte. Va rimesso il file giusto.
- Quale catalogo è caricato: il servizio lo dice (versione, quando è stato caricato, quanti modelli).
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
- Il pulsante della stampa o l'uscita
GPE_NEXT_PDFsono grigi. Passa il mouse sopra: dice perché. Se GPEnext non risponde, avvisa chi gestisce il server. Se è il tuo livello, chiedi almeno il livello Lettore. - Ieri avevo scelto
GPE_NEXT_PDF, oggi non c'è più. È voluto: l'uscita e ANALISI si scelgono a ogni lancio. - Al posto del PDF vedo la stampa grezza e un avviso. Manca il modello: vedi Se manca il modello.
- Sopra la stampa di sempre leggo «PDF con
GPE-NEXTnon fatto». Il server l'ha mandata già impaginata: chiedi a chi lo gestisce una stampante XML che mandi i dati. - L'avviso dice che il PDF non è riuscito. Leggi il motivo. Premi Riprova quando il servizio è tornato. Con Mostra XML hai comunque i dati.
- Ho cambiato il modello ma il PDF è uguale a prima. Hai salvato? Se il modello si pubblica, hai premuto Pubblica? Poi premi Rigenera.
- Non vedo «Modifica il modello». Serve il livello Utente base.
Nel designer
- Non trovo le impostazioni della pagina. C'è qualcosa di scelto: premi Esc.
- Una tabella è segnata «oltre la pagina». Sceglila e premi Adatta, o stringi le colonne.
- «Genera» chiede un file di dati. Il modello non ha dati di esempio: scegline uno nel pannello Dati.
- L'anteprima dice che il servizio dei PDF non risponde. Il modello non c'entra: riprova fra qualche minuto, poi avvisa chi gestisce il server.
- Il nome del modello nuovo non viene accettato. È già usato: prendi quello che la finestra propone.
Loghi e ditte
- Sul documento manca il logo. Controlla nel centro ditte che la ditta abbia il logo e che il codice sia uguale a quello del gestionale.
- Il modello nuovo è nato senza il posto per il logo. Il logo è stato caricato dopo: aggiungi dal designer un'immagine «Logo ditta».
Per chi amministra
- GPEnext non parte. Controlla i dati di collegamento al suo archivio e il file del catalogo: vedi Il catalogo dei modelli base.
- L'importazione non elenca niente. La finestra dice se la cartella dei vecchi modelli non è indicata o se è vuota: vedi Importare i modelli legacy.
Parole da sapere
- Modello. Lo stampo di un documento: dove vanno logo, testi, tabelle e totali.
- Documento. Un tipo di stampa, con il suo nome. Può avere più modelli.
- Designer. La pagina dove si disegna un modello.
- Testa, corpo, piede. Le tre fasce del foglio. Testa e piede si ripetono su ogni pagina.
- Bozza. Un modello cambiato ma non ancora messo in uso.
- Pubblicare. Mettere in uso una versione del modello.
- Modello base. Un modello standard, uguale per tutti. Si personalizza facendone una copia.
- Centro ditte. Dove ogni ditta ha codice, logo e dati per le stampe.
- Uscita. Dove va a finire una stampa del gestionale storico: qui,
GPE_NEXT_PDF. - Livello. Quello che puoi fare: Lettore stampa, Utente base crea e ritocca i suoi modelli, Utente avanzato usa tutto il designer.
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. Nessun PDF da nessuna parte: il contenitore gpe-gotenberg può restare bloccato dopo un avvio non riuscito (memoria), va riavviato.