# JD3 - Lavorare con le tabelle

# JD3.1 - La griglia: ordinare, filtrare, raggruppare

**In una frase.** Ogni tabella di SIGEAnext si ordina, si filtra e si raggruppa da sola, senza passare da Excel.

La tabella è la stessa in tutte le pagine: quello che impari su una vale per tutte. Le risposte che prima chiedevano un'esportazione, per esempio «quanti sono per categoria» o «quali superano una soglia», si ottengono sul posto.

1. **Ordina.** Premi l'intestazione di una colonna: le righe si ordinano. Un secondo clic inverte l'ordine, il terzo lo toglie. Tenendo premuto **Ctrl** ordini per più colonne: un numerino dice quale viene prima.
    
    ![Una tabella ordinata per due colonne: prima la categoria, poi l'importo. Pagina di prova con dati finti](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/una-tabella-ordinata-per-due-colonne-prima-la-categoria-poi-limporto-pagina-di-prova-con-dati-finti.png)
    
    *Una tabella ordinata per due colonne: prima la categoria, poi l'importo. Pagina di prova con dati finti*
2. **Cerca.** Scrivi nella casella **Cerca…**, in alto a sinistra della tabella. Restano le righe che contengono quel testo.
3. **Filtra una colonna.** Premi l'**imbuto** nell'intestazione e scegli la condizione: contiene, inizia per, uguale, vuoto. Per date e numeri le condizioni sono quelle adatte. In alto a destra il contatore dice quante righe vedi sul totale, per esempio «5 di 106 righe».
    
    ![La stessa tabella con un filtro: il contatore dice quante righe restano sul totale. Pagina di prova con dati finti](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-stessa-tabella-con-un-filtro-il-contatore-dice-quante-righe-restano-sul-totale-pagina-di-prova-con-dati-finti.png)
    
    *La stessa tabella con un filtro: il contatore dice quante righe restano sul totale. Pagina di prova con dati finti*
4. **Raggruppa.** Apri il pannello dell'analisi avanzata dalla barra della tabella e scegli un campo. Le righe si raccolgono sotto il loro gruppo, ognuno con il conteggio e i suoi totali.
    
    ![Le righe raggruppate per categoria, ogni gruppo con conteggio e totali. Pagina di prova con dati finti](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/le-righe-raggruppate-per-categoria-ogni-gruppo-con-conteggio-e-totali-pagina-di-prova-con-dati-finti.png)
    
    *Le righe raggruppate per categoria, ogni gruppo con conteggio e totali. Pagina di prova con dati finti*
5. **Torna com'era.** Quando c'è un filtro o un gruppo, nella barra compare un pulsante che li toglie tutti insieme.

<p class="callout success">**Cosa ci guadagni.**  
• In fondo alla tabella ci sono già somme e medie, nel formato della colonna.  
• Selezioni alcune celle e leggi subito somma, media e conteggio della selezione.  
• Le colonne si allargano e si spostano trascinando: l'ordine che scegli resta. </p>

<p class="callout info">**Nota.** Se la tabella carica i dati a pagine, ordinamento e filtri vengono chiesti al servizio e valgono per tutte le righe, non solo per quelle a schermo.</p>

<p class="callout info">**Per chi sviluppa.** La griglia è una sola per tutta l'app: `frontend/core/src/grid`. Le tabelle disegnate la usano attraverso il componente `app-dynamic-table` di ADEnext.</p>

<p class="callout info">**Per approfondire.**  
• La tabella — una sola griglia, e cosa sa fare: `docs/guide/tabella/griglia/README.md`</p>

# JD3.2 - Viste e colonne calcolate

**In una frase.** Una vista ricorda come vuoi vedere una tabella; una colonna calcolata aggiunge un valore che nei dati non c'è.

Senza le viste, ogni mattina rimetti gli stessi filtri e lo stesso ordine. Con una vista lo fai una volta, le dai un nome e la ritrovi. La colonna calcolata evita il passaggio in Excel per un margine, una percentuale o i giorni fra due date.

1. **Apri il menu delle viste.** A sinistra nella barra della tabella c'è un pulsante con il nome della vista in uso. All'inizio è **Standard**: la tabella come la manda il programma.
    
    ![Il menu delle viste aperto: Standard, Salva come, Colonne calcolate, Formattazione condizionale. Pagina di prova con dati finti](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/il-menu-delle-viste-aperto-standard-salva-come-colonne-calcolate-formattazione-condizionale-pagina-di-prova-con-dati-finti.png)
    
    *Il menu delle viste aperto: Standard, Salva come, Colonne calcolate, Formattazione condizionale. Pagina di prova con dati finti*
2. **Sistema la tabella e salva.** Metti filtri, ordine, gruppi e colonne come ti servono, poi scegli **Salva come…** e scrivi un nome. Decidi anche chi la vede: **Solo mia**, **Del ruolo** o **Aziendale**. Le ultime due sono per chi ha il permesso di pubblicare.
3. **Falla aprire da sola.** Premi la **stella** accanto al nome: la vista diventa la predefinita e si apre con la tabella.
4. **Aggiungi una colonna calcolata.** Dal menu delle viste scegli **Colonne calcolate…**, oppure premi il tasto destro su un'intestazione. Scegli un modello, per esempio **Differenza A − B** o **Giorni fra due date**, e indica i campi. L'anteprima mostra il risultato sulle prime righe.
    
    ![La finestra della vista alla voce Calcolate: i modelli pronti e, a sinistra, la colonna «Margine» già creata](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-finestra-della-vista-alla-voce-calcolate-i-modelli-pronti-e-a-sinistra-la-colonna-margine-gia-creata.png)
    
    *La finestra della vista alla voce Calcolate: i modelli pronti e, a sinistra, la colonna «Margine» già creata*
5. **Usala come le altre.** La colonna nuova ha il segno «fx» nell'intestazione. Si ordina, si filtra, entra nei totali e nell'esportazione.

<p class="callout success">**Cosa ci guadagni.**  
• Le viste stanno sul server: le ritrovi su un altro computer, senza fare niente.  
• Una vista del ruolo o aziendale mette tutti i colleghi sulla stessa tabella.  
• Con **Formattazione condizionale…** le celle che contano si colorano da sole. </p>

<p class="callout info">**Nota.** Una colonna calcolata è solo un modo di guardare: non scrive niente nei dati dell'azienda.</p>

<p class="callout info">**Per chi sviluppa.** Le viste delle pagine di SIGEAnext sono servite dal servizio stesso (`backend/business-logic/it_gsba_sigea_next`, pacchetto `grid_views`). Se l'archivio delle viste non risponde, la tabella continua a lavorare con le viste del browser e lo segnala.</p>

<p class="callout info">**Per approfondire.**  
• Griglie: viste, colonne calcolate, formattazione condizionale: `docs/guide/moduli/griglie-viste-calcolate-formati/README.md`</p>

# JD3.3 - Esportare in Excel e PDF

**In una frase.** Da ogni tabella scarichi un file Excel, CSV o PDF, oppure stampi con un modello impaginato.

Non serve chiedere una stampa nuova a chi sviluppa. Scegli tu le colonne e le righe, e il file esce con i valori come li vedi a schermo: date, importi e decimali già formattati.

1. **Apri la finestra.** In fondo alla barra della tabella premi una delle icone **CSV**, **Excel** o **PDF**. Si apre sempre la stessa finestra, **Esporta e stampa**, con il formato già scelto.
2. **Scegli titolo e colonne.** Il titolo diventa il nome del file. Spunta le colonne che vuoi e trascinale per cambiare l'ordine. Con **Tutte** e **Nessuna** fai prima.
    
    ![La finestra «Esporta e stampa»: formato Excel, quattro colonne scelte su undici. Pagina di prova con dati finti](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-finestra-esporta-e-stampa-formato-excel-quattro-colonne-scelte-su-undici-pagina-di-prova-con-dati-finti.png)
    
    *La finestra «Esporta e stampa»: formato Excel, quattro colonne scelte su undici. Pagina di prova con dati finti*
3. **Scegli le righe.** **Tutte**, **Filtrate** (se c'è un filtro) o **Selezionate** (le righe spuntate).
4. **Esporta.** Premi il pulsante in basso: il file si scarica.
5. **Stampa con un modello.** Scegli il formato di stampa, che a schermo si chiama `GPE-NEXT`. La finestra elenca i modelli adatti a questi dati: scegline uno e premi **Stampa**. Il PDF si apre in un'altra scheda. Se il modello non c'è, scrivi un nome in **Nuovo modello** e premi **Crea e apri il designer**: nasce un documento già impaginato, con intestazione, tabella e totali.
    
    ![La stessa finestra sul formato di stampa: i modelli per questi dati e il nome del modello nuovo. Pagina di prova con dati finti](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-stessa-finestra-sul-formato-di-stampa-i-modelli-per-questi-dati-e-il-nome-del-modello-nuovo-pagina-di-prova-con-dati-finti.p)
    
    *La stessa finestra sul formato di stampa: i modelli per questi dati e il nome del modello nuovo. Pagina di prova con dati finti*

<p class="callout success">**Cosa ci guadagni.**  
• Le colonne scelte valgono sia per il file sia per il modello nuovo.  
• Il **PDF semplice** va bene per un elenco al volo. Il modello serve quando il documento va consegnato.  
• Lo stesso modello stampa domani gli stessi dati aggiornati: non lo rifai. </p>

<p class="callout info">**Nota.** Se il formato di stampa è grigio, il servizio delle stampe è spento o il tuo ruolo non basta: la finestra dice quale dei due. Per creare un modello serve un livello più alto che per stampare. Per i modelli vedi il libro JK - GPEnext.</p>

<p class="callout info">**Per chi sviluppa.** La finestra è un componente unico in `frontend/core/src`, usato dalla barra di ogni griglia e dalla barra delle azioni della pagina (`frontend/shell/src/layout/components/app.actionbar.ts`).</p>

<p class="callout info">**Per approfondire.**  
• Esportare e stampare da una griglia: `docs/guide/tabella/esporta-e-stampa/README.md`  
• La tabella — una sola griglia, e cosa sa fare: `docs/guide/tabella/griglia/README.md`  
• Creare un documento dai tuoi dati: `docs/guide/gpe-next/cliente/13-documenti-dai-tuoi-dati.md`</p>