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

La función GetSysAttr() se utiliza para devolver información sobre el espacio empresarial inquilino y el espacio en el que se encuentra una app. Con la función GetSysAttr(), puede evaluar el ID y el nombre del espacio empresarial inquilino, el ID y el nombre del espacio, así como otros detalles sobre el entorno en el que reside la app. Esta función simplifica la identificación del espacio y del espacio empresarial inquilino de una app de Qlik Sense que podría moverse entre diferentes entornos. La función facilita la identificación del entorno específico en el que está trabajando. Esto es especialmente útil durante las etapas de desarrollo, prueba, aceptación y producción (DTAP) del ciclo de vida de una app.

Esta función puede utilizarse en el script de carga o en las expresiones de gráfico de la app, ya sea directamente como expresión o en una expresión almacenada como variable. Si prevé que su app se moverá entre espacios o espacios empresariales inquilinos durante su ciclo de vida, utilice la función en una expresión de gráfico para obtener de forma dinámica información sobre el espacio y el espacio empresarial inquilino sin recargar la app. Al hacerlo, almacene la expresión de la función en una variable fuera del script de carga o utilice la función directamente en la expresión del gráfico.

Utilice GetSysAttr() para determinar la siguiente información sobre su app:

El ID del espacio empresarial inquilino donde se encuentra la app.
El nombre del espacio empresarial inquilino donde se encuentra la app.
La URL del espacio empresarial inquilino donde se encuentra la app.
La URL del alias que se ha definido para el espacio empresarial inquilino que contiene la app.
La región del espacio empresarial inquilino que contiene la app.
El ID del espacio donde se ubica la app.
El nombre del espacio donde se encuentra la app.
El tipo de espacio (compartido o administrado) donde se encuentra la app.

La función GetSysAttr() se puede utilizar 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, solo devuelve 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:

