GetUserAttr - 脚本和图表函数

此示例定义了一组可用于您创建的应用程序内容的脚本变量。每次重新加载应用程序时，都将评估属性并将其添加到应用程序中。

执行以下操作：

1. 创建新 Qlik Sense 应用程序。

2. 打开数据加载编辑器，并将下面的加载脚本添加到新部分。 加载脚本包含：

   • 一个名为 Transactions 的新表，其中包含示例事务数据。这可以替换为任何数据，并且作为占位符添加。

   • 将 QlikCloudGroupMode 系统变量设置为 2 的脚本语句。userGroups 属性将返回 Idp 和用户所属的自定义组。

   • GetUserAttr 函数可以返回的可用属性的一系列脚本变量定义。

   Set QlikCloudGroupMode = 2;
   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');
   Let vUserLocale = GetUserAttr('userLocale');
   Let vUserZoneinfo = GetUserAttr('userZoneinfo');

3. 加载数据并以高级编辑模式打开新工作表。

4. 创建一个表格对象，并将以下表达式添加为维度：

• =vUserEmail

• =vUserSubject

• =vUserGroups，这将以字符串形式返回一个逗号分隔的列表

• =vUserLocale

• =vUserZoneinfo

表中的输出动态显示可用的用户属性。下表显示了使用 GetUserAttr 函数返回的结果示例。

在这个例子中，变量不是在加载脚本中定义的，而是在应用程序中定义的。 一旦定义，变量就可以在应用程序的图表表达式中使用。 在图表表达式中使用该函数的主要好处是，属性将自动刷新，而无需重新加载应用程序。 这使得在应用程序生命周期内，应用程序在用户之间的移动更加顺畅。

执行以下操作：

1. 创建新 Qlik Sense 应用程序。

2. 在高级编辑模式下打开新的工作表。

3. 打开变量对话框。

4. 选择新建，然后执行以下操作：

   • 在名称下输入 vUserEmail。

   • 在定义下输入=GetUserAttr('userEmail')。

   • 选择创建。

即会创建一个应用程序变量来显示用户的电子邮件地址。重复此步骤，使用以下参数为剩余属性创建变量：

• 用户主题

  • 名称：vUserSubject

  • 定义：=GetUserAttr('userSubject')

• 用户组

  • 名称：vUserGroups

  • 定义：=GetUserAttr('userGroups')

• User Locale

  • 名称：vUserLocale

  • 定义：=GetUserAttr('userLocale')

• 用户 Zoneinfo

  • 名称：vUserZoneinfo

  • 定义：=GetUserAttr('userZoneinfo')

5. 创建一个表格对象，并将以下表达式添加为维度：

• =vUserEmail

• =vUserSubject

• =vUserGroups（以字符串形式返回一个以逗号分隔的列表）

• =vUserLocale

• =vUserZoneinfo

新表中的输出动态显示可用的用户属性。下表显示了使用 GetUserAttr 函数返回的结果示例。

你也可以在没有变量的情况下使用应用程序中的函数。这个示例演示了如何加载一个表，其中每个属性都作为一个单独的字段。从这里，您可以在应用程序中创建可视化以显示这些详细信息。

执行以下操作：

1. 创建新 Qlik Sense 应用程序。

2. 打开数据加载编辑器，并将下面的加载脚本添加到新部分。 加载脚本包含：

   • 一个名为 Attributes 的新表，以字段形式将每个属性包含在内。

   • 为自定义组将 QlikCloudGroupMode 系统变量设置为 1 的脚本语句。userGroups 属性将仅返回用户所属的自定义组。

   Set QlikCloudGroupMode = 1;
   Attributes:
   Load RowNo() as Key,
   GetUserAttr('userEmail') as UserEmail,
   GetUserAttr('userSubject') as UserSubject,
   GetUserAttr('userLocale') as UserLocale,
   GetUserAttr('userZoneinfo') as UserZoneinfo,
   GetUserAttr('userGroups') as UserGroups autogenerate 1;
   

3. 加载数据。在数据模型中创建一个表，在各个字段中显示每个属性。

现在，您可以在可视化中使用属性字段，例如表或文本和图像对象。

您可以在不使用变量的情况下将函数直接输入图表表达式。用户属性将刷新，而无需重新加载应用程序。这使得在应用程序生命周期内，应用程序在用户之间的移动更加顺畅。

执行以下操作：

1. 创建新 Qlik Sense 应用程序。

2. 在高级编辑模式下打开新的工作表。

3. 将文本和图像对象拖到工作表上。

4. 在空白图表内单击并输入以下标签：

   用户电子邮件：

5. 在属性面板中，选择添加度量 。

6. 输入以下表达式：

   • =GetUserAttr('userEmail')

7. 在新行上为其他属性 添加标签和度量。对每个属性使用以下表达式：

   • =GetUserAttr('userSubject')（针对用户主题）

   • =GetUserAttr('userGroups')（针对用户组）

   • =GetUserAttr('userLocale')（针对用户区域设置）

   • =GetUserAttr('userZoneinfo')（针对用户地区信息）