页面树结构

版本比较

标识

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

1 概述


2 参数管理

数据模型参数主要的作用有如下两个方面:

  • 实现 查询 里面定义的参数与数据模型 参数管理 里面的映射关系:它类似于中间件功能,将私有查询参数与数据模型参数进行关联。应用详情请参见:参数筛选应用参数联动应用
  • 应用到计算度量、计算成员和命名集表达式中,实现动态获取结果。应用详情请参见:动态结果应用

Image Removed          Image Added


2.1 参数管理功能介绍

如果在查询中定义了参数,可以数据模型的参数管理进行映射、定义参数名称、数据类型、控件类型、默认值、备选值。

示例:根据输入的订单日期查询订单信息。

具体步骤如下:

1、创建数据模型并且在模型中添加 SQL查询

2、在 SQL查询 选择产品自带的northwind数据库下的”orders“表,编写SQL语句如下,代表可以参数ParamName默认值可以为空:

Image Added

3、保存SQL查询并回到模型。

4、点击参数工具栏的Image Added进入参数管理界面,映射参数,并设置参数相关选项:

选项内容
入口

点击 数据模型工具栏

一键映射
  • 在”参数面板“中单击 一键映射 Image Modified 按钮,系统自动创建模型参数,并建立好与所有私有参数的映射。
  • 自动映射的参数,默认沿用私有参数的名称、数据类型、控件类型等属性,且默认值为静态列表,值为私有参数默认值。
  • 当 默认值 改为SQL设置时,支持选择当前登录用户拥有查看权限数据库,且SQL表达式支持参数嵌套:参数嵌套示例请参见:参数联动应用按钮,系统自动创建模型参数,并建立好与 查询参数 的映射。
  • 自动映射的参数,默认沿用查询参数的名称、数据类型、控件类型等属性,且默认值为静态列表,值为查询参数默认值。
新建参数
  • 单个映射是指手工定义数据模型参数,并将其与私有查询资源中的参数进行映射关系设置。
  • 单击 新建参数 Image Modified 按钮,生成一个模型参数,需要手工映射参数、设置参数信息。
  • 新建的模型参数,映射关系,只允许选择带参数的查询。
复制参数

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

Image Modified

参数名称右侧面板的 参数名称 

...

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

Image Added

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

Image Added



3 各个查询类型的参数

目前数据模型查询类型除数据源表(HaNa数据库的表可以有参数)、导入文件日期表 之外,其它几种类型都支持带参数。

...

信息
title前置条件

如果存储过程自动识别的参数默认值不能为空,在 数据模型/参数管理 参数映射时也不能设置参数默认值为空,否则会报错。

1、存储过程查询中的参数在定义存储过程的时候定义,根据参数默认值输出结果集。

2、详情可参考:接入存储过程查询

Image Modified

3.5 脚本查询

脚本查询中的参数在脚本代码的结果集中定义,根据参数默认值输出结果集。

Image Modified

3.6 Java查询

信息
title前置条件

如果 Java查询 自动识别的参数默认值不能为空,在 数据模型/参数管理 参数映射时也不能设置参数默认值为空,否则会报错。

1、存储过程查询中的参数在定义存储过程的时候定义,根据参数默认值输出结果集。

2、详情可参考:Java查询

Image Modified