Consultazioni

• 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 WW

• 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.

• Tabella (campo TBL)

Definire la tabella dalla quale estrarre il campo da visualizzare. E' possibile visualizzare dei campi appartenenti a più tabelle a condizione che esista un legame logico tra di loro. Questo legame può essere determinato automaticamente a partire dai legami descritti nel dizionario dati, oppure definito nel folder successivo.

• Campo (campo FLD)

Definisce il nome del campo che si desidera visualizzare. Questo campo proviene dalla tabella precedente. Se questo campo non viene indicato, si indicherà un'espressione nella colonna corrispondente.

Il campo può essere scritto nel formato CAMPO(indice), dove indice è una costante che varia da 0 a N, se si ha di fronte un campo che ha più occorrenze. E' per esempio il caso del campo CHEF nella tabella AUTILIS ; si potrà scrivere CHEF(2) nel riquadro dei campi.

• Descrizione (campo INTITLIG)

Permette di definire una descrizione della colonna che sarà visualizzata all'esecuzione della consultazione.

Di default, quando è utilizzato un campo della tabella, viene proposta la sua descrizione (così come è memorizzata nel dizionario). In un contesto multilingue, questa descrizione è visualizzata all'esecuzione nella lingua di connessione dell'utente, essendo i testi del dizionario gestiti in tutte le lingue di connessione.

Ciò suppone che si possano definire delle traduzioni per una descrizione modificata, o corrispondente ad una espressione calcolata per cui non può essere definita nessuna traduzione.

La definizione di una descrizione in una lingua diversa da quella della connessione corrente è possibile su dei campi traducibili come questo grazie alla funzione Traduzioni in linea,accessibile con un clic destro sul campo.

Si apre allora una finestra che permette questo inserimento.

• Espressione (campo CLC)

Permette di definire un'espressione calcolata che verrà visualizzata all'esecuzione della consultazione.

Questo campo può essere inserito soltanto se non è stato fornito alcun nome di campo.

L'espressione puo integrare qualunque campo di una delle tabelle in linea nella consultazione, delle costanti, delle funzioni, delle variabili globali... L'editor di formule è disponibile per facilitare la definizione della formula.

• Tipo (campo CODTYP)

Questo tipo di dati permette di precisare come deve essere fatta la presentazione del dato. Nel caso di un campo, il tipo associato al campo viene proposto di default (ma è modificabile). Nel caso di un'espressione, deve essere precisato (può essere un tipo generico come una stringa di caratteri A, un menù locale M, un intero corto C, una data D, un decimale DCB, un intero lungo L...). Nel caso di una stringa di caratteri, verrà precisata la sua lunghezza massima sul campo Lunghezza che segue; nel caso di un menù locale, verranno precisati allo stesso tempo la lunghezza di visualizzazione e il numero di menù locale utilizzato. Se il tipo di dati utilizzato è collegato ad un oggetto, sarà possibile passare tramite tunnel nella gestione dell’oggetto al momento della consultazione.

• Lung (campo LNG)

Permette di definire la lunghezza di un campo quando quest'ultimo utilizza un tipo di dati generico la cui lunghezza non è fissata. E' il caso soprattutto dei tipi A e DCB.

Per i blob, come per i clob, occorre indicare la lunghezza che sarà quella massima di memorizzazione. La codifica è la seguente:

• Menù (campo NOLIB)

Definisce il numero di menu locale associato al campo definito sulla riga.

Quando un campo è di tipo menu locale, viene memorizzato sotto forma di un valore numerico (da 1 a 255) corrispondente ad un range di un'intestazione nella tabella chiamataMenù locali, salvata nella tabella dei messaggiAPLSTD.

In inserimento o in visualizzazione, si vede, secondo le scelte fatte sull'interfaccia utente:

• sia una intestazione che può essere scelta nella lista scorrevole comunemente chiamatacombo box
• sia una lista di bottoni di scelta.

L'interesse di questo tipo di inserimento è che la lista delle scelte è presentata nella lingua di connessione dell'utente.

Ogni numero di menu locale caratterizza la lista delle intestazioni possibili. Per esempio, il menu locale 1 corrisponde alla sceltaNo / Sì  in questo ordine. In questo caso particolare, l'interfaccia utente può anche essere la casella da contrassegnare.

• Intervallo (campo STREND)

Sono possibili tre scelte in questo campo:

• Non inserito significa che per tale campo non verrà inserito alcun intervallo di inizio-fine al lancio della consultazione.
• Inserito significa che per tale campo potrà essere inserito un intervallo di inizio-fine al lancio della consultazione.
• Non trasferito significa che per tale campo potrà essere inserito soltanto un intervallo di inizio-fine al lancio della consultazione, ma che tale campo non verrà trasferito nella videata per visualizzazione.

• Totale (campo CUM)

Questo campo può essere alimentato solo se il campo è numerico. Se è uguale a Sì, verrà visualizzato un insieme di valore per i diversi livelli di rottura indotti dai criteri di raggruppamento.

• Ord (campo SRT)

