リソースリスト

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

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

この種類のリストは、既存のファイルとプロジェクトの階層および権限に従って、ファイルとプロジェクトのリソースをまとめて表示するために使用します。リストは固定することも、ウィジェットを閲覧するユーザーごとに動的に生成することもできます。

ウィジェットの設定で、リソースリストの種類ドロップダウンメニューからファイルとプロジェクトのリソースを選択すると、リソースリストの内容メニューからリソースのサブタイプも選択できます。

• 固定：リストに表示するリソースの一覧をユーザーが手動で定義できます。
• 動的：
  • 最近使用したリソース：ユーザーが最近操作したリソースです。
  • お気に入り：ユーザーがお気に入りに登録したリソースです。
  • フォルダー：ユーザーが指定したプロジェクトやフォルダーの一覧に含まれるリソースです。
  • タグ：ユーザーがタグの一覧を指定すると、そのいずれかのタグがついたリソースが表示されます。

オブジェクトタイプ

この種類のリストは、既存のオントロジーの権限および設定に従って、オブジェクトタイプをまとめて表示するために使用します。リストは固定することも、ウィジェットを閲覧するユーザーごとに動的に生成することもできます。

オブジェクトタイプを選択すると、オブジェクトタイプリストの内容メニューから次のいずれかのサブタイプを選択できます。

• 固定：表示するオブジェクトタイプのリソースの一覧をユーザーが手動で定義できます。
• 動的：
  • すべて：オントロジー内でユーザーが閲覧できるすべてのオブジェクトタイプです。
  • 強調：ユーザーが閲覧でき、重要性が「強調」に指定されているオブジェクトタイプです。
  • お気に入り：ユーザーがお気に入りに登録したオブジェクトタイプです。

オブジェクトセット

この種類のリストは、固定されたオブジェクトセットの一覧を表示するために使用します。各項目は Workshop オブジェクトセット変数を元にしています。オブジェクトセットのリストを作成するには、ウィジェットの設定の最上位のドロップダウンからオブジェクトセットを選択します。

以下は、複数のリソースリストを含むモジュールの例です。ファイルとプロジェクトのリソースは、モジュールの上部に横方向に表示されています。その下のお気に入りのオブジェクトタイプというタイトルのセクションにはオブジェクトタイプが含まれ、オブジェクトタイプの隣の列にはオブジェクトセットが含まれています。

リソースリストウィジェットは、次のようなさまざまなインタラクションや表示オプションもサポートしています。

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

表示のオーバーライド

いずれの種類のリストでも、リストが固定されている場合は、各項目の表示をカスタマイズできます。デフォルトでは、ウィジェットは、ファイルとプロジェクトまたはオントロジーのリソースと同じ表示メタデータを項目に表示します。たとえば、Slate ダッシュボードには Slate アイコンと、Slate アプリに表示されるタイトルが表示されます。同様に、オブジェクトタイプにはオントロジーのアイコンとタイトルが表示されます。場合によっては、これらの表示メタデータに別の値を指定したり、画像カードのリスト形式の場合は、各項目にサムネイルと呼ばれる特定の画像を指定したりすると便利です。

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

• タイトル：固定の文字列または文字列変数でオーバーライドできます。
• 説明：固定の文字列または文字列変数でオーバーライドできます。
• スタイル：ミニマル、クラシック、強調のいずれかを選択してオーバーライドできます。
• アイコン：名前と、定義済みまたはカスタムの色を選択してオーバーライドできます。
• 項目の表示設定：項目の表示設定を制御するブール変数を選択できます。値が false の場合、項目はリストで非表示になります。
• サムネイル（画像カード形式のみ）：ファイルとプロジェクトの画像リソースをここで選択できます。リソースは事前に Foundry にアップロードしておく必要があります。
• サムネイルの位置（画像カード形式のみ）：上、右、下、左のいずれかを選択してオーバーライドできます。

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

リソースリストの各項目は操作できます。実行されるアクションは、リストの種類によって異なります。

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

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

ウィジェットのメイン設定で、該当する種類の選択されたオブジェクトタイプまたは選択されたオブジェクトセット変数が設定されている場合、イベント設定で、選択されたオブジェクトタイプの項目またはオブジェクトセットの項目自体を参照できます。イベントでの変数の使用について詳しくは、Workshop イベントを参照してください。

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

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