InObject - チャート関数
InObject() チャート関数は、現行オブジェクトが関数引数で指定された ID を持つ別のオブジェクト内に含まれているかどうかを評価します。オブジェクトはシートまたはビジュアライゼーションのいずれかです。
この関数は、最上位のシート オブジェクトから、他のビジュアライゼーションにネストされたビジュアライゼーションまで、シート内のオブジェクトの階層を表示するために使用できます。この関数は、if と ObjectId 関数と併用し、アプリでカスタム ナビゲーションを作成できます。
構文:
InObject(id_str)
戻り値データ型： ブール値
Qlik Sense では、真のブール値は -1 で表現され、偽の値は 0 で表現されます。
| 引数 | 説明 |
|---|---|
| id_str | 評価されるオブジェクトの ID を表す文字列値。 |
このシート ID は、アプリ URL から取得できます。ビジュアライゼーションのために、[開発者] オプションを使ってオブジェクト型のオブジェクト ID とテキスト文字列を特定します。
次の手順を実行します。
-
分析モードで、次のテキストを URL を追加します。
/options/developer
-
ビジュアライゼーションを右クリックして、
[開発者] をクリックします。 -
[プロパティ] で、ダイアログ ヘッダーからオブジェクト ID、「qType」プロパティからオブジェクト タイプを取得します。
制限事項:
この関数は、マスター アイテムであるコンテナ内のオブジェクト (ボタンなど) で呼び出された場合、想定外の結果をもたらすことがあります。この制限事項は、多数のリストボックスのコンテナである、フィルター パネルマスター アイテムにも適用されます。その理由は、マスター アイテムがオブジェクト階層を使用する方法です。
InObject() は、多くの場合、次の関数と組み合わせて使用されます。
| 関数 | 相互作用 |
|---|---|
| if - スクリプトおよびチャート関数 | if および ObjectId 関数を併用して、条件式を作成することができます。例えば、ビジュアライゼーションではこれらの関数を使った数式により、条件付きの色分けを行うことができます。 |
| ObjectId - チャート関数 | if と同様、ObjectId も InObject と併用すると、条件式を作成できます。 |
例 1 – 基本的機能
次の基本例では、オブジェクトが別のオブジェクトの中に入っているかどうか判断する方法がわかります。この場合、シートの ID を引数として使用することで、[テキストと画像] オブジェクトがシート オブジェクトの中にあるかどうかを確認します。
次の手順を実行します。
-
シートを開いて、シートに [テキストと画像] チャートをドラッグします。
-
プロパティ パネルで、[メジャーを追加] をクリックします。
-
をクリックして、数式エディタを開きます。 -
次の数式を展開先パスに貼り付けます。
=InObject() -
数式を変更して、括弧間の文字列としてシートの ID を含めます。
例えば、ID が 1234-5678 のシートについては、次を使用します。
=InObject('1234-5678')
-
[適用] をクリックします。
値 -1 がチャートに表示され、数式の評価が true であることを示します。
例 2 – 条件付きで色分けされたオブジェクト
概要
次の例は、現在開いているシートを示すために色分けして表示するカスタム ナビゲーション ボタンの作成方法を示しています。
最初に、新しいアプリを作成して、データ ロード エディターを開きます。次のロード スクリプトを新しいタブに貼り付けます。データ自体はプレースホルダーであり、例の内容には使用されないことに注意してください。
ロード スクリプト
Transactions:
Load
*
Inline
[
id,date,amount
8188,'1/19/2022',37.23
8189,'1/7/2022',17.17
8190,'2/28/2022',88.27
8191,'2/5/2022',57.42
8192,'3/16/2022',53.80
8193,'4/1/2022',82.06
8194,'4/7/2022',40.39
8195,'5/16/2022',87.21
8196,'6/15/2022',95.93
8197,'7/26/2022',45.89
8198,'8/9/2022',36.23
8199,'9/22/2022',25.66
8200,'11/23/2022',82.77
8201,'12/27/2022',69.98
8202,'1/1/2023',76.11
8203,'2/8/2022',25.12
8204,'3/19/2022',46.23
8205,'6/26/2022',84.21
8206,'9/14/2022',96.24
8207,'11/29/2022',67.67
]; ビジュアライゼーションの作成
データをロードして新しいシートを 2 つ作成します。それぞれ Sales 2022 と Sales 2023 というタイトルを付けます。
次に、2 つのシート間の移動に使用される 2 つのボタン オブジェクトをビルドします。
次の手順を実行します。
-
シートに 2 つの ボタン オブジェクトを追加します。
-
[スタイル] > [基本設定] で、各ボタンの [ラベル] をそれぞれ Sales 2022 と Sales 2023 に設定します。
- 次の画像のようにボタンを配置します。
2 つのナビゲーション ボタンを使った Sales 2022 シートの配置
-
[Sales 2022] ボタンを選択してから、プロパティ パネルで [アクションおよびナビゲーション] を拡張します。
-
[アクションを追加] をクリックして、[ナビゲーション] で、[シートの表示] を選択します。
-
[シート] で、[Sales 2022] を選択します。
-
このボタン アクションを繰り返して、[Sales 2023] ボタンを [Sales 2023] シートにリンクさせます。
-
ボタンを右クリックして
[マスター アイテムに追加] を選択することにより、ボタンをマスター アイテムに変換します。
これで、各ボタンをコピーし、同じサイズと配置で Sales 2023 シートに貼り付けることができます。
条件付きの色の作成
次に、現在開いているシートにリンクされている場合は青、開いてないシートにリンクされたている場合はグレーとなるようにボタンを設定します。
次の手順を実行します。
-
[Sales 2022] シートを開き、URL からシート ID を取得します。[Sales 2022] シートを開いたままにします。
-
[Sales 2022] ボタンのマスター アイテムをクリックして、プロパティ パネルで [編集] を選択します。
-
[スタイル] > [背景] で、ボタンを [数式別] に色分けするように選択します。
-
[数式] に、次のテキストを貼り付けます。
=if(InObject(''), Blue(), LightGray())
-
上記数式の括弧の間に、[Sales 2022] シートのシート ID を貼り付けます。
これで、[Sales 2022] シートが開いていればボタンが青に、開いていなければグレーになるよう設定されました。
[Sales 2023] シートにも上記の手順を繰り返し、[Sales 2023] ボタンのマスター アイテムを [Sales 2023] シート ID にリンクします。
各シートには現在 2 つのボタンが表示され、青い色で現在開いているシートを示しています。
[Sales 2022] シートのボタンが青く、[Sales 2022] が現在表示されていることを示した状態
