Consultazione SQL

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

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

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

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

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

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

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

• Gruppo (campo GRP)

Permette di disporre di un criterio di classificazione delle consultazioni.

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

• campo TEXTE

Permette di definire la consultazione stessa sotto un formato SQL classico comprensibile dal database.

Alcune osservazioni riguardo questa consultazione:

• Ogni query Select anche complessa può essere scritta qui, a condizione che restituisca un numero di campo inferiore al massimo ammesso.
• occorre ricordarsi che il campo NOMCHAMP(indice), gestito nella tabella NOMTABLE, è definito nel database come il campo NOMCHAMP_indice nella tabella NOMTABLE, indice che vale 0, 1, 2… N-1, dove N è la dimensione del campo.

Così per esempio si potrà scrivere:

Select LOGIN_0, CHEF_2 From AUTILIS
Where USR_0 like %1%
Order by CREDAT_0

• In una query di questo tipo, è possibile definire dei parametri tramite la sintassi %N%, che si riferisce al parametro numero N definito nel riquadro dei parametri (%1% nell'esempio precedente). I parametri saranno inseriti tramite il bottone durante l'esecuzione della richiesta.

• Descrizione (campo COLTIT)

• Tipo (campo COLTYP)

Questo tipo di dati permette di precisare come deve essere fatta la presentazione del dato. In caso di un menù locale, si specificherà il numero del 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.

• Menù (campo COLNUM)

Permette di definire un numero di menù locale da utilizzare per presentare il valore numerico della colonna restituita dalla consultazione.

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

• Descrizione (campo PARTIT)

Se il campo è indicato, un parametro la cui descrizione corrisponde a questo campo potrà essere inserito prima dell'esecuzione della consultazione (tramite il bottone ).

Questo parametro potrà essere utilizzato nel corpo della consultazione tramite la sintassi %N%, dove N rappresenta il numero della riga corrispondente nel riquadro dei parametri.

• Tipo (campo PARTYP)

Questo tipo di dati permette di facilitare l'inserimento del parametro corrispondente. Effettivamente, se un tipo viene definito:

• i controlli del formato sono attuati
• Se il tipo di dati utilizzato è legato ad un oggetto, è possibile utilizzare la finestra di selezione corrispondente.

• Menù (campo PARNUM)

Permette di definire un numero di menù locale da utilizzare per inserire il valore del parametro.

• Valore di default (campo VALDEB)

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