跳到主要内容 跳到补充内容

GetSysAttr - 脚本和图表函数

此函数返回所选应用程序的租户和空间域属性。 此函数均可用于数据加载脚本和图表表达式。

GetSysAttr() 函数可以直接在加载脚本或图表表达式中使用。在任何一种情况下,都可以使用函数将属性存储在变量中,也可以直接不使用变量。

如果在 Qlik Sense 客户端托管 中使用此函数,它将只返回空的数据值。因此,您可以使用该函数在 Qlik Sense 客户端托管 中开发脚本,而不会遇到错误,以便稍后将应用程序上载到 Qlik Cloud

语法:  

GetSysAttr(name)

返回数据类型:

参数
参数说明
name要返回的属性的名称。在表达式中作为字符串值输入。输入的字符串值区分大小写。

您可以使用该函数将环境属性加载到您的应用程序中。该函数可以返回以下属性:

GetSysAttr() 函数可以返回的环境属性
属性说明加载脚本变量的示例图表表达式示例(无变量)
$tenantid租户 ID。Let vTenantID = GetSysAttr('tenantId')=GetSysAttr('tenantId')
tenantName组合的名称。Let vTenantName = GetSysAttr('tenantName')=GetSysAttr('tenantName')
tenantUrl租户的默认 URL。Let vTenantUrl = GetSysAttr('tenantUrl')=GetSysAttr('tenantUrl')
tenantUrlAlias已为租户定义的别名 URL。Let vTenantUrlAlias = GetSysAttr('tenantUrlAlias')=GetSysAttr('tenantUrlAlias')
tenantRegion租户居住的区域。Let vTenantRegion = GetSysAttr('tenantRegion')=GetSysAttr('tenantRegion')
spaceId

空间 ID。这仅为共享托管空间中的应用程序定义。

信息注释

如果 GetSysAttr() 函数在 Qlik Cloud 中返回一个空 spaceId 值,则表示该应用程序位于个人空间中。

GetSysAttr() 函数在 Qlik Sense 客户端托管 中使用时总是返回一个空 spaceId 值。

Let vSpaceId = GetSysAttr('spaceId')=GetSysAttr('spaceId')
spaceName

空间的名称。这仅为共享或托管空间中的应用程序定义。

信息注释

如果 GetSysAttr() 函数在 Qlik Cloud 中返回一个空 spaceName 值,则表示该应用程序位于个人空间中。

GetSysAttr() 函数在 Qlik Sense 客户端托管 中使用时总是返回一个空 spaceName 值。

Let vSpaceName = GetSysAttr('spaceName')=GetSysAttr('spaceName')
spaceType

应用程序所在的空间类型。这仅为共享或托管空间中的应用程序定义。

信息注释

如果 GetSysAttr() 函数在 Qlik Cloud 中返回一个空 spaceType 值,则表示该应用程序位于个人空间中。

GetSysAttr() 函数在 Qlik Sense 客户端托管 中使用时总是返回一个空 spaceType 值。

Let vSpaceType = GetSysAttr('spaceType')=GetSysAttr('spaceType')

适用场景

此函数简化了可能在不同环境之间移动的 Qlik Sense 应用程序的空间和租户标识。此函数使您能够轻松识别所处的特定环境。这在应用程序生命周期的开发、测试、验收和生产 (DTAP) 阶段特别有用。

此函数可以在应用程序加载脚本中的加载语句中使用,也可以在图表表达式中使用,可以直接作为表达式或存储为变量的表达式使用。如果您预计您的应用程序在其生命周期内会在空间或租户之间移动,请使用图表表达式中的函数动态获取空间和租户信息,而无需重新加载应用程序。执行此操作时,请将函数表达式存储在加载脚本外部的变量中,或者直接在图表表达式中使用该函数。

示例 1 – 将环境属性存储为加载脚本变量

示例 2 – 将环境属性存储为变量,并在图表表达式中使用它们

示例 3 – 直接在加载脚本中使用函数

示例 4 – 在图表表达式中直接使用函数

本页面有帮助吗?

如果您发现此页面或其内容有任何问题 – 打字错误、遗漏步骤或技术错误 – 请告诉我们如何改进!