BI前端展现COGNOS开发部署文档

1、bi 前端展现前端展现 cognos 开发部署文档开发部署文档 张丽花张丽花 bi 项目组 2011-5-9 修改修改记录记录 编编号号日期日期描述描述版本版本作者作者审审核核发发布日期布日期 12011-05-09 初稿v1.0张丽花 2 目目 录录 1前言前言 .5 1.1编写目的 .5 1.2参考文档 .5 1.3预期读者 .5 1.4术语定义 .5 25173 bi 项目环境项目环境 .6 2.1环境设置 .6 2.2目录设置 .6 3项目开发设计流程图项目开发设计流程图 .6 4transformer 模型开发手册模型开发手册 .8 4.1transformer界面简介.8 4.2建

2、立模型设计的方法 .9 4.3制作 iqd 文件 .10 4.4建立多维模型 .11 4.5模型的一些属性说明和设置 .17 4.5.1 numeric 型 column 的设置.17 4.5.2 rollup 设置 .19 4.5.3设置数值的格式 .20 4.6运行模型生成cube.20 4.7cube的权限设置.21 4.8模型打包发布 .23 4.8.1 cube 和 publishcube.23 4.8.2自动更新模型 .23 4.8.3 framework manager 发布包.24 5frameworkmanager 模型开发手册模型开发手册.34 5.1framework m

3、anger工作流程.34 5.2打开 5173biproject模型.34 5.3导入元数据 .36 5.3.1导入元数据流程 .36 5.3.2导入元数据步骤 .36 5.3.3对元数据建立关系 .39 5.4创建业务视图查询主题 .39 5.5创建多维视图 .41 5.6设置对象安全性 .44 5.7管理和发布包 .46 6迁移备份迁移备份 .47 6.1导出数据包 .47 6.2数据包文件复制 .52 6.3导入数据包 .52 7report studio 报表开发报表开发.53 1 前言前言 1.1 编写目的编写目的 bi 前端展现 cognos 开发部署文档是 bi 项目前端展现设计

4、的操作手册，包括了 bi 前端展现 cognos 开发流程、transformer 模型设计、framework mananger 模型设计和数据迁移的基本方法， 为 cognos 前段展现开发和设计人员提供参考和指导。 1.2 参考文档参考文档 bi 需求项目文档 cognos 的帮助文档 1.3 预期读者预期读者 transformer 模型设计人员 transformer 模型开发人员 framework manager 模型设计人员 framework manager 模型开发人员 report studio 模型设计人员 report studio 模型开发人员 1.4 术语定义术语

5、定义 2 5173 bi 项项目目环环境境 2.1 环境设置环境设置 测试环境：192.168.29.60 正式环境：192.168.74.120 2.2 目录设置目录设置 biprojectcodeiqd -transformer 模型 iqd 文件 biprojectcodemodel-transformer 模型文件 biprojectcodecube-transformer 生成 cube biprojectcodepublishcube-transformer 发布 cube biprojectcodeframework5173biproject-framework 模型 bipro

6、jectcodescript-cube 定时更新脚本 biprojectdoc4.0.0.0分析设计文档-项目需求文分析文档 3 项项目开目开发设计发设计流程流程图图 多维分析还是固 定报表 制作iqd文件 新建项目 项目需求文档说明书 建立多维模型 运行模型生成cube 模型打包发布 在数据库视图，导入模型 所需数据表 对导入的数据表建立关 系 在业务视图目录，制作 查询主题 判定模型是否 多维 在多维分析目录，创建 度量和规则维度 对度量和规则维度之间 定义关系 建立星型组并导入到相 应的业务目录文件中 create alias shortcut，并导入到相 应的业务文件 发布模型 用re

7、port studio 制作报表 用analysis studio 进行分析，并验证模 型是否正确 项目通过测试后，迁移到正式环境 用transformer制作cube用framework建立模型 多维分析固定报表 是 否 结束 4 transformer 模型开模型开发发手册手册 4.1 transformer 界面简介界面简介 transformer 界面包括以下四个基本窗格： 数据源(data sources)窗格 数据源窗格的作用是将数据集成到模型中来。根据项目需求设计文档，从能够支持应用的数据 仓库及数据库中确定要查询哪些数据，并将它们加载进数据源窗格。然后再将数据源窗格的数据用 于

8、建立维度图，并创建 powercube。 在数据源窗格中可以有一个或多个数据源，每个数据源来自于一个数据源文件 (例如.iqd 等) ，每个数据源都有自己的数据源名。每个数据源由构成它的若干列(columns)组成。这是做模型的原 始基本素材。 数据源窗格中列的数据类型： 打开列的属性(双击列名)-general标签页-data class 如果数据源不是来源于.iqd，则它的列的数据类型开始为unspecified(未指定)。 维度图（dimension map）窗格 维度图窗格是一个用于建立多维立方体结构的工作区。根据数据源中的文本数据，各个维度以 及每个维度下层的设定在此组织 (维度和层

9、)。最底层要对应数据源窗格中的一个列。 度量（measures）窗格 度量窗格用于建立和显示模型所需要的度量。度量值是在 powerplay 报表单元中可视的数据。 根据模型设计文档，定义应用中需要的度量。模型中至少要有一个度量，度量与维度的最底一层关 联。每个标准度量要在数据源中对应有一个列 (计算度量除外)。 powercube 窗格 powercube 窗格显示用模型创建的 powercube。 4.2 建立模型设计的方法建立模型设计的方法 建立模型设计时，应首先选择度量，然后选择能够支持度量的维度和层。 作模型设计时，选好要说明的业务领域： 1)选定能够说明业务领域关键成功因素的度量指

