.. include:: /directives.rst .. _user-menu: `Menu utente `_ ========================== Cliccando sul menu utente |fa-user|, vengono visualizzate in alto le informazioni base dell'utente (:numref:`figure-user-menu`) mettendo inoltre a disposizione le azioni di: - |fa-feedback| :ref:`Invia un commento ` - |fa-settings| :ref:`Impostazioni ` - |fa-administration| :ref:`Amministrazione ` - |fa-logout| :ref:`Disconnetti ` .. _figure-user-menu: .. figure:: /img/headerbar/user-menu.png :alt: Menu utente :align: center :class: with-border Menu utente .. _send-feedback: `Invia un commento `_ ------------------------------------ Qualsiasi utente ha la possibilià di inviare un commento che riguarda l'applicativo utilizzando l'apposito modulo (:numref:`figure-send-feedback`). È importante selezionare la giusta :combobox:`Area d'interesse` quando si invia un commento. Queste aree sono: - :menuitem:`Dashboard`: tutte le richieste e segnalazioni che riguardano la :ref:`dashboard` - :menuitem:`Mappe`: tutte le richieste e segnalazioni che riguardano la :ref:`maps` - :menuitem:`Metadati`: tutte le richieste e segnalazioni che riguardano i :ref:`metadata` - :menuitem:`Analisi`: tutte le richieste e segnalazioni che riguardano l\':ref:`analysis` - :menuitem:`Controllo di qualità`: tutte le richieste e segnalazioni che riguardano il :ref:`quality-control` - :menuitem:`Rapporti`: tutte le richieste e segnalazioni che riguardano i :ref:`reports` - :menuitem:`Telefonia Mobile`: tutte le richieste e segnalazioni che riguardano il :ref:`rni-cadastre` - :menuitem:`Richiesta di permessi`: tutte le richieste per un cambiamento di :ref:`authorizations-and-permissions` - :menuitem:`Altro`: tutte le richieste e segnalazioni che non rientrano nelle altre aree Ogni richiesta inviata verrà valutata dagli amministratori che faranno avere un riscontro al mittente. .. _figure-send-feedback: .. figure:: /img/headerbar/send-feedback.png :alt: Modulo invia un commento :align: center Modulo invia un commento .. note:: |mandatory-fields| .. warning:: Se si stanno richiedendo permessi più ampi si prega di specificare dettagliatamente a cosa si vuole accedere e il motivo. .. _settings: `Impostazioni `_ -------------------------- L'utente ha la possibilità di cambiare alcune impostazioni dell'applicativo (:numref:`figure-user-settings`). Una volta che si modifica uno di questi campi cliccare sul pulsante :btn:`Salva`. È possibile anche visionare le :ref:`autorizzazioni e permessi ` a cui si ha diritto (:numref:`figure-user-settings-2`). Se necessario si possono richiedere maggiori permessi utilizzare il modulo di :ref:`send-feedback` indicando :menuitem:`Richiesta di permessi` come :combobox:`Area d'interesse`. .. _figure-user-settings: .. figure:: /img/headerbar/user-settings.png :alt: Impostazioni utente - parte 1 :align: center :class: with-border Impostazioni utente - parte 1 .. _figure-user-settings-2: .. figure:: /img/headerbar/user-settings-2.png :alt: Impostazioni utente - parte 2 :align: center :class: with-border Impostazioni utente - parte 2 .. note:: Tutte le impostazioni sono salvate in un database centralizzato. Questo significa che anche se si cambia browser, o postazione di lavoro, le impostazioni saranno quelle settate l'ultima volta. .. warning:: Per applicate i cambiamenti è richiesto di ricaricare la pagina cliccando il pulsante |fa-browser-reload| del proprio browser oppure cliccando il tasto :kbd:`F5`. .. _setting-show-code: `Mostra codici `_ ************************************ Cliccare sul campo :checkbox:`Mostra codici` (:numref:`figure-user-settings`) per abilitare o disabilitare questa impostazione che permette di vedere nelle pagine i codici identificativi dei vari elementi. .. note:: L'impostazione è stata ideata più per gli utenti avanzati e non comporta alcuna restrizione se non selezionata. .. setting-change-language: `Cambia lingua `_ ****************************************** Scegliendo dal menu a tendina :combobox:`Lingua` è possibile impostare la lingua desiderata dell'applicativo. Al momento le lingue possibili sono italiano e inglese. .. setting-change-password: `Modificare la password `_ *************************************************** Si ha la possibilità di cambiare la propria password riempiendo i campi (:numref:`figure-user-settings`): * :text:`Password corrente`: immettere la password attuale, * :text:`Nuova password`: immettere la nuova password desiderata, * :text:`Ridigita la nuova password`: confernare nuovamente la nuova password. Il campo :text:`Nuova password` utilizza un algoritmo che forza l'utente a scegliere una password relativamente robusta, questo viene segnalato con una barra colorata che cambia da rosso (password non accettabile :numref:`figure-field-password-bad`) a giallo (password non abbastanza robusta :numref:`figure-password-not-strong`) a verde (password accettata :numref:`figure-field-password-good`). .. list-table:: :align: center :class: figure-side-by-side no-padding * - .. _figure-field-password-bad: .. figure:: /img/headerbar/field-password-bad.png :alt: Password non accettabile :width: 200 :align: center Password non accettabile - .. _figure-password-not-strong: .. figure:: /img/headerbar/field-password-not-strong.png :alt: Password non robusta :width: 200 :align: center Password non robusta - .. _figure-field-password-good: .. figure:: /img/headerbar/field-password-good.png :alt: Password accettata :width: 200 :align: center Password accettata .. warning:: Se si sta utilizzando un account dell'Amministrazione Cantonale (AC) per accedere a **Palma** non si avrà la possibilità di cambiare password. In questo caso si raccomanda di modificare la propria password passando per i canali ufficiali dell'AC. .. _administration: `Amministrazione `_ ----------------------------------- .. container:: authorizations :ref:`Autorizzazioni `: ``Amministrazione`` Nel pannello di amministrazione si ha la possibilià di gestire: - i :ref:`contatti/account `, - le :ref:`organizzazioni `, - gli :ref:`indici di ricerca `, - la :ref:`modalità manutenzione `, - la :ref:`lista dei cambiamenti `, - l'invio di :ref:`email informative `. .. _contacts: `Contatti e account `_ ******************************** .. container:: authorizations :ref:`Autorizzazioni `: ``Amministrazione`` .. screenshot 1024x900 Da questo pannello si può avere una supervisione di tutti i contatti/account presenti nel applicativo (lista laterale :numref:`figure-admin-panel-contact`). Nella lista degli utenti è visualizzato il nome/cognome del contatto, il nome utente e il tipo di account (questi se il contatto dispone di un account): - |fa-user-ac|: se l'account è autenticanto tramite l'Amministrazione Cantonale (AC) - |fa-user-local|: se l'account è autenticato localmente. Utilizzando il :filter:`filtro` è possibile filtrare la lista per nome, cognome, e-mail oppure nome utente. Cliccando una voce nella lista si può avere i dettagli di un contatto. .. _figure-admin-panel-contact: .. figure:: /img/headerbar/admin/contact-account.png :alt: Pannello di amministrazione contatti :align: center :class: with-border Pannello di amministrazione contatti È possibile filtrare in modo avanzato cliccando sul pulante Filtri avanzati |fa-plus-square| (:numref:`figure-admin-panel-contact-filters`), questo permetterà di filtrare per: - :combobox:`Autorizzazioni` in base a una o più :ref:`autorizzazioni `, - :combobox:`Account disponibile` in base se il contatto dispone/non dispone di un account o se l'account è scaduto/attivo, - :combobox:`Ultimo accesso` in base all'ultimo accesso effettuato dell'utente, - :combobox:`Tipo account` in base al tipo di autenticazione: AC oppure locale. .. _figure-admin-panel-contact-filters: .. figure:: /img/headerbar/admin/contact-account-filters.png :alt: Filtri avanzati contatti/account :align: center :class: with-border Filtri avanzati contatti/account .. _add-contact: `Aggiungere `__ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Cliccando il pulsante :btn:`Aggiungi` apparirà una procedura guidata dove il primo modulo presenta i campi disponibili per descrivere il contatto (:numref:`figure-add-modify-contact`). Se si clicca si pulsante :btn:`Finisci` verrà creato un contatto senza account altrimenti è possibile collegare un account cliccando il pulsante :btn:`Account »` questo presenterà il modulo per immetere i relativi dati (:numref:`figure-add-modify-account`). È anche possibile importare i dati di contatto/account importandoli dal server `LDAP `_ dell'Amministrazione Cantonale (AC) cliccando il pulsante :btn:`Importa da LDAP`. Si aprirà una finestrà (:numref:`figure-admin-import-from-ldap`) dove è possibile, una volta immessi un :text:`Nome utente` e una :text:`Password` di un account LDAP validi, cercare il contatto tramite :text:`E-mail`. Cliccando sul pulsante :btn:`Finisci`, se l'utente è stato trovato, i moduli del contatto (:numref:`figure-add-modify-contact`) e dell'account (:numref:`figure-add-modify-account`) verranno compilati automaticamente. .. list-table:: :align: center :class: figure-side-by-side no-padding * - .. _figure-add-modify-contact: .. figure:: /img/headerbar/admin/contact-add-modify.png :alt: Modulo aggiunta/modifica di un contattto :align: center Modulo aggiunta/modifica di un contatto - .. _figure-add-modify-account: .. figure:: /img/headerbar/admin/account-add-modify.png :alt: Modulo aggiunta/modifica di un account :align: center Modulo aggiunta/modifica di un account .. _figure-admin-import-from-ldap: .. figure:: /img/headerbar/admin/import-from-ldap.png :alt: Finestra di ricerca contatto LDAP :align: center :class: with-border Finestra di ricerca contatto LDAP .. tip:: Se si desidera creare una password casuale cliccare sul pulsante |fa-gen-pwd| (:numref:`figure-add-modify-account`). .. note:: Non tutti i contatti necessitano un account, per esempio possono esistere dei contatti che servono solo per spedire delle e-mail, dati, ecc. .. note:: |mandatory-fields| .. _modify-contact: `Modificare `__ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Se si vuole modificare un contatto o account selezionare una voce nella lista laterale e poi fare click sul pulsante :btn:`Modifica` (:numref:`figure-admin-panel-contact`). In questo modo si avvierà la stessa :ref:`procedura guidata per l'aggiunta ` ma con già i campi completati per il contatto selezionato. Nel caso delle modifica di utente dell'Amministrazione Cantonale (AC) |fa-user-ac|, è possibile aggiornare i dati del contatto cliccando sul pulsante :btn:`Aggiorna informazioni LDAP`. Si aprirà una finestrà (:numref:`figure-admin-modify-from-ldap`) dove è possibile aggiornare le informazioni del contatto selezionato una volta immessi un :text:`Nome utente` e una :text:`Password` di un account LDAP validi. Cliccando sul pulsante :btn:`Finisci` il modulo del contatto (:numref:`figure-add-modify-contact`) sarà aggiornato se nuove informazioni sono state trovate o modificate. .. _figure-admin-modify-from-ldap: .. figure:: /img/headerbar/admin/modify-from-ldap.png :alt: Finestra di modifica contatto LDAP :align: center :class: with-border Finestra di modifica contatto LDAP .. note:: Quando si aggiornano le informazioni di un utente tramite LDAP, queste verranno solamemte applicate al contatto mentre le informazioni dell'account, anche se ci fossero aggiornamenti, non verrà in nessun modo modificato. .. _remove-contact: `Rimuovere `__ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Al momento non è possibile rimuovere un contatto/account con l'interfaccia grafica. Al riguardo contattare il team **oasi** tramite l'apposito modulo :ref:`send-feedback` indicando :menuitem:`Amministrazione` come :combobox:`Area d'interesse`. .. _modify-authorizations-and-permissions: `Modificare autorizzazioni e permessi `_ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Come già descritto nella sezione :ref:`Autorizzazioni e permessi ` ci sono diversi livelli di accesso che per questioni storiche e linguistiche non coincidono esattamente con quelli descritti. La seguente tabella associa le descrizioni con i nomi usati nell'applicativo: |authorization-table| Queste autorizzazioni possono essere modificate cliccando sul menu a tendina :combobox:`Autorizzazioni` (:numref:`figure-admin-authorizations`) nel modulo di aggiunta/modifica dell'account (:numref:`figure-add-modify-account`). .. _figure-admin-authorizations: .. figure:: /img/headerbar/admin/authorizations.png :alt: Menu autorizzazioni :align: center :class: with-border Menu autorizzazioni Attivando l'autorizzazione `OASI` nel modulo di aggiunta/modifica dell'account (:numref:`figure-add-modify-account`) verrà visualizzato una lista dove si potranno gestire i permessi (:numref:`figure-admin-oasi-permissions`). .. _figure-admin-oasi-permissions: .. figure:: /img/headerbar/admin/oasi-permissions.png :alt: Permessi OASI :align: center :class: with-border Permessi OASI Cliccando sul pulsante :btn:`Aggiungi` si aprirà una finestra (:numref:`figure-admin-add-permissions`) che permette di scegliere i permessi che si vogliono assegnare all'utente. Una volta selezionati, cliccare sul pulsante :btn:`Finisci` e questi verranno visulizzati nella lista dei permessi (:numref:`figure-admin-oasi-permissions`). Per rimuovere un permesso selezionare una voce nella lista dei permessi (:numref:`figure-admin-oasi-permissions`) e cliccare il pulsante :btn:`Riumuovi`. .. _figure-admin-add-permissions: .. figure:: /img/headerbar/admin/add-permissions.png :alt: Aggiungi/modifica permessi OASI :align: center Aggiungi/modifica permessi OASI .. tip:: Si possono selezionare più domini e tipi di permessi (:numref:`figure-admin-add-permissions`) tenendo premuto il tasto :kbd:`ctrl` mentre si seleziona una voce. .. _organizations: `Organizzazioni `_ ********************************* .. container:: authorizations :ref:`Autorizzazioni `: ``Amministrazione`` Da questo pannello si può avere una supervisione di tutte le organizzazioni presenti nell'applicativo (lista laterale :numref:`figure-admin-panel-organization`). Nella lista delle organizzazioni è visualizzato il nome e il simbolo |fa-user-ac| per avvisare se esiste un contatto di riferimento. Utilizzando il :filter:`filtro` è possibile filtrare la lista per nome, descrizione oppure nome/cognome del contatto di riferimento. Cliccando una voce nella lista si può avere i dettagli di un'organizzazione. .. _figure-admin-panel-organization: .. figure:: /img/headerbar/admin/organization.png :alt: Pannello di amministrazione organizzazioni :align: center :class: with-border Pannello di amministrazione organizzazioni .. _add-organization: `Aggiungere `__ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Cliccando il pulsante :btn:`Aggiungi` apparirà una finestra che consente l’aggiunta di una nuova organizzazione (:numref:`figure-add-modify-organization`). Cliccare su :btn:`Finisci` per aggiungere l'organizzazione. .. _figure-add-modify-organization: .. figure:: /img/headerbar/admin/organization-add-modify.png :alt: Pannello di aggiunta/modifica di un'organizzazione :align: center :class: with-border Pannello di aggiunta/modifica di un'organizzazione .. note:: |mandatory-fields| .. _modify-organization: `Modificare `__ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Se si vuole modificare un'organizzazione selezionare una voce nella lista laterale e poi fare click sul pulsante :btn:`Modifica` (:numref:`figure-admin-panel-organization`). In questo modo si aprirà la stessa :ref:`finestra ` ma con già i campi completati per il contatto selezionato. .. _remove-organization: `Rimuovere `__ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Per la rimozione bisogna selezionare l'organizzazione desiderata dalla lista laterale e cliccare sul pulsante :btn:`Elimina`. Verrà chiesta la conferma se si disidera veramente rimuovere l'organizzazione selezionata. .. warning:: Se l'organizzazione è in uso da un contatto questa non verrà eliminata. .. _application-settings: `Impostazioni applicazione `_ *************************************************** .. container:: authorizations :ref:`Autorizzazioni `: ``Amministrazione`` Per accedere a questo pannello cliccare sulla scheda :tab:`Impostazione applicazione` (:numref:`figure-admin-panel-app-settings`). In questo pannello è possibile gestire sia gli indici di ricerca che la modalità manutenzione. .. _figure-admin-panel-app-settings: .. figure:: /img/headerbar/admin/app-settings.png :alt: Pannello di amministrazione impostazione applicazione :align: center :class: with-border Pannello di amministrazione impostazione applicazione .. _indexes: **Indici** Gli indici di ricerca servono per velocizzare la ricerca di alcuni campi e necessitano un aggiornameto quando si fanno dei cambiamenti. Al momento ci sono due tipi di indici che si utilizzano e sono: - indice dei livelli: indicizza i nomi e descrizioni dei livelli utilizzati per la ricerca in :ref:`Mappe ` - indice dei mappali: indicizza il luogo e numero dei mappali e anche questi sono utilizzati per la ricerca in :ref:`Mappe ` Per aggiornare un indice scegliere dal menu a tendina il tipo che si vuole aggiornare e cliccare su pulsante :btn:`Ricostruisci`. Quando l'operazione è completata verrà visualizzato un messaggio che indica se l'operazione è andata a buon fine o meno. .. _maintenance-mode: **Modalità manutenzione** Cliccando il pulsante :btn:`Abilita la modalità di manutenzione` l'applicativo entra nella modalità manutenzion, questo garantisce che tutte le future richieste vengano redirizionate alla pagina del messaggio di manutenzione (:numref:`figure-admin-maintenance-message`). .. _figure-admin-maintenance-message: .. figure:: /img/headerbar/admin/maintenance-message.png :alt: Messaggio in modalità manutenzione :align: center :class: with-border Messaggio in modalità manutenzione Per disattivare questa modalità è necessario che l'amministratore abbia accesso al server dove l'applicativo risiede e modificare il valore della variabile ``maintenance`` a ``false`` nel file :file:`application.properties`. .. _admin-changelogs: `Lista dei cambiamenti `_ ******************************************* .. container:: authorizations :ref:`Autorizzazioni `: ``Amministrazione`` Da questo pannello è possibile gestire la lista dei cambiamenti che viene visualizzata :ref:`nella barra del titolo ` cliccando il pulsante |fa-changelogs|. Utilizzando il :filter:`filtra...` è possibile filtrare la lista in base alle parole trovate nel contenuto. .. _figure-admin-changelogs: .. figure:: /img/headerbar/admin/changelogs.png :alt: Lista dei cambiamenti nel pannello amministrazione :align: center :class: with-border Lista dei cambiamenti nel pannello amministrazione .. _add-changelog: `Aggiungere `__ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Per aggiungere un nuovo elemento nella lista dei cambiamenti cliccare sul pulsante :btn:`Aggiungi` (:numref:`figure-admin-changelogs`) dove si aprirà una finestra che ne consente l'aggiunta (:numref:`figure-add-modify-changelog`). Cliccare su :btn:`Finisci` per aggiungere il nuovo elemento. .. _figure-add-modify-changelog: .. figure:: /img/headerbar/admin/changelog-add-modify.png :alt: Modulo aggiunta/modifica di un elemento :align: center Modulo aggiunta/modifica di un elemento .. note:: |mandatory-fields| .. _modify-changelog: `Modificare `__ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Per la modifica selezionare un elemento desiderato dalla lista (:numref:`figure-admin-changelogs`) e cliccare sul pulsante :btn:`Modifica`. In questo modo si aprirà la stessa finestra per l'aggiunta ma con i campi pre-compilati dell'elemento selezionato (:numref:`figure-add-modify-changelog`). Cliccare su :btn:`Finisci` per accettare le modifiche. .. _remove-changelog: `Rimuovere `__ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Per la rimozione bisogna selezionare un elemento desiderato dalla lista (:numref:`figure-admin-changelogs`) e cliccare sul pulsante :btn:`Elimina`. Verrà chiesta la conferma se si disidera veramente rimuovere l'elemento. .. _send-email: `Invia e-mail `_ **************************** .. container:: authorizations :ref:`Autorizzazioni `: ``Amministrazione`` Gli amministratori hanno la possibilità di inviare degli e-mail agli utenti. Questo può essere utile, ad esempio, per avvisarli di qualche disservizio. Per accedere a questo pannello cliccare sulla scheda :tab:`Invia e-mail` (:numref:`figure-admin-send-email`). .. _figure-admin-send-email: .. figure:: /img/headerbar/admin/send-email.png :alt: Pannello di amministrazione invia email :align: center :class: with-border Pannello di amministrazione invia email Si ha la possibilità di spedire l'e-mail filtrado gli account per: - :combobox:`Autorizzazioni`: account con una determinata :ref:`autorizzazione `, - :combobox:`Ultimo accesso`: account che hanno fatto un'accesso all'applicativo negli ultimi 1, 7, 30, 365 giorni oppure a tutti indipendentemente dall'ultimo accesso, - :combobox:`Tipo account`: account che fanno parte dell'Amministrazione Cantonale (AC), account creati localmente oppure per tutti i tipi di account. Cliccando sul pulsante :lnkbtn:`Mostra contatti` è possibile visionare la lista di utenti che riceveranno l'e-mail (:numref:`figure-admin-send-email-contacts`). .. _figure-admin-send-email-contacts: .. figure:: /img/headerbar/admin/send-email-contacts.png :alt: Lista utenti a cui inviare l'e-mail :align: center :class: with-border Lista utenti a cui inviare l'e-mail Per potere inviare l'e-mail si è obbligati a scrivere il messaggio, :text:`Soggetto` e :text:`Corpo`, in tutte le lingue supportate dall'applicativo. Il campo :text:`Corpo` permette una formattazione di base per il testo. Riempito tutti i campi si ha la possibilità di ottenere un'ateprima del messaggio che si vuole spedire (:numref:`figure-admin-send-email-preview`) cliccando il pulsante :btn:`Anteprima` oppure di spedire effettivamente l'e-mail cliccando il pulsante :btn:`Invia`. L'operazione di invio visualizzerà un messaggio che indica se l'azione è andata a buon fine o meno. .. _figure-admin-send-email-preview: .. figure:: /img/headerbar/admin/send-email-preview.png :alt: Anteprima dell'e-mail :align: center :class: with-border Anteprima dell'e-mail .. warning:: La formattazione del corpo del messaggio a volte crea dei problemi non visibili nell'editore di testo dunque si raccomanda di visualizzare l'anteprima dell'e-mail prima di inviarlo. .. _logout: `Disconnessione `_ -------------------------- Per disconnettere il proprio utente da **Palma** cliccare su :menuitem:`Disconnetti` dal menu utente (:numref:`figure-user-menu`).