¶ Guida al Modulo Query - (MD)
¶ Obiettivo della guida
L'obiettivo principale di questa guida sarà quello di mostrare come visualizzare
determinati dati presenti in una particolare tabella - dati che verranno scelti di
volta in volta - utilizzando le query. Verranno inoltre spiegate le varie
funzionalità proprie del modulo Query.
¶ Breve presentazione della tabella AngRes (Risorse)
La tabella di riferimento per l'estrapolazione dei dati sarà quella delle Risorse,
AngRes. Le risorse presenti nella tabella AngRes sono, per questa guida, le seguenti:
- Mario Rossi
- Guido Verdi
- Paolo Bianchi
- Pressa 1
La visualizzazione standard della tabella AngRes è questa:
| Cod. Ris. | Desc. Ris. |
|---|---|
| MR | Mario Rossi |
| GV | Guido Verdi |
| PB | Paolo Bianchi |
| PR1 | Pressa 1 |
La query standard che sta dietro a questa tabella è StdAngRes, rintracciabile
all'interno della lista query che viene visualizzata come schermata iniziale del
modulo Query. Per poter modificare questa query, dovremo crearne una nuova versione.
¶ Come creare un nuovo template e una nuova versione di query
¶ Come creare un nuovo template
Una query template è una query di base, non modificabile. Tutte le versioni che le
succederanno avranno come minimo il contenuto della stessa template. Per creare un
nuovo template di query, entrare nel modulo Query e cliccare il pulsante
Nuovo template posizionato in alto sopra la barra delle etichette. Si aprirà un modal.
¶ Il modal Nuovo template di query
- Codice query — il codice che daremo alla query template
- Descrizione query — il nome che daremo alla query template
- Da tabella — la tabella di partenza della query template
- Applicativa — le query applicative sono query già presenti in installazione,
già utilizzate dal sistema all'interno del software. Questo flag è da lasciare a
falsedall'utente; sarà il sistemista o lo sviluppatore che, per personalizzare
il software, interverrà settandolo atrue.
¶ Come creare una nuova versione di una query
All'interno del modulo Query, cercare tramite il bottone di ricerca la query standard
StdAngRes, selezionarla, e aggiungere tramite il pulsante in alto Nuova Versione
una nuova versione di questa query, denominando il campo Descrizione Query Risorse2.
Impostando il flag del campo Default a true la nuova versione sarà quella
predefinita e sarà quindi possibile modificare la query a seconda dei dati che si
vorranno visualizzare.
NB: Risorse2 non è visibile all'interno della lista delle query standard; essa
è la nuova versione della query standard StdAngRes. La si potrà recuperare
all'interno della lista delle versioni di questa query.
¶ Sezione "Query"
All'interno del modulo Query, selezionata la query di interesse, si aprirà una
schermata divisa per sezioni, la prima delle quali sarà la sezione Query.
All'interno di essa abbiamo più voci:
- Codice query — non modificabile, è il codice della query standard
- Descrizione query — da modificare per evitare di confondersi con la versione
template; nell'esempio di questa guida la nuova versione è stata denominata Risorse2 - Applicativa — cfr. Il modal Nuovo template di query
- Default — da settare a
truese si vuole utilizzare la nuova versione della
query. Settata afalse, verrà fatta lavorare la query standard.
¶ Sezione "Tabelle collegate"
¶ Il modal Modifica tabella di partenza e collegamenti
All'interno di questa sezione, cliccando la tabella collegata AngRes comparirà
il modal Modifica tabella di partenza e collegamenti. Vediamo le voci e i flag
che contiene:
- Da tabella — voce non modificabile, mostra la tabella di partenza
- Alias di partenza — l'alias serve a distinguere all'interno della query le
tabelle utilizzate più volte - Completa — settando a
true, verranno aggiunti alle Colonne visualizzabili
tutti i campi non obbligatori presenti nel modulo di inserimento delle risorse - Campi personalizzati — settato a
true, permette di visualizzare i campi
creati dall'utente nel modulo di inserimento dati dell'entità
¶ Le Tabelle dettaglio e le Tabelle dipendenti
Due tabelle possono essere legate da relazioni di dipendenza o di dettaglio:
- Diremo che la tabella A dipende da B se la definizione di A fa riferimento
alla definizione di B - Viceversa, diremo che B è dettaglio di A
Esempio pratico:
- Tipi Risorse → una risorsa può avere 1 tipo → tabella dettaglio
- Timbrature → una risorsa può avere N timbrature → tabella dipendente
¶ Cardinalità nelle tabelle dettaglio e nelle tabelle dipendenti
Il flag Solo Se Esiste (SSE) fa da filtro alla visualizzazione:
- SSE =
true→ vengono mostrati solo i record che hanno il dato collegato valorizzato - SSE =
false→ vengono mostrati tutti i record, anche quelli senza il dato collegato
Esempio — collegamento AngRes + AngPrjCal (Calendari):
SSE = true
| Desc. Ris. | Desc. Calend. |
|---|---|
| Mario Rossi | Calendario Mario Rossi |
| Guido Verdi | Calendario Guido Verdi |
SSE = false
| Desc. Ris. | Desc. Calend. |
|---|---|
| Mario Rossi | Calendario Mario Rossi |
| Guido Verdi | Calendario Guido Verdi |
| Paolo Bianchi | |
| Pressa 1 |
¶ Sezione "Colonne"
Questa sezione permette di scegliere quali colonne visualizzare e in quale ordine.
Dando Modifica, compariranno due sotto-sezioni:
- Colonne Visualizzate — le colonne attualmente mostrate
- Colonne Visualizzabili — le colonne disponibili da aggiungere
Esempio con Descrizione Risorsa e Codice Risorsa:
| Desc. Ris. | Cod. Ris. |
|---|---|
| Mario Rossi | MR |
| Guido Verdi | GV |
| Paolo Bianchi | PB |
| Pressa 1 | PR1 |
¶ Le etichette della sezione Colonne
| Etichetta | Descrizione |
|---|---|
| Alias | Riferimento alla tabella di provenienza della colonna |
| Nome colonna | Codice della colonna |
| Descrizione breve | Nome stringato della colonna |
| Descrizione estesa | Nome completo della colonna |
| Tipo colonna | A = Uid, B = Vero/falso, I = Numero intero, S = Testo, T = Data/ora |
| Ricerca fulltext | Abilita la ricerca testuale (solo per colonne di tipo S) |
¶ Sezione "Ordinamenti"
Questa sezione permette di modificare l'ordine di visualizzazione dei record.
Compariranno due sotto-sezioni:
- Ordinamenti applicati
- Ordinamenti applicabili
Esempio con ordinamento per Descrizione Risorsa (Crescente = true):
| Desc. Ris. | Cod. Ris. |
|---|---|
| Guido Verdi | GV |
| Mario Rossi | MR |
| Paolo Bianchi | PB |
| Pressa 1 | PR1 |
¶ Gestione degli omonimi
In caso di omonimi, aggiungendo anche il Codice Risorsa agli ordinamenti applicati
con Crescente = false:
| Desc. Ris. | Cod. Ris. |
|---|---|
| Guido Verdi | GV1 |
| Guido Verdi | GV |
| Mario Rossi | MR |
| Paolo Bianchi | PB |
| Pressa 1 | PR1 |
Flag Crescente:
true= ordine A→Z,false= ordine Z→A
¶ Come visualizzare il campo Codice Risorsa
Entrare nel modulo Query, selezionare la query StdAngRes e la nuova versione
Risorse2. Cliccare Modifica, spostarsi nella sezione Colonne visualizzate,
selezionare Descrizione Risorsa (ResDsc) e cliccare Rimuovi. La tabella
risultante sarà:
| C. Ris. |
|---|
| MR |
| GV |
| PB |
| PR1 |
| GV1 |
¶ Come visualizzare il Tipo Risorsa
I Tipi Risorse disponibili sono: operaio, ufficio, materiali.
Per visualizzarli, collegare la tabella AngRes alla tabella AngResTyp nella
sezione Tabelle collegate. Il risultato sarà:
| Desc. Ris. | Desc. Tip. Ris. |
|---|---|
| Mario Rossi | Ufficio |
| Guido Verdi | Operaio |
| Paolo Bianchi | Ufficio |
| Pressa 1 | Materiali |
| Guido Verdi | Ufficio |
¶ Come visualizzare il Macro Tipo Risorsa
Collegare in sequenza:
- AngRes → AngResTyp (tabella dettaglio)
- AngResTyp → AngResMacTyp (tabella dettaglio)
Il risultato sarà:
| Desc. Ris. | Desc. Tip. Ris. | Cod. Mac. Typ. |
|---|---|---|
| Mario Rossi | Ufficio | H |
| Guido Verdi | Operaio | H |
| Paolo Bianchi | Ufficio | H |
| Pressa 1 | Materiali | M |
| Guido Verdi | Ufficio | H |
¶ Anteprima query
Selezionare la query di interesse e cliccare il pulsante Anteprima — si aprirà
un modal con i dati risultanti dalla query.
¶ Esporta ed importa query
¶ Esporta query
Selezionare la query di interesse e cliccare Esporta. Il modal permette di scegliere:
- Tutta la famiglia — esporta tutte le versioni della query
- Solo il template — esporta solo la query di base
- Colonne selezionate — se
true, esporta anche la sezione Colonne - Ordinamenti righe — se
true, esporta anche la sezione Ordinamenti - Pulsante Esporta — produce un file
.qrysul proprio PC
¶ Importa query
Dal modulo Query cliccare Importa. Il wizard si articola in due passi:
- Punto 1 — caricare o trascinare il file
.qryda importare - Punto 2 — scegliere le opzioni di importazione:
- Tutta la famiglia / Solo il template
- Colonne selezionate / Ordinamenti righe
- Pulsante Importa — importa la query; se esiste già una query con lo stesso
codice, l'importazione terminerà con un errore
¶ Come inserire i calendari ed associarli alle risorse
- Da JPM, entrare nel modulo Calendari
- Cliccare Nuovo e inserire il Codice Calendario (es.
CMR) e la
Descrizione Calendario (es.CalendarioMarioRossi) - Tornare su Synergy, entrare nel modulo Risorse
- Selezionare la risorsa desiderata e cliccare Modifica
- Nella sezione Schedulazione, associare il calendario appena creato
- Ripetere per ogni risorsa
¶ Come associare i gruppi alle risorse
- Entrare nel modulo Gruppi e cliccare Nuovo gruppo utente
- Impostare i parametri (es. Codice Gruppo:
UffTec, Descrizione:Ufficio Tecnico) - Impostare il flag Pubblico a
true - Nella sezione Membri, cliccare Aggiungi Risorse e selezionare la risorsa
- Tornare nel modulo Query, cercare StdAngRes → Risorse2
- Nella sezione Tabelle collegate, selezionare la tabella AngResGrp
(Associazione risorse gruppi)
SSE = false
| Desc. Ris. | Desc. Grp. |
|---|---|
| Guido Verdi | |
| Guido Verdi | |
| Mario Rossi | Ufficio Tecnico |
| Paolo Bianchi | |
| Pressa 1 |
SSE = true
| Desc. Ris. | Desc. Grp. |
|---|---|
| Mario Rossi | Ufficio Tecnico |
La tabella AngResGrp è necessaria perché Risorse e Gruppi non hanno un
riferimento diretto l'una all'altra. AngResGrp funge da tabella di associazione,
permettendo di legare più risorse a più gruppi.