GetSysAttr(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.

Puede utilizar la función para cargar atributos de entorno en su app. La función puede deolver los atributos siguientes:

Atributos de entorno que puede devolver la función GetSysAttr()
Atributo	Descripción	Ejemplo de variable de script de carga	Ejemplo de expresión de gráfico (sin variable)
tenantId	El ID del espacio empresarial inquilino.	Let vTenantID = GetSysAttr('tenantId')	=GetSysAttr('tenantId')
tenantName	En nombre del espacio empresarial inquilino.	Let vTenantName = GetSysAttr('tenantName')	=GetSysAttr('tenantName')
tenantUrl	La URL predeterminada para el espacio empresarial inquilino.	Let vTenantUrl = GetSysAttr('tenantUrl')	=GetSysAttr('tenantUrl')
tenantUrlAlias	La URL de alias que se ha definido para el espacio empresarial inquilino.	Let vTenantUrlAlias = GetSysAttr('tenantUrlAlias')	=GetSysAttr('tenantUrlAlias')
tenantRegion	La región en la que reside el espacio empresarial inquilino.	Let vTenantRegion = GetSysAttr('tenantRegion')	=GetSysAttr('tenantRegion')
spaceId	El ID del espacio. Esto solo se define para una app en un espacio compartido o administrado. Nota informativa Si la función GetSysAttr() devuelve un valor spaceId vacío in Qlik Cloud, significa que la app se encuentra en un espacio personal. La función GetSysAttr() siempre devuelve un valor spaceId vacío cuando se utiliza en Qlik Sense Client-Managed.	Let vSpaceId = GetSysAttr('spaceId')	=GetSysAttr('spaceId')
spaceName	El nombre del espacio. Esto solo se define para una app en un espacio compartido o administrado. Nota informativa Si la función GetSysAttr() devuelve un valor spaceName vacío in Qlik Cloud, significa que la app se encuentra en un espacio personal. La función GetSysAttr() siempre devuelve un valor spaceName vacío cuando se utiliza en Qlik Sense Client-Managed.	Let vSpaceName = GetSysAttr('spaceName')	=GetSysAttr('spaceName')
spaceType	El tipo de espacio en el que se encuentra la aplicación. Esto solo se define para una app en un espacio compartido o administrado. Nota informativa Si la función GetSysAttr() devuelve un valor spaceType vacío in Qlik Cloud, significa que la app se encuentra en un espacio personal. La función GetSysAttr() siempre devuelve un valor spaceType vacío cuando se utiliza en Qlik Sense Client-Managed.	Let vSpaceType = GetSysAttr('spaceType')	=GetSysAttr('spaceType')

Ejemplo 1: almacenamiento de atributos de entorno como variables de script de carga

En este ejemplo, definirá un conjunto de variables de script que se pueden usar 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 de Qlik Sense en un espacio compartido.
Abra Editor de carga de datos.

Pegue el siguiente script de carga en una nueva pestaña:

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 vTenantId = GetSysAttr('tenantId');
Let vTenantName = GetSysAttr('tenantName');
Let vTenantUrl = GetSysAttr('tenantUrl');
Let vTenantUrlAlias = GetSysAttr('tenantUrlAlias');
Let vTenantRegion = GetSysAttr('tenantRegion');
Let vSpaceId = GetSysAttr('spaceId');
Let vSpaceName = GetSysAttr('spaceName');
Let vSpaceType = GetSysAttr('spaceType');

Este script de carga contiene lo siguiente:

Una nueva tabla, llamada Transactions, contiene datos de transacciones de muestra. Esto podría reemplazarse con cualquier dato, y se agrega como marcador de posición.
Una serie de definiciones de variables de secuencias de comandos, para los atributos disponibles que pueden obtenerse mediante GetSysAttr().

Cargue los datos y abra una hoja nueva en el modo de edición avanzada.

Cree un objeto de Tabla y agregue las siguientes expresiones como dimensiones, junto con sus respectivas etiquetas:

=vTenantId, con la etiqueta Tenant ID
=vTenantName, con la etiqueta Tenant Name
=vTenantUrl, con la etiqueta Tenant URL (Default)
=vTenantUrlAlias, con la etiqueta Tenant URL (Alias)
=vTenantRegion, con la etiqueta Tenant Region
=vSpaceId, con la etiqueta Space ID
=vSpaceName, con la etiqueta Space Name
=vSpaceType, con la etiqueta Space Type

Ahora tiene una tabla en su app que muestra dinámicamente cada uno de los atributos de entorno disponibles. Exportar la app y cargarla en un espacio y espacio empresarial inquilino diferentes le otorgaría estos atributos para la versión recién cargada de la app.

Ejemplo 2: almacenar atributos de entorno como variables y utilizarlos en expresiones de gráfico

En este ejemplo, en lugar de definir variables en el script, definiremos una serie de variables mediante el cuadro de diálogo en el modo de edición avanzada. Luego, las variables se pueden utilizar en expresiones de gráfico en la app.

Haga lo siguiente:

Cree una nueva app de Qlik Sense en un espacio compartido.
Abra una hoja nueva en el modo de edición avanzada.
Haga clic en para abrir el diálogo de variables.
Haga clic en Crear nuevo.
En Nombre, escriba vTenantId.
En Definición , escriba =GetSysAttr('tenantId').
Haga clic en Crear.

Esto crea una variable de aplicación para mostrar la identificación del espacio empresarial inquilino. Repita los pasos 3 a 6 para crear una variable para cada uno de los atributos restantes. Utilice los siguientes parámetros:

Nombre del espacio empresarial inquilino
- Nombre: vTenantName
- Definición: =GetSysAttr('tenantName')
URL del espacio empresarial inquilino
- Nombre: vTenantUrl
- Definición: =GetSysAttr('tenantUrl')
Alias de URL del espacio empresarial inquilino
- Nombre: vTenantUrlAlias
- Definición: =GetSysAttr('tenantUrlAlias')
Región del espacio empresarial inquilino
- Nombre: vTenantRegion
- Definición: =GetSysAttr('tenantRegion')
ID del espacio
- Nombre: vSpaceId
- Definición: =GetSysAttr('spaceId')
Nombre del espacio
- Nombre: vSpaceName
- Definición: =GetSysAttr('spaceName')
Tipo de espacio
- Nombre: vSpaceType
- Definición: =GetSysAttr('spaceType')

Cree un objeto de Tabla y agregue cada una de las siguientes expresiones como dimensiones, junto con sus respectivas etiquetas:

=vTenantId, con la etiqueta Tenant ID
=vTenantName, con la etiqueta Tenant Name
=vTenantUrl, con la etiqueta Tenant URL (Default)
=vTenantUrlAlias, con la etiqueta Tenant URL (Alias)
=vTenantRegion, con la etiqueta Tenant Region
=vSpaceId, con la etiqueta Space ID
=vSpaceName, con la etiqueta Space Name
=vSpaceType, con la etiqueta Space Type

El principal beneficio de utilizar la función en expresiones de gráfico es que no es necesario volver a cargar la aplicación para que estos atributos se actualicen. Esto permite un movimiento más fluido de aplicaciones entre espacios empresariales inquilinos y espacios como parte del ciclo de vida de la aplicación.

Ejemplo 3: uso de la función directamente 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 de Qlik Sense en un espacio compartido.
Abra el Editor de carga de datos.

Pegue el siguiente script de carga en una nueva pestaña:

Attributes:

Load RowNo() as Key,
GetSysAttr('tenantId') as TenantID,
GetSysAttr('tenantName') as TenantName,
GetSysAttr('tenantUrl') as TenantUrl,
GetSysAttr('tenantUrlAlias') as TenantUrlAlias,
GetSysAttr('tenantRegion') as TenantRegion,
GetSysAttr('spaceId') as SpaceID,
GetSysAttr('spaceName') as SpaceName,
GetSysAttr('spaceType') as SpaceType 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 usar los campos de atributos en visualizaciones, como tablas u objetos de texto e imagen.

Ejemplo 4: uso de la función directamente en expresiones de gráfico

Puede introducir la función directamente en las expresiones del gráfico sin usar una variable.

El principal beneficio de usar la función en expresiones de gráfico es que no es necesario volver a cargar la app para actualizar estos atributos. Esto permite un movimiento más fluido de aplicaciones entre espacios empresariales inquilinos y espacios como parte del ciclo de vida de la aplicación.

Haga lo siguiente:

Cree una nueva app de Qlik Sense en un espacio compartido.
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 para agregar texto y escriba:
ID del espacio empresarial:
En el panel de propiedades, haga clic en Añadir medida.
Introduzca la siguiente expresión:
=GetSysAttr('tenantId')
Repita estos pasos para los otros atributos en líneas nuevas, utilizando las expresiones presentadas en la tabla de atributos en la introducción de este tema de ayuda.

¿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.

Deje aquí sus comentarios