页面树结构

版本比较

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。

...

选项内容
入口

点击 数据模型工具栏

一键映射
  • 在”参数面板“中单击 一键映射  按钮,系统自动创建模型参数,并建立好与 查询参数 的映射。
  • 自动映射的参数,默认沿用查询参数的名称、数据类型、控件类型等属性,且默认值为静态列表,值为查询参数默认值。
新建参数
  • 单个映射是指手工定义数据模型参数,并将其与私有查询资源中的参数进行映射关系设置。
  • 单击 新建参数  按钮,生成一个模型参数,需要手工映射参数、设置参数信息。
  • 新建的模型参数,映射关系,只允许选择带参数的查询。
复制参数

数据模型的参数支持复用其它数据模型的参数:通过参数复制功能,实现将目标参数克隆到当前数据模型。

控件类型
  • 支持输入框、列表(单选/多选)、列表(单选/多选)、树形(单选/多选)、日期、时间、日期时间。
默认值
  • 默认值可以不填写,代表查询全部数据。
  • 假设 查询 的参数定义“参数 默认值 是必填; 那么在数据模型参数映射之后,默认值也需要填写;否则不能正常查询报表,会提示需要先设置参数默认值。
  •  默认是”静态列表“选项。
备选值
  •  默认是”静态列表“选项,如果“静态列表”满足不了,可以使用 “SQL”,通过写SQL语句动态显示备选值。
  • SQL表达式支持参数嵌套,例如:select * from table where {[id = ${ParamName}]},ParamName为参数名:
    “{[ ]}”表示该参数可为空;
     如果没有”{[]}“,只有${}, 比如id = ${ParamName}代表参数ParamName默认必须填写。
  • 支持预览sql语句的数据,如果SQL包含了参数,则以参数默认值进行预览。
数据源
  • 数据源:默认值为”静态列表“时不允许修改,默认禁用关联的查询参数的数据源;
  • 默认值为”SQL“选项时支持时,允许选择数据库(当前登录用户拥有查看权限的数据库)
插入
X个参数未关联
  • 在”参数面板“中左下角显示当前数据模型的查询参数个数的信息,单击该信息,弹出所有查询参数的列表,列表中列出各参数的归属。

参数生效


默认生效解决的是什么场景?什么问题?

比如在模型中设了3个参数,在仪表盘中只用了2个参数,但是还是会按3个参数来过滤;

如下图,在模型定义了2个参数,一个”区域“、一个”省份“,在报表层上只拖了一个”区域“参数,但还是会按照"省份"的默认值去过滤数据,有一些想要查看全部区域数据这样就显示不出来。所以增加了一个“默认生效”的选项来进行控制,当不想要“省份”默认生效时,可以把“省份”参数的“参数生效”选项,设为不勾选。

Image Removed

原理:

1、“默认生效”勾选状态 当选择了“默认生效”选项时,无论用户是否在可视化界面上设置了参数值,该参数都将自动应用。这意味着即使用户没有手动输入参数值,系统也会采用参数的默认值来进行计算或过滤,从而实现了参数的强制生效!

2、如果不勾选“默认生效”,则表示参数的使用将遵循按需原则。具体来说:

  • 如果取数子图中没有选择与参数相关的表或查询,则该参数不会生效;即使参数被拖入报表中,但如果它与查询的数据不在同一个子图中,该参数也不会生效。
  • 只有当参数与查询的数据位于同一个子图中时,该参数才会生效,并且默认情况下只对它所映射的那张表进行过滤。

详细可查看:详细示例可查看:模型参数默认生效

也可查看:参数原理视频讲解.mp4

信息
title子图概念

以"事实表"为中心,通过表或者查询的关系建立一个子图,子图(也可以理解为扩展表),也可以理解为数据模型中的每个表都可构建一个子图,A表的子图是以A表为中心,根据筛选方向即箭头指向它的代表能筛选它的表,都会把它纳入子图中。

5、设置好参数后,保存数据模型,并去创建 交互式仪表盘,制作组件,并且拖入参数,可以根据参数查询订单信息,效果如下:

...

参数联动是指参数A的选择影响参数B可选值的一种动态效果。

示例:区域、省份 参数联动查询。

具体步骤如下:

1、创建数据模型并且在模型中添加 即席查询 1、创建数据模型并且在模型中添加 可视化SQL查询

2、在 即席查询 选择产品自带的northwind数据库, 可视化SQL查询 选择产品自带的northwind数据库,分别拖拽”发货区域“和”省份“字段到条件区,自动生成两个参数:

3、保存即席查询后,并返回数据模型。保存可视化SQL查询。后,并返回数据模型。

4、单击数据模型 设置参数 按钮,打开 参数管理 窗口,单击 一键映射 按钮,自动创建模型参数并映射即席查询中的参数:按照如下修改这两个参数设置:按钮,自动创建模型参数并映射可视化SQL查询中的参数:按照如下修改这两个参数设置:

销售区域参数

销售省份参数

5、参数设置后,保存该数据模型。

...

具体操作步骤如下:

1、创建数据模型,并且在模型中增加即席查询可视化SQL查询,并且把 省份 作为筛选条件,如下图:

2、保存模型,并且在 参数管理映射对应的参数,以及编写SQL构建层级关系,该示例为2层:

...

示例: 根据参数”结算时间点“选择的值,显示从当年1月1日至所选时间点的销量总和。

1、创建数据模型并且在模型中添加 即席查询可视化SQL查询 。

2、在 即席查询 选择产品自带的northwind数据库,拖拽字段如下: 可视化SQL查询。 选择产品自带的northwind数据库,拖拽字段如下:

3、保存即席查询后,并返回数据模型,基于时间字段”订单日期 保存可视化SQL查询后,并返回数据模型,基于时间字段”订单日期 创建时间层次,并且保存模型:

4、创建参数"结算时间点"

...

SQL查询中,在表达式中通过“${ParamName}”来标识参数,其中“ParamName”为参数名;用“{[ ]}”表示该参数可为空。如:参数表达式 {[id = ${产品编码}]},表示id字段与参数“产品编码”匹配,且参数允许为空用于输出所有编码的产品。

示例如下图,详情可参考: 创建SQL查询


3.

...

可视化SQL查询

可视化SQL查询中的参数由拖拽字段生成的条件会自动生成参数,详情可参考:可视化SQL查询

3.3 ETL高级查询

信息
title前置条件

1、参数表达式中的参数名与参数设置的”参数名“必须一致。

2、定义参数时,可以设置参数为空;再使用参数的地方,用“{[ ]}”表示该参数可为空,即查询全部数据。

...