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.
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).