前端清单文档

本文档详细指导如何在 Fabric 工作负载中构造和配置前端清单。 通过这些基于 JSON 的清单,合作伙伴能够定义工作负载外观、标识和行为,这对于在 Fabric 中为用户提供定制且一致的体验至关重要。

前端清单由两个主要组件组成:

  • 产品清单:定义工作负载标识和品牌
  • 项清单:工作负载中各个项的详细信息配置,包括用户交互元素

产品清单

产品清单定义工作负载产品的核心属性,指定其标识、品牌和用户交互配置。

特性

  • name(字符串):产品的唯一系统名称
  • displayName(字符串):用户易记的显示名称
  • fullDisplayName(字符串):产品的描述性名称
  • favicon(字符串):产品网站图标的路径
  • icon(对象):产品图标的路径,存储在资产文件夹中(例如“assets/icon.png”)

主页配置

定义工作负载主页的布局和内容。

  • homePage(对象):主页的配置设置
    • learningMaterials(数组):工作负载详细信息页上显示的学习材料列表
      • title(字符串):学习材料的标题
      • introduction(字符串):材料的简介
      • description(字符串):材料的详细描述
      • onClick(对象):单击材料时触发的操作
      • image(字符串):与材料关联的图像的路径
    • recommendedItemTypes(数组):工作负载详细信息页上显示的推荐项类型的列表

创建体验

在产品中创建新项时的配置,用于指定用户交互选项。

  • createExperience(对象):用于创建工作负载项的配置
    • description(字符串):针对创建体验的一般说明
    • cards(数组):创建过程中显示的卡片列表
      • title(字符串):卡片的标题
      • description(字符串):卡片的简要说明
      • icon(对象):卡片中使用的图标的路径
      • onClick(对象):单击卡片时触发的操作
      • availableIn(数组):可以使用卡片的位置
      • itemType(字符串):链接到已创建卡片的项的类型

工作区设置和产品详细信息

  • workspaceSettings(对象):特定于工作区功能的设置
    • getWorkspaceSettings(对象):包含用于检索工作区设置的操作
  • productDetail(对象):产品品牌和信息的其他详细信息
    • publisher(字符串):产品的发布者
    • slogan(字符串):产品口号
    • description(字符串):产品的简短说明
    • image(对象):产品映像的配置
      • mediaType(整数):图像的媒体类型
      • source(字符串):图像的路径
    • slideMedia(数组):产品详细信息页幻灯片中使用的媒体文件列表

项清单

项清单定义工作负载中各个项的配置详细信息,包括属性、图标、编辑器路径和与作业相关的设置。

特性

  • name(字符串):项的唯一系统名称
  • displayName(字符串):显示的该项的用户易记名称
  • displayNamePlural(字符串):用于显示目的的显示名称的复数形式

编辑器和图标配置

  • editor(对象):Fabric 工作负载应用中项编辑器的路径配置
    • path(字符串):编辑器的相对路径
  • icon(对象):指定表示项的图标
    • name(字符串):资产文件夹中图标文件的路径(例如“assets/icon.svg”)

上下文菜单项

定义项上下文菜单中可用的操作,为用户提供交互选项。

  • contextMenuItems(数组):上下文菜单中的操作列表
    • name(字符串):操作的系统名称
    • displayName(字符串):操作的显示名称
    • icon(对象):操作的图标
      • name(字符串):图标文件的路径(例如“assets/icon.svg”)
    • handler(对象):菜单项的操作处理程序
      • action(字符串):所触发操作的名称
    • tooltip(字符串):操作的可选工具提示文本

监视和 DataHub 配置

  • supportedInMonitoringHub(布尔):指定是否可以在监视中心显示或筛选该项
  • supportedInDatahubL1(布尔):指定是否可以在 DataHub L1 中显示或筛选该项

项作业操作配置

与项作业实例关联的作业相关操作的配置。

  • itemJobActionConfig(对象):定义与项作业相关的操作
    • registeredActions(对象):包含详细信息、取消和重试等作业操作
      • detail(对象):用于查看作业详细信息的操作
      • cancel(对象):用于取消作业的操作
      • retry(对象):用于重试作业的操作

项目设置

项设置的配置选项。

  • itemSettings(对象):项的额外设置
    • schedule(对象):包含计划信息
      • itemJobType(字符串):要从 Fabric 共享 UI 计划的作业类型
      • refreshType(字符串):指定项的刷新功能。 可能的值包括 "None""Refresh""Run"
    • recentRun(对象):最近的作业运行配置
      • useRecentRunsComponent(布尔):是否使用 Fabric 共享的最近运行组件
    • getItemSettings(对象):自定义项设置的配置。
      • 操作(字符串):返回自定义项设置列表的相应操作的名称。

项任务流类别

定义与 Fabric 任务流框架集成的项类别。

  • itemJobTypes(数组):指定分配给任务流框架中的项的类别。 每个项最多可以有两个类别。 支持的类别为 "getData""storeData""prepareData""analyzeAndTrainData""trackData""visualizeData""develop""generalTask""others"。 如果未指定任何类别,则使用“其他”作为默认值。

注意

开发和测试添加到清单的新属性时,请确保已从示例存储库中同步最新的验证脚本工具

此步骤仅仅是本地开发所需的,不是云模式所需的。