GetUserAttr - función de script y de gráfico

Este ejemplo define un conjunto de variables de script que pueden utilizarse en el contenido de la app que cree. Cada vez que se vuelve a cargar la app, los atributos se evalúan y añaden a la app.

Haga lo siguiente:

1. Cree una nueva app en Qlik Sense.

2. Abra el Editor de carga de datos y añada el script de carga inferior en una nueva sección. El script de carga contiene:

   • Una nueva tabla, denominada Transactions, con datos de muestra de transacciones. Esto podría reemplazarse con cualquier dato, y se agrega como marcador de posición.

   • Una sentencia de script que establece la variable de sistema QlikCloudGroupMode en 2. El atributo userGroups devolverá tanto los grupos de IdP como los personalizados a los que pertenece el usuario.

   • Una serie de definiciones de variables de script para los atributos disponibles que puede devolver la función 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. Cargue los datos y abra una hoja nueva en el modo de edición avanzada.

4. Cree un objeto Tabla y añada las siguientes expresiones como dimensiones:

• =vUserEmail

• =vUserSubject

• =vUserGroups, esto devuelve una lista separada por comas en una cadena de caracteres

• =vUserLocale

• =vUserZoneinfo

El resultado de salida de la tabla muestra dinámicamente los atributos de usuario disponibles. La tabla siguiente muestra un ejemplo de los resultados que devuelve utilizando la función GetUserAttr.

En este ejemplo, en lugar de definir variables en el script de carga, las variables se definen en la app. Una vez definidas, las variables pueden utilizarse en expresiones de gráfico en la app. La principal ventaja de utilizar la función en expresiones de gráfico es que los atributos se actualizarán automáticamente sin tener que recargar la app. Esto permite un movimiento más fluido de las apps entre usuarios como parte del ciclo de vida de la app.

Haga lo siguiente:

1. Cree una nueva app en Qlik Sense.

2. Abra una hoja nueva en el modo de edición avanzada.

3. Abra el diálogo de variables.

4. Seleccione Crear nuevo y haga lo siguiente:

   • En Nombre, introduzca vUserEmail.

   • En Definición, introduzca =GetUserAttr('userEmail').

   • Seleccione Crear.

Se crea una variable de app para mostrar la dirección de correo electrónico del usuario. Repita este paso para crear una variable para los atributos restantes utilizando los siguientes parámetros:

• User Subject

  • Nombre: vUserSubject

  • Definición: =GetUserAttr('userSubject')

• User Groups

  • Nombre: vUserGroups

  • Definición: =GetUserAttr('userGroups')

• User Locale

  • Nombre: vUserLocale

  • Definición: =GetUserAttr('userLocale')

• User Zoneinfo

  • Nombre: vUserZoneinfo

  • Definición: =GetUserAttr('userZoneinfo')

5. Cree un objeto de Tabla y añada las siguientes expresiones como dimensiones:

• =vUserEmail

• =vUserSubject

• =vUserGroups (devuelve una lista separada por comas en una cadena de texto)

• =vUserLocale

• =vUserZoneinfo

El resultado de salida en la nueva tabla muestra dinámicamente los atributos de usuario disponibles. La tabla siguiente muestra un ejemplo de los resultados que devuelve la función GetUserAttr.

También puede usar la función en sus aplicaciones sin una variable. Este ejemplo demuestra cómo cargar una tabla con cada atributo como un campo individual. A partir de ahí, puede crear visualizaciones en la aplicación para mostrar estos detalles.

Haga lo siguiente:

1. Cree una nueva app en Qlik Sense.

2. Abra el Editor de carga de datos y añada el script de carga inferior en una nueva sección. El script de carga contiene:

   • Una nueva tabla llamada Attributes, que contiene cada atributo como un campo.

   • Una sentencia de script que establece la variable del sistema QlikCloudGroupMode en 1 para los grupos personalizados. El atributo userGroups devolverá solo los grupos personalizados a los que pertenezca el usuario.

   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. Cargue los datos. Se crea una tabla en el modelo de datos que muestra cada uno de los atributos en campos individuales.

Ahora puede utilizar los campos de atributo en visualizaciones como tablas u objetos de texto e imagen.

Puede introducir la función directamente en las expresiones del gráfico sin usar una variable. Los atributos de usuario se actualizarán sin tener que recargar la app. Esto permite un movimiento más fluido de las apps entre usuarios como parte del ciclo de vida de la app.

Haga lo siguiente:

1. Cree una nueva app en Qlik Sense.

2. Abra una hoja nueva en el modo de edición avanzada.

3. Arrastre un objeto de Texto e imagen a la hoja.

4. Haga clic dentro del gráfico en blanco e introduzca la siguiente etiqueta:

   User Email:

5. En el panel de propiedades, seleccione Añadir medida.

6. Introduzca la siguiente expresión:

   • =GetUserAttr('userEmail')

7. Añada etiquetas y medidas para los demás atributos en nuevas líneas. Utilice las siguientes expresiones para cada atributo:

   • =GetUserAttr('userSubject'), para el asunto de usuario: User Subject

   • =GetUserAttr('userGroups'), para los grupos de usuario: User Groups

   • =GetUserAttr('userLocale'), para la configuración regional de usuarios: User Locale

   • =GetUserAttr('userZoneinfo'), para Información sobre la zona de usuario: User Zone info