.. include:: /directives.rst

.. _dashboard:

Dashboard
=========
.. container:: authorizations

   :ref:`Autorizzazioni <authorizations-and-permissions>`: vedere i :ref:`singoli widget <widgets>`

La dashboard (:numref:`figure-dashboard`), suddivisa in righe e colonne, consente di attivare delle
viste, o widget, che possono rappresentare dei dati o semplicemente raggruppare delle selezioni
personalizzate.

Per accedere a questo strumento cliccare sull'icona |fa-dashboard| nel
:ref:`menu laterale <side-menu>`.

.. _figure-dashboard:
.. figure:: /img/sidemenu/dashboard/dashboard-widgets.png
   :alt: Dashboard
   :align: center
   :class: with-border
   :width: 100%

   Dashboard

.. _widgets:

Widgets
-------
I widget permettono di :ref:`visualizzare dati temporali <temporal-data-widgets>`
oppure permettono di di :ref:`salvare delle selezioni <custom-configuration-widgets>`.

I widget si presenatano come delle piccole finestre (:numref:`figure-widget`).

Sulla parte sinistra abbiamo una zona di presa che serve per
:ref:`spostare il widget <move-widget>` e il titolo, mentre sulla parte destra abbiamo dei pulsanti che permettono le seguenti azioni:

- |fa-reload| ricarica i dati dei widget che visualizzano dati temporali
- |fa-settings| permnette di cambiare le impostazioni del widget
- |fa-close| rimuove il widget dalla dashboard

Potrebbero esserci altri pulsanti a dipendenza del tipo di widget.

Nell'angolo in basso a destra, dove è presente l'icona |fa-resize|,
tendo premuto il tasto sinistro del mouse |mouse-left-click| e trascinadolo
si può ridimensionare il widget.

.. _figure-widget:
.. figure:: /img/sidemenu/dashboard/widget.png
   :alt: Widget
   :align: center

   Widget

.. note::
   I widget e la loro disposizione sono salvati in un database centralizzato.
   Questo significa che l'ultima disposizione data alla dashboard verrà
   ripresentata indipendentemente da che browser, o postazione di lavoro, venga usato.

.. _add-widget:

`Aggiungere un widget <add-widget>`_
------------------------------------
Per aggiungere un widget cliccare il pulsante :btn:`Aggiungi widget` (:numref:`figure-dashboard`).
Facendo questo si aprirà una finestra (:numref:`figure-add-widget`) dove si può scegliere
il tipo di widget dal menu a tendina :combobox:`Tipologia`, la dimensione del widget dal campo
:text:`Dimensione` e le impostazioni che cambiano a dipendenza di quale tipo si
è scelto (riferiersi alla sezione del relativo widget). Quando si è scelto la configurazione
voluta cliccare sul pulsante :btn:`Aggiungi`.

.. _figure-add-widget:
.. figure:: /img/sidemenu/dashboard/add-widget.png
   :alt: Aggiungi un widget
   :align: center

   Aggiungi un widget

.. _move-widget:

`Spostare un widget <move-widget>`_
-----------------------------------
Nella barra del titolo sulla sinistra abbiamo una zona di presa |fa-grip| (:numref:`figure-widget`) che
permette si spostare il widget sulla griglia della dashboard, questo può essere fatto tenendo premuto il
tasto sinistro del mouse |mouse-left-click| e trascinadolo nel punto voluto.

.. _temporal-data-widgets:

`Widget visualizzazione dati <temporal-data-widgets>`_
------------------------------------------------------
Questi tipi di widget permettono di avere una supervisione dei dati temporali tramite la visualizzazione
di :ref:`allarmi <alarms-widget>`, :ref:`manutenzioni <maintenances-widget>`, :ref:`grafico <chart-widget>`
oppure con una :ref:`panoramica dei dati <overview-widget>` che sono stati inseriti nella banca dati. Si
possono avere più widget dello stesso tipo (p.es. si possono avere più widget con grafico per
diversi parametri).

.. _overview-widget:

`Panoramica dati <overview-widget>`_
************************************
.. container:: authorizations

   :ref:`Autorizzazioni <authorizations-and-permissions>`: ``Dati temporali » analisi``

