Consultazione grafica

• Codice (campo COD)

Questo codice permette d'identificare una consultazione.

• Descrizione (campo INTIT)

Permette di definire una descrizione associata ad ogni scheda.

• Descr. breve (campo INTITSHO)

Questa descrizione permette di fornire una descrizione alla scheda.
Viene utilizzata in alcune videate o stampe quando non vi è spazio sufficiente per visualizzare la descrizione estesa.

• Attivo (campo ENAFLG)

Questa casella da contrassegnare permette di attivare o disattivare la scheda corrente senza tuttavia perderne il contenuto.
Una scheda disattivata non potrà venire utilizzata (richiamandone il codice) in altre schede (documenti, parametrizzazioni, ecc.), o durante elaborazioni di massa.
Le abilitazioni su una determinata funzione possono vietare la creazione di una scheda attiva. In questo caso, la casella viene disattivata di default e non è modificabile se non da un utente autorizzato, o attraverso un circuito di firma definito tramite Workflow.

• campo CLBFL

• Numero righe (campo NBRLIG)

Permette di definire un numero di righe per pagina logica nella videata di consultazione generata dalla consultazione. Se tale numero di righe supera il numero di righe fisiche visualizzabili, verrà visualizzato un ascensore a destra del riquadro. Dei bottoni situati in alto nella videata permetteranno di navigare tra pagine logiche (visualizzare la successiva, precedente, ultima, prima).

• Righe massime (campo MAXLIG)

