GetUserAttr - 指令碼與圖表函數

此範例定義一組指令碼變數，這可用於您建立的應用程式內容。每次載入應用程式時，會評估屬性並新增至應用程式。

請執行下列動作：

1. 建立新的 Qlik Sense 應用程式。

2. 開啟資料載入編輯器並將下面的載入指令碼新增至新的索引標籤。 載入指令碼包含：

   • 稱為 Transactions 的新表格，內含交易資料樣本。這可以替換為任何資料，並新增為預留位置。

   • 一系列的指令碼變數定義，用於 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');

3. 在進階編輯模式中載入資料並開啟新的工作表。

4. 建立表格物件並新增下列運算式作為維度：

• =vUserEmail

• =vUserSubject

• =vUserGroups，這會傳回字串中以逗號分隔的清單

表格中的輸出動態顯示可用的使用者屬性。下表顯示了使用 GetUserAttr 函數傳回的結果範例。

在此範例中，不是在載入指令碼中定義變數，而是在應用程式中定義變數。定義後，變數可以用於應用程式的圖表運算式。在圖表運算式中使用該函數的主要優點是，屬性將會自動重新整理，無需載入應用程式。作為應用程式生命週期的一部分，這讓使用者之間的應用程式移動更加順暢。

請執行下列動作：

1. 建立新的 Qlik Sense 應用程式。

2. 在進階編輯模式中開啟新的工作表。

3. 開啟變數對話方塊。

4. 選取新建，然後執行下列事項：

   • 在名稱之下，輸入 vUserEmail。

   • 在定義之下，輸入 =GetUserAttr('userEmail')。

   • 選取建立。

建立一個應用程式變數以顯示使用者的電子郵件地址。重複此步驟，使用下列參數為其餘屬性建立變數：

• 使用者主旨

  • 姓名：vUserSubject

  • 定義：=GetUserAttr('userSubject')

• 使用者群組

  • 姓名：vUserGroups

  • 定義：=GetUserAttr('userGroups')

5. 建立表格物件並新增下列運算式作為維度：

• =vUserEmail

• =vUserSubject

• =vUserGroups (傳回字串中以逗號分隔的清單)

新表格中的輸出動態顯示可用的使用者屬性。下表顯示了從 GetUserAttr 函數傳回的結果範例。

您也可以在應用程式中使用函數而沒有變數。此範例呈現如何載入表格，其中以每個屬性作為個別欄位。由此，您可以在應用程式中建立視覺化以顯示這些詳細資訊。

請執行下列動作：

1. 建立新的 Qlik Sense 應用程式。

2. 開啟資料載入編輯器並將下面的載入指令碼新增至新的索引標籤。 載入指令碼包含：

   • 一個稱為 Attributes 的新表格，其中包含每個屬性作為欄位。

   Attributes:
   Load RowNo() as Key,
   GetUserAttr('userEmail') as UserEmail,
   GetUserAttr('userSubject') as UserSubject,
   GetUserAttr('userGroups') as UserGroups autogenerate 1;

3. 載入資料。表格在資料模型中建立，資料模型在個別欄位中顯示每個屬性。

您現在可以在視覺化中使用屬性欄位，例如表格或文字與影像物件。

您可以直接在圖表運算式中輸入函數，而不使用變數。使用者屬性將會重新整理，無需載入應用程式。作為應用程式生命週期的一部分，這讓使用者之間的應用程式移動更加順暢。

請執行下列動作：

1. 建立新的 Qlik Sense 應用程式。

2. 在進階編輯模式中開啟新的工作表。

3. 將文字和影像物件拖曳到工作表。

4. 按一下空白圖表內部並輸入以下標籤：

   使用者電子郵件：

5. 在屬性面板中，選取新增量值。

6. 輸入下列運算式：

   • =GetUserAttr('userEmail')

7. 在新行新增其他屬性 User Subject 和 User Groups 的標籤和量值。對每個屬性使用以下運算式：

   • =GetUserAttr('userSubject')，適用於使用者主旨

   • =GetUserAttr('userGroups)，適用於使用者群組