10、标； 2)确定能够准确地反映数据等级结构的层。为了使应用导航比较快速和易于操作，尽量保持 每个维度中的层数不超过 5 层。 3)选择的维度与度量要匹配。推荐维度数尽量保持在 57 个，因为较少的维度可以使得应用 几乎更直观和易于使用。 在生成 powercube 前，在 transfomer 模型中必须完成： 1)集成数据源数据 2)建立维度图 3)定义需求的度量 4.3 制作制作 iqd 文件文件 iqd 文件用于在多维模型中组织数据源，实际的作用就是将所需要的维表和事实表从数据库 中读出来，成为生成 cube 的数据来源。 根据以往的经验，虽然 iqd 文件中可以手写较为复杂的 sql 语

11、句，但如果是事实表 iqd 不 建议这样做，iqd 文件中最好只有简单的 select 语句，这样不至于影响效率。 可以通过一个 iqd 的模版手工编写 iqd 文件： a)第 1、2 行是固定语句 b)第 3 行指明了到数据库的逻辑连接名 c)从第 4 行到第 12 行是 iqd 中的查询语句主体 d)从第 13 行到结束是对查询出来的每个字段的申明 以上皆为固定格式 4.4 建立多维模型建立多维模型 1） 点击菜单上的“new”按钮新建一个模型，输入模型名称和数据源名称后，在“data source type” 中选择“impromptu query definition”，即 iqd 类

12、型。 2 从 d:biproject codeiqd 导入需要的维表 iqd，实事表 iqd 维表 iqd 实际上就是对维表的查询语句，用来建立多维模型的维度，实际上就是搭出多维 模型的架子。 事实表 iqd 给出的就是多维模型中最细粒度的数据，实际上就是给多维模型中的 measures 提供数值。 然后点击下一步，在弹出的框中要求输入数据库的登录用户名和密码。最后点击完成。 添加 iqd 文件作为数据源后，双击 iqd 中的列便可以看到列的属性 3 创建维度，从维度 iqd 中拖入需要的维度到维度窗格 拖入“年” 再拖入 “月” 拖入“日期 id“(注意维度的最底层一定要和实事表中的相同，c

13、ognos 是同名关联),且要设 置成 unique 4 维度设置,有经常变化维和不常变化维,双击维度 iqd,在 general 中设置,可以提高 cube 生成效率 对于很少变化的维度，设置如下 常变维度 实事表设置 如果确保维表中是主键唯一，没有重复数据，可以设置成 maximize data access speed,生成 cube 时就不会去验证唯一性，提高生成效率 5 拖入度量 在度量窗格右键单击创建“insert measure folder”,插入度量值组 4.5 模型的一些属性说明和设置模型的一些属性说明和设置 4.5.1 numeric 型型 column 的设置的设置 对

14、空值的特殊设置：如果原数据库中数据为空或者维度组合所对应的数据为空，通过设置 missing value 可以选择显示为空或者为0： 数值输出倍数及精度设置： 之所以会有数值输出倍数及精度设置有如下原因： cube 生成中由于整型数据的运算效率比浮点型要高，所以输入数值会被根据其小数位数自动 进行放大为整数，而作为运算结果输入到 cube 时则会被恢复回原来的值，也就是缩小相应的倍数， outputscale=2，就是乘以 0.01，precision=2 就是精确到小数点后两位。 对于 numeric 型 column 的聚合运算：根据度量的业务含义进行控制，如果度量是按时间维度 进行聚合的

15、话如“余额”度量，就要在 time state rollup 中配置“last priod”。如果是成交金额就要在 regular rollup 中选择 deflaut（sum）： 4.5.2 rollup 设置设置 regular rollup：用于定义在普通维度上进行聚合的运算。 time state rollup：用于定义在时间维度上的聚合运算，如果选择 none（regular rollup）则在时间维度 上是汇总。 4.5.3 设置数值的格式设置数值的格式 对数据的显示格式进行设置。 4.6 运行模型生成运行模型生成 cube 在 powercube 窗格，右键单击，选择“inser

16、t powercube”，创建 cube 在 powercube name 输入名称，选择 powercube file name 后的 browse 按钮选择 cube 保 存路径，cube 生成路径指向 d:biprojectcodecube 目录下 最后选择生成 cube 按钮，生成 cube,最后保存模型 备注：在真实数据生成模型前，可能需要假数据生成 cube,所以生成真数据前，要清空原先 model 中的数据，选择 tools-clean house,再重新生成 cube，并保存模型 4.7 cube 的权限设置的权限设置 cube 或者报表都需要进行权限的设置。cube 的权限配

