数据绑定
数据绑定是将准备好的数据集与画布上的可视化组件连接起来的机制。如果不绑定,图表或表格没有数据可以显示。Dashboardx Designer 通过交互式的数据绑定面板处理字段映射,让数据选择变得简单。
如何绑定数据集
选择画布上的某个组件后,数据绑定面板会列出所有可用的数据集。点击某个数据集前的复选框,该数据集下的所有可用字段都会被选中,Dashboardx Designer 会自动使用这些字段进行组件数据匹配和显示。
每个组件对数据集字段都有特定要求,可通过组件的示例模板了解具体要求。如果只需展示部分字段,可点击字段前的复选框取消选择不需要的字段。
改名不再打断绑定
组件绑定的不是列名的文本,而是列本身。v2.0.0 起,智能体在绑定时同样按列本身引用字段,而不是按名字匹配。
带来的直接好处是:重建数据集、调整列顺序、修改列标题,都不会让已经配好的图表悄悄失去字段。名字只是给人看的标签。
等待数据集加载完成
数据集创建后会在后台加载,加载完成前无法绑定——绑到半成品上的图表会画出一张悄悄错误图。加载期间数据集旁有加载图标,完成后图标消失。
详见 后台加载的数据集。
切片语义修正
v2.0.0 中切片语义被重新规定:
- 切片区域为组件拥有的只读输出。组件在每次选择变化时覆盖其内容,智能体或用户不能在其中写入。
- 连接在切片区域上的其他组件应在其数据集中引用该区域,而不是直接绑定切片区域。
详见 数据切片。
选择器组件的默认值
单选框、下拉框、复选框可以预设默认选中值,让切片从一开始就有数据。在 属性列表 → 通用设置 选项卡的 控件配置 → 选中值 中设置;默认值需要与数据集中的取值完全一致,多选模式下可以预设多个值。图表类组件不需要默认选中值 —— 它们等待用户点击。
该值会在文档打开时写入切片,之后你在面板中改动它也会立即生效;但不会覆盖随文件一起恢复的选中项——详见 数据切片。
绑定数据集的展示
在画布上选定已完成数据集绑定的组件后,数据绑定面板中该数据集前的复选框会显示选中或部分选中状态。选中状态表示数据集的所有字段都在组件中展示,部分选中状态表示只有部分字段在组件中展示。
切片数据集
数据绑定面板也会展示所有的切片数据集,当前切片数据集不支持与组件进行直接绑定。
⚠ 警告
所有支持数据绑定的组件能且只能和一个数据集进行绑定。
常见问题
为什么绑定被拒绝,提示数据集仍在加载?
数据集还没加载完。等图标消失(列与行数已填充)后重试即可。由智能体发起的绑定会自动等待。
改名后需要重新绑定吗?
通常不需要。字段绑定不依赖列名,改标题、调顺序都不影响已有绑定。只有当你删除并重建了数据集,才需要重新选择字段。
能使用带中文列名的数据集吗?
可以。列名只是绑定面板中的显示文字。
数据集已经绑定,图表却什么都不显示
- 在数据空间里打开这个数据集,确认它确实有行。
- 确认勾选的是你想用的那个数据集,而不是名字很像的另一个。
- 检查有没有某个喂给这个组件的切片当前处于空选中状态。
- 核对组件要求的形状与你给的是否一致——文件 → 从模板新建 里的示例模板是最快的参照。
数据行数远多于图表能展示的量
先聚合再用。在数据空间里用公式把数据降到图表真正需要的层级——一个读几百行汇总结果的组件,远好于一个读几万行原始记录的组件。