GetUserAttr — funkcja skryptu i funkcja wykresu

W tym przykładzie definiuje się zestaw zmiennych skryptu, których można użyć w tworzonej zawartości aplikacji. Za każdym razem, gdy aplikacja zostanie przeładowana, atrybuty zostaną oszacowane i dodane do aplikacji.

Wykonaj następujące czynności:

1. Utwórz nową aplikację Qlik Sense.

2. Otwórz Edytor ładowania danych i poniżej dodaj skrypt ładowania do nowej sekcji. Skrypt ładowania zawiera:

   • Nowa tabela o nazwie Transactions z przykładowymi danymi transakcji. Można to zastąpić dowolnymi danymi i jest to dodawane jako tekst zastępczy.

   • Instrukcja skryptu, która ustawia zmienną systemową QlikCloudGroupMode na 2. Atrybut userGroups zwróci zarówno grupy Dostawca tożsamości, jak i grupy niestandardowe, do których należy użytkownik.

   • Seria definicji zmiennych skryptu dla dostępnych atrybutów, które może zwrócić funkcja 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. Załaduj dane i otwórz nowy arkusz w zaawansowanym trybie edycji.

4. Utwórz obiekt Tabela i dodaj poniższe wyrażenia jako wymiary:

• =vUserEmail

• =vUserSubject

• =vUserGroups — zwraca to listę w postaci ciągu znaków rozdzieloną przecinkami

• =vUserLocale

• =vUserZoneinfo

Dane wyjściowe w tabeli dynamicznie wyświetlają dostępne atrybuty użytkownika. Poniższa tabela przedstawia przykład wyników zwróconych przy użyciu funkcji GetUserAttr.

W tym przykładzie zamiast definiować zmienne w skrypcie ładowania, zmienne są definiowane w aplikacji. Po zdefiniowaniu zmienne mogą być używane w wyrażeniach wykresu w aplikacji. Główną zaletą korzystania z funkcji w wyrażeniach wykresu jest automatyczne odświeżanie atrybutów bez konieczności ponownego ładowania aplikacji. Umożliwia to płynniejsze przenoszenie aplikacji między użytkownikami w ramach cyklu życia aplikacji.

Wykonaj następujące czynności:

1. Utwórz nową aplikację Qlik Sense.

2. Otwórz nowy arkusz w zaawansowanym trybie edycji.

3. Otwórz okno dialogowe zmiennych.

4. Wybierz opcję Utwórz nowy, a następnie wykonaj poniższe czynności:

   • W polu Nazwa wpisz vUserEmail.

   • W polu Definicja wpisz =GetUserAttr('userEmail').

   • Wybierz Utwórz.

Zmienna aplikacji zostaje utworzona w celu wyświetlenia adresu e-mail użytkownika. Powtórz ten krok, aby utworzyć zmienną dla pozostałych atrybutów, używając następujących parametrów:

• Podmiot użytkownika

  • Nazwa: vUserSubject

  • Definicja: =GetUserAttr('userSubject')

• Grupy użytkownika

  • Nazwa: vUserGroups

  • Definicja: =GetUserAttr('userGroups')

• Ustawienia regionalne użytkownika

  • Nazwa: vUserLocale

  • Definicja: =GetUserAttr('userLocale')

• Informacje o strefie użytkownika

  • Nazwa: vUserZoneinfo

  • Definicja: =GetUserAttr('userZoneinfo')

5. Utwórz obiekt Tabela i dodaj poniższe wyrażenia jako wymiary:

• =vUserEmail

• =vUserSubject

• =vUserGroups (zwraca to listę w postaci ciągu znaków rozdzieloną przecinkami)

• =vUserLocale

• =vUserZoneinfo

Dane wyjściowe w tabeli dynamicznie wyświetlają dostępne atrybuty użytkownika. Poniższa tabela przedstawia przykład wyników zwróconych z funkcji GetUserAttr.

Możesz także użyć tej funkcji w swoich aplikacjach bez zmiennej. Ten przykład pokazuje, jak załadować tabelę z każdym atrybutem jako osobnymi polem. Stąd możesz tworzyć wizualizacje w aplikacji, aby wyświetlić te szczegóły.

Wykonaj następujące czynności:

1. Utwórz nową aplikację Qlik Sense.

2. Otwórz Edytor ładowania danych i poniżej dodaj skrypt ładowania do nowej sekcji. Skrypt ładowania zawiera:

   • Nowa tabela o nazwie Attributes, która zawiera każdy atrybut jako pole.

   • Instrukcja skryptu, która ustawia zmienną systemową QlikCloudGroupMode na 1 dla grup niestandardowych. Atrybut userGroups zwróci tylko grupy niestandardowe, do których należy użytkownik.

   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. Załadowanie danych. W modelu danych zostanie utworzona tabela wyświetlająca każdy z atrybutów w poszczególnych polach.

Teraz możesz używać pól atrybutów w wizualizacjach, takich jak tabele lub obiekty tekstowe i graficzne.

Funkcję można wprowadzić bezpośrednio do wyrażeń wykresu bez użycia zmiennej. Atrybuty użytkownika będą odświeżane bez konieczności przeładowywania aplikacji. Umożliwia to płynniejsze przenoszenie aplikacji między użytkownikami w ramach cyklu życia aplikacji.

Wykonaj następujące czynności:

1. Utwórz nową aplikację Qlik Sense.

2. Otwórz nowy arkusz w zaawansowanym trybie edycji.

3. Przeciągnij obiekt tekstu i grafiki na arkusz.

4. Kliknij wewnątrz pustego wykresu i wprowadź następującą etykietę:

   User Email:

5. W panelu właściwości wybierz Dodaj miarę.

6. Wprowadź następujące wyrażenie:

   • =GetUserAttr('userEmail')

7. Dodaj etykiety i miary dla pozostałych atrybutów w nowych wierszach. Dla każdego atrybutu użyj następujących wyrażeń:

   • =GetUserAttr('userSubject'), dla podmiotu użytkownika

   • =GetUserAttr('userGroups'), dla grup użytkownika

   • =GetUserAttr('userLocale'), dla ustawień regionalnych użytkownika

   • =GetUserAttr('userZoneinfo'), dla informacji o strefie użytkownika