17、置步骤如下： 我一般只需要对交易类型或游戏厂商表进行权限的设置。 1 选中维度窗口后，选择 show diagram。如下图： 2 选择 show diagram 后会出现以下界面； 3 选择 use customvier。如下图： 4 选择 use custom view 后就可以对该维表进行权限设置。选择你要排除掉的交易类型(该角色 的用户不应该看到交易类型)后，就可以啦。 4.8 模型打包发布模型打包发布 4.8.1 cube 和和 publishcube cube 和 publishcube 是 cube 在硬盘上的存放路径。在用 transformer 开发 cube 时,cube

18、目录是模 型 model 生成 cube 的位置，在自动更新 cube 时，先生成到 cube 目录，然后自动复制到 publishcube 目录。 在 cognos 门户中创建数据源时，cube 的路径是 publishcube 文件夹中相对应的位置 4.8.2 自动更新模型自动更新模型 (1) 打开 transformer,创建新的 model，在 file/model properties 中设置 utf-8，在 code/transformer 中指定的文件路径保存,生成 cube 到 code/cube。cube 和 model 名要保持 一样 (2) 自动更新 cube,把新生成

19、model 加到自动更新脚本中，有两个自动更新脚本，分两个时间 点，经营数据 bkupdatecube1.bat 是早上 9 点更新，其它 updatecube.bat 是 11:30 更新，如 把 5173 资金余额统计.mdl 加到脚本，打开经营数据 bkupdatecube1.bat。加入一行 cogtr.exe -n1 -s -kdw=dwuser/ d:biprojectmodels资金数据分析.pyj xcopy d:biprojectcubes资金数据分析.mdc d:biprojectpublishcubes /e /y 4.8.3 framework manager 发布包发

20、布包 cube 的名称和 model 的名称，还有数据源名称，project 名称，包的名称都要保持一样 打开 fm，创建一个新的 project,命名为“经营数据分析”， 创建新的数据源 选择 new 按钮，创建新的数据源 在下找到 cube 的位置,一定要是全路径 测试连接 关闭，选择刚创建的数据源 选择 next,包名和数据源名相同 选择 finish 选择“打开”图标，指定包的存放路径，新发布的包是存放在“多维分析模型”目录中 最后选择 finish，完成包的发布 5 frameworkmanager 模型开模型开发发手册手册 5.1 framework manger 工作流程工作流程

21、 5.2 打开打开 5173biproject 模型模型 点击菜单上的“open”按钮打开 5173biproject 模型， 点击“打开”按钮，在弹出的框中要求输入 cognos connection 的登录用户名和密码。 5.3 导入元数据导入元数据 5.3.1 导入元数据流程导入元数据流程 5.3.2 导入元数据步骤导入元数据步骤 1) 在 5173 数据仓库-数据源视图，右击选择“run metadata wizard” 2) 选择元数据源，点击“next” 按钮， 3) 从已有的数据源菜单中，选择“dw”,点击“next” 4) 选择所需要的维度表或事实表， 点击“next”,点击“

22、导入” 5.3.3 对元数据建立关系对元数据建立关系 在数据库视图目录下，对导入的维度表和事实表，建立主外键关系，维度表是主键，事实表是外键。 5.4 创建业务视图查询主题创建业务视图查询主题 模型查询主题重复使用来自数据源视图中的查询主题和其它模型查询主题的查询项 它们对于创建有意义的元数据视图给报表作者是非常有效的 模型查询主题在不影响底层查询主题的情况下，允许进一步定制元数据以满足特殊需求。 1)在业务视图目录，右击“create”- “query subject” 2)输入查询主题名称，点击“ok” 3)对查询主题的查询项进行定义 4)把 name 修改成中文 5.5 创建多维视图创建

23、多维视图 1)根据需求文档，在业务视图，创建维度。 2) 对维度建立层次关系， 3)创建度量 4)对规则维度和度量维度，建立关系。 5)选择“度量维度”，右击，选择“create star shcema grouping” 6 按照需求文档，把模型移动到相应的文件夹下。 5.6 设置对象安全性设置对象安全性 按需求文档，设置多维分析对象的安全性 5.7 管理和发布包管理和发布包 1)在 packages-5173bi,右击，选择“publish packages” 2)选择包的发布位置，点“next”-“next”-“next”-“publish” 6 迁移迁移备备份份 当报表和多维模型在测试服务器上测试通过后，需从 192.168.29.60 导出数据包，然后导入到 192.168.74.120 上。下面介绍在 cognos 中怎样对数据进行备份及迁移。 6.1 导出数据包导出数据包 1)打开cognos服务，在【启动】下拉菜单下,选择【cognos administration】进入页面，如下图所示。 2)在弹出的页面中选择【配置】下的内容管理，如下图所示。 3)在右上角工具导航条上选择【新建导出】，如下图 4)在弹出的【新建导出向导】页面中,为新建的包取名，进入下一步。 5)在弹出的【选择部署方法-新建导出向导