リソースリスト

リソースリストウィジェットは、Foundryのさまざまな種類のリソースを表示するために使用されます：

ファイルとプロジェクトのリソース

この種類のリストは、ファイルとプロジェクトのリソースのコレクションを表示するために使用され、これらは固定的に配置されるか、各ユーザーがウィジェットを表示するたびに動的に生成され、既存のファイルとプロジェクトの階層と権限に従います。

ウィジェットの設定で ファイルとプロジェクトのリソース オプションが選択された場合、リソースリストの内容 メニューを使用してリソースのサブタイプを選択することもできます：

• 静的：ユーザーは手動で表示するリソースのリストを定義できます。
• 動的：
  • 最近：ユーザーが最近対話したリソース。
  • お気に入り：ユーザーがお気に入りにしたリソース。
  • フォルダー：ユーザーが指定したプロジェクトおよび/またはフォルダーのリストにあるリソース。
  • タグ：ユーザーはタグのリストを指定して、これらのタグの1つを持つリソースが表示されるようにすることができます。

オブジェクトタイプ

この種類のリストは、オブジェクトタイプのコレクションを表示するために使用され、これらは固定的に配置されるか、各ユーザーがウィジェットを表示するたびに動的に生成され、既存のオントロジーの権限と設定に従います。

オブジェクトタイプ オプションが選択された場合、オブジェクトタイプリストの内容 メニューから次のサブタイプを選択できます：

• 静的：ユーザーは手動で表示するオブジェクトタイプのリソースのリストを定義できます。
• 動的：
  • すべて：ユーザーに見えるオントロジー内のすべてのオブジェクトタイプ。
  • 目立つ：ユーザーに見え、目立つとマークされているオブジェクトタイプ。
  • お気に入り：ユーザーがお気に入りにしたオブジェクトタイプ。

オブジェクトセット

この種類のリストは、各アイテムが Workshop オブジェクトセット変数 によってバックアップされたオブジェクトセットの静的に固定されたコレクションを表示するために使用されます。オブジェクトセットリストを作成するには、ウィジェットの設定で最上位のドロップダウンから オブジェクトセット オプションを選択します。

以下は、複数のリソースリストを含むモジュールの例です。ファイルとプロジェクトのリソースは、モジュールの上部に水平に配置されています。その下のセクションには、ユーザーのお気に入りのオブジェクトタイプ が含まれており、その隣の行にはオブジェクトセットが含まれています。

リソースリストウィジェットは、以下のような多数のインタラクションと表示オプションをサポートしています：

• 2つのアイテム形式：
  • リスト
  • 画像カード
• 3つの表示スタイル：
  • ミニマム
  • 目立つ
  • クラシック

表示のオーバーライド

リストの各タイプについて、リストが静的に固定されている場合、各アイテムの表示をカスタマイズできます。デフォルトでは、ウィジェットはアイテムの表示メタデータを、リソースがファイルとプロジェクトまたはオントロジーにあるものと同一のものとして表示します。例えば、Slate ダッシュボードは、Slate アプリに表示されるタイトルとともに Slate アイコンを表示します。同様に、オブジェクトタイプはそのオントロジーアイコンとタイトルを表示します。場合によっては、これらの表示メタデータに対して異なる値を提供したり、画像カードリスト形式の場合、各アイテムに対して特定の画像（サムネイルと呼ばれる）を提供したりすることが望ましいかもしれません。

アイテムの表示をカスタマイズするには、ウィジェットの設定エディターでそのアイテムを選択し、Display Overrides セクションをオンにします。以下のメタデータを指定またはオーバーライドできます：

• タイトル：静的な文字列または文字列変数でオーバーライドできます。
• 説明：静的な文字列または文字列変数でオーバーライドできます。
• スタイル：ミニマム、クラシック、または目立つの選択でオーバーライドできます。
• アイコン：名前と定義済みまたはカスタムカラーの選択でオーバーライドできます。
• アイテムの可視性：アイテムの可視性を制御するためのブール型の変数を選択できます。値が false の場合、アイテムはリスト上で非表示になります。
• サムネイル（画像カード形式のみ）：ここではファイルとプロジェクトからの画像リソースを選択できます。リソースはまず Foundry にアップロードする必要があります。
• サムネイル位置（画像カード形式のみ）：上、右、下、または左の選択でオーバーライドできます。

Workshop 変数とイベントフレームワークとの統合

リソースリストの各アイテムは対話的です。実行されるアクションはリストのタイプによります：

• ファイルとプロジェクトのリソースリストの場合、リソースアイテムを選択すると、そのリソースが新しいブラウザタブでデフォルトの Foundry アプリケーションで開きます。ユーザーが Carbon ワークスペースにいて、そのリソースを Carbon で開くことができる場合、リソースは新しい Carbon タブで開きます。
  • データセットを表すアイテムは、新しいブラウザタブで Dataset Preview アプリケーションで開きます。データセットは直接 Carbon で開くことはできないため、常に Dataset Preview で開きます。
  • Slate ダッシュボードを表すアイテムは、新しいブラウザタブで Slate アプリケーション で開くか、ユーザーが Carbon にいる場合は新しい Carbon タブで開きます。
• オブジェクトタイプのリソースリストの場合、オブジェクトタイプのアイテムを選択すると、そのオブジェクトタイプのすべてのオブジェクトをシードにした新しい探索 Object Explorer が開きます。新しい探索は新しいブラウザタブで開くか、ユーザーが Carbon にいる場合は新しい Carbon タブで開きます。
• オブジェクトセットのリソースリストの場合、オブジェクトセットのアイテムを選択すると、そのオブジェクトセットが新しいブラウザタブで Object Explorer で開くか、ユーザーが Carbon にいる場合は新しい Carbon タブで開きます。

リソースリストのすべてのタイプについて、ウィジェットがアイテムの静的リストを表示するときにデフォルトのアクションをオーバーライドできます。ウィジェットの設定エディターでアイテムを選択し、標準の Workshop イベント を任意の数追加します。ファイルとプロジェクトのリソースの場合は リソースの選択時に、オブジェクトタイプのリソースの場合は オブジェクトタイプの選択時に、オブジェクトセットのリソースの場合は オブジェクトセットの選択時に を使用します。

Workshop Events の詳細については、イベントで変数を使用する方法を参照してください。

主なウィジェット設定の 選択されたオブジェクトタイプ または 選択されたオブジェクトセット セクションでは、選択されたオブジェクトタイプまたはオブジェクトセットの値を含む変数を設定できます。

リソースリストの内容 セクションでそのアイテムを選択して特定のアイテムの設定に移動します。その後、設定した 選択されたオブジェクトタイプ または 選択されたオブジェクトセット 変数をイベント設定で使用します。以下の例では、変数は オブジェクトエクスプローラーを開く イベントのパラメーターです。