spagobi系列文章-03 document配置

1 Document配置

Ø 每个document是一个报表，图表等信息展示的载体。Document的定义包含：datasource（数据源）dataset（数据集合，数据查询方式），engin type（引擎类型）template (模板文件), DOCUMENT ANALYTICAL DRIVER DETAILS(报表参数引擎)等几个部分。

1.1 数据源配置

Ø 功能：数据源是报表等所有分析数据的来源之一。可以定义各种类型的数据库。

Ø 入口菜单：

Ø 操作页面

支持jndi和jdbc两种方式定义数据源。

1.2 数据集配置

Ø 入口菜单：

Ø 操作页面：

支持以下几种方式读取数据：

其中query方式是通过数据库操作来读取数据，必须定义数据源和相应的SQL语句。

SQL语句中如果带有参数可以使用$P{参数名}，并且需要在dataset中定义参数的类型：

1.3document参数配置

Document参数等同于dataset参数，document参数通过url name字段与dataset中定义的参数相对应，Document参数是展示在图表执行页面中，用于操作员选择使用。Dataset参数是sql语句执行的参数。这两个参数必须同时定义才能有效。

Document参数被解耦为几个部分：

1.3.1 LOV

用于定义参数的具体值，例如下拉列表中所有值。定义LOV时可以从数据库中读取数据生成结果。

Ø 入口菜单：

Ø 配置LOV

点击页面左上角的T图标打开参数设置页面：

这里可以对LOV设置展示字段，值字段和可见的字段，对应于下拉列表的name和value

1.3.2ADM

定义参数的类型，是否必输项，可访问的角色等信息。

Ø 入口菜单：

Ø 配置ADM,并引用LOV

这个地方定义参数是否为必输项。

定义参数类型

1.4document Object配置

document Object定义图表或报表的相关参数：标签、名称、类型、引擎、模板文件、查询参数等。

Ø 入口菜单：

Ø 操作页面：

新增document使用右上角的添加图标，打开document定义页面：

Type字段定义该document的类型，包括：

Engine字段定义该document type使用的引擎类型，选择type不同则engine的展示也不同。

Dataset字段选择定义好的数据集合。这样就与数据源和查询语句关联起来了。

Document的参数定义如下：

如果参数作为隐藏参数，不在document执行页面中展示则 visible不打勾。

在Analytical driver中选择该参数对应的ADM。