[]
        
首页
开发者学堂
文档
论坛
市场
生态机会
活动
在线Demo 免费试用
(Showing Draft Content)

跳转参数设置

1. 概述

跳转至带参数的仪表板或报表时,可为目标参数指定固定值,也可从源仪表板的数据点、筛选器、过滤后的数据或仪表板参数中获取值。

本章介绍各数值类型的配置方法,以及字段选择、空值处理和多字段传递规则。创建跳转项目的操作请参阅“跳转至仪表板”。

2. 打开参数设置

在组件的跳转设置对话框中选择目标仪表板,然后展开【文档设置】区域。参数设置面板将列出目标仪表板中的所有参数。

为需要传值的参数选择【数值类型】,并配置对应的【数值】。

image

3. 数值类型

数值类型

参数来源

【未设置】

不主动指定值,传递Null 值(即空值)给目标仪表板。

【常量值】

配置时输入的固定的常量值。

【数据列】

当前选中数据点对应字段的值,以及有效钻取路径中记录的字段值。

【筛选器】

指定筛选器当前选择的值。

【过滤后的数据】

指定字段在当前过滤状态下的值。

【仪表板参数】

源仪表板中指定参数的当前值。

3.1 未设置

选择【未设置】时,不主动为目标参数指定值,目标参数沿用现有的默认值或输入提示规则。

image

image

3.2 常量值

选择【常量值】,并输入固定值。每次跳转时,系统均将该值传递至目标参数。

例如,将“大区”参数的常量值设置为“西北”,跳转时目标仪表板将接收“西北”而不是所选数据点的纬度值。

image

image

注意:

使用【常量值】时,不支持通过逗号分隔的方式向多值参数传递多个值。

例如,输入“华东,华北,西北”后,目标参数会将其识别为一个完整的值,而非三个独立值。若目标字段中不存在该完整值,则筛选结果为空。

如下图所示,目标仪表板中通过参数“地区”进行全局过滤

image

在跳转设置中,将“华东,华北,西北”配置为【常量值】时,系统会将其作为一个完整的值传递至目标仪表板。由于目标数据集的【客户地区】列中不存在该完整值,因此筛选结果为空。

image

3.3 数据列

选择【数据列】作为数值类型后,系统将根据参数映射,传递当前选中数据点对应字段的值,以及当前有效钻取路径中记录的上级值。

3.3.1 选择字段

单击【数值】输入框,打开字段选择对话框。左侧【选择字段】列表显示可选字段。勾选字段前的复选框后,该字段将添加至右侧【结果】列表。

跳转时,系统将传递【结果】列表中各字段对应的值。

image

【选择字段】列表包含以下两类字段:

字段分类

说明

【绑定字段】

列出当前组件中所有已绑定的字段,包括绑定至提示标签的字段。

【钻取字段】

列出当前钻取配置允许使用的维度字段,包括后续层级中才会使用的字段。禁用钻取时,不显示该区域。

钻取字段的具体范围及使用示例,请参阅“钻取后跳转”。

3.3.2 调整结果列表

在右侧【结果】列表中检查需要传递值的字段:

  • 拖动字段可调整顺序。为一个目标参数选择多个源字段时,按此顺序传递。

  • 将鼠标悬停至字段上,单击删除图标可移除该字段。

单击【确定】保存。重新打开对话框时,已选字段及其顺序将保留。

image

注意:

  • 字段显示名称可能相同,请确认选择的是所需源字段。已删除或失效的字段会保留并以删除线显示,应移除或重新选择,不能将其视为尚未选中的有效字段。

  • 无论目标参数为单值参数还是多值参数,建议仅选择一个源字段作为参数值来源。

3.4 筛选器

选择【筛选器】,可将指定筛选器当前选择的值传递至目标参数。

image

  1. 将【数值类型】设置为【筛选器】。

  2. 在弹出的对话框中选择需要使用的筛选器。

  3. 保存设置。

运行时,系统将使用该筛选器当前选择的值进行跳转。

image

3.5 过滤后的数据

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

image

支持以下过滤场景:

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

    image

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

    image

3.6 仪表板参数

选择【仪表板参数】,可将源仪表板中指定参数的当前值传递至目标参数。

使用前,需先在源仪表板中创建相应参数。

image

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

image

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

image

4. 数据列传递规则

4.1 未选中与数据库空值

【数据列】映射中,某个有效字段尚未选中,与明确选中了数据库空值,含义不同。

状态

处理方式

有效映射字段尚未选中

对应参数或组合位置按未设置处理。

明确选中了数据库空值

保留空值,仍受组件现有空参数规则限制。

没有当前选择

所有已配置字段均按未选中处理,不仅凭上级钻取值构造当前选择。

未设置的目标参数按现有规则使用默认值或提示输入。组合参数中未设置的位置,不增加该层级的筛选限制。

注意:需要当前选择的【数据列】跳转项目,在当前选择为空时,仍按组件既有规则禁用。常量或其他参数来源的跳转项目沿用原有可用性规则。

4.2 多字段与字段顺序

一个目标参数映射一个源字段时,接收去重后的值数组;映射多个源字段时,每行按【结果】列表中的字段顺序传递。

系统仅保留当前选择或钻取路径中已记录的组合关系,不会将彼此独立的上级值与下级值任意组合。

注意:当多个字段之间的组合关系无法确定时,不应假设系统会自动推断。需要稳定传递各级值时,可为各级维度分别配置目标参数,具体示例请参阅“钻取后跳转”。

4.3 参数来源的边界

【数据列】仅传递已配置字段及当前有效钻取路径中记录的值,不自动传递切片器、全局筛选、交叉筛选或【保留】【排除】状态,也不自动识别目标参数。

需要传递筛选值时,应选择【筛选器】或【过滤后的数据】等相应数值类型。

5. 升级与集成注意事项

5.1 未选中值的标记

仪表板跳转参数使用 $$unset 表示未选中的有效字段,使用 null 表示明确选中的数据库空值。

场景

传递示例

含义

单字段未选中

["$$unset"]

参数未设置。

单字段选中数据库空值

[null]

明确选择了空值。

组合字段仅选中地区

[["East","$$unset"]]

地区为 East,省份未设置。

组合字段的省份选中数据库空值

[["East",null]]

地区为 East,省份明确为空值。

该规则仅适用于目标为仪表板的文档跳转。跳转至报表、外部链接,以及其他场景中的 Selection 动态变量沿用原有行为。

5.2 升级后检查项

新的未选中处理规则影响仪表板跳转中所有现有【数据列】参数映射,不仅影响新增的钻取字段。原先未选字段可能以 null 传递,完全没有选择时可能传递空数组;更新后,未选字段使用 $$unset,实际数据库空值的处理保持不变。

检查项

说明

目标参数默认值

未选字段不再作为空值筛选条件保留。若业务要求始终应用筛选,应显式配置默认值,并验证实际筛选结果。

透视表 AnyNull 设置

未选字段不再因空参数而禁用跳转;明确选中的数据库空值仍会触发该规则。若要求未选中时禁用跳转,应检查依赖选择的动作禁用规则或其他可用性配置。

外部集成

解析跳转参数 dp 的程序需将 $$unset 识别为对应位置未设置。以 $$ 开头的值为协议保留值,不应作为用户数据传递,当前不提供转义方式。