{"id":26027,"date":"2023-03-06T12:25:35","date_gmt":"2023-03-06T11:25:35","guid":{"rendered":"http:\/\/help.qualiware.it\/qw-help\/?p=26027"},"modified":"2023-08-23T08:29:29","modified_gmt":"2023-08-23T06:29:29","slug":"qw_dashboard_designer","status":"publish","type":"post","link":"https:\/\/help.qualiware.it\/qw-help\/qw_dashboard_designer\/","title":{"rendered":"Dashboard Designer"},"content":{"rendered":"

La funzione Dashboard Designer<\/strong> consente di creare e modificare le “dashboard”, che consistono in visualizzazioni grafiche costruite a partire dai dati presenti nel database di QualiWare.<\/span><\/p>\n

La scheda sotto riportata consente di creare una nuova dashboard, sia da zero che importandone una esistente, di modificarla e anche di visualizzare ci\u00f2 che vedr\u00e0 l’utente.<\/p>\n

\"Elenco<\/a><\/p>\n

Le dashboard possono essere sia collegate ad un pulsante del menu della versione desktop o dell’app, sia inserite come slide all’interno della “slideshow dashboard” visualizzata nella home page di QualiWare e configurabile come descritto qui<\/a>.<\/p>\n

Una dashboard pu\u00f2 utilizzare sia il database di QualiWare, che eventuali database esterni che possono essere definiti utilizzando il pulsante “Origine dati”.<\/p>\n

Una guida completa al Dashboard Designer \u00e8 disponibile qui<\/a>. Di seguito riportiamo le indicazioni principale per la creazione del collegamento con i dati da visualizzare.<\/p>\n

Creazione delle query in una dashboard<\/strong><\/h3>\n

Una dashboard pu\u00f2 essere composta da diversi riquadri (card) ognuno dei quali presenta un grafico o una griglia basati sui dati restituiti da una query. All’interno di una query possono, quindi, essere definite pi\u00f9 query, con, eventualmente, dei parametri che vengono richiesti all’utente al momento dell’esecuzione della dashboard.<\/p>\n

Le query si definiscono dalla funzione “Origine dati” del menu.<\/p>\n

\"\"<\/a><\/p>\n

\"\"<\/a><\/p>\n

Per aggiungere una query, selezionare l’origine dati “QualiWare”, o una delle altre origini dati definite, e premere poi “Aggiungi Query”.<\/p>\n

\"\"<\/a><\/p>\n

\u00c8 possibile sia inserire manualmente una query, sia crearla attraverso il “Query Builder” premendo sul link “Crea Query”. 
\nNOTA: se si inserisce la query manualmente, non \u00e8 poi possibile modificarla con il Query Builder.<\/p>\n

Parametri nelle query e nella dashboard<\/strong><\/h3>\n

Eventuali parametri dovranno essere inseriti nella query definendoli con un nome a piacere preceduto dal carattere “@”. In pratica \u00e8 la stessa modalit\u00e0 utilizzata nell’SQL Query Designer, con la differenza che \u00e8 necessario far precedere il nome del parametro dal carattere “@” anzich\u00e8 “:”. <\/p>\n

Premendo il pulsante “Prossimo” nella scheda di definizione della query si acceder\u00e0 alla scheda di definizione dei parametri presenti nella query stessa. <\/p>\n

\"\"<\/a><\/p>\n

 <\/p>\n

In questa scheda, si dovranno inserire tutti i parametri utilizzati nella query, premendo il tasto “Aggiungi”. Per ognuno dovr\u00e0 essere ripetuto il nome utilizzato, specificando “Espressione” nel campo “Tipo”, e poi, tramite l’editor di espressioni che si attiva con il pulsante “…”, collegarlo al parametro della dashboard, cosa che si pu\u00f2 fare anche inserendo manualmente nel campo “Valore” il nome di quest’ultimo preceduto dal carattere “?”.<\/p>\n

I parametri della dashboard, che l’utente potr\u00e0 modificare, si possono definire dal menu “Parametri” della dashboard. Il sistema inserisce automaticamente un parametro denominato “USERCODE” che \u00e8 invisibile all’utente finale, e conterr\u00e0 automaticamente il codice dell’utente connesso.<\/p>\n

\"\"<\/a><\/p>\n

I parametri definiti a livello di dashboard possono essere liberamente riutilizzati in tutte le query inserite. Ovviamente non \u00e8 possibile prevedere in una query un parametro che non abbia alcuna corrispondenza con uno dei parametri definiti a livello di dashboard.<\/p>\n

Parametri a scelta multipla
\n<\/strong><\/h3>\n

Nelle dashboard \u00e8 possibile definire parametri che consentono la seleziona multipla. Per poterli collegare alle query \u00e8 indispensabile procedere come segue:
\n1) usare la funzione “Join” nel collegamento fra il parametro della query e quello della dashboard, come illustrato nella figura seguente:<\/p>\n

\"\"<\/a><\/p>\n

La funzione “Join” trasforma l’array dei parametri selezionati in una stringa con i valori separati dalla stringa specificata come secondo argomento.<\/p>\n

2) nella query, usare la funzione di STRING_SPLIT per separare i valori inseriti, e utilizzarli per il filtro, come mostrato nella figura seguente:<\/p>\n

