オブジェクトリスト

オブジェクトリストウィジェットは、オブジェクトデータをリストまたはグリッドで表示するために使用します。オブジェクトリストウィジェットを設定するモジュールビルダーは、次のことができます。

• 1つまたは複数のオブジェクトタイプのデータを表示する。
• 表示するプロパティタイプとリンクされたオブジェクト、およびその表示形式を選択する。
• 必要に応じてメディアプロパティを選択し、各オブジェクトの画像またはアイコンを表示する。
• 初期の並べ替え条件を設定する。
• Ontology Manager で設定された条件付き書式設定と数値の書式設定オプションを表示する。
• オブジェクトごとに null プロパティを非表示にし、よりコンパクトに表示する。
• リスト内で単一選択または複数選択を許可する。
• リスト内でオブジェクトが選択されたときに Workshop イベントをトリガーする。

以下のスクリーンショットは、Flight Alert オブジェクトを表示するように設定されたオブジェクトリストウィジェットの例です。

以下のスクリーンショットは、オブジェクトを画像付きのグリッド表示で表示するように設定されたオブジェクトリストウィジェットの例です。

以下のスクリーンショットは、オブジェクトをアイコン付きのリスト表示で表示するように設定されたオブジェクトリストウィジェットの例です。

設定オプション

以下のスクリーンショットは、新しく追加されたオブジェクトリストウィジェットの初期状態と初期設定パネルです。

オブジェクトリストウィジェットの主な設定オプションは次のとおりです。

• 入力データ
  • オブジェクトセット： この入力変数は、ウィジェット内に表示されるデータを決定します。モジュールビルダーは、このモジュール内の別の場所で作成された既存のオブジェクトセット変数を再利用するか、新しいオブジェクトセット変数をインラインで定義できます。以下に示すほかの設定オプションの多くは、このオブジェクトセットパラメーターに値を設定してからでないと設定できません。
• プロパティの設定
  • メディアを追加： 必要に応じて、オブジェクト情報とともに画像を表示できます。メディア設定の詳細は後述します。
  • プロパティを追加： ここでプロパティを選択すると、そのプロパティがリスト内に表示されます。
  • デフォルトの並べ替え条件： この設定では、リスト内に最大1つのデフォルトの並べ替え条件を適用できます。モジュールビルダーは、リスト内に表示されているプロパティタイプでも、表示されていない非表示のプロパティタイプでも並べ替えできます。
  • ユーザーによる並べ替えを有効にする： 有効にすると、リストの上にサブヘッダーが表示され、ユーザーがリストの並べ替え条件を変更できます。ユーザーは、リスト内に表示されているプロパティタイプでも、表示されていない非表示のプロパティタイプでも並べ替えできます。
  • 並べ替えを有効にする： 有効にして設定すると、ユーザーがウィジェット内の項目をドラッグアンドドロップして並べ替えできます。項目は、オブジェクトカードの右側に表示されるドラッグハンドルを使った場合にのみドラッグできます。並べ替え設定の詳細は後述します。
  • null プロパティを非表示にする： 有効にすると、リスト内でオブジェクトごとに null プロパティが非表示になります。
• 選択
  • アクティブなオブジェクト： このウィジェットの2つの出力変数のうちの1つ目で、現在アクティブな行、つまり強調表示されている行を、オブジェクトを1個だけ含むオブジェクトセットとして出力します。このオブジェクトセットは、現在のモジュール内の下流のウィジェットで使用できます。
  • アクティブなオブジェクトの自動選択を有効にする： デフォルトでは、読み込み時にリストの最初の行が自動的にアクティブなオブジェクトとして設定されます。この設定を無効にすると、自動選択が行われなくなり、読み込み時のアクティブなオブジェクトが空になります。
  • 選択したオブジェクト： このウィジェットの2つの出力変数のうちの2つ目で、現在チェックされている行、つまり選択されている行のオブジェクトセットを出力します。このオブジェクトセットは、現在のモジュール内の下流のウィジェットで使用できます。この出力変数は、複数選択を有効にするトグルが true に設定されている場合にのみ使用され、値が設定されます。
  • アクティブなオブジェクトの選択時： このオプションでは、リスト内の行が選択されたときにトリガーする Workshop イベントをモジュールビルダーが設定できます。たとえば、より詳細なオブジェクトの表示を含むドロワーを表示させることができます。
  • 複数選択を有効にする： このトグルを有効にすると、ユーザーはリスト内の複数のオブジェクトをチェックまたは選択できます。選択されたオブジェクトセットは、選択したオブジェクトのオブジェクトセットを介して出力され、現在のモジュール内の下流のウィジェットで使用できます。
