コンテキスト変数
コンテキスト変数は、ダッシュボード・ページまたはカードに関連付けられた変数です。 コンテキスト変数を使用して、動的かつカスタマイズされたダッシュボードとカードを作成できます。 コンテキスト変数に基づいて、ダッシュボード・ページまたはカードの内容を変更できます。
コンテキスト変数は動的な値です。つまり、コンテキスト変数が変更されると、ページまたはカードに表示される内容も変更されます。 例えば、商品詳細ページには、商品 ID のコンテキストが必要です。 同じ詳細ページを、商品 ProductA および商品 ProductBに使用することができます。 そのため、コンテキストが商品 A から商品 B に変更されると、ページ・コンテンツが変更されます。
ダッシュボード上のカードがデータをレンダリングしない場合は、問題を調査してください。 詳しくは、 コンテキストの欠落を参照してください。
コンテキスト変数は、以下の 2 つのタイプに分類されます。
- ページ・コンテキスト変数
- コンテンツを正常にロードするためにページが必要とする動的な値またはパラメーター。 現在、コンテキストをページに渡すには、そのページに移動するリンクを構成します。 このリンクを構成すると、コンテキストは URL パラメータを使用して渡されます。 ページ・コンテキスト変数の追加について詳しくは、 ページ・コンテキスト変数の構成を参照してください。
- カード・コンテキスト変数
- カードがその内容を正常にロードするために必要な値またはパラメーター。 コンテキスト変数は、カード内のどこでも使用できる。 例えば、これらの変数は、クエリーのレンダリング、アイコンの読み込み、ラベル文字列として使用することができます。 これらの変数はページレベルで設定できる。 カード・コンテキストの設定には3つのオプションがある：
- デフォルト値（ウィジェット・レベルでカード・コンテキストとして追加された値）、
- 静的値（ユーザー定義値）、
- ページコンテキスト（ページに対して定義されたページコンテキスト変数）。
View propertiesをクリックすると、サイドナビゲーションに、選択したカードにリンクされているすべてのカードコンテキスト変数をリストするアコーディオンが表示されます。 Configure をクリックすると、Configure card コンテキスト・ダイアログが開きます。 各カードコンテキスト変数は、タグでそのタイプが強調されたアコーディオン項目として表示される。