I dati provenienti dalla consultazione possono essere ordinati a seconda di uno o più campi, vale a dire presentati in ordine crescente (per un ordinamento ascendente) o descrescente (per un ordinamento discendente) dei valori del campo.

L'ordinamento è l'ordine numerico per i campi numerici, cronologico per le date e l'ordine di codifica utilizzato per i caratteri nei campi alfanumerici (sui codici alfabetici, è l'ordine lessicografico).

Se sono richiesti molteplici criteri di ordinamento, l'ordinamento si effettuerà prioritariamente sul campo che appare come primo nel riquadro poi, a parità di valore, sul secondo criterio e così via.

• Gruppo (campo GRP)

Questo campo permette di realizzare un livello di rottura. Se si alimenta questo campo con Si, potrà essere fatto un raggruppamento dei campi successivi per mezzo della rottura sul campo corrente e gli eventuali valori totalizzati saranno visualizzati a livello del raggruppamento.

Questo campo può essere inserito solo se si è definito un ordinamento sulla riga corrente (Ascendenteo Discendente a scelta).

Per esempio, se si definisce un'elenco di utenti ordinati per profilo, una rottura per profilo permetterà di raggruppare su una sola riga tutti gli utenti collegati ad un profilo, e di far apparire dei dati totalizzati collegati al raggruppamento (per esempio il loro numero se si ha un campo uguale a 1 che viene sommato).

• Livello (campo NIV)

Corrisponde al livello di dettaglio desiderato per la visualizzazione dell'informazione.

Il livello 1 significa che l'informazione è visualizzata al livello 1 di aggregazione (il più elevato) ed a tutti i livelli successivi, il livello 2 significa che l'informazione non sarà visualizzata al livello 1, ma al livello 2 e a tutti i livelli più dettagliati, ecc. Il livello più elevato corrisponde al dettaglio più preciso della consultazione, che è quello visualizzato di default quando si entra nella consultazione.

Questo livello viene assegnato di default a 1 sulla prima riga e incrementato ogni volta che viene richiesta una rottura (Gruppo=si) sul campo precedente. Può essere modificato se si vuole visualizzare un importo ad un livello di aggregazione diverso. Per esempio, quando si ordinano e si raggruppano le informazioni su un codice come il codice utente, e quando si desidera visualizzare il nome dell'utente nella colonna successiva, è evidente che questo nome debba essere visualizzato allo stesso livello del codice a lui corrispondente e non solo su dei livelli più dettagliati.

• Tunnel (campo TUN)

• Tipo di grafico (campo GRA)

Questo campo può essere inserito solo se il modo di rappresentazione scelto in testata non è Carattere. Permette di specificare il modo in cui verrà attuata la rappresentazione grafica.

Può assumere i seguenti valori:

• Nessuno o Descrizione se il campo della riga è di tipo alfanumerico. Il campo che utilizza il valore Descrizione sarà utilizzato come titolo del grafico. Attenzione, solo una riga del riquadro può assumere questo valore, se è già presente su una riga, occorrerà prima modificare il valore della riga che ha il valore Descrizioneper ridargli il valore Nessuno prima di poter assegnare questo valore ad un'altra riga del riquadro
• Nessuno, Valoreo Defaultse il campo della riga è di tipo numerico. La regola à la seguente:
• Nessuno significa che il campo non verrà mai presentato sul grafico.
• Se il grafico definito nell'ultimo folder permette di far apparire più serie, tutte le serie che corrispondono ai campi definiti come Default saranno visualizzate (lo saranno tutte se nessuna è posizionata in avanti).
• Se il grafico definito nell'ultimo folder permette di far apparire solo una serie, la colonna che corrisponde al primo campo definito Default sarà visualizzata (lo sarà la prima se nessuna è posizionata in avanti).

• Rappresentazione (campo REP)

Questo campo può essere inserito solo se:

• il modo di rappresentazione scelto nella testata non è Carattere.
• sui campi numerici di cui si è deciso di visualizzare il valore.

Permette di gestire le combinazioni dei grafici se il tipo di grafico definito nei parametri grafici permette di far apparire più serie indipendenti di tipo differente (è ignorato negli altri casi). In pratica, le combinazioni utilizzabili sono le seguenti:

• Tipo = Multigrafico, Grafico di default=Linee, Rappresentazione=Multi
• Tipo = Multigrafico, Grafico di default=Barre, Rappresentazione=Multi

La regola à allora la seguente:

• Default significa che la rappresentazione grafica della serie corrisponde al grafico di default dell'ultimo folder (Barre, o Lineenei casi che ci interessano).
• Barra o Linea permette di forzare il modo di presentazione corrispondente alla serie in questione.

• Valori di default (inizio) (campo VALDEB)

Si inserisce qui il valore del parametro, sotto forma di una espressione calcolata che fa intervenire delle variabili collegate al contesto di lancio. Se il parametro è un intervallo di inizio/fine, si inseriscono due valori.

• Valori di default (fine) (campo VALFIN)

• Numero righe (campo NBRLIG)

• 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.

• 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.

• campo IMAG

Immagine esplicativa delle informazioni inserite in precedenza.