GetUserAttr - funzione dello script e del grafico

In questo esempio viene definito un set di variabili per gli script che è possibile usare nei contenuti dell'app creati dall'utente. Ogni volta che l'app viene ricaricata, gli attributi verranno valutati e aggiunti all'app.

Procedere come indicato di seguito:

1. Creare una nuova app Qlik Sense.

2. Aprire l'Editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova sezione. Lo script di caricamento contiene:

   • Una nuova tabella, denominata Transactions, con i dati della transazione di esempio. È possibile sostituire questi ultimi con qualsiasi dato, e vengono aggiunti come segnaposto.

   • L'istruzione di uno script che imposta la variabile di sistema QlikCloudGroupMode su 2. L'attributo userGroups restituirà sia i gruppi IdP che quelli personalizzati a cui partecipa l'utente.

   • Una serie di definizioni delle variabili degli script per gli attributi disponibili che può restituire la funzione GetUserAttr.

   Set QlikCloudGroupMode = 2;
   Transactions:
   Load * inline [
   id,date,amount
   1,1/1/2023,500.67
   2,1/2/2023,458.91
   3,1/3/2023,12.34
   4,1/4/2023,90.90
   5,1/5/2023,256.30
   6,1/6/2023,789.16
   7,1/7/2023,501.25
   8,1/8/2023,87.01
   9,1/9/2023,161.16
   10,1/10/2023,300.06
   ];
   Let vUserEmail = GetUserAttr('userEmail');
   Let vUserSubject = GetUserAttr('userSubject');
   Let vUserGroups = GetUserAttr('userGroups');
   Let vUserLocale = GetUserAttr('userLocale');
   Let vUserZoneinfo = GetUserAttr('userZoneinfo');

3. Caricare i dati e aprire un nuovo foglio in modalità di modifica avanzata.

4. Creare un oggetto Tabella e aggiungere le seguenti espressioni come dimensioni:

• =vUserEmail

• =vUserSubject

• =vUserGroups restituisce un elenco di elementi separati da virgola in una stringa

• =vUserLocale

• =vUserZoneinfo

L'output della tabella visualizza in modo dinamico gli attributi utente disponibili. La tabella che segue mostra un esempio dei risultati restituiti utilizzando la funzione GetUserAttr.

In questo esempio, anziché definire le variabili nello script di caricamento, queste vengono definite nell'app. Una volta definite, le variabili possono essere utilizzate nelle espressioni del grafico nell'app. Il vantaggio principale dell'utilizzo della funzione nelle espressioni del grafico è che gli attributi si aggiorneranno automaticamente senza dover ricaricare l'app. Questo consente lo spostamento più fluido delle app tra gli utenti come parte del ciclo di vita dell'app.

Procedere come indicato di seguito:

1. Creare una nuova app Qlik Sense.

2. Aprire un nuovo foglio in modalità di modifica avanzata.

3. Aprire la finestra di dialogo variabili.

4. Selezionare Crea nuovo, quindi fare quanto segue:

   • Alla voce Nome, inserire vUserEmail.

   • Alla voce Definizione, inserire =GetUserAttr('userEmail').

   • Selezionare Crea.

Viene creata una variabile dell'app che consente di visualizzare l'indirizzo e-mail dell'utente. Ripetere questo passaggio per creare una variabile per gli altri attributi utilizzando i seguenti parametri:

• Oggetto utente

  • Nome: vUserSubject

  • Definizione: =GetUserAttr('userSubject')

• Gruppi di utenti

  • Nome: vUserGroups

  • Definizione: =GetUserAttr('userSubject')

• Impostazioni locali dell'utente

  • Nome: vUserLocale

  • Definizione: =GetUserAttr('userLocale')

• Info zona utente

  • Nome: vUserZoneinfo

  • Definizione: =GetUserAttr('userZoneinfo')

5. Creare un oggetto Tabella e aggiungere le seguenti espressioni come dimensioni:

• =vUserEmail

• =vUserSubject

• =vUserGroups (restituisce un elenco di elementi separati da virgola in una stringa)

• =vUserLocale

• =vUserZoneinfo

L'output nella nuova tabella visualizza in modo dinamico gli attributi utente disponibili. La tabella seguente mostra un esempio dei risultati restituiti utilizzando la funzione GetUserAttr.

È possibile anche usare la funzione nelle proprie app senza bisogno di alcuna variabile. Questo esempio dimostra come caricare una tabella con ciascuno degli attributi come campi individuali. Da qui, è possibile creare visualizzazioni in un'app in modo da mostrare tali dettagli.

Procedere come indicato di seguito:

1. Creare una nuova app Qlik Sense.

2. Aprire l'Editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova sezione. Lo script di caricamento contiene:

   • Una nuova tabella, denominata Attributes, che contiene ogni attributo come campo.

   • L'istruzione di uno script che imposta la variabile di sistema QlikCloudGroupMode su 1 per i gruppi personalizzati. L'attributo userGroups restituirà solo i gruppi personalizzati a cui partecipa l'utente.

   Set QlikCloudGroupMode = 1;
   Attributes:
   Load RowNo() as Key,
   GetUserAttr('userEmail') as UserEmail,
   GetUserAttr('userSubject') as UserSubject,
   GetUserAttr('userLocale') as UserLocale,
   GetUserAttr('userZoneinfo') as UserZoneinfo,
   GetUserAttr('userGroups') as UserGroups autogenerate 1;
   

3. Caricare i dati. Viene creata una tabella nel modello dati, che visualizza ciascuno degli attributi in campi individuali.

Ora è possibile usare i campi degli attributi nelle visualizzazioni, come oggetti tabella o di testo e immagine.

È possibile immettere la funzione direttamente nelle espressioni del grafico senza utilizzare una variabile. Gli attributi utente si aggiorneranno senza dover ricaricare l'app. Ciò consente lo spostamento più fluido delle app tra gli utenti come parte del ciclo di vita dell'app.

Procedere come indicato di seguito:

1. Creare una nuova app Qlik Sense.

2. Aprire un nuovo foglio in modalità di modifica avanzata.

3. Trascinare un oggetto Testo e immagine sul foglio.

4. Fare clic all'interno del grafico vuoto e inserire la seguente etichetta:

   Email utente:

5. Nel pannello delle proprietà, selezionare Aggiungi misura.

6. Inserire la seguente espressione:

   • =GetUserAttr('userEmail')

7. Aggiungere le etichette e le misure per gli altri attributi su nuove righe. Utilizzare le seguenti espressioni per ogni attributo:

   • =GetUserAttr('userSubject'), per Oggetto utente

   • =GetUserAttr('userGroups'), per i Gruppi di utenti

   • =GetUserAttr('userLocale'), per le impostazioni locali dell'utente

   • =GetUserAttr('userZoneinfo'), per le informazioni sulla zona dell'utente