前端清单文档
本文档详细指导如何在 Fabric 工作负载中构造和配置前端清单。 通过这些基于 JSON 的清单,合作伙伴能够定义工作负载外观、标识和行为,这对于在 Fabric 中为用户提供定制且一致的体验至关重要。
前端清单由两个主要组件组成:
- 产品清单:定义工作负载标识和品牌。
- 项清单:工作负载中各个项的详细信息配置,包括用户交互元素。
产品清单
产品清单定义工作负载产品的核心属性,指定其标识、品牌和用户交互配置。
特性
- name(字符串):产品的唯一系统名称。
- displayName(字符串):用户易记的显示名称。
- fullDisplayName(字符串):产品的描述性名称。
- favicon(字符串):产品网站图标的路径。
- icon(对象):产品图标的路径,存储在资产文件夹中(例如“assets/icon.png”)。
主页配置
定义工作负载主页的布局和内容。
- homePage(对象):主页的配置设置。
- learningMaterials(数组):工作负载详细信息页上显示的学习材料列表。
- title(字符串):学习材料的标题。
- introduction(字符串):材料的简介。
- description(字符串):材料的详细描述。
- onClick(对象):单击材料时触发的操作。
- image(字符串):与材料关联的图像的路径。
- recommendedItemTypes(数组):工作负载详细信息页上显示的推荐项类型的列表。
- learningMaterials(数组):工作负载详细信息页上显示的学习材料列表。
创建体验
在产品中创建新项时的配置,用于指定用户交互选项。
- 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(对象):用于重试作业的操作。
- registeredActions(对象):包含详细信息、取消和重试等作业操作。
项目设置
项设置的配置选项。
- itemSettings(对象):项的额外设置。
- schedule(对象):包含计划信息。
- itemJobType(字符串):要从 Fabric 共享 UI 计划的作业类型。
- refreshType(字符串):指定项的刷新功能。 可能的值包括
"None"
、"Refresh"
和"Run"
。
- recentRun(对象):最近的作业运行配置。
- useRecentRunsComponent(布尔):是否使用 Fabric 共享的最近运行组件。
- getItemSettings(对象):自定义项设置的配置。
- 操作(字符串):返回自定义项设置列表的相应操作的名称。
- schedule(对象):包含计划信息。
项任务流类别
定义与 Fabric 任务流框架集成的项类别。
- itemJobTypes(数组):指定分配给任务流框架中的项的类别。 每个项最多可以有两个类别。 支持的类别为
"getData"
、"storeData"
、"prepareData"
、"analyzeAndTrainData"
、"trackData"
、"visualizeData"
、"develop"
、"generalTask"
和"others"
。 如果未指定任何类别,则使用“其他”作为默认值。