JE4 - Le tabelle

JE4.1 - Costruire una tabella

In una frase. Scegli da dove arrivano i dati, lasci che il Table Builder proponga le colonne e poi le sistemi una per una.

Una tabella è la cosa che si guarda di più in un gestionale. Disegnarla vuol dire decidere quali colonne mostrare e come: un numero con le migliaia, una data all'italiana, un sì o no come icona. Si decide una volta, sulla colonna.

  1. Apri il Table Builder. Dal menu: Low-Code Platform › Dynamic Tables › Table Builder. Scrivi nome e descrizione.

  2. Scegli la sorgente. Con Sfoglia cerchi l'endpoint che dà i dati. Poi Genera colonne dall'endpoint: il builder legge un campione e crea una colonna per ogni campo, indovinando il tipo.

  3. Sistema le colonne. Nell'elenco in basso cambi intestazione e larghezza, e spunti se la colonna è visibile, ordinabile, filtrabile. Il numero nella prima casella la sposta. La matita apre il resto: tipo, decimali, allineamento, colonna fissa, icona.

    Il Table Builder: sopra l'anteprima con i dati veri, sotto l'elenco delle colonne

    Il Table Builder: sopra l'anteprima con i dati veri, sotto l'elenco delle colonne

  4. Aggiungi una colonna che nei dati non c'è. Con Aggiungi crei una colonna calcolata da una formula, oppure una che unisce due campi con un separatore.

  5. Salva e guarda. L'anteprima in alto è la tabella vera, con i dati veri.

    La tabella nella pagina: la provincia come etichetta, i numeri con le migliaia, il sì o no come icona

    La tabella nella pagina: la provincia come etichetta, i numeri con le migliaia, il sì o no come icona

Cosa ci guadagni. Nell'esempio la tabella dei comuni ha più di ottomila righe. La pagina ne chiede al server una manciata per volta, e ricerca e ordinamento li fa il server su tutte: la tabella resta veloce anche su archivi grandi.

Nota. Tutte le tabelle dell'applicazione, disegnate o no, usano la stessa griglia. Quello che impari su una vale per le altre.

Per chi sviluppa. Il disegno è in frontend/ade-next/src/studio/table-builder, la tabella a schermo in frontend/ade-next/src/runtime/table, la griglia comune in frontend/core/src/grid.

Per approfondire.
• Il Table Builder — ogni impostazione, e come si vede nella tabella: docs/guide/tabella/builder/README.md

JE4.2 - Filtri, gruppi e totali

In una frase. Decidi come si cerca nella tabella, per cosa si raggruppa e quali somme mostra in fondo.

Una tabella lunga serve se ci trovi quello che cerchi e se ti dà il totale senza portare i dati in un foglio di calcolo. Queste tre cose si preparano nel disegno, e l'utente le può poi cambiare mentre lavora.

  1. Prepara i filtri. Nel Table Builder, scheda Impostazioni › Filtri. La ricerca libera è già accesa. Per ogni colonna filtrabile scegli il modo di partenza, per esempio «Inizia con».

  2. Controlla chi filtra. Con Rileva cosa filtra l'endpoint il builder chiede al servizio su quali colonne sa filtrare. Su quelle il filtro cerca in tutto l'archivio. Sulle altre cerca solo nelle righe già caricate, e la tabella lo dice.

    Il filtro di una colonna: «Inizia con BA», e in alto la scritta che dice su cosa cerca

    Il filtro di una colonna: «Inizia con BA», e in alto la scritta che dice su cosa cerca

  3. Scegli il raggruppamento. Nella scheda Raggr. indichi la colonna per cui la tabella si apre già raggruppata. Nell'esempio, la provincia.

  4. Aggiungi i totali. Nella stessa scheda aggiungi le somme (o medie, conteggi, minimo, massimo) e accendi Mostra Footer Totali.

    Righe raggruppate per provincia, con la somma della popolazione di ogni gruppo e il totale in fondo

    Righe raggruppate per provincia, con la somma della popolazione di ogni gruppo e il totale in fondo

  5. Decidi come si sfogliano le righe. A pagine, a scorrimento continuo con Carica altre, oppure tutto in memoria per le tabelle piccole.

Cosa ci guadagni. Il totale in fondo è su tutte le righe trovate, non sulla pagina che hai davanti. E quando filtri, il contatore dice «33 di 569»: si vede che il filtro ha lavorato.

Nota. Chi usa la tabella trova gli stessi strumenti nella barra: filtri con «e» e «oppure», raggruppamento, colonne visibili, esportazione. Per numeri e grafici c'è il pulsante Analisi: vedi il libro JF - Analytics.

Per chi sviluppa. Verso il server i filtri viaggiano come filter=campo:operatore:valore, la ricerca libera come q=, l'ordinamento come sort=. Con i dati sul server l'ordinamento è su una colonna per volta.

Per approfondire.
• Il Table Builder — ogni impostazione, e come si vede nella tabella: docs/guide/tabella/builder/README.md
• La tabella — una sola griglia, e cosa sa fare: docs/guide/tabella/griglia/README.md

JE4.3 - Stili e azioni

In una frase. Una regola colora le celle che contano, e i pulsanti di riga fanno partire quello che serve: aprire una scheda, modificare, cancellare.

Una tabella non serve solo a leggere. Deve far vedere a colpo d'occhio cosa merita attenzione, e deve far arrivare con un clic alla schermata successiva.

  1. Scrivi una regola di stile. Nel Table Builder, scheda Impostazioni › Stile. Scegli la colonna, la condizione e l'aspetto: colore del testo, sfondo, grassetto. In fondo vedi l'anteprima.

    Una regola di stile: popolazione maggiore di 500.000, sfondo rosato e grassetto

    Una regola di stile: popolazione maggiore di 500.000, sfondo rosato e grassetto

  2. Guardala nella tabella. La regola vale riga per riga, sui dati veri.

    La regola nella tabella: le sei città sopra il mezzo milione sono evidenziate

    La regola nella tabella: le sei città sopra il mezzo milione sono evidenziate

  3. Aggiungi le azioni. Nella scheda Azioni ogni azione è un pulsante sulla riga: un nome, un'icona, un colore. La tabella nata da un endpoint ne ha già tre: visualizza, modifica, elimina.

  4. Decidi quando l'azione si vede. Ogni azione ha due regole: Visibile se e Disattivata se. Si compongono come le regole dei form, da tendine.

    Le azioni: «apri» resta spenta sulle righe con popolazione sotto mille

    Le azioni: «apri» resta spenta sulle righe con popolazione sotto mille

  5. Collega l'azione a un'altra schermata. Un'azione di riga può aprire un'altra funzione, in una finestra o a pagina intera, passandole i valori della riga. È il caso tipico della testata che apre le sue righe.

Cosa ci guadagni. Colori e pulsanti seguono i dati senza una riga di programma: se domani la soglia cambia, cambi un numero nel disegno.

Nota. Un'azione apre sempre una schermata, e le passa solo i valori che quella schermata dichiara di voler ricevere. Se ne manca uno il disegno lo segnala come errore, prima che se ne accorga l'utente.

Per chi sviluppa. Nel flusso l'azione è un nodo «Apri schermata» collegato all'evento della riga. Dalla barra della tabella, il pulsante della stampa manda le righe a GPEnext: vedi il libro JK - GPEnext.

Per approfondire.
• Il Table Builder — ogni impostazione, e come si vede nella tabella: docs/guide/tabella/builder/README.md
• Le azioni: cosa apre cosa: docs/guide/flussi/azioni/README.md