カード・コンテキスト変数の構成
カードのコンテキスト変数を構成して、カード上の特定のエレメントをカスタマイズおよび制御することができます。
開始前に
このタスクについて
カード・コンテキスト変数は、ページ・コンテキスト変数や静的値と次のように相互作用します：
- コンテキスト変数を持つカードがページコンテキスト変数を持たないページに追加された場合、カードはカードコンテキスト変数のデフォルト値をロードする。
- カード・コンテキストと同じ名前のページ・コンテキスト変数が追加されると、カードは自動的にページ・コンテキストの値を使う。
- サイドパネルでは、静的な値を使用するようにカードを設定することができます。 名前に関係なく、別のページコンテキスト変数を使うようにカードを設定することもできる。
- 設定されたページコンテキスト変数が削除されると、カードにエラーメッセージが表示される。 他の既存のページコンテキスト変数を使うには、カードを再設定する必要がある。
手順
再利用のための汎用カードの設定例
一般的なカードを作成し、複数のページで再利用することができます。 コンテンツを表示するには、静的な値やページ・コンテキスト変数を設定することで、異なるページで同じカードを効果的に使用することができます。
一般的なカードを作成する。
カードビルダを使って、特定の国のロケーションレコードを表示するテーブルカードを作成する。
- プライマリー・ビジネス・オブジェクト・フィールドで、「Location選択する。
- 以下のクエリーを設定する：
country Equals Variable $country以下の画像は、ある国の位置情報を取得するテーブルカードのクエリ構成を示している。
countryという名前のコンテキスト変数を設定し、typeを'Stringに設定し、Valueフィールドに'USA入力する。
- カラムに'
id、'locationName、'city、'coordinatesを追加する。
同じジェネリックカードの複数のインスタンスを追加する。
ページビルダーを使って、様々な国の位置情報を表示できるページを作成します。 作成した新しいカードのインスタンスを複数追加する。 デフォルトでは、すべてのカードは、デフォルトのコンテキスト値であるUSAを使用しているため、同じように表示されます。
最初のカードはそのままにしておく。すでにアメリカの情報が表示されているので、それを追跡する必要があるからだ。
- 静的コンテキストを使用するように汎用カードを設定する。
- 2枚目のカードで、オーバーフローメニューアイコンをクリックし、［をクリックする。
- ソースを'Static valueに変更する。
- 値」フィールドに「Canada入力する。
ページコンテキスト変数を作成する。
countryNameという名前のページコンテキスト変数を設定し、タイプを'Stringに設定し、値フィールドに'UKと入力する。
汎用カードがページコンテキストを使用するように設定する。
- 3枚目のカードで、オーバーフローメニューアイコンをクリックし、［をクリックする。
- ソースを'Page contextに変更する。
- ページのコンテキスト変数フィールドで、「countryName選択する。
次の画像は、コンテキスト変数に基づいて異なるデータを表示するために2回複製された1枚の汎用カードを表示しています。
