[]
跳转至带参数的仪表板或报表时,可为目标参数指定固定值,也可从源仪表板的数据点、筛选器、过滤后的数据或仪表板参数中获取值。
本章介绍各数值类型的配置方法,以及字段选择、空值处理和多字段传递规则。创建跳转项目的操作请参阅“跳转至仪表板”。
在组件的跳转设置对话框中选择目标仪表板,然后展开【文档设置】区域。参数设置面板将列出目标仪表板中的所有参数。
为需要传值的参数选择【数值类型】,并配置对应的【数值】。

数值类型 | 参数来源 |
|---|---|
【未设置】 | 不主动指定值,传递Null 值(即空值)给目标仪表板。 |
【常量值】 | 配置时输入的固定的常量值。 |
【数据列】 | 当前选中数据点对应字段的值,以及有效钻取路径中记录的字段值。 |
【筛选器】 | 指定筛选器当前选择的值。 |
【过滤后的数据】 | 指定字段在当前过滤状态下的值。 |
【仪表板参数】 | 源仪表板中指定参数的当前值。 |
选择【未设置】时,不主动为目标参数指定值,目标参数沿用现有的默认值或输入提示规则。


选择【常量值】,并输入固定值。每次跳转时,系统均将该值传递至目标参数。
例如,将“大区”参数的常量值设置为“西北”,跳转时目标仪表板将接收“西北”而不是所选数据点的纬度值。


注意:
使用【常量值】时,不支持通过逗号分隔的方式向多值参数传递多个值。
例如,输入“华东,华北,西北”后,目标参数会将其识别为一个完整的值,而非三个独立值。若目标字段中不存在该完整值,则筛选结果为空。
如下图所示,目标仪表板中通过参数“地区”进行全局过滤
在跳转设置中,将“华东,华北,西北”配置为【常量值】时,系统会将其作为一个完整的值传递至目标仪表板。由于目标数据集的【客户地区】列中不存在该完整值,因此筛选结果为空。
选择【数据列】作为数值类型后,系统将根据参数映射,传递当前选中数据点对应字段的值,以及当前有效钻取路径中记录的上级值。
单击【数值】输入框,打开字段选择对话框。左侧【选择字段】列表显示可选字段。勾选字段前的复选框后,该字段将添加至右侧【结果】列表。
跳转时,系统将传递【结果】列表中各字段对应的值。

【选择字段】列表包含以下两类字段:
字段分类 | 说明 |
|---|---|
【绑定字段】 | 列出当前组件中所有已绑定的字段,包括绑定至提示标签的字段。 |
【钻取字段】 | 列出当前钻取配置允许使用的维度字段,包括后续层级中才会使用的字段。禁用钻取时,不显示该区域。 |
钻取字段的具体范围及使用示例,请参阅“钻取后跳转”。
在右侧【结果】列表中检查需要传递值的字段:
拖动字段可调整顺序。为一个目标参数选择多个源字段时,按此顺序传递。
将鼠标悬停至字段上,单击删除图标可移除该字段。
单击【确定】保存。重新打开对话框时,已选字段及其顺序将保留。

注意:
字段显示名称可能相同,请确认选择的是所需源字段。已删除或失效的字段会保留并以删除线显示,应移除或重新选择,不能将其视为尚未选中的有效字段。
无论目标参数为单值参数还是多值参数,建议仅选择一个源字段作为参数值来源。
选择【筛选器】,可将指定筛选器当前选择的值传递至目标参数。

将【数值类型】设置为【筛选器】。
在弹出的对话框中选择需要使用的筛选器。
保存设置。
运行时,系统将使用该筛选器当前选择的值进行跳转。

选择【过滤后的数据】,可将指定字段在当前过滤状态下的值传递至目标参数。配置时需指定一个字段,仅支持选择一个字段。

支持以下过滤场景:
组件联动产生的交叉过滤。 例如,在饼图中选择“华北”后,柱状图随之过滤。若柱状图的跳转参数配置为传递过滤后的地区字段,跳转时将传递“华北”。

组件已配置的过滤条件。 包括直接添加的数据过滤,以及通过【保留】或【排除】操作形成的过滤条件。

选择【仪表板参数】,可将源仪表板中指定参数的当前值传递至目标参数。
使用前,需先在源仪表板中创建相应参数。

使用仪表板参数作为数值类型,并选择该参数。

跳转后,将参数值传递给目标仪表板。

【数据列】映射中,某个有效字段尚未选中,与明确选中了数据库空值,含义不同。
状态 | 处理方式 |
|---|---|
有效映射字段尚未选中 | 对应参数或组合位置按未设置处理。 |
明确选中了数据库空值 | 保留空值,仍受组件现有空参数规则限制。 |
没有当前选择 | 所有已配置字段均按未选中处理,不仅凭上级钻取值构造当前选择。 |
未设置的目标参数按现有规则使用默认值或提示输入。组合参数中未设置的位置,不增加该层级的筛选限制。
注意:需要当前选择的【数据列】跳转项目,在当前选择为空时,仍按组件既有规则禁用。常量或其他参数来源的跳转项目沿用原有可用性规则。
一个目标参数映射一个源字段时,接收去重后的值数组;映射多个源字段时,每行按【结果】列表中的字段顺序传递。
系统仅保留当前选择或钻取路径中已记录的组合关系,不会将彼此独立的上级值与下级值任意组合。
注意:当多个字段之间的组合关系无法确定时,不应假设系统会自动推断。需要稳定传递各级值时,可为各级维度分别配置目标参数,具体示例请参阅“钻取后跳转”。
【数据列】仅传递已配置字段及当前有效钻取路径中记录的值,不自动传递切片器、全局筛选、交叉筛选或【保留】【排除】状态,也不自动识别目标参数。
需要传递筛选值时,应选择【筛选器】或【过滤后的数据】等相应数值类型。
仪表板跳转参数使用 $$unset 表示未选中的有效字段,使用 null 表示明确选中的数据库空值。
场景 | 传递示例 | 含义 |
|---|---|---|
单字段未选中 |
| 参数未设置。 |
单字段选中数据库空值 |
| 明确选择了空值。 |
组合字段仅选中地区 |
| 地区为 East,省份未设置。 |
组合字段的省份选中数据库空值 |
| 地区为 East,省份明确为空值。 |
该规则仅适用于目标为仪表板的文档跳转。跳转至报表、外部链接,以及其他场景中的 Selection 动态变量沿用原有行为。
新的未选中处理规则影响仪表板跳转中所有现有【数据列】参数映射,不仅影响新增的钻取字段。原先未选字段可能以 null 传递,完全没有选择时可能传递空数组;更新后,未选字段使用 $$unset,实际数据库空值的处理保持不变。
检查项 | 说明 |
|---|---|
目标参数默认值 | 未选字段不再作为空值筛选条件保留。若业务要求始终应用筛选,应显式配置默认值,并验证实际筛选结果。 |
透视表 AnyNull 设置 | 未选字段不再因空参数而禁用跳转;明确选中的数据库空值仍会触发该规则。若要求未选中时禁用跳转,应检查依赖选择的动作禁用规则或其他可用性配置。 |
外部集成 | 解析跳转参数 |