Il widget della panoramica dati (:numref:`figure-widget-overview`) permette di avere una supervisione di
quanti dati sono stati inseriti nella banca dati durante la giornata corrente.

Ogni barra visualizzata corrisponde a una specifico :ref:`punto di misura <measurement-point-definition>`
e :ref:`parametro <parameter-definition>`. La barra è divisa in tre sezioni dove vengono visualizzati:

.. raw:: html

   <div style="position: relative; width: 400px; padding-bottom: 20px;">
   <div style="position: relative; width: 400px;">
      <div>
         <div styel="position: relative; width: 100%; height: 6px;">
            <div style="background: #f2f2f2; width: 100%; position: absolute; left:0; bottom: 1px; height: 5px;"></div>
            <div style="background: #d0d0d0; width: 60%; position: absolute; left:0; bottom: 1px; height: 5px;"></div>
            <div style="background-color: #e84429; width: 20%; position: absolute; left:0; bottom: 1px; height: 5px;"></div>
         </div>
      </div>
   </div>
   <div style="position: relative; width: 400px;">
      <div style="padding-bottom: 15px;">
         <div styel="position: relative; width: 100%; height: 6px;">
            <div style="background: #f2f2f2; width: 100%; position: absolute; left:0; bottom: 1px; height: 5px;"></div>
            <div style="background: #d0d0d0; width: 60%; position: absolute; left:0; bottom: 1px; height: 5px;"></div>
            <div style="background-color: #ffce2b; width: 35%; position: absolute; left:0; bottom: 1px; height: 5px;"></div>
         </div>
      </div>
   </div>
   <div style="position: relative; width: 400px;">
      <div style="padding-bottom: 15px;">
         <div styel="position: relative; width: 100%; height: 6px;">
            <div style="background: #f2f2f2; width: 100%; position: absolute; left:0; bottom: 1px; height: 5px;"></div>
            <div style="background: #d0d0d0; width: 60%; position: absolute; left:0; bottom: 1px; height: 5px;"></div>
            <div style="background-color: #009c30; width: 50%; position: absolute; left:0; bottom: 1px; height: 5px;"></div>
         </div>
      </div>
   </div>
   </div>

- in grigio chiaro i dati previsti durante la giornata in percentuale (quindi sempre il 100%)
- in grigio scuro i dati previsti fino a questo momento
- a colori i dati che effettivamente sono stati caricari nel sistema, dove il colore indica:
   - :raw-html:`<font color="#e84429">rosso</font>`: meno del 50% di dati importati rispetto a quanto previsto al momento attuale (barra grigio scura)
   - :raw-html:`<font color="#ffce2b">giallo</font>`: tra il 50% e il 74% di dati importati rispetto a quanto previsto al momento attuale (barra grigio scura)
   - :raw-html:`<font color="#009c30">verde</font>`: almeno il 75% di dati importati rispetto a quanto previsto al momento attuale (barra grigio scura)

Cliccando sul pulsante |fa-eye| si possono visualizzare le informazioni relative a una barra (località, punto di misura, parametro,...).

Per accedere alle sue impostazioni (:numref:`figure-widget-overview-settings`) cliccare sull'icona
|fa-settings| dove si può scegliere:

- il :ref:`dominio <domain-definition>` dal menu a tendina :combobox:`Dominio`
- la :ref:`campagna <campaign-definition>` dal menu a tendina :combobox:`Campagna` (lasciare in bianco per riferirsi a tutte le campagne)

Per rendere effettive le impostazioni cliccare sul pulsante :btn:`Salva`.

.. _figure-widget-overview:
.. figure:: /img/sidemenu/dashboard/widget-overview.png
   :alt: Widget: panoramica dati
   :align: center

   Widget: panoramica dati

.. _figure-widget-overview-settings:
.. figure:: /img/sidemenu/dashboard/widget-overview-settings.png
   :alt: Widget: panoramica dati configurazione
   :align: center

   Widget: panoramica dati configurazione

.. tip::
   Se si mantiene il mouse su una barra per qualche momento verranno visualizzati
   i dati numerici e in percentuale dei dati inseriti.


.. _alarms-widget:

