仪表板参数

1. 概述

1.1 功能概述

仪表板参数用于增强数据可视化的交互性和灵活性，允许用户动态调整图表、筛选数据或切换分析视角，无需修改底层数据或模型；参数既可以是静态的常量值，也可以是动态数据（如绑定用户上下文信息、组件数据列或实时筛选器值），从而实现个性化、实时的数据分析体验。

1.2 应用场景

仪表板参数的核心作用是赋予用户动态控制权，通过灵活的数据过滤、交互式分析和多维度展示，提升仪表板的实用性和可操作性。它们广泛应用于组件筛选、全局数据联动、仪表板跳转及自动化任务等场景，让数据分析更智能、更高效。

• 典型应用场景一：动态维度与动态度量分析

  • 场景描述： 当业务分析需要灵活切换分析维度（如横轴字段）和指标（如纵轴数值）时，通过仪表板参数实现可视化元素的动态调整

  • 具体应用： 通过创建并绑定筛选器至仪表板参数，结合分析表达式动态新建计算列（维度）和度量值（指标），最终映射到可视化图表实现灵活分析

• 典型应用场景二：跨文档参数传递与数据过滤

  • 场景描述： 当需要通过仪表板跳转传递过滤条件，或在系统集成时注入外部参数值进行数据过滤的场景

  • 具体应用： 通过定义接收参数并配置仪表板参数的传递规则，在跳转分析时自动映射仪表板参数值，或系统集成时通过集成参数dp将外部参数传入仪表板参数，最后将其应用于全局筛选、直连数据集过滤或组件级过滤

2. 操作步骤

2.1 前提条件

1. 权限要求： 仅拥有创建仪表板权限的用户或系统管理员可执行此操作。

2.2 操作步骤-添加参数

1. 在仪表板设计器界面，依次单击「仪表板>全局配置」，右侧属性找到仪表板参数，然后单击仪表板参数后按钮，弹出仪表板参数设置窗口。

   
   

2. 在仪表板参数设置窗口，指定参数名称、提示文本以及数据类型等，设置完成后，单击“确定”，即可保存该参数。

   
   

• 配置项说明：

  设置项名称	说明
  参数名称	定义仪表板参数的唯一标识符，用于系统内容识别和引用
  提示文本	仪表板参数在具体使用时显示的名称（默认与参数名称相同）
  多值数据	启用后支持同时选择多个参数值进行筛选 未启用时默认仅使用第一个值
  数据类型	用于设置参数的数据类型，支持如下几种数据类型：布尔型、日期型、日期时间型、整型、浮点型、字符串类型以及多维数据
  默认数据	设置仪表板参数的默认值
  绑定	给仪表板参数绑定数据源类型，可以选择数据列、筛选器或无
  在运行计划中使用	启用后可在运行计划面板中 通过下拉列表现在参数值（需绑定数据源） 未绑定数据源时可以输入多行文本（自动折行显示）
  允许输入多行文本	仅当启用“在运行计划中使用”且未绑定数据源时，在创建运行任务时，输入框中输入内容会自动折行

  type=info

  注意： 在仪表板数据过滤场景中，参数的数据类型必须与被过滤字段完全一致，否则将导致筛选失败或数据异常。

2.3 参数默认数据与绑定设置

通过预先配置仪表板参数的默认值和数据绑定设置，可以显著提升可视化分析时的操作便捷性。

2.3.1 为参数设置默认数据

Wyn 系统提供以下四种参数默认值配置方式，满足不同业务场景需求.

• 参数默认值配置方式：

  参数默认数据类型	说明	系统图示
  静态数据	用户通过直接输入常量值设置参数默认值 输入格式需与参数数据类型严格匹配
  用户数据	自动获取当前登录用户的上下文信息（用户名等属性），并将其设置为参数的默认值 注意： 除系统默认提供的用户上下文信息外，还可自定义扩展新的用户上下文信息，详情请参考：用户上下文属性管理
  组织数据	基于用户所属组织的组织上下文信息（用户名等属性），并将其设置为参数的默认值 注意： 除系统默认提供的组织上下文信息外，还可自定义扩展新的组织上下文信息，详情请参考：组织属性和组织上下文信息
  查询结果	基于仪表板已添加的数据集/数据模型，选取字段，并将其设置为参数的默认值 注意： 使用此方式，必须预先为仪表板配置数据集/数据模型，且查询结果所选字段数据类型必须与参数类型严格匹配（如日期字段→日期型参数）

