# 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.

1. **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](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/modelli-di-stampa-una-scheda-per-documento-con-la-ricerca-in-alto.png)
    
    *Modelli di stampa: una scheda per documento, con la ricerca in alto*
2. **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.
3. **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](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/lelenco-a-tabella-dopo-la-ricerca-mezzi-nome-descrizione-documento-e-azioni.png)
    
    *L'elenco a tabella dopo la ricerca «mezzi»: nome, descrizione, documento e azioni*
4. **Usa le azioni della riga.** La matita apre il modello, i due fogli lo duplicano, il cestino lo elimina.
5. **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](https://gsdoc.genesyssoftware.eu/link/37945).

<p class="callout info">**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.</p>

<p class="callout info">**Per chi sviluppa.** La pagina è all'indirizzo `/gpe/templates`. Il codice è in `frontend/gpe-next/src/studio/templates`.</p>

<p class="callout info">**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`</p>

# 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](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/il-designer-con-un-modello-aperto-i-dati-a-sinistra-il-foglio-al-centro-le-proprieta-a-destra.png)

*Il designer con un modello aperto: i dati a sinistra, il foglio al centro, le proprietà a destra*

## 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](https://gsdoc.genesyssoftware.eu/link/37944).
- **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à](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/una-cella-di-tabella-scelta-sopra-il-foglio-i-comandi-della-cella-a-destra-le-sue-proprieta.png)

*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.

<p class="callout success">**Cosa ci guadagni.** Aggiungere il totale di una colonna è un clic su **Totale**. Nel gestionale storico era una modifica al programma.</p>

<p class="callout info">**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`.</p>

<p class="callout info">**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`</p>

# 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.

1. **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](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/il-pannello-proprieta-senza-niente-di-scelto-descrizione-del-modello-pagina-margini-sezioni-numeri.png)
    
    *Il pannello Proprietà senza niente di scelto: descrizione del modello, pagina, margini, sezioni, numeri*
2. **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.
3. **Imposta i margini.** In **Margini pagina (mm)** scrivi i quattro margini. Sotto, **Dimensioni sezioni** dice quanto restano alte testa, corpo e piede.
4. **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.
5. **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.
6. **Aggiungi una pagina, se serve.** Con il **+** accanto a «Pagina 1» il modello prende una seconda pagina, con un'impaginazione sua.

<p class="callout warning">**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.</p>

<p class="callout info">**Nota.** La barra in fondo al foglio dice sempre dove sei: pagina, formato, sezione. Da lì accendi e spegni griglia, righelli e guide.</p>

<p class="callout info">**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.</p>

<p class="callout info">**Per approfondire.**  
• La pagina: formato, margini, testa, piede e più pagine: `docs/guide/gpe-next/staff/07-pagina.md`</p>

# 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.

1. **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](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/lanteprima-dentro-il-designer-il-pdf-del-modello-con-i-dati-di-esempio.png)
    
    *L'anteprima dentro il designer: il PDF del modello con i dati di esempio*
2. **Leggi il PDF.** Usi i comandi del visualizzatore: ingrandisci, scorri le pagine, scarichi, stampi.
3. **Correggi e rigenera.** Chiudi con la **×**, fai la modifica sul foglio e premi di nuovo **Genera**. Oppure, a pannello aperto, **Genera anteprima**.
4. **Ritocca, se serve.** **Ritocca e stampa** lavora su questo PDF soltanto: il modello non cambia.
5. **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.

<p class="callout info">**Nota.** L'anteprima veloce non sa per quale ditta stai stampando: il logo della ditta può restare vuoto. Lo vedi nella stampa vera.</p>

<p class="callout info">**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.</p>

<p class="callout info">**Per approfondire.**  
• Anteprima, export e vista BI: `docs/guide/gpe-next/staff/08-anteprima-ed-export.md`</p>

# 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

<table id="bkmrk-tasto-cosa-fa-ctrl%2B0"><thead><tr><th>Tasto</th><th>Cosa fa</th></tr></thead><tbody><tr><td>Ctrl+0</td><td>mostra la pagina intera</td></tr><tr><td>Ctrl+1</td><td>torna al 100%</td></tr><tr><td>Ctrl+2</td><td>ingrandisce su ciò che hai scelto</td></tr><tr><td>Ctrl + rotellina</td><td>ingrandisce dove sta il mouse</td></tr><tr><td>Spazio + trascina</td><td>sposta la vista</td></tr></tbody></table>

## Scegliere e modificare

<table id="bkmrk-tasto-cosa-fa-maiusc"><thead><tr><th>Tasto</th><th>Cosa fa</th></tr></thead><tbody><tr><td>Maiusc + clic</td><td>sceglie più elementi</td></tr><tr><td>Esc</td><td>toglie la selezione</td></tr><tr><td>Frecce</td><td>sposta di mezzo millimetro</td></tr><tr><td>Maiusc + frecce</td><td>sposta di 5 millimetri</td></tr><tr><td>Ctrl + frecce</td><td>sposta di un decimo di millimetro</td></tr><tr><td>Ctrl+C, Ctrl+V</td><td>copia e incolla</td></tr><tr><td>Ctrl+D</td><td>duplica</td></tr><tr><td>Canc</td><td>elimina</td></tr><tr><td>Ctrl+Z, Ctrl+Y</td><td>annulla e ripete</td></tr><tr><td>Ctrl+S</td><td>salva</td></tr></tbody></table>

## Aiuti e pannelli

<table id="bkmrk-tasto-cosa-fa-g-acce"><thead><tr><th>Tasto</th><th>Cosa fa</th></tr></thead><tbody><tr><td>G</td><td>accende e spegne la griglia</td></tr><tr><td>R</td><td>accende e spegne i righelli</td></tr><tr><td>W</td><td>mostra i contorni di celle, elementi e margini</td></tr><tr><td>P</td><td>apre e chiude l'anteprima</td></tr><tr><td>? oppure F1</td><td>apre l'elenco delle scorciatoie</td></tr></tbody></table>

<p class="callout info">**Nota.** Con una tabella scelta le frecce cambiano i suoi margini, non la posizione.</p>

<p class="callout info">**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.</p>

<p class="callout info">**Per approfondire.**  
• Scorciatoie da tastiera del designer: `docs/guide/gpe-next/staff/12-scorciatoie.md`</p>