`Allarmi <alarms-widget>`_
**************************
.. container:: authorizations

   :ref:`Autorizzazioni <authorizations-and-permissions>`: ``Dati temporali » manutenzioni e allarmi``

Il widget degli allarmi (:numref:`figure-widget-alarms`) permette di avere una supervisione degli
allarmi avvenuti in un dato periodo di tempo.

Per accedere alle sue impostazioni (:numref:`figure-widget-alarms-settings`) cliccare sull'icona
|fa-settings| dove si può scegliere:

- un periodo tra quelli preimpostati dal menu a tendina :combobox:`Periodo`
- il :ref:`dominio <domain-definition>` dal menu a tendina :combobox:`Dominio` (lasciare in bianco per riferirsi a tutti i domini)
- la :ref:`campagna <campaign-definition>` dal menu a tendina :combobox:`Campagna` (lasciare in bianco per riferirsi a tutte le campagne)

Per rendere effettive le impostazioni cliccare sul pulsante :btn:`Salva`.

.. _figure-widget-alarms:
.. figure:: /img/sidemenu/dashboard/widget-alarms.png
   :alt: Widget: allarmi
   :align: center

   Widget: allarmi

.. _figure-widget-alarms-settings:
.. figure:: /img/sidemenu/dashboard/widget-alarms-settings.png
   :alt: Widget: allarmi configurazione
   :align: center

   Widget: allarmi configurazione

.. tip::
   Nella lista dei allarmi è possibile :ref:`copiare le righe selezionate <grid-and-list-copy>`.

.. _maintenances-widget:

`Manutenzione <maintenances-widget>`_
*************************************
.. container:: authorizations

   :ref:`Autorizzazioni <authorizations-and-permissions>`: ``Dati temporali » manutenzioni e allarmi``

Il widget delle manutenzioni (:numref:`figure-widget-maintenances`) permette di avere una supervisione di
interventi avvenuti in un dato periodo di tempo.

Per accedere alle sue impostazioni (:numref:`figure-widget-maintenances-settings`) cliccare sull'icona
|fa-settings| dove si può scegliere:

- un periodo tra quelli preimpostati dal menu a tendina :combobox:`Periodo`
- il :ref:`dominio <domain-definition>` dal menu a tendina :combobox:`Dominio` (lasciare in bianco per riferirsi a tutti i domini)
- la :ref:`campagna <campaign-definition>` dal menu a tendina :combobox:`Campagna` (lasciare in bianco per riferirsi a tutte le campagne)

Per rendere effettive le impostazioni cliccare sul pulsante :btn:`Salva`.

.. _figure-widget-maintenances:
.. figure:: /img/sidemenu/dashboard/widget-maintenances.png
   :alt: Widget: manutenzioni
   :align: center

   Widget: manutenzioni

.. _figure-widget-maintenances-settings:
.. figure:: /img/sidemenu/dashboard/widget-maintenances-settings.png
   :alt: Widget: manutenzioni configurazione
   :align: center

   Widget: manutenzioni configurazione

.. tip::
   Nella lista delle manutenzioni è possibile :ref:`copiare le righe selezionate <grid-and-list-copy>`.

.. _chart-widget:

`Grafico <chart-widget>`_
*************************
.. container:: authorizations

   :ref:`Autorizzazioni <authorizations-and-permissions>`: ``Dati temporali » analisi``

Il widget grafico (:numref:`figure-widget-chart`) permette di avere una supervisone
dei valori di un determinato :ref:`parametro <parameter-definition>` in un dato periodo di tempo.

Per accedere alle sue impostazioni (:numref:`figure-widget-chart-settings`) cliccare sull'icona
|fa-settings| dove si può scegliere:

- un periodo tra quelli preimpostati dal menu a tendina :combobox:`Periodo`
- la :ref:`risoluzione <resolution-definition>` della misura dal menu a tendina :combobox:`Risoluzione`
- il :ref:`dominio <domain-definition>` dal menu a tendina :combobox:`Dominio` (opzionale)
- la :ref:`campagna <campaign-definition>` dal menu a tendina :combobox:`Campagna` (opzionale)
- la :ref:`località <location-definition>` dal menu a tendina :combobox:`Località`
- il :ref:`parametro <parameter-definition>` dal menu a tendina :combobox:`Parametro`
- il :ref:`punto di misura <measurement-point-definition>` dal menu a tendina :combobox:`Punto di misura`