2.3.2 为参数设置绑定

可以将仪表板参数与数据列/筛选器数据关联，实现参数值随用户交互实时更新：

1. 数据列： 选择数据列后，需指定目标组件（画布已有组件）已绑定的字段列，以完成参数与数据列的精确关联。

• 操作流程：

  • 操作步骤： 仪表板参数设置窗口，选择绑定>数据列，进入数据列设置界面，选择目标组件（画布已有组件）及其已绑字段（如支付方式），然后单击数据列设置界面的确定返回仪表板参数设置窗口，最后单击确定按钮，完成参数与数据列的关联配置。

    
    

  • 成果展示： 仪表板参数绑定到数据列后，在富文本组件使用仪表板，当在仪表板预览或查看界面选中目标组件时，关联的富文本组件将实时显示仪表板参数动态变化的内容。

    
    

    type=info

    注意：

    多字段选择限制： 仅当参数类型为"多维数据"时，多个字段勾选才能生效；其他数据类型默认取首个字段值

    字段绑定要求： 所选字段必须已绑定至仪表板画布区域的组件上，否则无法获取有效参数值

2. 筛选器： 选择筛选器后，需指定目标筛选器，所选的筛选器种类不同，筛选器设置对话框的内容略有不同：

   
   

• 筛选器类型说明：

  筛选器类型	说明	系统图示及成果展示
  标签列表	单字段绑定模式 自动完成字段匹配，无需额外配置 例如：当标签列表筛选器与仪表板参数绑定后，富文本组件通过引用该仪表板参数，可实现内容的实时动态更新
  多维列表框/多维下拉框	该类型的筛选器可以绑定1个或多个字段 参数类型为”多维数据”时可激活多选功能 非多维类型默认取首字段 例如：当多维列表框筛选器与仪表板参数绑定后，富文本组件通过引用该仪表板参数，可实现内容的实时动态更新
  日期范围/相对日期	可绑定极值日期（最大值/最小值） 多值数据支持值区间和极值日期 参数类型必须是日期型/日期时间型 例如：当日期范围筛选器与仪表板参数绑定后，富文本组件通过引用该仪表板参数，可实现内容的实时动态更新
  数值范围	可绑定极值（最大值/最小值） 多值数据支持值区间和极值 例如：当数值范围筛选器与仪表板参数绑定后，富文本组件通过引用该仪表板参数，可实现内容的实时动态更新
  文本筛选器	单字段绑定模式 自动完成字段匹配，无需额外配置 例如：当文本筛选器与仪表板参数绑定后，富文本组件通过引用该仪表板参数，可实现内容的实时动态更新

2.3.3 为日期型参数设置转换格式

当参数类型为日期/日期时间型时，系统提供高级数据转换功能。通过转换选项，您可以将原始时间数据转换为多种格式，满足不同业务场景需求。

• 转换规则对照表：

  转换规则	说明	系统图示
  原始值	保留原始时间数据，仅调整显示格式（如yyyy/mm/dd→yyyy-mm-dd）
  部分值	提取特定时间单位转换为整型（如2018/10/18→2018），转换后参数类型变更为整形
  调整值	对日期进行偏移（如选择明天），并可以转换格式，保持原有参数数据类型不变
  UTC 字符串	转换为标准 UTC 字符串进行显示

2.4 使用仪表板参数

仪表板参数设置完成后，可广泛应用于组件筛选、全局过滤、仪表板跳转、运行计划及直连数据集动态查询（支持与用户输入型参数绑定））等多种数据交互场景。

1. 组件筛选器： 在单个组件内绑定参数，实现局部数据过滤，详情请参考 组件筛选器。

2. 仪表板全局筛选器： 用于整个仪表板，统一控制数据集/数据模型的筛选条件，详情请参考仪表板全局数据筛选器。

3. 仪表板跳转： 通过参数传递实现文档间的数据联动，详情请参考仪表板跳转。

4. 仪表板运行计划： 结合运行计划，动态更新仪表板参数，详情请参考 仪表板运行计划。

5. 直连数据集动态参数绑定： 将仪表板参数传递至直连数据集，实现动态查询。

• 直连数据集动态参数绑定实现步骤：

  • 仪表板设计器中添加仪表板参数，仪表板参数绑定筛选器

    
    

  • 直连数据集参数（用户输入型）关联仪表板参数，实现动态数据加载

    
    

  • 成果展示：