| dalla versione 9.0.3940 - modificato il 09/11/2010 - link - english
|
Scopo
E' il ruolo dell'utente autenticato. Finché non viene valorizzata questa proprietà l'applicazione mostrerà la pagina di login. Dare un valore a questa proprietà significa autenticare l'utente.
Generalmente a questa proprietà viene attribuito un valore della lista valori UserRoles, ma questo non toglie che possa essere attribuito un ruolo non previsto a design-time: in tal caso basta assegnare a
UserRole il valore intero corrispondente al ruolo desiderato.
Modalità di autenticazione
L'autenticazione dell'utente può avvenire in tre modi:
- nell'evento di Initialize quando non è prevista l'autenticazione dell'utente (generalmente si attribuisce a UserRole il valore Administrator o Anonimous);
- nell'evento di OnLogin quando occorre verificata l'identità dell'utente cercando username e password in una tabella del DB oppure quando si hanno già le credenziali necessarie all'identificazione dell'utente, come in caso di autenticazione integrata;
- nell'evento di OnCommand quando l'applicazione viene chiamata tramite comando passandogli le credenziali, ad esempio tramite URL.
Applicazione.userRole = Amministratore
Quando letta
Restituisce un intero corrispondente al ruolo attribuito all'utente durante l'autenticazione; restituisce null se l'utente non è ancora stato autenticato.
Quando impostata
Attribuisce il ruolo dell'utente che significa aver autenticato l'utente passando quindi il login.
Note
-
Se si usa il modulo RTC e si attribuiscono uno o più ruoli tramite la procedura RTCEnableRole occorre comunque impostare anche UserRole per autenticare l'utente.
event Applicazione.OnLogin(
inout boolean DataValid
inout string UserName
inout string Password
)
{
int Ruolo = 0
select into variables (found variable)
set Ruolo = Ruolo
from
Utenti
where
Username = UserName
Password = Password
if (Ruolo > 0)
{
Applicazione.userRole = Ruolo
Applicazione.userName = UserName
}
}
Cosa ne pensi?
Ti sono rimaste delle domande su punti che questo articolo non ha trattato? Pensi che sia utile aggiungere una nota all'articolo? Aiutaci a migliorare la documentazione di Instant Developer scrivendo il tuo commento nei campi qui sotto.