Per rendere effettive le impostazioni cliccare sul pulsante :btn:`Salva`.

.. _figure-widget-chart:
.. figure:: /img/sidemenu/dashboard/widget-chart.png
   :alt: Widget: grafico
   :align: center

   Widget: grafico

.. _figure-widget-chart-settings:
.. figure:: /img/sidemenu/dashboard/widget-chart-settings.png
   :alt: Widget: grafico configurazione
   :align: center

   Widget: grafico configurazione

.. _custom-configuration-widgets:

`Widget di personalizzazione <custom-configuration-widgets>`_
-------------------------------------------------------------
Questi widget permetto di salvare le :ref:`selezioni dei livelli nelle mappe <layers-selection>`,
le :ref:`selezioni del filtro globale <global-filterbar>` oppure le :ref:`selezioni per le analisi dei dati <analysis>`.
Si possono aggiungere più selezione nello stesso widget quindi è possibile avere solo un'istanza per questi
tipi di widget.

.. _custom-profiles-widget:

`Profili personalizzati <custom-profiles-widget>`_
**************************************************
.. container:: authorizations

   :ref:`Autorizzazioni <authorizations-and-permissions>`: ``Dati temporali » analisi``

Il wiget dei profili personalizzati (:numref:`figure-widget-custom-profiles`) permette di impostare dei
profili per il :ref:`filtro globale <global-filterbar>`.
Cliccando sull'icona |fa-arrow-right| di una qualsiasi riga della tabella si attiverà il profilo nel
filtro globale cancellando quello attualmente in uso (si verrà avvisati con un messaggio).

Per aggiungere un nuovo profilo (:numref:`figure-widget-custom-profiles-settings`) cliccare sull'icona
|fa-settings| si dovrà inserire:

- il nome del profilo :text:`Nome`
- uno o più :ref:`domini <domain-definition>` dal menu a tendina :combobox:`Dominio`
- una o più  :ref:`campagne <campaign-definition>` dal menu a tendina :combobox:`Campagna`

Per salvare il profilo appena inserito cliccare sul pulsante :btn:`Aggiungi profilo`.
Questa procedura può essere ripetuta per inserive più profili.
Si può eliminare un profilo cliccando sull'icona |fa-close| nelle tabella che si trova
in fondo.
Per rendere effettive le modifiche cliccare sul pulsante :btn:`Salva`.

.. _figure-widget-custom-profiles:
.. figure:: /img/sidemenu/dashboard/widget-custom-profiles.png
   :alt: Widget: profili personalizzati
   :align: center

   Widget: profili personalizzati

.. _figure-widget-custom-profiles-settings:
.. figure:: /img/sidemenu/dashboard/widget-custom-profiles-settings.png
   :alt: Widget: grafico configurazione
   :align: center

   Widget: profili personalizzati configurazione

.. tip::
   I profili personalizzati possono anche essere aggiunti direttamente dalla
   :ref:`barra dei filtri globali <global-filterbar-other-actions>`.

.. tip::
   Nella lista dei profili personalizzati è possibile :ref:`copiare le righe selezionate <grid-and-list-copy>`.

.. _custom-maps-widget:

`Mappe personalizzate <custom-maps-widget>`_
********************************************
.. container:: authorizations

   :ref:`Autorizzazioni <authorizations-and-permissions>`: ``Dati spaziali``

Il widget delle mappe personalizzate (:numref:`figure-widget-custom-maps`) permette di preimpostare delle
selezioni di livelli da potere usare in :ref:`Mappe <maps>`.
Cliccando sull'icona |fa-arrow-right| di un qualsiasi gruppo di livelli della tabella questi verranno
selezionati nelle schermata :ref:`Mappe <maps>`. cancellando quelli attualmente in uso.

Per aggiungere dei nuovi livelli (:numref:`figure-widget-custom-maps-settings`) cliccare sull'icona
|fa-settings| e inserire:

- la mappa di base da visualizzare dal menu a tendina :combobox:`Mappa di base`
- lo zoom e il centro dal menu a tendina :combobox:`Zoom/Centro`
- il nome del gruppo nel campo :text:`Nome` (si possono raggruppare più livelli in un unico gruppo)
- il :ref:`geocatalogo  <geocatalog>` dal menu a tendina :combobox:`Geocatalogo`
- il :ref:`livello <layer-definition>` dal menu a tendina :combobox:`Livello`

Per salvare il livello appena inserito cliccare sul pulsante :btn:`Aggiungi livello`.
Questa procedura può essere ripetuta per inserive più livelli.
Si può eliminare un livello, o tutto il gruppo, cliccando sull'icona |fa-close| nelle tabella che si trova
in fondo.
Per rendere effettive le modifiche cliccare sul pulsante :btn:`Salva`.

.. _figure-widget-custom-maps:
.. figure:: /img/sidemenu/dashboard/widget-custom-maps.png
   :alt: Widget: mappe personalizzate
   :align: center

   Widget: mappe personalizzate

.. _figure-widget-custom-maps-settings:
.. figure:: /img/sidemenu/dashboard/widget-custom-maps-settings.png
   :alt: Widget: mappe personalizzate configurazione
   :align: center

   Widget: mappe personalizzate configurazione

.. tip::
   Le mappe personalizzate possono anche essere aggiunte direttamente dalla
   :ref:`selezione dei livelli in Mappe <add-selected-layers-to-dashboard>`.

.. tip::
   Nella lista delle mappe personalizzate è possibile :ref:`copiare le righe selezionate <grid-and-list-copy>`.

.. _custom-selection-widget:

`Selezione dati personalizzate <custom-selection-widget>`_
**********************************************************
.. container:: authorizations

   :ref:`Autorizzazioni <authorizations-and-permissions>`: ``Dati spaziali``

Il widget delle selezioni dati personalizzate (:numref:`figure-widget-custom-selections`) permette di preimpostare delle
selezioni di dati da potere usare in :ref:`Analisi <analysis>`.
Cliccando sull'icona |fa-arrow-right| di un qualsiasi gruppo di selezioni della tabella questi verranno
selezionati nelle schermata :ref:`Analisi <analysis>` cancellando quelli attualmente in uso.

Per aggiungere dei nuove selezioni di dati (:numref:`figure-widget-custom-selections-settings`) cliccare sull'icona
|fa-settings| e inserire:

- il nome del gruppo nel campo :text:`Nome gruppo` (si possono raggruppare più selezioni di dati in un unico gruppo)
- la :ref:`risoluzione <resolution-definition>` della misura dal menu a tendina :combobox:`Risoluzione`
- il :ref:`dominio <domain-definition>` dal menu a tendina :combobox:`Dominio` (opzionale)
- la :ref:`campagna <campaign-definition>` dal menu a tendina :combobox:`Campagna` (opzionale)
- la :ref:`località <location-definition>` dal menu a tendina :combobox:`Località`
- il :ref:`parametro <parameter-definition>` dal menu a tendina :combobox:`Parametro`
- il :ref:`punto di misura <measurement-point-definition>` dal menu a tendina :combobox:`Punto di misura`

Per salvare la selezione appena inserita cliccare sul pulsante :btn:`Aggiungi selezione`.
Questa procedura può essere ripetuta per inserive più selezioni di dati.
Si può eliminare una selezione, o tutto il gruppo, cliccando sull'icona |fa-close| nelle tabella che si trova
in fondo.
Per rendere effettive le modifiche cliccare sul pulsante :btn:`Salva`.

.. _figure-widget-custom-selections:
.. figure:: /img/sidemenu/dashboard/widget-custom-selections.png
   :alt: Widget: selezioni personalizzate
   :align: center

   Widget: selezioni personalizzate

.. _figure-widget-custom-selections-settings:
.. figure:: /img/sidemenu/dashboard/widget-custom-selections-settings.png
   :alt: Widget: selezioni personalizzate configurazione
   :align: center

   Widget: selezioni personalizzate configurazione

.. tip::
   Le selezioni personalizzate possono anche essere aggiunte direttamente dalla
   :ref:`Selezione dati <selection-load>`.

.. tip::
   Nella lista delle selezioni personalizzate è possibile :ref:`copiare le righe selezionate <grid-and-list-copy>`.