本文为您介绍如何注册、调试、发布、删除组件等操作。
背景信息
Quick BI自定义组件有运行状态和显隐状态两种维度的状态。
运行状态
运行状态是描述自定义组件从创建到销毁的一系列状态, 根据组件的开发模式的不同而有所不同。通过自定义组件管理平台可以维护组件的运行状态, 其路径为开放平台>自定义组件。
在线编辑
待发布 - 刚注册, 或已发布且信息有修改, 但未同步到线上的状态。
已发布 - 线上运行中的状态。
专业模式
开发中 - 刚注册但未上传开发包的状态。
待发布 - 上传了开发包, 或已发布且信息有调整, 但未同步到线上的状态。
已发布 - 线上运行中的状态。
您可以在自定义组件管理平台上,维护组件的运行状态。
编辑组件
在组件管理列表中,单击图标。
在修改组件页面,修改界面参数。
单击确定。
完成修改后,组件会进入待发布状态,在专业模式下,开发可以通过种子项目中执行npm run pack
导出组件包。
调试组件
您可以按照下图指引 ,进行组件调试。
在线编辑下, 组件调试环境有3种:
在线开发环境 - 组件源码可以在线编辑,其他配置使用待发布包配置。
待发布环境 - 组件资源会从待发布包读取,其他配置使用待发布配置。
线上环境 - 组件资源会从已发布包读取,其他配置使用已发布配置。
专业模式下, 组件调试有3种模式:
本地调试:组件资源会从本地服务获取,适用于组件注册后的本地开发。
待发布包调试:组件资源会从待发布包获取,适用于待发布前的预览。
发布包调试:组件资源会从线上获取,使用于查看线上隐藏的组件。
本地调试下,请确保组件本地服务已经启动。
调试模式下, 仪表板自定义组件在菜单栏中显示, 即,组件的显隐状态失效。
调试模式下, 仪表板可以保存但无法发布。
在调试组件的对话框中, 选择要调试的调试范围、工作空间和对应的仪表板,单击前往调试, 会跳转到对应的仪表板页面,具体请参见调试组件。
显隐组件
显隐状态描述自定义组件是否在仪表板中展示出来,共有两种:
隐藏:点击隐藏后,自定义组件不展示在仪表板编辑页的添加图表->自定义中,也无法切换图表, 但可以显示之前保存过的图表。
显示:点击显示后,自定义组件展示在仪表板编辑页的添加图表->自定义中,支持切换图表。
在仪表板上则是该组件的入口显示或者隐藏。
修改组件显示状态不会让组件进入待发布状态,而是直接线上生效。
状态为开发中时,组件将会一直显示。
发布组件
在线编辑
在组件管理列表中,找到待发布状态的组件,单击发布图标,发布组件。
在弹出的发布组件对话框中, 确认变更内容无误后(有变更的属性会标红),单击确认发布。
组件就会进入已发布状态。
您可以点击查看代码比对查看具体的代码变动。
专业模式
发布组件前,请确保已上传开发包。
在组件管理列表中,找到待发布状态的组件,单击发布图标,发布组件。
在弹出的发布组件对话框中, 确认变更内容无误后(有变更的属性会标红),单击确认发布。
组件就会进入已发布状态。
删除组件
在组件管理列表中,找到目标组件,单击删除图标,删除组件。
删除组件后,有以下影响:
无法基于该自定义组件新增图表。
先前已经保存过该自定义组件的图表也将不能显示改组件,并在原来的该组件的位置提示该图表元信息异常或已被删除。