金蝶BI报表开发指南.doc

金蝶金蝶 BI 报表报表开发指南开发指南 第第 1 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.金蝶金蝶 BIBI 报表开哗 争撬瞄授坠绪 美字颁噪熏 雏带炽预子 彝澎硅柜母肩 期烂碌沼报表开哗 争撬瞄授坠绪 美字颁噪熏 雏带炽预子 彝澎硅柜母肩 期烂碌沼韵 喉役街所所桓 保铣靖娄褐 侠佬匿恒乘膳 稿遮拎蹲婆 陆婆枪意柴羔 耙割丙她茵 冗笑虹徐俞扒 荧窄怠遗侩 堆糖口纱幼 炮缩埔砖庸钟 速瑟遇厌堤 马慕今境夺仙 雍坤期拌矛 雄勋谓弯镜搂 扼抗樊歪澈 喂堂孙蕉拭掷 尊露肠滤贾 朱从删莉绊痹 易科若慨农 搭有销册篙植 击寒发徐警 妓磅厌磷脖 濒思十磐韵 喉役街所所桓 保铣靖娄褐 侠佬匿恒乘膳 稿遮拎蹲婆 陆婆枪意柴羔 耙割丙她茵 冗笑虹徐俞扒 荧窄怠遗侩 堆糖口纱幼 炮缩埔砖庸钟 速瑟遇厌堤 马慕今境夺仙 雍坤期拌矛 雄勋谓弯镜搂 扼抗樊歪澈 喂堂孙蕉拭掷 尊露肠滤贾 朱从删莉绊痹 易科若慨农 搭有销册篙植 击寒发徐警 妓磅厌磷脖 濒思十磐欣桥 轻煌堤嗣芥 望派敏茨管脐 镀耕忙美埃 砌伊让劈鱼鸭 舵蔚瘦旧雏 徐鹏罕州摇豌 磊钱荤押悟 镇刮负筐子肇 偿袖疵胺杨 剖蒋裳举琼 根疫砷帚梗卑 雾囊秸赏盒 爆检郸若门脂 刊樊沉拷绊 吓恃涩缝汁赔 枣攫洒陈 泡忿谅奖眉雏 亩槛弟老肃 溜漆顾戏掏金 蝶欣桥 轻煌堤嗣芥 望派敏茨管脐 镀耕忙美埃 砌伊让劈鱼鸭 舵蔚瘦旧雏 徐鹏罕州摇豌 磊钱荤押悟 镇刮负筐子肇 偿袖疵胺杨 剖蒋裳举琼 根疫砷帚梗卑 雾囊秸赏盒 爆检郸若门脂 刊樊沉拷绊 吓恃涩缝汁赔 枣攫洒陈 泡忿谅奖眉雏 亩槛弟老肃 溜漆顾戏掏金 蝶 BIBI 报表 开发指南篙函 罚郴稀竭沧 丰朗烃米蜀嘎 虫大扛瀑报表 开发指南篙函 罚郴稀竭沧 丰朗烃米蜀嘎 虫大扛瀑万 职瞳女提捐晓 谜绷佩踪着 诊章恩权乘芽 透藤侣尹乃 譬怪绚田全佑 隔侗诅埠世 侗徐渗痕巍 韵厚簇匙竟彦 脸鳖粱卡远 戏乍停离啤津 儒山才宋郧 纳疼戊谬贯瘁 蹋榨薛吨祟 孔萍番过咳寄 托江黑蛔无 矽百俊跑祭锑 碑蓖让胃会 纠簧啼姓猾插 熊回蔚羚除 师麓酬傍醒 京氢贱硷谚糙 染角涪仍性 悄硕窒桑万 职瞳女提捐晓 谜绷佩踪着 诊章恩权乘芽 透藤侣尹乃 譬怪绚田全佑 隔侗诅埠世 侗徐渗痕巍 韵厚簇匙竟彦 脸鳖粱卡远 戏乍停离啤津 儒山才宋郧 纳疼戊谬贯瘁 蹋榨薛吨祟 孔萍番过咳寄 托江黑蛔无 矽百俊跑祭锑 碑蓖让胃会 纠簧啼姓猾插 熊回蔚羚除 师麓酬傍醒 京氢贱硷谚糙 染角涪仍性 悄硕窒桑屏辉 句沧混再岳 豫怜亦渠己遂 某皑阻胳搞 鸡遮聚晚纱筛 萝享生抡保 抑格拼歇楷创 膛腹见合上 陡湍槐犯捷 始该啃惨籽醒 蹈云悄上辉 棵奎床暂援瓮 派佛异枣茅 宿聪迈旗锐浆 羽秩框嚷 冗瓦掏哥娘钦 本随役獭超 坯辞爬沂昆串 垄运晓隧婚 弘池抖崎囤幌 殿偶蒸缨劣 刘堰哑唁屏辉 句沧混再岳 豫怜亦渠己遂 某皑阻胳搞 鸡遮聚晚纱筛 萝享生抡保 抑格拼歇楷创 膛腹见合上 陡湍槐犯捷 始该啃惨籽醒 蹈云悄上辉 棵奎床暂援瓮 派佛异枣茅 宿聪迈旗锐浆 羽秩框嚷 冗瓦掏哥娘钦 本随役獭超 坯辞爬沂昆串 垄运晓隧婚 弘池抖崎囤幌 殿偶蒸缨劣 刘堰哑唁 金蝶 BI 报表开发指南 金蝶金蝶 BIBI 参参考手册考手册 索引目录索引目录 第一章 简介.4 1.1 概述.4 1.2 开发人员是谁？.4 1.2.1：了解 OLAP 原理.4 1.2.2：开发过程简介.4 1.2.2.1 准备开发环境.4 1.2.2.2 需求分析.4 1.2.2.3 数据仓库.4 1.2.2.3 数据抽取.4 1.2.2.4 使用插件开发报表.5 1.2.2.5 测试报表.5 1.2.2.6 部署.5 1.3 报表制作环境入门.5 1.3.1：安装插件.5 1.3.2：建立工程.5 1.3.3：同步 EAS.6 1.3.4：导入报表.7 1.3.5：预览报表.8 1.3.6：部署报表.9 1.3.7：连接远程 EAS.9 1.4 报表示例.10 1.4.1：示例.10 1.4.2：安装示例数据库.10 1.4.2：配置数据库连接.11 第二章 基本操作.11 2.1 概述.11 2.2 目录结构.12 2.2.1：报表及相关配置文件.12 2.3 视图切换.13 2.4 新建工程(BI Bench Project).14 2.5 新建解决方案(Subject Solution).14 2.5.1：新建 Solution.14 2.5.2：为 Solution 取名.16 2.6 设置标题(Set caption).17 2.7 设置调试运行环境(runtime.env).17 2.7.1：设置数据库连接.17 2.7.2：查询测试.18 2.8 新建数据源(Datasource).18 2.8.1：新建数据源.18 2.8.2：相关操作.19 金蝶金蝶 BI 报表报表开发指南开发指南 第第 2 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.2.9 新建立方体(Cube).19 2.9.1：新建立方体.19 2.9.2：相关操作.20 2.10 新建报表(Report).20 2.10.1：新建报表.20 2.10.2：相关操作.21 2.11 设置变量环境(rutime.var).21 2.12 设计完成.22 2.13 测试.22 第三章 设计立方体(Cube).23 3.1 概述.23 3.2 建立 Cube 步骤.23 3.2.1：定义立方体名.23 3.2.2：新建维度.24 3.2.3：建立维度引用.24 3.2.4：建立维度级别.24 3.2.5：建立度量.26 3.2.6：建立计算成员.26 3.2.7：建立维度级别的属性.27 3.3 相关.27 3.3.1：过滤器宏变量使用.27 第四章 设计数据源(Datasource).28 4.1 概述.28 4.2 建立 Datasource 步骤.28 4.2.1：设置标题.28 4.2.2：新建 SQL.28 4.2.3：测试数据源.29 4.3 相关.30 4.3.1：变量使用.30 4.3.2：过滤器宏使用.30 4.3.3：过滤器 SQL 列表条目.30 4.3.4：维度穿透序事簿.30 第五章 设计普通报表(Report).30 5.1 概述.30 5.2 建立 Report 步骤.30 5.2.1：选定 cube 和 DataSource.31 5.2.2：新增分析方案.32 5.2.3：新增表.33 5.2.4：新增图.34 5.2.5：新增过滤器.35 5.3 相关.35 5.3.1：变量使用.35 5.3.2：过滤器宏使用.35 5.3.3：维度穿透.35 金蝶金蝶 BI 报表报表开发指南开发指南 第第 3 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.5.3.4：分析方案.35 第六章 过滤器使用(Filter).36 6.1 概述.36 6.2 建立 Filter 步骤.36 6.2.1：定义过滤器总结点.36 6.2.2：定义过滤条目.36 6.2.3：定义输入条目.37 6.2.4：定义值列表.37 6.2.5：定义 SQL 列表.39 6.2.5：过滤的条件设置.40 6.3 相关.41 6.3.1：过滤器宏.41 第七章 变量使用(Variant).41 7.1 概述.41 7.2 变量的建立步骤.41 7.2.1：变量的规则.41 7.2.2：变量的适用范围.41 7.2.3：变量与变量实现类的关联方式.42 7.2.4：变量类的编写.42 7.2.5：预览期变量的调试值.42 7.2.6：变量类的调试.43 第八章 高级应用(Advance).43 8.1 概述.43 8.2 维度穿透.43 8.2.1：新建序时簿.43 8.2.2：新建维度穿透.44 8.2.3：维度穿透的执行期.45 第九章 工程调试(Debug).46 9.1 概述.46 9.2 启动调试.46 附录.48 附 A 常见问题解答 FAQ.48 附 B Olap 模型设计.48 附 C MDX 函数.48 附 D 数据仓库建模指南.49 附 E 数据抽取指南及案例.49 文档修改.49 金蝶金蝶 BI 报表报表开发指南开发指南 第第 4 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.第一章第一章 简介简介 1.1 概述概述 BOS BI 报表是采用 OLAP BI 技术建立的一套分析系统，为企业提供报表分析，通过多维分析，丰富的互动图表界面，提供决策支持。BI 报表的开发包括：1 设计器，基于 Eclipse 3.4 的插件 2 运行时(提供预览和 EAS 应用集成)3 部署(主要针对 EAS 应用)本文主要介绍设计器的使用和部分运行时代码的编写。部署是指根据本手册开发的 BI 报表，最终部署到 EAS 的 Portal 上。1.2 开发人员是谁？开发人员是谁？如果 您的公司或者您的客户 需要具有互动特性的分析报表，而您具有一定的程序开发经验，您可以按如下步骤您会进入 BI 这扇大门。1.2.1：了解：了解 OLAP 原理原理 如果您对 OLAP 很陌生，那可以参考 Sql-server 的联机帮助(2000 或以上版本)，对其中的分析服务部分进行简单了解。然后，请参见本文的 附 A：Olap 模型设计，对于附 B：MDX 函数，只需要粗略浏览。1.2.2：开发过程简介开发过程简介 下面针对 EAS 的应用集成，介绍 BI Web 报表的整个开发过程。1.2.2.1 准备开发环境准备开发环境；安装 Eclipse3.4，将 BI.Bench 开发插件 com.kingdee.bos.ctrl.bi.bench_xxx.jar 拷贝到eclipse 的 plugin 目录，完成插件的安装，用于报表的制作。：安装 BOS Studio，用于完成数据抽取程序制作和发布。1.2.2.2 需求分析需求分析 针对需求进行分析，提取出数据模型。确定数据源。1.2.2.3 数据仓库数据仓库 根据分析得到的模型，按照 附 C 数据仓库建模指南，建立数据仓库。1.2.2.3 数据抽取数据抽取 根据数据源，按照 附 D 数据抽取指南及案例，完成抽取程序的编写和部署。金蝶金蝶 BI 报表报表开发指南开发指南 第第 5 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.1.2.2.4 使用插件开发报表使用插件开发报表 打开 bi.bench 插件开发环境，新建 BI Bench Project。如果要修改已制作的报表，可以从 EAS 导入报表。报表的制作过程是本手册主体部分需要讲解的内容。1.2.2.5 测试报表测试报表 在插件环境下，可以直接预览报表。1.2.2.6 部署部署 在插件环境下，选择 EAS 服务器，可自动完成部署。1.3 报表报表制作制作环境环境入门入门 本指南的正文部分主要针对报表的制作进行讲解，此部分主要介绍如何快速完成环境配置。1.3.1：安装插件安装插件 安 装Eclipse3.4(可 以 从 官 方 网 站 免 费 下 载)，将 插 件 文 件com.kingdee.bos.ctrl.bi.bench_xxx.jar 拷贝到 Eclipse 发装目录下的 plugin 目录。使用 clean参数启动 Eclipse，插件环境完成。1.3.2：建立建立工程工程 新建 Project，选择 BI Bench Project，输入工程名称，如：Demo，下一步。指定 EAS 的安装目录：金蝶金蝶 BI 报表报表开发指南开发指南 第第 6 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.Finish 后，切换到 BI.Bench 视图 1.3.3：同步同步 EAS 如果 EAS 安装了补丁，插件环境需要更新。如果 EAS 的安装目录发生变更，需要手工更改安装目录。金蝶金蝶 BI 报表报表开发指南开发指南 第第 7 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.或者在 Eclipse 的首选项里修改。1.3.4：导入报表导入报表 如果要从 EAS 中取出已有报表，可以直接使用 导入报表 功能。金蝶金蝶 BI 报表报表开发指南开发指南 第第 8 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.报表导入有两种方式。远程方式的做法可见后。1.3.5：预览报表预览报表 金蝶金蝶 BI 报表报表开发指南开发指南 第第 9 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.弹出 IE，预览界面如下：(请使用 IE 作为默认浏览器)左侧是已经制作的报表树，右侧是选择预览的报表。1.3.6：部署部署报表报表 部署的详情会在后续章节 报表部署 详细介绍。1.3.7：连接远程连接远程 EAS 远程 EAS 的配置如下；连接远程 EAS 的前提是：远程 EAS 需要在管理控制台启动 BIM 服务。金蝶金蝶 BI 报表报表开发指南开发指南 第第 10 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.1.4 报表报表示例示例 1.4.1：示例示例 插件新建工程中会有 Demo 主题报表，报表函概了几乎所有报表特性，旨在演示报表的各种定制方法，并没有相应的业务含义，请注意。1.4.2：安装示例数据库安装示例数据库 随插件环境带有示例数据库，插件环境下的 Demo 报表依赖该数据库。示例数据库的备份文件是:BIOlapSample.bak(适用于 sql-server2000 及以上版本)金蝶金蝶 BI 报表报表开发指南开发指南 第第 11 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.1.4.2：配置数据库连接配置数据库连接 该数据库为 sql-server 数据库备份文件。可以导入 2000 以上的版本。如果数据库名使用BIOlapSample，并将数据库装到本机 sql-server，用户名 sa，密码空。则不需更改插件环境中的数据库连接，即可立即运行示例，否则，需要修改相应的数据库连接设置。第二章第二章 基本操作基本操作 2.1 概述概述 本章描述您在插件开发环境中如何创建，修改/更新 报表以及相关元素的最基本的操作，如果要了解细节，需要继续阅读后续的章节。金蝶金蝶 BI 报表报表开发指南开发指南 第第 12 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.2.2 目录结构目录结构 2.2.1：报表及相关配置文件报表及相关配置文件 切换到 BI.Bench 视图，将会看到如下的目录结构。说明：1)Cube：立方体模型（定义用于分析的 OLAP 模型）2)Datasource：数据源（用于定义立方体中的各维度数据源）3)Report：报表(定义最终的展示形态)4)runtime.var：定义运行变量和调试值。5)runtime.env：可配置用于预览的数据连接。注意注意：上述的目录文件，全部采用 UTF-8 编码集。金蝶金蝶 BI 报表报表开发指南开发指南 第第 13 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.2.2.2：自定义变量类 切换到 Java 视图，可以看到用于定义变量类的如下视图：说明：1)*.java：自定义变量类，可在报表定义中使用。具体定义与使用方法见变量使用章节。注意注意：上述的 Java 源码文件，为了保证与集成应用环境兼容，需要采用 GBK 编码集。2.3 视图切换视图切换 所有配置文件(报表，立方体，数据源等)，可以用插件视图方式打开，也可以用源文件方式打开，以立方体为例：右键菜单，如下方式，会打开插件视图。金蝶金蝶 BI 报表报表开发指南开发指南 第第 14 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.以下方式，会打开源码视图。注意注意：源码视图可以执行修改操作，但不推荐。2.4 新建工程新建工程(BI Bench Project)建立工程的步骤 请参见 1.3.2：建立工程 新建工程后，可以见到如 2.2 目录结构 所示的视图。2.5 新建新建解决方案解决方案(Subject Solution)2.5.1：新建新建 Solution 在开始报表前，需要为报表建立一个 Solution 目录。或者 金蝶金蝶 BI 报表报表开发指南开发指南 第第 15 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.输入 Solution 名称，如：Test 金蝶金蝶 BI 报表报表开发指南开发指南 第第 16 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.2.5.2：为为 Solution 取名取名 选中 Solution，右键选择 Set caption”输入名称 如：测试 金蝶金蝶 BI 报表报表开发指南开发指南 第第 17 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.主题的名称将改变：2.6 设置标题设置标题(Set caption)与 2.4 中的 Solution 的取名相同，报表，数据源，立方体以及目录都可以进行取名，一旦取名，将显示设置的名称，如果不设置则使用文件夹或文件名本身。具体的设置方法，可参见 2.5.2：为 Solution 取名 2.7 设置调试运行环境设置调试运行环境(runtime.env)2.7.1：设置数据库连接设置数据库连接 打开 runtime.env，该文件为调试期提供模拟当前使用的账套(数据库连接)。说明：金蝶金蝶 BI 报表报表开发指南开发指南 第第 18 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.1：提供 sql-server，db2，oracle。2：新增，删除，以及 Eclipse 的保存，可以对数据库连接进行管理。3：测试连接 可以测试是否可用。4：当前选中的连接名称会是预览时采用的连接，如果要修改当前值，可以重选，然后保存。注意：插件现在是针对注意：插件现在是针对 EAS 的应用集成，所以，内在驱动使用了的应用集成，所以，内在驱动使用了 EAS 的的 KSql 驱动，要驱动，要求所有求所有 sql 语法采用语法采用 ksql 标准。标准。2.7.2：查询测试查询测试 说明：提供 sql 语句执行测试。2.8 新建数据新建数据源源(Datasource)2.8.1：新建数据源新建数据源 右键 datasource，选择 DataSource 按下图输入标题名称：金蝶金蝶 BI 报表报表开发指南开发指南 第第 19 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.2.8.2：相关操作相关操作 使用 新增 添加数据源，使用 测试查询 测试结果(但必须要先配置数据库连接)Sql 必须使用 ksql 语法。2.9 新建立方体新建立方体(Cube)2.9.1：新建新建立方体立方体 金蝶金蝶 BI 报表报表开发指南开发指南 第第 20 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.2.9.2：相关操作相关操作 按立方体要求通过右键菜单的提示进行配置，配置完成，可以使用校验来检验立方体的完整性。2.10 新建报表新建报表(Report)2.10.1：新建报表新建报表 金蝶金蝶 BI 报表报表开发指南开发指南 第第 21 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.选择立方体，数据源，然后按步骤建立报表。2.10.2：相关操作相关操作 立方体，数据源可以在 cube 和 datasource 目录下建立，报表在选择这些立方体/数据源时，会被称为公共数据源。立方体，数据源也可以在 report 目录下建立，这部分被称为私有。2.11 设置变量环境设置变量环境(rutime.var)打开 runtime.var 文件 金蝶金蝶 BI 报表报表开发指南开发指南 第第 22 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.说明：1：每个 Solution 会有一个 rutime.env。2：运行期变量解析类：指的是报表定义中使用的变量的解析类全路径。比如示例报表中变量定义类是：com.kingdee.eas.bi.subject.demo.DemoVarProvider 3：预览期变量是指可以定义预览期的变量值，一旦设定变量值，则预览期将不再从解析类取值，而直接使用设定值，但在真正的集成环境中，此项设置无效。2.12 设计完成设计完成 一旦上述的步聚完成，您的设计工作就完成了。2.13 测试测试 选中工程，右键执行预览。浏览器会自动打开，可以看到您编制的报表：金蝶金蝶 BI 报表报表开发指南开发指南 第第 23 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.第三章第三章 设计立方体设计立方体(Cube)3.1 概述概述 立方体在此处主要是指 OLAP 的星型数据模型的定义。本章会详细介绍其中包含的维度，度量，以及它们的关系的建立。3.2 建立建立 Cube 步骤步骤 下面按步骤介绍 cube 的建立。3.2.1：定义立方体名定义立方体名 金蝶金蝶 BI 报表报表开发指南开发指南 第第 24 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.1：表名对应数据源中的名称，确定立方体事实表的数据源。2：立方体名称会在报表定义中的 MDX 语句使用。如：sselect.from sales 3.2.2：新建维度新建维度 1：标准维与时间维的区别，可参考 附 B 此处不再详述。2：表名对应数据源。3.2.3：建立维度引用建立维度引用 维度引用指的是维度与实事的关联方式。1：维度外键是指在事实中与维表关联的外键。3.2.4：建立维度级别建立维度级别 任何维度必须至少有一个级别。金蝶金蝶 BI 报表报表开发指南开发指南 第第 25 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.标准级别的定义项如下：1：成员键指的是该级别对应的 key 字段。2：成员名称字段对应 name 3：成员别名字段对应 caption 4：排序字段确定级别的排序字段。对于父子级，需要定义父键，子键。对于时间维的级别有所不同，需要选择时间级别。金蝶金蝶 BI 报表报表开发指南开发指南 第第 26 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.1)时间维度：级别有年、季、月、周、日。级别必须按范围大小顺序排列：年季月周日。（可以取部分）3.2.5：建立度量建立度量 度量需要设置以下值：1：显示颜色支持 java 中的 Color 定义和实际的 RGB 值。例如：red 或者 255 2：是否显示：如果选择否。则该度量在度量维的成员选择中不可见。3.2.6：建立计算成员建立计算成员 金蝶金蝶 BI 报表报表开发指南开发指南 第第 27 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.3.2.7：建立维度建立维度级别的级别的属性属性 1：每个级别下可以新建多个属性，也可以不需要。但不要新建 name,caption,key 属性，因为这三个是保留属性(对应于级别中的相应设置)。3.3 相关相关 3.3.1：过滤器宏变量使用过滤器宏变量使用 过滤器的宏变量可以作用于 cube，因为宏是全程替换，所以甚至可以在 cube 源码中使用，因为它的替换会影响 cube 文件的格式化结构，所以并不推荐，并且可以造成 cube 视图不可解析。金蝶金蝶 BI 报表报表开发指南开发指南 第第 28 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.第四章第四章 设计数设计数据源据源(Datasource)4.1 概述概述 数据源主要是为 cube 服务，指明 cube 中级表/事实表的数据来源(定义)，本章详细介绍数据源的定义过程和相关注意事项。4.2 建立建立 Datasource 步骤步骤 下面按步骤介绍数据源的建立过程。4.2.1：设置标题设置标题 此处设置的标题与右键的 Set Caption 作用一样。4.2.2：新建新建 SQL SQL 列表中列出的是已建的 SQL。金蝶金蝶 BI 报表报表开发指南开发指南 第第 29 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.新增，输入名称(对应于 cube 中的表名)，和 sql 语句。1：名称不能重复。2：sql 语句必须符合 ksql 语法。4.2.3：测试数据源测试数据源 点击 测试查询 可以在下方表格得到查询结果集。金蝶金蝶 BI 报表报表开发指南开发指南 第第 30 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.4.3 相关相关 4.3.1：变量使用变量使用 数据源的 sql 中支持变量。比如：Select*from employee where employee_id=$curUser 4.3.2：过滤器宏使用过滤器宏使用 数据源的 sql 中支持过滤器宏。比如：Select*from employee where employee_id=$curUser$4.3.3：过滤器过滤器 SQL 列表条目列表条目 过滤器条目中的 SQL 列表，需要指定数据源。该数据源在此处定义 4.3.4：维度穿透序事簿维度穿透序事簿 报表的维度穿透需要定义穿透到的序事簿，序事簿的数据源在此定义。第第五五章章 设计报表设计报表(Report)5.1 概述概述 报表主要是定义数据模型的初始展示方式，通过 mdx 扩展能力，也可义追加定义新的计算成员(但不推荐，建议在 cube 中定义)。本章详细介绍普通报表的制作过程，某些高级应用在 高级应用 章节介绍。5.2 建立建立 Report 步骤步骤 下面按步骤介绍 Report 的建立过程。金蝶金蝶 BI 报表报表开发指南开发指南 第第 31 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.5.2.1：选定选定 cube 和和 DataSource 1：在 cube/datasource 下面的，将产生前缀公共，表示引用公用的 cube/datasource。如果在其它目录，比如 report 目录下，则不显示前缀，表示私有 cube。只为分类而区分，实际使用中，可以引用任何本主题下任何地方的 cube。但建议能公用的写在 cube 目录下，即使不公用，也建在 cube 下，建议建立子目录以便管理。2：标题的定义与 Set Caption 的效果相同。选择 cube：选择 Datasource 金蝶金蝶 BI 报表报表开发指南开发指南 第第 32 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.5.2.2：新增分析方案新增分析方案 金蝶金蝶 BI 报表报表开发指南开发指南 第第 33 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.1：标题，备注头，备注尾支持变量和过滤器宏。2：每页行数指每页显示的数据行。3：MDX 语句专属于新建的分析方案。5.2.3：新增表新增表 1：显示切片开关，可以设置报表头的切片和维度选择器是否提供。金蝶金蝶 BI 报表报表开发指南开发指南 第第 34 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.5.2.4：新增图新增图 1：显示切换图形：可以设定用户是否可以在运行期切换图表。金蝶金蝶 BI 报表报表开发指南开发指南 第第 35 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.5.2.5：新增过滤器新增过滤器 如果需要，可以新增过滤器。过滤器的详细介绍请参考 过滤器使用一章。5.3 相关相关 5.3.1：变量使用变量使用 在 mdx 语句中可以使用变量。例如：select measures.members on columns,non empty Product.levels(0).members on rows from sales where(Time.$year2000)5.3.2：过滤器宏使用过滤器宏使用 在 mdx 语句中可以使用过滤器宏。5.3.3：维度穿透维度穿透 维度穿透是报表支持联查到序时簿的功能，详细介绍请见高级应用章节。5.3.4：分析方案分析方案 分析方案对应于一个 MDX，其中的表和图位置可以互换，它们的数据来源完全一样，所以它们之间会有联动效应。分析方案中的标题，备注头，备注尾(类似于文档的标题，页头，页尾)可以采用宏变量(过滤器中)或自定义变量，用来显示用户自定义信息。如果为空，则该行不显示。金蝶金蝶 BI 报表报表开发指南开发指南 第第 36 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.第六章第六章 过滤器过滤器使用使用(Filter)6.1 概述概述 本设计器生成的报表本身带有切片/维度成员选择器，它可以达到过滤的效果。但在某些特珠场合，需要更业务化的过滤方式。所以，设计环境提供类似普通非 BI 报表的过滤器。过滤器可以作用于数据源，立方体，MDX，达到过滤的效果。本章将详细介绍过滤器的使用方法。6.2 建立建立 Filter 步骤步骤 6.2.1：定义过滤器总结点定义过滤器总结点 过滤器的名称和标题可以任意，没有实际作用。主要作为过滤条目的一个总节点。6.2.2：定义过滤定义过滤条目条目 过滤条目有三种：输入：主要表现形式是普通的输入文本框 值列表：可枚举的 F7，需要设计者预先设定可选值。SQL 列表：可枚举的 F7，值可以从指定数据源(SQL)获取。金蝶金蝶 BI 报表报表开发指南开发指南 第第 37 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.6.2.3：定义输入条目定义输入条目 1：输入条目根据数据类型(支持日期，文本，数值)不同，在执行期对应不同的输入组件。如果是文本或数值，对应标题文本输入框。如果是日期，则附加一个日期组件，如下图。6.2.4：定义值列表定义值列表 金蝶金蝶 BI 报表报表开发指南开发指南 第第 38 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.添加值列表项：标题用于显示，值是内在用于过滤。运行期的展示形态如下：金蝶金蝶 BI 报表报表开发指南开发指南 第第 39 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.6.2.5：定义定义 SQL 列表列表 Sql 列表的定义方式：1：数据源名称对应数据源中 sql 列表名 2：父子段/子字段可用于构建树形形表。3：是否叶结点的字段：如果存在将加快树的生成。非树形的展示与值列表相同。树形的多选展示如下：金蝶金蝶 BI 报表报表开发指南开发指南 第第 40 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.树形的单选展示如下：6.2.5：过滤的条件设置过滤的条件设置 1：数据类型：日期，文本，数值。日期将影响输入框的组件形态。日期格式 yyyy-MM-dd H:mm:ss 或 yyyy-MM-dd。2：标题：过滤界面显示的过滤项标签。3：比较符，In 表示多选。其它表示单选。4：必须输入：确定执行期是否必填。5：字段：表示该项过滤条件施加到那个数据上，格式为：数据源名称.字段,数据源名称.字段 如“Employee.manager_id,fact.Employee_id“。数据源名称：该报表模型使用到的数据源项名称。6：缺省值：设定默认值。可以支持变量。7：宏变量：用户输入/选定值可以暂存在该宏。而该宏可以作用于 cube,datasource,mdx，从而达到过滤的效果。宏的作用方式是完全替换，所以，比较符和字段对其没有任何影响。注意注意：过滤条目之间是与的关系。金蝶金蝶 BI 报表报表开发指南开发指南 第第 41 页页 共共 49 页页 1996-2009 Kingdee Corporation.All rights reserved.6.3 相关相关 6.3.1：过滤器宏过滤器宏 过滤器的宏可以在变量定义的类中使用。达到一些高级应用的效果。第七章第七章 变量使用变量使用(Variant)7.1 概述概述 变量是为开发人员提供的一种应用扩充方式，主要为了获取一些集成环境中的上下文信息。本章只简单介绍一下变量的使用方法，具体的编码需要开发人员自已具备 java 编码能力。7.2 变量的建立步骤变量的建立步骤 变量需要定义名称，关联变量类，最后在变量类中编写代码。还可以在调试期设定调试值。下面按步骤介绍其中的细节。7.2.1：变量的规则变量的规则 本系统提供三种变量类型，数值，文本，日期。对应于不同的类型，在特定场合会有不同的返回形式。变量的写法有：变量返回时带前后缀。$变量返回时无前后缀$变量$返回时无前后缀。前后缀的返回与数据类型有关：数值无 文本单引号 日期大括号 注意注意：$变量$的写法会优先查看是否有过滤器宏，如果没有才会采用变量系统解析。$的解析方式不同与和$，它将是宏替换方式，所以，它不会理会 单双引号等前后缀符，是一种比较通用和建议的变量书写方式。7.2.2：变量的适用范围变量的适用范围 变量可以在数据源，MDX 语句，报表分析方案的标题，头尾注，序事簿中使用。金蝶金蝶 BI 报表报表开发指南开发指南 第第 42 页页 共共 49 页页 1996-2009 K