Visualizza wikitesto di Verifica appartenenza a gruppo/ruolo

== Introduzione ==
Permette di verificare se l'utente passato come parametro appartiene al gruppo o al ruolo contestualizzato specificato.

== Parametri ==

=== id_utente/logon_utente [IN] ===
Mutuamente esclusivi, permette di identificare l'utente per <code>id</code> oppure per <code>logon</code> ''(non descrizione!)''

=== mode [IN] ===
Indica il tipo di entità di cui si vuole verificare l'appartenenza:
* <code>GRUPPO</code>: L'entità di cui si vuole verificare l'appartenenza è un gruppo di utenti. L'utente potrà appartenere per assegnamento diretto oppure perchè un gruppo a cui appartiene è contenuto nel gruppo in oggetto (ereditato).
* <code>RUOLO IN UFFICIO</code>: L'entità si cui si vuole verificare l'appartenenza è un ruolo contestualizzato da un ufficio.

=== id_gruppo/nome_gruppo [IN] ===
Se <code>mode = GRUPPO</code> permette di identificare il gruppo per <code>id</code> oppure per <code>nome</code> ''(non descrizione!)''

=== id_ruolo/nome_ruolo [IN] ===
Se <code>mode = RUOLO IN UFFICIO</code> permette di identificare il ruolo per <code>id</code> oppure per <code>nome</code> ''(non descrizione!)''

=== id_ufficio_ctx [IN] ===
Se <code>mode = RUOLO IN UFFICIO</code> permette di indicare l'ufficio di contesto del ruolo (solo per <code>id</code>).

Se il parametro non viene specificato allora l'azione verificherà che l'utente possieda il ruolo in un contesto qualsiasi.

=== ufficio_ctx_mode [IN] ===
Se <code>mode = RUOLO IN UFFICIO</code> permette di indicare la posizione dell'ufficio di contesto rispetto all'assegnazione fatta all'utente:
* <code>owned</code>: L'ufficio dev'essere direttamente assegnato al ruolo dell'utente.
* <code>children</code>: L'ufficio dev'essere un sotto-ufficio dell'ufficio assegnato al ruolo dell'utente.
* <code>subtree</code>: L'ufficio può essere direttamente assegnato oppure essere un sotto ufficio.

=== sostituzioni [IN] ===
Permette di specificare se considerare anche le sostituzioni che l'utente in oggetto ha attive per il controllo <code>(default = INCLUSE)</code>:
* <code>INCLUSE (1)</code>: Viene controllato se l'utente stesso oppure uno degli utenti che egli sta sostituendo appartengono al <code>gruppo</code> o <code>ruolo</code>.
* <code>ESCLUSE (0)</code>: Viene controllato solo se l'utente stesso appartiene al <code>gruppo</code> o <code>ruolo</code>.

=== result [OUT] ===
Risultato della verifica di appartenenza:
* <code>APPARTIENE (1)</code>: L'utente appartiene all'entità specificata.
* <code>NON APPARTIENE (0)</code>: L'utente non appartiene all'entità specificata.

'''''Nota:''' Quando si specifica <code>utente</code>, <code>gruppo</code> oppure <code>ruolo</code> tramite il <code>logon</code> o il <code>nome</code>, si tenga conto del fatto che il controllo avviene per valore esatto (quindi attenzione a maiuscole/minuscole e spazi soprattutto in coda che sono difficilmente visibili).''