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

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

次の手順を実行します。

1. 共有スペースに新しい Qlik Sense アプリを作成します。

2. データ ロード エディター を開きます。

3. 次のロード スクリプトを新しいタブに貼り付けます。

   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 vTenantId = GetSysAttr('tenantId');
   Let vTenantName = GetSysAttr('tenantName');
   Let vTenantUrl = GetSysAttr('tenantUrl');
   Let vTenantUrlAlias = GetSysAttr('tenantUrlAlias');
   Let vTenantRegion = GetSysAttr('tenantRegion');
   Let vSpaceId = GetSysAttr('spaceId');
   Let vSpaceName = GetSysAttr('spaceName');
   Let vSpaceType = GetSysAttr('spaceType');

このロード スクリプトには次が含まれます。

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

• GetSysAttr() によりフェッチできる利用可能な属性の一連のスクリプト変数定義。

データをロードし、高度な編集モードで新しいシートを開きます。

[テーブル] オブジェクトを作成し、対応するラベルと合わせて次の式を軸として追加します。

• =vTenantId、ラベルあり Tenant ID

• =vTenantName、ラベルあり Tenant Name

• =vTenantUrl、ラベルあり Tenant URL (Default)

• =vTenantUrlAlias、ラベルあり Tenant URL (Alias)

• =vTenantRegion、ラベルあり Tenant Region

• =vSpaceId、ラベルあり Space ID

• =vSpaceName、ラベルあり Space Name

• =vSpaceType、ラベルあり Space Type

これで、利用可能な環境属性それぞれに動的に表示されるテーブルがアプリ内にできました。アプリをエクスポートし、異なるテナントやスペースにアップロードすると、新しくアップロードされたアプリのバージョンにこれらの属性が付与されます。

この例では、スクリプトで変数を定義する代わりに、高度な編集モードでダイアログを使用して、いくつかの変数を定義します。そうすると、変数はアプリのチャート式内で使用できます。

次の手順を実行します。

1. 共有スペースに新しい Qlik Sense アプリを作成します。

2. 高度な編集モードで新しいシートを開きます。

3. をクリックして変数ダイアログを開きます。

4. [新規作成] をクリックします。

5. [名前] に「vTenantId」と入力します。

6. [定義] に「=GetSysAttr('tenantId')」と入力します。

7. [作成] をクリックします。

これでテナントの ID を表示するアプリ変数が作成されます。ステップ 3 から 6 を繰り返して、残りの属性それぞれに変数を作成します。次のパラメーターを使用します。

• テナント名

  • 名前: vTenantName

  • 定義: =GetSysAttr('tenantName')

• テナント URL

  • 名前: vTenantUrl

  • 定義: =GetSysAttr('tenantUrl')

• テナント URL エイリアス

  • 名前: vTenantUrlAlias

  • 定義: =GetSysAttr('tenantUrlAlias')

• テナント地域

  • 名前: vTenantRegion

  • 定義: =GetSysAttr('tenantRegion')

• スペース ID

  • 名前: vSpaceId

  • 定義: =GetSysAttr('spaceId')

• スペース名

  • 名前: vSpaceName

  • 定義: =GetSysAttr('spaceName')

• スペースの種類

  • 名前: vSpaceType

  • 定義: =GetSysAttr('spaceType')

[テーブル] オブジェクトを作成し、対応するラベルと合わせて次の各式を軸として追加します。

• =vTenantId、ラベルあり Tenant ID

• =vTenantName、ラベルあり Tenant Name

• =vTenantUrl、ラベルあり Tenant URL (Default)

• =vTenantUrlAlias、ラベルあり Tenant URL (Alias)

• =vTenantRegion、ラベルあり Tenant Region

• =vSpaceId、ラベルあり Space ID

• =vSpaceName、ラベルあり Space Name

• =vSpaceType、ラベルあり Space Type

これで、利用可能な環境属性それぞれに動的に表示されるテーブルがアプリ内にできました。アプリをエクスポートし、異なるテナントやスペースにアップロードすると、新しくアップロードされたアプリのバージョンにこれらの属性が付与されます。

チャート式内で関数を使用する主なメリットは、これらの属性を更新するためにアプリをリロードする必要がないということです。これにより、アプリのライフ サイクルの一環としてテナントやスペース間でアプリを移動する際に、移動がスムーズになります。

関数はアプリ内で変数がなくても使用できます。この例では、各属性を個別の項目としたテーブルをロードする方法を示します。ここから、アプリでビジュアライゼーションを作成し、これらの詳細を表示できます。

次の手順を実行します。

1. 共有スペースに新しい Qlik Sense アプリを作成します。

2. データ ロード エディターを開きます。

3. 次のロード スクリプトを新しいタブに貼り付けます。

   Attributes:
   
   Load RowNo() as Key,
   GetSysAttr('tenantId') as TenantID,
   GetSysAttr('tenantName') as TenantName,
   GetSysAttr('tenantUrl') as TenantUrl,
   GetSysAttr('tenantUrlAlias') as TenantUrlAlias,
   GetSysAttr('tenantRegion') as TenantRegion,
   GetSysAttr('spaceId') as SpaceID,
   GetSysAttr('spaceName') as SpaceName,
   GetSysAttr('spaceType') as SpaceType autogenerate 1;

データをロードします。データ モデルにテーブルが作成され、個別の項目で各属性が表示されます。

これで、ビジュアライゼーションで、テーブルやテキスト、画像のオブジェクトなどの属性項目を使用できるようになりました。

変数を使用せずにチャート式内に関数を直接入力することができます。

チャート式内で関数を使用する主なメリットは、これらの属性を更新するためにアプリをリロードする必要がないということです。これにより、アプリのライフ サイクルの一環としてテナントやスペース間でアプリを移動する際に、移動がスムーズになります。

次の手順を実行します。

1. 共有スペースに新しい Qlik Sense アプリを作成します。

2. 高度な編集モードで新しいシートを開きます。

3. テキスト オブジェクトと画像オブジェクトをシートにドラッグします。

4. 空のチャート内部をクリックして、テキストを追加し、次を入力します。

   テナント ID:

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

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

   =GetSysAttr('tenantId')

7. このヘルプ トピックの紹介にある属性テーブルの式を使用して、新しい行で他の属性のためにこれらのステップを繰り返します。