• 表示と書式設定
  • タイトル： 値を設定すると、ここで入力した文字列のタイトルを含むサブヘッダーがリストの上に表示されます。
  • セキュリティマーキングを表示する： 有効にすると、プロパティのセキュリティマーキングがコンパクトな灰色のピルとして表示され、選択すると拡張ウィンドウ表示になります。
  • オブジェクト数を表示： 有効にすると、入力オブジェクトセット変数に含まれるオブジェクトの件数を表示するサブヘッダーがリストの上に表示されます。
  • ウィジェットの表示： デフォルトではオブジェクトをリストで表示しますが、グリッドで表示することもでき、行数、グリッド内の各オブジェクトカードのサイズ、グリッド内のカードの間隔を指定できます。
  • プロパティのスタイル： デフォルトでは、プロパティは値とともにインラインで表示されますが、値を揃えて表示することもできます。
  • 空状態のメッセージ： このウィジェットに表示するオブジェクトがないときの、空の状態のメッセージをカスタマイズします。

メディア設定

設定オプション

オブジェクトリストウィジェットのメディア設定オプションは次のとおりです。

• プロパティ： 表示する画像を含む、オブジェクトセットのプロパティです。現在、画像 URL、画像の添付ファイル、および Media Reference プロパティがサポートされています。
• メディアの表示： 選択したメディアは、大きな画像として表示するか、オブジェクトのタイトルの横にあるオントロジーアイコンに代わるアイコンとして表示できます。
• 画像の拡大プレビューを有効にする： 有効にすると、画像を拡大し、モーダル内で全体を表示できます。
• 画像にカーソルを置いたときにプロパティを表示： 有効にすると、画像にカーソルを置いたときに、画像上のオーバーレイに追加のプロパティが表示されます。
• 画像の位置： 画像はさまざまな場所に表示でき、高さまたは幅を固定サイズに設定できます。
• サイズ変更： 画像をトリミングして表示領域いっぱいに広げるか、コンテナに合わせてトリミングせずに画像全体を表示できます。

並べ替えの設定

ビルダーは、ユーザーがウィジェット内でオブジェクトカードをドラッグアンドドロップできるようにすることで、オブジェクトリスト内の項目を並べ替え可能に設定できます。

制限事項

• 現在、並べ替えは単一のオブジェクトリストウィジェット内でのみサポートされています。
• グリッドレイアウトでの項目の並べ替えは、現在サポートされていません。
• 並べ替えが有効な場合、オブジェクトリストウィジェットには最初の500個のオブジェクトのみが表示されます。

設定オプション

• 条件付きで有効化： ウィジェット内で並べ替えを有効にするかどうかを決定するブール変数を設定します。
• 主キーの配列： 表示されるオブジェクトの主キーを含む文字列配列を設定します。配列内の主キーの順序によって、ウィジェットの並べ替え済みセクションにこれらのオブジェクトが表示される順序が決まります。主キーが配列に含まれていないオブジェクトは、ウィジェット内の並べ替え済みオブジェクトの下にある未並べ替えリストセクションに表示されます。これらのオブジェクトは、並べ替えられていない状態で表示されるか、ウィジェットで設定されている場合はデフォルトの並べ替えが適用された状態で表示されます。
  • 項目を未並べ替えリストセクションからドラッグアンドドロップすると、そのオブジェクトの主キーが主キーの配列に追加されます。同様に、項目をウィジェットの未並べ替えリストセクションにドラッグアンドドロップすると、その項目の主キーが主キーの配列から削除されます。
  • 主キーの配列が空の場合、または表示されるオブジェクトの主キーと配列の内容に共通するものがない場合、ウィジェットの上部にコールアウトが表示され、ユーザーに「未並べ替えの項目を上にドラッグアンドドロップして並べ替え」るよう案内します。
  • 主キーの配列に、現在ウィジェットに表示されていないオブジェクトの主キーが含まれている場合、たとえば絞り込みによって表示対象から除外されている場合でも、その順序は維持されます。たとえば、配列の順序が [A, B, C, D] で、現在 B が絞り込みによってウィジェットの表示対象から除外されている場合、表示されるリストは [A, C, D] になります。ユーザーが D を A と C の間に並べ替えると、更新後の配列は [A, B, D, C] になります。唯一の例外は、ユーザーが項目を最後に表示されているオブジェクトの下にドラッグした場合です。この場合、その項目は最後に表示されているオブジェクトの直後に配置されます。
• 並べ替え時： ビルダーは、ウィジェット内の項目が並べ替えられたときに、主キーの配列を更新するか、アクションを実行するかを選択できます。
  • 配列変数を更新： ユーザーがウィジェット内の項目を並べ替えると、それに合わせて主キーの配列が更新されます。
    • 主キーの配列への更新は自動的に保存されないため、ユーザーがモジュールを再読み込みしたり、モジュールから別の場所に移動したりすると、主キーの配列への変更は失われます。配列への更新を保存するには、ビルダーが主キーの配列の新しい値を保存するアクションを設定する必要があります。ウィジェット内の項目が並べ替えられるたびにアクションをトリガーしたくない場合は、配列変数を更新オプションと、別途設定したアクション（たとえば、モジュール内の別の場所にあるボタングループウィジェットのアクション）を組み合わせて使用する方法が適しています。
  • アクションを実行： ユーザーがウィジェット内の項目を並べ替えるたびにトリガーされる並べ替え時のアクションを設定します。
    • 並べ替え時に更新された主キーの配列を表す特別な並べ替え後の配列パラメーターをアクションパラメーターとして使用して、配列への更新を保存できます。