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 id oppure per logon (non descrizione!)

mode [IN]

Indica il tipo di entità di cui si vuole verificare l'appartenenza:

• GRUPPO: 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).
• RUOLO IN UFFICIO: L'entità si cui si vuole verificare l'appartenenza è un ruolo contestualizzato da un ufficio.

id_gruppo/nome_gruppo [IN]

Se mode = GRUPPO permette di identificare il gruppo per id oppure per nome (non descrizione!)

id_ruolo/nome_ruolo [IN]

Se mode = RUOLO IN UFFICIO permette di identificare il ruolo per id oppure per nome (non descrizione!)

id_ufficio_ctx [IN]

Se mode = RUOLO IN UFFICIO permette di indicare l'ufficio di contesto del ruolo (solo per id).

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 mode = RUOLO IN UFFICIO permette di indicare la posizione dell'ufficio di contesto rispetto all'assegnazione fatta all'utente:

• owned: L'ufficio dev'essere direttamente assegnato al ruolo dell'utente.
• children: L'ufficio dev'essere un sotto-ufficio dell'ufficio assegnato al ruolo dell'utente.
• subtree: 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 (default = INCLUSE):

• INCLUSE (1): Viene controllato se l'utente stesso oppure uno degli utenti che egli sta sostituendo appartengono al gruppo o ruolo.
• ESCLUSE (0): Viene controllato solo se l'utente stesso appartiene al gruppo o ruolo.

result [OUT]

Risultato della verifica di appartenenza:

• APPARTIENE (1): L'utente appartiene all'entità specificata.
• NON APPARTIENE (0): L'utente non appartiene all'entità specificata.

Nota: Quando si specifica utente, gruppo oppure ruolo tramite il logon o il nome, 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).