PylGam grid¶
L’interfaccia PylGam grid è una consueta finestra del desktop PylGam che mostra tipicamente i record di una tabella GAM appunto in formato tabellare.
I metadati di configurazione dei singoli campi sono definiti nel modello SQLAlchemy del database o sovrascritti nelle definizioni js di ciascuna grid.
La grid Reports
La grid mostrata qui sopra è modificabile e quindi ha, nella barra superiore, i pulsanti per aggiungere un nuovo record o per cancellare la selezione e, nella barra inferiore i pulsanti di conferma o di annullamento delle modifiche.
Selezionando uno o più record o effettuando delle modifiche le azioni disponibili si attivano/disattivano opportunamente.
Aggiunta di un record¶
Quando la grid non è in sola lettura e l’ azione non è disabilitata premendo il pulsante Aggiungi viene creato un nuovo record, pre-popolato in alcuni campi. Il record viene inserito in una nuova riga della grid e salvo in rari casi, mostrato in una specifica form.
Al salvataggio della form il record viene aggiornato (solo) nella grid che quindi risulta modificata e si attiva l’azione Salva.
Solo il salvataggio dall’entità di partenza completa l’operazione con il reale salvataggio dei dati nel database.
Cancellazione di un record¶
Quando la grid non è in sola lettura e l’ azione non è disabilitata premendo il pulsante Elimina dopo un messaggio di conferma il/i record viene/vengono marcati per la cancellazione (sfondo rosso).
La grid risulta modificata e si attiva l’azione Salva.
Solo il salvataggio dall’entità di partenza completa l’operazione con il reale salvataggio dei dati nel database.
Ordinamento dei record¶
 |
L’ordinamento di default è stabilito nella configurazione della grid ma può essere variato premendo sull’intestazione delle colonne. |
 |
Quando si passa con il cursore sulle intestazioni delle colonne compare, sul lato destro, il pulsante dell’elenco a cascata. Premendo sulla freccetta si ottiene il menù di ordinamento che consente di visualizzare i record della grid ordinati in base ai valori della colonna. Al primo click in ordine ascendente, al secondo discendente. |
 |
La voce Colonne mostra un sub-menu con l’elenco dei campi della grid. Usare i riquadri di spunta per visualizzare o nascondere le colonne. |
Barra di paginazione¶
La barra di paginazione, in basso, consente di variare la paginazione e di scorrere il numero di record più opportuno.
Con un doppio click del mouse sul campo Righe per pagina si ricalcola il numero di record visualizzabili [1]. Immettendo un numero si forzano i record paginati (ev. compare la barra di scorrimento laterale).
Con il campo di ricerca è possibile filtrare i dati con il confronto del testo inserito con tutti i campi predisposti (premere sull’etichetta per una diversa scelta).
A destra la barra di paginazione mostra l’intervallo dei record mostrati ed il numero di record totali del dataset.
| [1] | Vedi anche doppio click sul titolo della grid |
Grid dettaglio¶
Una PylGam grid può essere innestata come dettaglio di una PylGam form. In questo caso le azioni disponibili nella grid vengono spostate ed incolonnate a destra del dettaglio e vengono attivate/visualizzate in base alla selezione. L’azione in alto serve per far collassare e nascondere il pannello di dettaglio.
A sinistra una etichetta verticale identifica la grid.
NB: Una grid dettaglio mostra i record filtrati con i parametri della form.
Esportazione del dataset come ODS¶
 |
Tra i report disponibili, in molte grid è possibile sceglire l’esportazione del dataset come ods. Questo report consiste nell’esportazione in un foglio di calcolo di tutto il dataset creato dal proxy della grid. Nota I record mostrati dalla grid non sono solitamente tutto il dataset bensì solo alcune righe in quanto la grid scarica solo il numero di record visualizzato nella barra di paginazione |