Navigation:  I Viewer: esposizione dei dati > Il Viewer Grid > Le Rule di una Grid > Runtime Rules

Si dicono Runtime Rules le regole di formattazione condizionale che impostano dinamicamente proprietà relative alle celle di una Column e alle righe di una Band della Grid corrente.

 

Per aggiungere una nuova Runtime Rule nel tab dedicato del Ruels Editor, è necessario premere il pulsante Add della toolbar. Esso visualizza, in dropdown, le seguenti opzioni:

✓ Rule

✓ Condition

✓ Row statement

✓ Cell statement

 

L'aggiunta di una nuova Rule è caratterizzata dai seguenti attributi:

✓ Key, identificativo univoco della regola;

✓ Description, la descrizione estesa della regola;

✓ un flag di abilitazione/disabilitazione della Rule.

 

 

 

L'aggiunta di una nuova Condition è caratterizzata dai seguenti attributi:

✓ Condition, SQL expression booleana con cui condizionare l'applicazione della regola;

✓ Description, la descrizione estesa della Condition;

✓ un flag di abilitazione/disabilitazione della Condition.

 

 

 

 

 

L'aggiunta di un nuovo Statement è caratterizzata dai seguenti attributi:

✓ Type, che può assumere i valori Cell oppure Row a seconda che sia relativo ad una singola cella oppure ad una intera riga della griglia;

✓ Columns, le colonne a cui lo statement si applica;

✓ Description, la descrizione estesa dello Statement;

✓ un flag di abilitazione/disabilitazione dello Statement.

 

La proprietà Columns può essere compilata:

✓ elencando manualmente il nome delle colonne, separate da virgola;

✓ facendo uso dell'apposita finestra di dialogo che permette di selezionare le colonne dalla lista di tutte le colonne del data member del Viewer.

 

Nella Property Grid, posta nella parte destra del Rules Editor, sono visulaizzate le Property grafiche su cui è possibile agire per configurare il comportamento della griglia in presenza della Rule selezionata.

 

Nel caso di Statement con Type Cell, le Property editabili sono quelle delle Column del Grid mentre, nel caso di Statement con Type Row, sono quelle delle Band.

 

Le principali Column Property, disponibili nel contestuale visualizzatore delle Property, sono:

✓ Activation specifica il comportamento della cella/riga attiva;

✓ ActivateAppearance definisce uno stile grafico per la cella/riga atttiva;

✓ Style determina lo stile delle celle, conferendovi particolari funzionalità;

✓ Hidden  nasconde le righe per cui la Condition risulta verificata;

✓ OnCellButtonClick specifica quale Command del sottostante Book eseguire, quando un cella di tipo bottone viene cliccata;

✓ OnCellValueChanged specifica quale Command del sottostante Book eseguire, quando il contenuto di un cella viene modificato.

 

I valori di queste Property possono essere:

✓ Costanti, selezionati tra i valori caratteristici di ogni proprietà;

✓ Variabili, selezionati da un campo della Band associata alla Rule corrente.

 

 

 

A partire dalla IrionEDM 2016 Update 9, le Runtime Rules di un Viewer Grid possono essere impostate:

✓  con Engine di tipo Model

✓  con Engine di tipo Viewer

 

Se impostata con Engine di tipo Model, la Rule agisce come nelle precedenti versioni, senza alcun comportamento modificato.

 

 

 

Se impostata con Engine di tipo Viewer, permette di agire a livello di Viewer e vengono espanse le funzionalità che sono rese disponibili tramite Engine Model con, ad esempio, l'utilizzo delle formule per la configurazione della Condition Expression.

Infatti se si vuole utilizzare la funzionalità di Formula, occorre cliccare sul pulsante posto appena a lato della Condition Expression.

Da qui è possibile scrivere le opportune formule e delle quali avviene già un check sintattico.