GetUserAttr - スクリプトおよびチャート関数

この例では、作成したアプリ コンテンツで使用できる一連のスクリプト変数を定義します。アプリがリロードされるごとに、属性は評価されアプリに追加されます。

次の手順を実行します。

1. 新しい Qlik Sense アプリを作成します。

2. データ ロード エディターを開き、以下のロード スクリプトを新しいタブに追加します。 ロード スクリプトには次が含まれています。

   • サンプル トランザクション データを含む、Transactions と呼ばれる新しいテーブル。これは任意のデータで置き換えることができるプレースホルダーとして追加されています。

   • GetSysAttr() 関数が返すことができる、使用可能な属性の一連のスクリプト変数定義。

   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. 空白のチャート内をクリックし、次のラベルを入力します。

   User Email:

5. プロパティ パネルで、 [メジャーを追加] を選択します。

6. 次の式を入力します。

   • =GetUserAttr('userEmail')

7. 新しい行に、他の属性である User Subject と User Groups のラベルとメジャーを追加します。各属性には次の数式を使用します。

   • ユーザー サブジェクトには =GetUserAttr('userSubject')

   • ユーザー グループには =GetUserAttr('userGroups)