用例开发WorkshopVisualization widgets资源列表

注意:以下翻译的准确性尚未经过验证。这是使用 AIP ↗ 从原始英文文本进行的机器翻译。

资源列表

资源列表微件用于显示各种类型的Foundry资源:

文件和项目资源

此类型列表用于显示文件和项目资源的集合,这些集合可以是静态固定的,也可以根据每个查看微件的用户动态生成,符合现有的文件和项目层次结构和权限。

文件和项目资源设置菜单。

当在微件配置的资源列表类型下拉菜单中选择文件和项目资源选项时,您还可以使用资源列表内容菜单选择资源的子类型:

  • 静态:用户可以手动定义要在列表中显示的资源列表。
  • 动态:
    • 最近的:用户最近互动过的资源。
    • 收藏的:用户已收藏的资源。
    • 文件夹:位于用户指定的项目和/或文件夹列表中的资源。
    • 标签:用户可以指定一个标签列表,以便具有这些标签之一的资源将显示出来。
文件和项目资源设置菜单。

对象类型

此类型列表用于显示对象类型的集合,可以是静态固定的,也可以根据每个查看微件的用户动态生成,符合现有Ontology权限和设置。

对象类型资源设置菜单

当选择对象类型选项时,您可以从对象类型列表内容菜单中选择以下子类型之一:

  • 静态:用户可以手动定义要显示的对象类型资源列表。
  • 动态:
    • 全部:Ontology中用户可见的每种对象类型。
    • 重要:用户可见的被标记为重要的对象类型。
    • 收藏的:用户已收藏的对象类型。
对象类型资源设置菜单

对象集

此类型列表用于显示静态固定的对象集集合,其中每个项目由一个Workshop对象集变量支持。要创建对象集列表,请从微件配置顶级下拉菜单中选择对象集选项。

对象集资源设置菜单

下面是一个包含多个资源列表的模块示例。文件和项目资源位于模块顶部,水平显示。在它们下面,标题为您最喜欢的对象类型的部分包含对象类型,而对象类型旁边的列包含对象集。

一个显示不同类型资源列表的Workshop模块示例

资源列表微件还支持多种交互和显示选项,包括:

  • 两种项目格式:
    • 列表
    • 图片卡片
  • 三种显示样式:
    • 最小化
    • 重要
    • 经典

列表格式最小化显示样式配置 列表格式经典显示样式配置 列表格式重要显示样式配置

图片卡片格式最小化显示样式配置 图片卡片格式经典显示样式配置 图片卡片格式重要显示样式配置

显示覆盖

对于每种列表类型,如果列表是静态固定的,那么每个项目都可以自定义其显示。默认情况下,微件将显示项目的显示元数据,与文件和项目或Ontology中的资源相同。例如,Slate仪表盘将显示Slate图标以及在Slate应用中显示的标题。同样,对象类型将显示其Ontology图标和标题。在某些情况下,可能希望为这些显示元数据提供不同的值,或者在图片卡片列表格式的情况下,为每个项目提供一个特定的图片(称为缩略图)。

静态列表项目显示覆盖配置

要自定义项目的显示,请在微件的配置编辑器中选择该项目并开启显示覆盖部分。可以指定或覆盖以下元数据:

  • 标题:可以用静态字符串或字符串变量覆盖。
  • 描述:可以用静态字符串或字符串变量覆盖。
  • 样式:可以选择最小化、经典或重要来覆盖。
  • 图标:可以选择名称和预定义或自定义颜色来覆盖。
  • 项目可见性:可以选择一个布尔变量来控制项目的可见性。如果值为false,则该项目将在列表中隐藏。
  • 缩略图(仅适用于图片卡片格式):可以选择文件和项目中的图片资源。资源必须先上传到Foundry。
  • 缩略图位置(仅适用于图片卡片格式):可以选择顶部、右侧、底部或左侧来覆盖。
静态列表项目显示覆盖配置

与Workshop变量和事件框架的集成

资源列表中的每个项目都是交互式的。执行的操作将取决于列表的类型:

  • 对于文件和项目资源列表,选择资源项目将会在新浏览器标签页中打开默认Foundry应用中的该资源。如果用户在Carbon工作区,并且该资源可以在Carbon中打开,则资源将在新Carbon标签页中打开。
    • 代表数据集的项目将会在新浏览器标签页中打开数据集预览应用。由于数据集不能直接在Carbon中打开,它们将始终在数据集预览中打开。
    • 代表Slate仪表盘的项目将会在新浏览器标签页中打开Slate应用,或者在用户位于Carbon中的情况下在新Carbon标签页中打开。
  • 对于对象类型资源列表,选择对象类型项目将会打开一个新的探索对象浏览器,其中包含该对象类型的所有对象。新的探索将在新浏览器标签页中打开,或者在用户位于Carbon中的情况下在新Carbon标签页中打开。
  • 对于对象集资源列表,选择对象集项目将会在对象浏览器中打开该对象集,在新浏览器标签页中打开,或者在用户位于Carbon中的情况下在新Carbon标签页中打开。

对于所有类型的资源列表,当微件显示静态项目列表时,可以覆盖默认操作。在微件的配置编辑器中,选择该项目并添加任意数量的标准Workshop事件。对于文件和项目资源,请使用选择资源时,对于对象类型资源,请使用选择对象类型时,对于对象集资源,请使用选择对象集时

选择在列表中单击项目时应该发生的Workshop事件

如果在主要微件配置中为正确类型设置了所选对象类型所选对象集变量,则可以在事件配置中引用所选对象类型项目或对象集项目本身。有关在事件中使用变量的更多信息,请参阅Workshop事件

在主要微件配置的所选对象类型所选对象集部分,您可以设置包含所选对象类型或对象集值的变量。

配置列表中所选项目的变量

通过在资源列表内容部分选择该项目导航到特定项目的配置。然后在事件配置中使用配置的所选对象类型所选对象集变量。在下面的示例中,变量是打开对象浏览器事件的参数。

在Workshop事件中使用所选项目的配置