[]
通过配置组件的命令实现多样化的功能,包括更新组件的状态、切换页面以及控制3D组件的漫游路径等。这种方式赋予了灵活操控数据大屏的能力,能够实现动态交互、页面导航以及复杂的三维组件动态数据展示,满足从状态管理到视觉呈现的多种设计需求。
本节为您详细介绍如何通过命令来执行特定的操作。
图表
表格
图片组件
按钮组件
打开组件的属性面板,在数据交互中找到“鼠标左键选项”,将该选项设定为“命令”。
点击“添加项目”,在弹出的对话框中选择命令的种类,并根据选项设置命令。
type=info
注意:
不同种类的可视化组件支持的命令种类不完全一样。
每种命令的设置项目不完全相同,将在“3.常用命令说明”中为您一一介绍
为组件添加命令之后,在仪表板的运行时(预览报表、在门户站点中查看报表),通过点击鼠标左键,即可触发命令并执行相应操作。
例如,为按钮组件添加了一个命令,用来控制柱状图组件的显示与隐藏。
在仪表板设计器中预览该仪表板,或者保存该仪表板之后在门户站点中查看该仪表板,点击按钮,执行命令,隐藏或显示柱状图。
type=info
注意:
可以为组件添加多个命令,命令执行的时候,将按照命令项目的顺序依次执行。
用于控制组件的显示及隐藏,点击“+”添加需要控制的组件,可同时添加多个组件。
指定切换的目标页面,运行时点击按钮组件,将切换到指定页面。
用于切换指定选项卡组件的页签。用户需要选择选项卡容器及需要切换的目标页签。
当跳转的目标页面中,包含一个按钮组件,且设定该按钮组件的命令为“关闭跳转”。当通过跳转打开目标页面,点击该按钮,将关闭跳转的目标仪表板。
在命令中实现跳转的行为。
为按钮添加跳转设置项目。在命令设置对话框中,指定跳转项目。运行时点击按钮,执行跳转行为。
通过点击组件,为仪表板参数赋值。
为仪表板添加参数,在命令对话中,选定参数并为这个参数赋值。
type=info
注意:
无法通过命令为多值参数及多维数据参数赋值。
通过点击组件,调用外部API。
以下通过点击按钮向推送数据集添加数据的示例,展示如何调用外部API。
创建一个推送数据集,获得端点地址。
在仪表板中添加一个外部API,并将获得的推送数据集端点地址填入其中。
保存该外部API
在仪表板中添加一个按钮组件,并设置命令为“调用外部API”,并选择刚刚创建的外部API,并填入要发送的数据。数据的格式请参考推送数据集的请求体。
添加一个数据表,并绑定该推送数据集,并将该数据集设置为实时刷新。
保存仪表板并返回至文档门户站点。
查看该仪表板,点击按钮,可以看到每点击一次向推送数据集中推送一笔数据。
type=warning
注意:
以上仅结合示例向您展示如何通过点击按钮调用外部API,您可根据自身需求灵活应用此功能。
通过点击导出对应组件。
在命令设置对话框中,选择“导出”,在组件下拉列表中选择需要导出的的组件(可选范围为图表及表格组件)。根据实际需求选择导出类型。
通过点击组件来执行3D场景的自定义脚本。
在命令设置对话框中,选择“3D场景自定义脚本”,绑定当前仪表板中的3D场景,选择该场景中包含的自定脚本。如何创建3D场景的自定义脚本,请参考:3D模型自定义脚本。
通过按钮来控制3D场景数据漫游的开启或停止。
在命令设置对话框中,选择“3D场景数据点漫游”,绑定当前仪表板中的3D场景,设置数据点漫游动作,提供三个数据点漫游动作供用户选择:
开始数据漫游:点击按钮开始数据点漫游。
停止数据点漫游:点击按钮停止数据点漫游。
暂停/恢复 数据点漫游:点击按钮开始执行数据点漫游,再次点击暂停数据点漫游,再次点击恢复执行数据点漫游,依此类推。
通过按钮来控制3D场景路径漫游的开启或停止。
在命令设置对话框中,选择“3D场景路径漫游”,绑定当前仪表板中的3D场景,设置路径漫游动作,提供三个路径漫游动作供用户选择:
开始路径漫游:指定路径漫游名称,运行时,点击按钮开始路径漫游。
停止路径漫游:点击按钮停止路径漫游。
暂停/恢复 路径漫游:点击按钮开始执行路径漫游,再次点击暂停路径漫游,再次点击恢复执行路径漫游,依此类推。
通过按钮来控制3D场景中动画的开启与停止。
在命令设置对话框中,选择“3D场景动画”,绑定当前仪表板中的3D场景,选择动画名称,设置动画执行动作,提供三个动画动作供用户选择:
开始动画:运行时,点击按钮开始播放动画。
停止动画:点击按钮停止播放动画。
暂停/恢复 动画:点击按钮开始播放动画,再次点击暂停播放动画,再次点击恢复播放动画,依此类推。
type=info
注意:
在3D模型中,动画的执行时机必须是“手动触发”。手动触发的动画才能在仪表板中通过命令来控制它的执行状态。
通过组件来控制复合地图中各个图层的显示或隐藏。
在命令设置对话框中,选择“更新复合地图图层”,绑定当前仪表板中的复合地图,指定图层,并为各个图层添加动作来控制该图层的显示状态。
为图表组件添加钻取命令,可以通过单击鼠标左键来实现钻取的功能。