\"\"<\/a><\/p>\n

La funzione STRING_SPLIT \u00e8 disponibile su SQL Server versione 2016 o successiva, con un livello di compatibilit\u00e0 130 o superiore.<\/p>\n

Per ulteriori informazioni sul passaggio dei parametri alle query vedere qui<\/a>.<\/p>\n

NOTA<\/strong>
\nIl pannello di scelta dei valori dei parametri non viene automaticamente mostrato all’utente all’apertura della dashboard. \u00c8 quindi necessario prevedere per ogni parametro un valore di default, che l’utente pu\u00f2 cambiare premendo il pulsante in alto a destra.<\/p>\n

\u00c8 possibile esportare ogni riquadro, e ispezionarne i dati, utilizzando i pulsanti che appaiono passandoci sopra il mouse.<\/p>\n

\"\"<\/a><\/p>\n

\u00c8 anche possibile assegnare ai parametri della query un valore di default che tenga conto del fatto che l’utente non abbia inserito manualmente i valori dei parametri nell’apposito pannello. \u00c8 infatti possibile lasciare vuoto il valore predefinito di un parametro, attivando la casella “Ammetti Null” del parametro stesso, e assegnare al parametro della query il valore tramite una formula come la seguente:<\/p>\n

iif(isnull(?DA_DATA),AddYears(Today(),-1),?DA_DATA)<\/pre>\n
In questo caso, se il parametro DA_DATA viene lasciato vuoto (come \u00e8 alla prima apertura della dashboard), viene di default assegnato ad una data di un anno precedente quella corrente.<\/p>\n
Filtri dei dati nella dashboard<\/strong><\/h3>\n
\u00c8 possibile prevedere dei filtri direttamente all’interno della dashboard, in appositi riquadri. In quel caso, la query potr\u00e0 anche non contenere parametri.<\/p>\n
\"\"<\/a><\/p>\n
Utilizzo dei componenti “Gantt” e “Hierarchical Tree View”<\/strong><\/h3>\n
La dashboard consente l’utilizzo di due componenti particolarmente interessanti, che si trovano nella parte “Articoli Personalizzati” della palette dei controlli sulla sinistra. Si tratta dei componenti “Gantt” e “Hierarchical Tree View” che consentono rispettivamente di visualizzare un diagramma di Gantt e una rappresentazione gerarchica ad albero.<\/p>\n
Essendo entrambe rappresentazioni gerarchiche, la query che viene utilizzata per fornire i dati deve contenere un campo per restituire sia un campo che rappresenta la chiave univoca del record, sia un campo contiene il valore del campo chiave del record “padre” del record stesso. Essi vanno associati rispettivamente agli elementi “ID” e “PARENT ID” del componente.<\/p>\n
Affinch\u00e8 i dati vengano visualizzati componenti, \u00e8 di fondamentale importanza assegnare correttamente “ID” e “PARENT ID” dei record di primo livello, nel seguente modo:<\/p>\n