Il numero massimo di righe corrisponde ad un parametro della consultazione (maxrows) che arresta la ricerca quando è stato trovato nel database un numero di righe che soddisfa le condizioni (queste righe saranno in seguito ordinate, ma il database non garantisce che le N righe trovate siano le N prime nell'ordinamento). Si tratta di un'ottimizzazione che permette di limitare il carico per il database.

• N° colonne fisse (campo NBRCOL)

Permette di fissare le prime x colonne di un riquadro in caso di paginazione orizzontale.

• Tempo massimo (campo MAXTIM)

Permette di fermare la ricerca dopo questo tempo (espresso in secondi). Ciò permette di evitare di aspettare troppo a lungo soprattutto nel caso di una parametrizzazione di una nuova consultazione.

Nota: Contrariamente al n° massimo di righe, tale informazione non viene trasmessa al database. Quindi il tempo massimo può essere superato se la durata della consultazione è troppo lunga.

• Stampa (campo RPT)

Definisce il codice di una stampa che verrà associata alla funzione File/Elenco a partire dalla consultazione delle richieste. Se non si indica nulla, si utilizza la stampa ALISTE che proporrà un'impaginazione di default. E' possibile duplicare tale stampa generica (basterà soltanto modificare l'impaginazione) per creare delle stampe che si adattano perfettamente alla consultazione così definita.

Il codice stampa qui inserito può essere associato ad un insieme di codici stampa attraverso la funzione dedicata.

• Criteri di selezione (campo SEL)

Permette di inserire dei criteri di selezione che sono delle espressioni logiche relative ai campi delle tabelle, che possono includere delle costanti, delle funzioni, degli operatori. Saranno estratte solo le righe delle tabelle che soddisfano queste condizioni. L'editor di formule permette di semplificare la scrittura di queste espressioni.

• Espress. legame (campo LNK)

Occorre qui definire i collegamenti che non sono definiti nel dizionario o che devono essere considerati in modo prioritario. La struttura del legame deve corrispondere alla chiave del file da collegare. Ci devono essere tanti campi separati da dei punti e virgola quante parti di chiave. Infatti, la sintassi corretta è:

[F:ABV1]CHIAVE=espressione1 ; espressione2..., dove:

    [F:ABV1]CHIAVE è la chiave della tabella collegata. Con tasto destro, si ha accesso alla funzione Scelta tabella che propone l'elenco di tutte le tabelle presenti nel primo folder. La selezione di una delle tabelle determina la visualizzazione del primo indice della tabella. Se si desidera utilizzare un altro indice, è possibile farlo con l'aiuto della funzione Scelta di un indice, sempre accessibile con tasto destro, che proporrà di scegliere tra l'elenco di tutti gli indici della tabella precedentemente selezionata.

    espressione1, espressione2 sono le espressioni che permettono di fornire dei valori ai diversi campi delle chiave definita precedentemente (se la chiave è in una parte, vi è soltanto un'espressione, altrimenti le espressioni sono separate da un punto e virgola). Si dispone inoltre della funzione Scelta di un campo, che permette di alimentare i diversi valori della chiave con dei campi di una delle tabelle interessate. Dopo la scelta della chiave, che fa apparire il numero di punti e virgola che definiscono le parti di chiave da indicare, questa funzione permette di alimentare successivamente tutte le parti mancanti. Si noti che è possibile definire delle parti di chiavi costanti.

Dal punto di vista del database, questa sintassi definisce delle join esterne a sinistra. S noti che una seconda sintassi permette di definire delle joint di sistema (cosa che può essere interessante sul piano delle performance). Si aggiunge una tilde (~) alla sintassi che diventa:

[F:ABV1]CHIAVE~=espressione1 ; espressione2...

• Tipo richiesta (campo ALLUSR)

Permette di gestire la visualizzazione di una consultazione, con i comportamenti seguenti:

• Consultazione normale: il risultato della consultazione viene visualizzato se la query è già stata consultata dall'utente. Infatti, ogni utente che lancia la consultazione crea un set di dati personali che non può essere visto da altri.
• Consultazione condivisa: il risultato dell'esecuzione di tale consultazione effettuata da un utente può essere consultato da altri utenti. L'interesse di avere delle consultazioni condivise consiste nel fatto che una query pesante, lanciata in un determinato momento da un solo utente, permette in seguito ad un insieme di utenti di disporre di un'informazione comune. Per questo genere di consultazione si consiglia che solo un utente possa eseguirla, mentre gli altri vi hanno accesso solo in consultazione. Inoltre, è perfettamente plausibile calcolare questo tipo di consultazione in batch se è particolarmente pesante da costituire; il codice del job batch corrispondente si chiama infatti CALALH.
• Consultazione ricalcolata: il risultato della consultazione non viene mai visualizzato automaticamente. Occorre premere i bottone refresh o inserire i criteri. L'interesse di questo tipo di consultazione è quello di evitare di ricaricare dei dati se si è a conoscenza che questi scadranno rapidamente.

• Gruppo (campo GRP)

Permette di disporre di un criterio di classificazione delle consultazioni.

• Codice accesso (campo ACS)

Questo codice di accesso permette di limitare l'accesso alla scheda corrente ad alcuni utenti.
Se il campo viene indicato, solo gli utenti che dispongono di questo codice di accesso nel loro profilo possono visualizzare e modificare questa scheda.

Il diritto di esecuzione controlla il fatto che si possa eseguire la consultazione in oggetto (facendo il refresh della consultazione o modificandone i parametri e rieseguendola).

• Oggetto (campo OBJLNK)

Permette di determinare dei filtri di abilitazione applicati alla costituzione della consultazione. Questi filtri sono quelli per sito, per ruolo e per codice accesso.

I principi del filtro sono i seguenti:

• Il codice oggetto permette di definire quali sono i campi codice accesso e codice sito sui quali effettuare un filtro.
• Questo filtro viene quindi applicato in funzione dei siti autorizzati e dei diritti di accesso per la gestione dell'oggetto accordati all'utente che esegue la consultazione.
• Allo stesso modo viene inoltre applicato il filtro sui ruoli definiti dal codice oggetto.

Ciò suppone che la tabella sulla quale vengono eseguiti i filtri faccia parte della query generata. Si intende la tabella in cui si trovano i campi codice accesso, codice sito e all'occorrenza il campo definito dai ruoli accordati all'utente. Non si tratta obbligatoriamente della tabella principale della consultazione: ad esempio, una consultazione su righe di documenti può essere filtrata rispetto a delle autorizzazioni fornite su campi di tabelle collegate alla testata del documento.

Attenzione, questi filtri sono applicati esclusivamente durante il calcolo della query e mai durante la consultazione. Ciò può essere sensibile se la consultazione è condivisa, per esempio, o se i filtri per sito di un utente sono cambiati tra il momento in cui la consultazione è stata calcolata ed il momento in cui la si visualizza.

• Funzione (campo FCTLNK)

Permette di collegare le autorizzazioni d'accesso alla consultazione alle autorizzazioni fornite sulla funzione.

Il principio è il seguente: si verifica, all'entrata nella consultazione, che la funzione collegata sia autorizzata all'utente (per almeno un sito, se l'abilitazione su questa funzione si effettua per sito). Ma questa verifica si effettua esclusivamente nel caso in cui tale consultazione non sia condivisa.

Infatti, se la consultazione è condivisa, si parte dal principio che le abilitazioni della persona che ha calcolato la consultazione si applicano e si propagano a tutti quelli che hanno il diritto di visualizzarla. Quindi occorre definire in modo molto accurato le abilitazioni alle richieste condivise, quando queste riguardano dei dati sensibili. Ciò viene effettuato mediante il codice di accesso situato in questo folder.

• Rappresentazione (campo REPGRA)

Questo flag definisce il modo in cui la rappresentazione dei dati sarà fatta a video. Le possibilità offerte sono le seguenti:

• Carattere: i dati sono rappresentanti solo sotto forma di un riquadro.
• Car. o Graf.: i dati della sono presentati sotto una delle due modalità. La modalità di default è determinata dal campo Visualizzazione di default definito nei parametri grafici della scheda.
• Car. e Graf.: i dati sono presentati sotto le due modalità simultaneamente. La posizione del grafico in relazione al riquadro è determinata dal campo Posizione del folder Grafico.
• Grafico: i dati sono rappresentanti solo sotto forma di un grafico.

• campo OPTGRA

Permette di organizzare la coabitazione tra carattere e grafico, quando la modalità di presentazione dei dati permette entrambi. A seconda dei casi:

• se la presentazione è Car o Graf, si sceglie il valore di default della rappresentazione.
• se la rappresentazione è Car e Graf, si fornisce la posizione del grafico in relazione al riquadro di dati.

• campo IMAG

Immagine esplicativa delle informazioni inserite in precedenza.

• Tipo (campo TYPGRA)

Questo campo è utile dal momento in cui si ha più di un valore numerico nel riquadro in grado di essere presentato in forma grafica. Può assumere due valori:

• Grafico semplice: in questo caso si vede solo una colonna di valori alla volta (un selettore permette di scegliere quale)
• Multigrafico: in questo caso, si vedono tutte le colonne visualizzabili, combinate secondo il parametro definito dal parametro Rappresentazione.

• Rappresentazione (campo FSHGRA)

Quando nel grafico vengono rappresentate più serie (a condizione che la rappresentazione di tutte le serie sia identica e non sia di tipo settore), è possibile specificare come si combinano le serie di valori alla visualizzazione, inserendo il seguente valore:

• Multipermette di presentare i valori di ogni serie gli uni di fianco agli altri (un colore per serie)
• Cumulativo permette di presentare i valori in totalizzazione verticale.
• Confronto permette di presentarli facendo un confronto relativo (l'altezza del grafico è costante).

• Grafico di default (campo DEFGRA)

Definisce la rappresentazione grafica utilizzata per i dati da presentare (tra le scelte Barre, Linee, Aree, Settori). Una immagine visualizzata in funzione della scelta fatta illustra il tipo di rappresentazione ottenuto.

Se si presenta una sola serie di valori, la rappresentazione grafica di default è stabilita da questo parametro.

Se si presentano più serie di valori, è possibile miscelare i modi di rappresentazione (una serie in forma di barre, un'altra in forma di linee, ad esempio). In questo caso, ogni serie di valori viene rappresentata in funzione del campo Rappresentazionesituato nel riquadro dei campi:

• se vale Barrao Linea, questa modalità di rappresentazione è utilizzata per la serie di valori interessata se è compatibile con la rappresentazione grafica di default (non è possibile miscelare dei settori con delle barre o delle linee).
• se vale Default, viene utilizzata la modalità di rappresentazione grafica di default per la serie.

All'utilizzo, se la rappresentazione delle serie è omogenea (a maggior ragione se vi è una sola serie nel grafico), si dispone di un selettore dei grafici per passare in un'altra modalità di rappresentazione.