È possibile suddividere la struttura di gestione delle deleghe in tre parti:

1. Gestione personale (DocWay4)
2. Gestione admin (ACL)
3. Notifiche (email)

La gestione personale delle deleghe consiste nella designazione degli utenti (persone interne della propria UOO) che potranno eseguire l'accesso in propria vece.

Ogni utente potrà:

• Selezionare la persona interna da delegare tramite lookup
• Decidere se la delega sarà senza scadenza (permanente) o selezionare l'intervallo di validità tramite due date (inizio e fine).
• Attivare o disattivare la stessa
• Attivare il sistema di notifica. Ogni volta che l'utente riceve una notifica (ad esempio assegnazione di un documento) verranno notificati anche tutti gli utenti con una sua delega valida e il sistema di notifica attivo (vedi “Notifiche”).

Tutta la gestione personale si svolge attraverso l'interfaccia di DocWay4:

• Si accede al pannello di gestione con il menù della home in alto a destra (gestione profilo, gestione deleghe, logout)
• Una volta in delega è possibile rilasciarla tramite lo stesso menù, dove ora ci sarà solo il pulsante per il rilascio
• Si seleziona una delega con il menù di selezione delle deleghe in alto a destra, scegliendole per nome

NOTE
Possono esistere deleghe non modificabili ne eliminabili dall'utente, che sono state inserite dall'amministratore in ACL (vedi “Gestione admin”).
Non è possibile avere due deleghe assegnate alla stessa persona interna.

La gestione amministrativa delle deleghe consiste nella designazione “forzata” di deleghe di accesso attraverso la funzione di modifica della persona interna disponibile in ACL.

Ogni utente con diritto di modifica delle persone interne e diritto di amministrazione deleghe in ACL potrà:

• Selezionare, modificare o eliminare le deleghe per l'utente in modifica in modo del tutto analogo alla gestione personale
• Imporre che la delega da lui assegnata non sia modificabile / eliminabile dall'utente tramite la gestione deleghe personale
• Effettuare una ricerca di tutti i deleganti di una certa persona interna, tramite ricerca delle persone interne.
• Per l'amministratore ACL sarà possibile attivare o disabilitare, da apposita interfaccia, i diritti sia personali che admin per quanto riguarda le deleghe

Per quanto riguarda le notifiche, ogni volta che deve essere inviata un'email di notifica relativa ai documenti, ai fascicoli o ai raccoglitori ad un utente, vengono eseguite le seguenti operazioni:

• Controllo dei delegati dell'utente
• Individuazione delle deleghe con flag di notifica attivo
• Scarto di tutte le deleghe non attive o non in data valida
• Creazione ed invio di un'email personalizzata per l'utente delegato (dove sarà presente un URL con attributi che verranno interpretati con PrettyFaces per gestire l'accesso diretto in delega)

Inoltre viene gestito il caso in cui un utente, che già ha effettuato un accesso in delega, riceva invece una propria notifica email e, in quel caso, la gestione con PrettyFaces comporterà il logout del delegante e l'acceso con il proprio profilo.

Per attivare la gestione dai clienti è necessario effettuare le seguenti operazioni:

• Attivazione delle properties relative alla delega nel file it.highwaytech.apps.xdocway.properties

######################### Gestione deleghe ######################### 

# Property per l'attivazione della gestione delle deleghe ('si', 'no' - Default = 'no')
abilitaDeleghe=si

# Numero massimo deleghe singolo utente ('10' - Default = '5')
deleghe.numeroMassimo=5

##################################################################### 

• Aggiornare il conf di archivio acl (…/extraway/xw/db/acl/acl.conf.xml) con la versione compatibile alla vers. 4.11.0

È necessaria l'aggiunta dei seguenti “title”:

• Attivazione dei rights:
  • ACL-DL01 (Amministrazione Deleghe in ACL) in …/conf/DocWay4-service/base/acl/diritti/acl.xml
  • DW-DOC-DL01 (Gestione Deleghe Personali) in …/conf/DocWay4-service/base/acl/diritti/docway.xml (nel caso di più archivi occorre configurarlo in ogni archivio)

Esempio di come dovrebbe essere la struttura dell'XML

acl.xml

<listof_rights>
   <common>
      <group label="Access Control List" tipo="base">
         <group label="Diritti speciali">
            <right cod="ACL-DL01" label="Amministrazione Deleghe in ACL"></right>
         </group>
      </group>
   </common>
</listof_rights>

docway.xml

<listof_rights>
   <db nome="xdocwaydoc" cod="DOC">
      <group label="Diritti dell'utente per DOCWAY" tipo="base">
         <group label="Amministrazione">
	    <right cod="DW-DOC-DL01" label="Gestione Deleghe Personali"></right>
         </group>
      </group>
   </db>
</listof_rights>

• Attivazione delle properties per la visualizzazione dei nuovi diritti in ACL nel file it.highwaytech.apps.generic.properties

# Lista di property mostraDiritto che definiscono quando mostrare o meno certi diritti in base al valore di certe property.
# Sintassi:
#
# mostraDiritto.<progressivo numerico crescente>=<codice diritto>;<package>;<appname>;<nome_property>[=|!=]<valore>[$#$<nome_property>[=|!=]<valore>$#$...]
#
# Il separatore '$#$' consente di avere più property in and.
#
# Se <codice diritto> vale "GROUP-label", viene visualizzato o meno l'intero gruppo di diritti con etichetta "label".
# Se <codice diritto> contiene "*" vengono visualizzati o meno i diritti che contengono qualsiasi sequenza di caratteri o niente al posto di esso.
#
mostraDiritto.XX=ACL-DL01;it.highwaytech.apps;xdocway;abilitaDeleghe=si
mostraDiritto.YY=DW-DOC*-DL01;it.highwaytech.apps;xdocway;abilitaDeleghe=si