GetUserAttr — функция скриптa и диаграммы

В этом примере будет определен набор переменных скрипта, которые можно использовать в создаваемом содержимом приложения. При каждой перезагрузке приложения атрибуты оцениваются и добавляются в приложение.

Выполните следующие действия.

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')

• Локаль пользователя

  • Имя: 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'), для информации о зоне пользователя​