User Role

proprietà copia link

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.

Sintassi

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.

Esempio

// *********************************************************************
// Evento notificato dall'applicazione quando l'utente effettua il login
// *********************************************************************
event Applicazione.OnLogin(
  inout boolean DataValid // Impostare a True per indicare che le credenzi...
  inout string UserName   // User Name inserito dall'utente nella pagina d...
  inout string Password   // Password inserita dall'utente nella pagina di...
)
{
  int Ruolo = 0
  //
  // Verifico l'identità dell'utente sul DB
  select into variables (found variable)
    set Ruolo = Ruolo
  from
    Utenti // master table
  where
    Username = UserName
    Password = Password
  //
  if (Ruolo > 0)
  {
    Applicazione.userRole = Ruolo
    Applicazione.userName = UserName
  }
}

Ultima modifica: 23/03/2021 / Validità: da 9.0.3940