La función GetUserAttr() devuelve la siguiente información sobre el usuario que accede a una app:
La dirección de correo electrónico del usuario.
El asunto del usuario.
Los grupos de proveedores de identidad (IdP) a los que pertenece el usuario.
Utilice la función GetUserAttr() directamente en el script de carga o en una expresión de gráfico. En cualquier caso, puede usar la función para almacenar atributos en una variable o directamente sin una variable. Si utiliza esta función en Qlik Sense Client-Managed, devolverá únicamente valores de datos vacíos. Por lo tanto, puede usar la función para desarrollar scripts en Qlik Sense Client-Managed sin encontrar errores, con la intención de cargar luego las apps en Qlik Cloud.
Sintaxis:
GetUserAttr(name)
Tipo de datos que devuelve: dual
Argumentos
Argumento
Descripción
name
El nombre del atributo para devolver. Escriba un valor de cadena en la expresión. El valor de cadena introducido distingue entre mayúsculas y minúsculas.
Utilice la función para cargar atributos de usuario en su app. La función puede devolver los atributos siguientes:
Atributos de usuario que puede devolver la función GetUserAttr()
Atributo
Descripción
Ejemplo de variable de script de carga
Ejemplo de expresión de gráfico (sin variable)
Ejemplo de resultados de una expresión de gráfico
userEmail
El correo electrónico del usuario actual.
Let vUserEmail = GetUserAttr('userEmail')
=GetUserAttr('userEmail')
john.doe@company.com
userSubject
El asunto del usuario actual.
Let vUserSubject = GetUserAttr('userSubject')
=GetUserAttr('userSubject')
00uss7ra3dk9doJln0x7
userGroups
Los grupos IdP del usuario actual que accede a la app. Devuelve una lista separada por comas en una cadena de caracteres.
Let vUserGroups = GetUserAttr('userGroups')
=GetUserAttr('userGroups')
Sales,Product-Lead,OKTA-Github-RnD
Cuándo se utiliza
Esta función devuelve las propiedades del usuario y los grupos para el usuario actual de la app. Esto le permite construir soluciones que personalicen el contenido que aparece para sus usuarios. Por ejemplo, en una aplicación global de ventas, puede mostrar hojas específicas de un producto solo a los comerciales responsables de un grupo de productos concreto. Utilice la función en sentencias LOAD del script de carga de la app o en expresiones de gráfico, ya sea directamente como expresión o en una expresión almacenada como variable.
Ejemplo: almacenamiento de atributos de usuario como variables en el script
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:
Cree una nueva app en Qlik Sense.
Abra el editor de carga de datos y agregue el script de carga a continuación a una nueva pestaña. 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 serie de definiciones de variables de script para los atributos disponibles que puede devolver la función GetUserAttr.
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');
Cargue los datos y abra una hoja nueva en el modo de edición avanzada.
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
Nota de sugerenciaPuede añadir una etiqueta de dimensión, como Correo electrónico del usuario, para mejorar la legibilidad cuando cree la dimensión.
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.
Tabla de resultados
=vUserEmail
=vUserSubject
=vUserGroups
john.doe@company.com
00uss7ra3dk9doJln0x7
Sales,Product-Lead,OKTA-Github-RnD
Ejemplo: almacenar atributos de usuario como variables y su uso en expresiones de gráfico
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:
Cree una nueva app en Qlik Sense.
Abra una hoja nueva en el modo de edición avanzada.
Abra el diálogo de variables.
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:
Asunto del usuario
Nombre: vUserSubject
Definición: =GetUserAttr('userSubject')
Grupos de usuarios
Nombre: vUserGroups
Definición: =GetUserAttr('userGroups')
Cree un objeto Tabla y añada las siguientes expresiones como dimensiones:
=vUserEmail
=vUserSubject
=vUserGroups (devuelve una lista separada por comas en una cadena de caracteres)
Nota de sugerenciaPuede añadir una etiqueta de dimensión, como Correo electrónico del usuario, para mejorar la legibilidad cuando cree la dimensión.
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.
Tabla de resultados
=vUserEmail
=vUserSubject
=vUserGroups
john.doe@company.com
00uss7ra3dk9doJln0x7
Sales,Product-Lead,OKTA-Github-RnD
Ejemplo: uso de la función GetUserAttr en el script de carga
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:
Cree una nueva app en Qlik Sense.
Abra el editor de carga de datos y agregue el script de carga a continuación a una nueva pestaña. El script de carga contiene:
Una nueva tabla, denominada Attributes, que contiene cada atributo como un campo.
Attributes:
Load RowNo() as Key,
GetUserAttr('userEmail') as UserEmail,
GetUserAttr('userSubject') as UserSubject,
GetUserAttr('userGroups') as UserGroups autogenerate 1;
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.
Ejemplo: utilización de la función GetUserAttr en expresiones de gráfico
Puede introducir la función directamente en las expresiones del gráfico sin usar una variable. Los atributos del 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:
Cree una nueva app en Qlik Sense.
Abra una hoja nueva en el modo de edición avanzada.
Arrastre un objeto de Texto e imagen a la hoja.
Haga clic dentro del gráfico en blanco e introduzca la siguiente etiqueta:
Correo electrónico del usuario:
En el panel de propiedades, seleccione Añadir medida.
Introduzca la siguiente expresión:
=GetUserAttr('userEmail')
Añada etiquetas y medidas para los otros atributos, User Subject y User Groups, en nuevas líneas. Utilice las siguientes expresiones para cada atributo:
=GetUserAttr('userSubject'), para Asunto del usuario
=GetUserAttr('userGroups), para Grupos de usuarios
¿Esta página le ha sido útil?
No dude en indicarnos en qué podemos mejorar si encuentra algún problema en esta página o su contenido, como, por ejemplo, errores tipográficos, pasos que falta o errores técnicos.