跳到主要內容 跳至補充內容

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) 階段期間,這特別實用。

此函數可用於應用程式載入指令碼或圖表運算式中的 Load 陳述式,可直接作為運算式使用,或在運算式中儲存為變數使用。若您預期應用程式會在生命週期期間於空間或租用戶之間移動,請在圖表運算式中使用該函數,以動態取得空間和租用戶資訊,而不必載入應用程式。若這麼做,請在載入指令碼以外的變數中儲存該函數運算式,或直接在圖表運算式中使用該函數。

範例 1 – 儲存環境屬性作為載入指令碼變數

範例 2 – 儲存環境屬性作為變數並在圖表運算式中使用

範例 3 – 直接在載入指令碼中使用函數

範例 4 – 直接在圖表運算式中使用函數

此頁面是否對您有幫助?

若您發現此頁面或其內容有任何問題——錯字、遺漏步驟或技術錯誤——請告知我們可以如何改善!