区块是基于基础组件封装的高级功能模块,作为黑盒工具,它能够定义内外数据传输,内部封装了组件样式、布局、默认数据(不含动态数据源)和蓝图逻辑,外部则定义了业务相关的数据接口。本文将介绍如何创建和管理区块,帮助用户高效完成区块设计与应用。
使用限制
区块功能为专业版及以上版本专属特性,如需使用,请升级至专业版或尊享版。
进入区块管理
- 登录DataV控制台。
在我的资产页签中选择左侧导航栏中的我的区块。
创建区块
平台支持创建空白区块和模板区块,用户可根据需求选择从零开始设计或基于预设模板快速构建功能模块。
创建空白区块
在我的区块页面内,单击新建区块。
在弹出的选择区块模板对话框中,单击对话框右下角的直接创建。
在新建区块对话框中,填写新建区块的信息。
参数
说明
英文名
(必填)输入区块的英文名,20字符以内的英文,数字及中划线,不可以有空格,创建后不可修改。如
block-test-xz
,英文名称必须是唯一的,不能与系统中其它区块重名。显示名
(必填)输入区块的显示名,20字符以内,不可包含特殊字符,可随时修改。如测试区块,可以与系统中其它区块重名。
预设尺寸
预先设定区块的尺寸大小,系统默认有多种选择,可选:
横向(适用PC)480x260px
横向(适用PC)900x260px
纵向布局(适用大屏)260x940px
纵向布局(适用大屏)380x940px
纵向布局(适用大屏)480x940px
区块信息填写完成后,单击确定,完成创建一个空白区块。创建完成后系统会自动跳转到区块编辑器面板中,区块编辑器功能介绍请参见区块编辑器概览。
新创建的区块会自动显示在我的区块页面列表中。
创建模板区块
在我的区块页面内,单击页面上方的新建区块。
在弹出的选择区块模板对话框中,鼠标移动到模板区块上,单击新建区块。
在弹出的创建区块对话框中,填写被创建的区块信息。
参数
说明
英文名
(必填)输入模板区块的英文名,20字符以内的英文,数字及中划线,不可以有空格,创建后不可修改。如
block-test-xz
,英文名称必须是唯一的,不能与系统中其他区块重名。显示名
(必填)输入模板区块的显示名,20字符以内,可随时修改。如测试区块,可以与系统中其它区块重名。
区块信息填写完成后,单击确定,完成创建一个模板区块。创建完成后系统会自动跳转到区块编辑器面板中,区块编辑器功能介绍请参见区块编辑器概览。
新创建的区块会自动显示在我的区块页面列表中。
区块操作
区块管理支持复制、删除和授权等操作,方便用户灵活管理和调整区块内容,提升看板设计的效率与协作性。
删除区块
在我的区块页面中,单击待复制区块名称右侧的
图标,选择删除。
单击对话框右下角的确定即可删除当前区块;单击取消即可取消删除操作。
删除区块后,已添加到可视化应用上的区块功能仍然可以使用,但无法从资产列表中再次添加该区块。
复制区块
在我的区块页面中,单击待复制区块名称右侧的
图标,选择复制。
在复制对话框输入区块的英文名和显示名,单击右下角的确定即可复制该区块到当前工作空间账号下,并跳转到区块编辑器中。
重命名区块
在我的区块页面中,单击区块名称左侧的图标,在重命名输入框中自定义修改名称,完成后单击空白处或按下回车键即可完成重命名。
区块授权与拷贝
区块功能集成了权限管理与共享拷贝能力,为用户提供安全可控的区块协作解决方案。
授权区块
用户可灵活配置区块访问权限,实现细粒度的数据安全管理与控制。
在我的区块页面中,单击待复制区块名称右侧的
图标,选择授权。
在区块授权对话框中,输入目标用户的用户识别码,设置区块使用的截止时间,然后单击右下角的授权按钮,即可将该区块的使用权限授予其他用户。
在控制台首页,单击右上角账号旁的下拉列表,即可查找您的用户识别码。
区块授权的默认权限等级为订阅者,订阅者仅可在编辑页的区块列表中查看和使用已上线的区块。
授权后,您可以单击区块名称后的授权,进入区块授权对话框,在已授权记录中查看授权记录。如果您需要解除授权,单击操作列的解除授权,在弹出的确认对话框中单击确定,即可解除该区块的授权。
拷贝区块
区块支持拷贝给他人操作,为用户提供灵活的区块管理方式和高效的团队协作体验。
在我的区块页面中,单击待复制区块名称右侧的
图标,选择拷贝。
在弹出对话框中输入目标用户识别码,单击确认即可将当前区块复制至该用户账号。
在控制台首页,单击右上角账号旁的下拉列表,即可查找您的用户识别码。
如果被拷贝的用户缺少区块内的组件权限,则拷贝失败。
发布与预览区块
在区块管理中,发布与预览功能使用户能够在正式发布前预览区块,确保内容和样式符合预期。通过预览区块,用户可以实时查看效果并进行必要的调整和优化,从而提升区块的质量和一致性。
预览区块
在我的区块页面中,单击目标区块,进入区块编辑器,单击右上角的
图标预览区块页面。
在预览页内,您可以查看区块的整体样式,并配置右侧的样式、数据、事件和动作等功能。操作示例如下表:
名称
操作
样式
在样式页签内配置不同的样式,参考组件指南中的配置说明。
如下图所示,在样式页签中,将轮播列表组件中的表头配置项内的背景颜色设置成红色。
数据
在数据页签内,输入不同的数据内容,并查看内部组件的数据配置和对应的样式是否符合调整的预期。
如下图所示,可以在右侧数据页签输入额外的数据,单击下方的测试按钮,即可查看对应组件中显示数据内容的变更。
输入不同数据
测试新增数据成果
事件
在事件页签中,单击某个事件对应区块中的组件,查看组件内部抛出的数据在事件页签中是否正确。
如下图所示,单击轮播列表组件中的一行数据,可以在右侧轮播列表点击事件页签中的事件响应结果处,监听轮播列表组件被单击时抛出的数据。
动作
在动作页签中,针对某个动作输入不同的参数,查看该动作对应内部组件的行为是否符合修改预期。
如下图所示,可以在右侧动作页签的更新样式下的测试参数输入框中输入颜色参数,把垂直胶囊柱状图的柱子边框颜色变为绿色。
单击预览页面右上角的
图标,即可返回区块编辑页面继续编辑区块内容。
如果预览成功且区块内容各功能测试后符合预期,可将区块发布到线上环境供其他人员在后续的可视化应用中直接添加使用。
发布区块
在我的区块页面中,单击目标区块,进入区块编辑器,单击右上角的
图标发布区块。
在发布区块对话框中,输入本次发布的区块自定义备注内容,单击右下角的确认。
如果非首次发布,您可以查看区块上次发布的版本号和发布时间。
发布成功后的区块,可在DataV控制台的我的资产页签下的我的区块中,单击某一区块的查看历史处,查看该区块的历史版本。
区块版本与资产管理
区块版本历史管理
区块的版本历史功能仅在区块发布后可用。每次发布都会为当前区块内容生成一个快照,并分配一个新的版本号。未发布过的区块不会生成历史版本信息。
在我的区块页面中,单击某个区块上方的查看历史。
在右侧弹出的历史版本面板中,您可以查看当前区块的所有版本,包括区块的版本号、发布时间、说明、状态和操作等信息。
区块版本信息参数
说明
版本号
每个区块支持多版本,最新版本号为当前已发布的最大版本号。如需更新,请在画布编辑器中单击升级至最新版本。
发布时间
每一个版本区块的发布详细时间。
说明
发布区块时自定义设置的版本情况说明。
状态
区块版本的上下线状态。
操作
针对不同状态下的历史版本的区块,可对区块进行上线或下线的操作。
上线:单击一个未上线状态下区块右侧的
图标,在弹出的上线版本对话框中,单击确定即可上线该版本区块内容。
下线:单击一个已上线状态下区块右侧的
图标,在弹出的下线版本对话框中,单击确定即可下线该版本区块内容。
默认情况下,区块发布后即处于已上线状态。上线后,您可以在可视化应用画布编辑器中单击升级按钮,将区块更新至最新版本后继续使用。
升级收藏资产为区块
在我的资产页签中选择左侧导航栏的组件收藏夹。
鼠标移动至某个收藏的资产上方,单击资产内的
图标。
在升级成区块对话框中,按命名要求填写区块的英文名和显示名。
只有配置了静态数据或API数据源的收藏资产,才能在升级为区块时生效,同时您需配置内部数据的传输逻辑。
完成区块配置项的填写后,单击右下角的确定按钮,即可将资产成功升级为区块。
升级后的区块会自动显示在我的区块管理页面中。
相关文档
使用区块编辑器相关操作。
- 本页导读 (1)
- 使用限制
- 进入区块管理
- 创建区块
- 创建空白区块
- 创建模板区块
- 区块操作
- 删除区块
- 复制区块
- 重命名区块
- 区块授权与拷贝
- 授权区块
- 拷贝区块
- 发布与预览区块
- 预览区块
- 发布区块
- 区块版本与资产管理
- 区块版本历史管理
- 升级收藏资产为区块
- 相关文档