报表仓库应用手册.doc

报表仓库应用手册 版本 2.0 使用对象本手册主要面向A3产品高级实施顾问及用户内部顾问 版本控制【此部分要记录该文档形成过程中的历次版本变更过程及变更的内容】编号章节修订说明项目当前版本号修订日期修订前版本号修订后版本号修改人审批人1初始创建，全部章节12002011-12-71.0汪国瑞2增补第十章节12002012-04-161.01.1汪国瑞 3修改格式 12002012-09-241.1 2.0汪国瑞目录一、功能概述51.1 关于本模块51.2 主要功能51.2.1 数据服务定义51.2.2 报表设计61.2.3 计算方案设置61.2.4 权限管理61.2.5 报表应用发布61.2.6 报表导航61.2.7 组合查询6二、应用流程7三、报表设计83.1 案例简介83.2 操作说明103.2.1 基础数据设置103.2.2 合同收支汇总分析设计113.2.3 合同执行明细分析设计213.2.4 报表钻取应用26四、样表管理33五、计算方案35六、权限管理37七、应用发布38八、报表导航39九、组合查询40十、应用技巧集锦4310.1 数据源定义4310.1.1 存储过程应用4310.1.2 参数多值应用4410.1.3 系统变量应用4610.1.4 过滤条件应用4810.1.5 数据源列表自定义功能4910.2 Oracle数据库注意事宜5010.2.1 中文显示乱码5010.2.2 参数变量定义50一、 功能概述1.1 关于本模块企业在应用 ERP 系统一段时间后，将会产生大量的日常运营数据。这些数据都是企业宝贵的信息资源，它为企业各方面了解企业当前运营状况，作出各项决策提供定量化的依据。可以说，判断一个ERP 系统的成熟与否，很大程度上看其数据分析功能是否能满足客户的需要。新中大A3的各模块不仅为用户提供了丰富的通用的报表，而且提供了A3报表仓库模块帮助用户快速、准确地编制各种个性化报表。A3报表仓库模块提供了丰富的内置系统服务及变量，满足各层次用户不同需要；而且其与EXCEL 类似的操作风格，用户经过简单培训就能独立操作编制自己所需报表，降低企业培训费用。1.2 主要功能 报表仓库模块主要有自定义报表的设计、注册、授权、应用导航等功能， 实现了自定义报表的统一集成管理。 本版本完善了报表的应用展示功能，用户可在框架的管理对象、自定义功能树，面板功能区块快速引用，丰富A3产品的桌面展示功能，为企业高层管理人员提供了形象有效的决策分析工具。1.2.1 数据服务定义 作为自定义报表的核心内容，数据服务的应用尤为关键，目前系统提供内置系统服务（数据源）以及自定义服务功能（数据源），自定义数据服务主要支持基于SQL的定义方式，与一代lform数据源定义方式较为相似。1.2.2 报表设计 报表仓库模块应用了lform2.0报表控件，报表设计方式与lform1.0类似，在引用数据源的方式上存在一些差异，需事先通过中心数据源管理模块引入报表设计的数据源。1.2.3 计算方案设置 该功能适用于无参数报表，用户通过计算方案配置可实现报表的固定周期隔时自动计算。方便用户快速查询事先缓存的计算结果，优化复杂报表即时查询时的性能。1.2.4 权限管理 统一的报表授权平台，可按用户、用户组、角色维度对系统样表、自定义报表进行权限管理。1.2.5 报表应用发布 报表仓库中完成核准的报表可被发布至A3主框架的多个区域：自定义功能树、“报表”管理对象、快捷功能、框架面板区域，方面用户快速应用报表功能。1.2.6 报表导航 报表导航功能用于报表发布应用记录情况的查询，用户可按应用位置、业务类型维度进行应用分布情况的查询。1.2.7 主题分析该功能是报表仓库报表、财务中心自定义报表、项目管理自定义报表以及系统内置业务固定报表按角色进行多报表集中查询分析功能。二、 应用流程如下流程图概括的描述了自定义报表的通用设计应用流程进。三、 报表设计3.1 案例简介为系统化阐述报表从设计到授权发布应用的整体流程，本文将通过引用如下报表实例进行详细说明。 报表实例说明：报表名称功能说明面向对象说明合同收支汇总分析可按收支方向、类型统计合同的结算执行情况公司领导可作为桌面指标报表合同执行明细分析可按收支方向、类型查询合同的明细信息及结算执行情况公司领导、合同管理用户该报表可作为收支汇总分析表的链接表 报表样式： 合同收支汇总分析 合同执行明细分析3.2 操作说明3.2.1 基础数据设置基础设据设置步骤目前需要配置的内容主要是报表的业务类型及报表存放目录。 报表业务类型设置【操作界面】：业务类型设置 报表目录维护【操作界面】：报表列表报表目录 数据源目录维护【操作界面】：数据源设置服务目录3.2.2 合同收支汇总分析设计 下文将详细介绍合同收支汇总分析表的设计实现过程，该报表主要由数据列表和图形两部分组成，其中图形根据明细数据结果进行展示。3.2.2.1 报表新增【操作界面】：报表列表新增 在主菜单中单击【报表列表】 ，进入报表列表界面，选择目录后可单击【新增】进入报表新增报表的属性编辑页面，可根据需要填入相关属性内容，如下图： 完成属性信息填写后，可通过【保存】按钮完成报表的属性暂存，回到报表列表页面，或通过【保存并设计】直接进入报表设计页面。3.2.2.2 报表样式设计 报表工作页新建进入报表设计功能后，需新增报表工作页，类似Excel的sheet页： 报表样式设计可先按照要求完成报表基本格式的设计，报表设计器采用了类Excel的设计模式，可以将现成的报表格式从excel中直接复制到报表设计器进行快速定制报表格式，本文略过此功能详细介绍。3.2.2.3 报表数据源定义数据源即报表展示结果的取数来源，是报表设计过程中核心的步骤，用户可以结果为导向根据报表展示内容的需要进行定义，目前数据源的获取有两种方式：系统默认内置数据源，用户自定义数据源（基于sql 语句或存储过程）。本示例报表的数据源定义步骤如下： 数据源定义sql编写，建议在SQL查询分析其中完成语句编写：本报表数据源详细SQL可见A3系统内置服务：S00000048合同收支汇总分析 新增自定义数据服务【操作界面】：数据服务设置-新增 数据服务列表 数据服务新增l 基本信息：用于定义服务名称，说明描述l 查询定义：数据源SQL定义，可将查询分析器中已完成的sql黏贴到查询定义即可。l 预览：服务定义完成后，可点击“预览”查看该数据服务的运行结果，检测服务定义是否正确。 数据源预览 中心数据源引入已定义的数据源服务考虑到系统后期的功能扩展，数据服务定义的功能不仅为自定义报表应用，也可为下一代自定义表单应用，因此报表仓库模块增加了中心数据源功能，即自定义报表可引用已发布到中心数据源中的数据服务。自定义表单自定义报表表单数据源中心数据源数据服务定义【操作界面】：中心数据服务设置-新增数据服务3.2.2.4 报表数据设计通过如上步骤完成了该报表的数据服务定义后，可将中心数据源中的“合同收支汇总分析”数据源引入报表。 引入报表数据源 报表数据填充设置完成数据源引入后，可点击toolbar上的“工具箱”，进入数据源页签，如下： 数据源页签说明：l 标题行：数据源各字段的描述l 数据行：数据服务提供的数据结果；用户可直接选择“数据行”拖拉进报表设计器的任意单元格，报表计算时可动态产生数据源包含的各列结果。l 单个数据：即数据源包含的各个字段，也可直接拖拉至单元格引用，但报表计算时仅动态产生拖入的字段列。 如上图所示，用户可将“数据行”直接拖拉至B5单元格，完成数据源填充位置设置。 完成如上数据源填充设置后，用户可保存，此时简单的列表式报表已完成设计，报表运行效果如下：l 序号可通过lform的自带函数=dataRowNumber( )实现l 合计可通过lform的自带函数=sum( , , , )实现，如合同金额列的合计函数写法为：=sum(e5:e5) 分类汇总小计设置本报表中可增加按“收支方向”、“结算模式”列进行分类汇总，实现金额小计，效果如下： 可通过lform自带的数据源分类汇总实现l 分类项设置：如下可选择收支方向、结算模式、合同类型进行分类，并设置需进行小计的分类l 小计公式设置： 小计公式有求和、求平均等等，相见“提示”。3.2.2.5 报表图形设计本章节主要介绍汇总分析表中下半部分的饼状图、柱状图设计。图形的设置及运行效果依赖于数据源，因此图形设置的核心的内容是配置与数据源字段的取数关系。 柱状图l 由于本报表的数据源进行了分类汇总设置，因此添加图形时，需选择“分类汇总统计图（数据源）”下拉类型l 系统默认第一级分类项“收支方向”为图形的统计数据项，并选择已结算金额、未结算金额为系列，完成设置后可点击确定，将图形放置在设计器任意位置。l 报表计算后图形效果为如下 饼状图配置与柱状图类似3.2.3 合同执行明细分析设计该执行明细表与如上汇总分析表的最大差别在于增加了可交互的查询条件，用户可输入相关查询条件进行查询，且“收支方向”、“合同类型”为必输条件，“项目”、“结算单位”为可选条件。3.2.3.1 报表新增同上，本处省略。3.2.3.2 报表样式设计同上，本处省略。3.2.3.3 报表数据源定义本报表数据源定义时需增加作为查询条件的四个参数，其中“收支方向”、“合同类型”为必输条件，“项目”、“结算单位”为可选条件。 做为必输条件的参数需在sql编辑器中用进行申明，且在“查询条件”TAB设置对应名称参数，“取值来源”取客户端（即从lform获取用户手工输入的条件）如下： 做为可选条件的参数需在sql编辑器中用query进行标记占位，且在“过滤条件”TAB设置对应参数，注意参数名必须与后台物理字段名称一致：说明：本报表数据源详细SQL可见A3系统内置服务：S00000061合同执行明细分析 本例中query 占位符等同于sql中的 and xm = and jsdw=，因此在query所在的SQL语句前需有where条件，且where 和query需在过滤条件的同一层，例如在secuser中将logid作为可选过滤条件查询用户信息时，则数据源中查询定义如下： 参数定义时“取值来源”可选择如下类型： l 固定值：默认给参数赋固定值l 客户端：获取用户在lform中输入的内容传递给对应参数l 日期时间：提供系统当前日期的取数来源，如当月、当季等l 系统信息：系统总线提供的服务，如当前用户、当前组织等3.2.3.4 报表查询条件设置完成数据源设计后，需在lform设计器中进行查询条件设置，lform目前支持三类条件输入方式：手工录入、下拉字典（弹出帮助）、日期控件。 查询条件类型： 手工录入即lform中普通单元格 下拉字典：l 手工新增字典：字典内容较少，系统表无取数来源的字典可由手工录入l 数据源字典：字典内容可从系统表或内置系统服务获取，可直接引用中心数据源中任意数据源作为字典。 日期控件lform提供的日期输入小日历，启用步骤如下：l 设置某单元格属性为日期型l Sheet页属性启用l 日历效果，双击单元格可弹出如下日历效果： 查询条件区与数据源参数绑定：查询条件字段与数据源参数绑定的方式与lform1.0相似，直接在数据源所在单元格依次输入其参数对应的取数坐标位置即可。 可对收支方向、合同类型字段所在单元格设置必输项提示，右键属性，设置窗口及效果如下：3.2.4 报表钻取应用报表的钻取查询功能是新一代报表平台的特色功能，可通过超链接的方式实现多张报表的数据透视查询。功能模型及实现流程如下：3.2.4.1案例一文本钻取 当前版本系统可对单元格或图形设置穿透链接，本手册将以如上汇总表与明细表为例，进行报表钻取功能的介绍。 案例场景描述用户点击汇总表的收支方向字段，可以明细表为蓝本，钻取显示对应方向合同的明细收支情况，如下： 明细报表根据源报表链接传递的收支方向显示合同类型为采购合同的相关合同明细执行信息。 明细报表对应的数据源及参数为：ds1 ；szfx,htlx 链接配置说明 选择需产生链接的单元格，右键选择“报表链接设置”，如下图选择“收支方向”B5单元格，进入链接配置页面： 在“关联关联报表”处选择该链接需钻取的目标报表，并明确至具体工作表（sheet页），完成数据穿透的目标报表设定。 接下来进入核心的传参方式配置区：l 不传参：目标报表无需从源报表接受参数计算，即“死链接”l 固定值传参：可将多个固定值传入目标报表数据源l 单元格静态传参：以单元格坐标标识源报表中需传递的内容l 单元格动态传参：以单元格坐标标识源报表中需传递的内容，与静态单元格传参的差异在于其链接配置的对象为数据源动态产生的单元格l 图形传参：将图形中鼠标选择图形区域的信息作为参数传递至目标报表 本应用场景中：链接需产生在合同类型字段上，随数据源计算实时产生，且需要源报表链接传入收支方向、合同类型作为明细表的计算参数，收支方向依赖用户点击链接不同而传递。 综上所述，需采用“动态单元格传参”方式，将鼠标点击链接对应的收支方向值以及采购合同这一类型传递至目标报表钻取数据。 l 由于需将“收支方向”的后台代码传至目标报表，因此数据源中合同类型名称后需增加recpay列，提供合同类型的代码列，即上图的C列，因此设置为：l 需传递的采购合同类型值为（ProjectPurchase）固定内容，因此设置为：3.2.4.2案例二图形钻取 案例场景描述用户点击汇总表中饼状图的任意饼块，可以明细表为蓝本，钻取显示对应收支方向合同且合同类型为采购合同(ProjectPurchase)的合同明细收支情况，如下： 明细报表根据源报表链接传递的收支方向显示合同类型为采购合同(ProjectPurchase)的相关合同明细执行信息。 明细报表对应的数据源及参数为：ds1 ；szfx,htlx 链接配置说明 选择需产生链接的单元格，右键选择“报表链接设置”，如下图选择饼状图，进入链接配置页面： 在“链接关联报表”处选择该链接需钻取的目标报表，并明确至具体工作表（sheet页），完成数据穿透的目标报表设定。 本应用场景中：链接需产生在合同类型字段上，随数据源计算实时产生，且需要源报表链接传入收支方向、合同类型作为明细表的计算参数，收支方向依赖用户点击图形不同而传递。 综上所述，需采用“图形传参”方式，将鼠标点击链接对应的收支方向值以及采购合同（ProjectPurchase）这一类型传递至目标报表钻取数据。 l 由于需将“收支方向”的后台代码传至目标报表，因此数据源中合同类型名称后需增加recpay列，提供合同类型的代码列，即上图的C列，因此设置为：l 需传递的采购合同类型值为（ProjectPurchase）固定内容，因此设置为：四、 样表管理为方便企业用户快速获取各类报表，系统已内置施工行业最常用的样表供实施顾问、企业内部快速部署，使用。并且随着产品版本的更新，样表库会进行不断的更新、完善。作为系统的样表涉及了各模块的业务数据，因此样表也需进行完善的权限控制，系统内置的报表管理员角色rw_admin具备了所有样表的默认权限。因此用户可通过关联系统内置的报表管理员角色进行样表引入，并将样表分配给相关用户使用。除了系统样表的引入应用，软件还提供了将自定义报表发布样表功能，以供企业定制个性化样表库。 【操作界面】：报表列表样表引入将系统样表库中的样表复制到报表列表中，供用户设计、使用 【操作界面】：报表列表转存样表将报表列表中自定义的报表发布到样表库，充实样表库内容 【操作界面】：dbcnt数据导入该功能用于系统样表更新导入。正常版本升级后，dbcnt升级时会同步更新系统内置报表，若存在更新失败时，管理员可进入DBCNT，选择对应账套年度通过“数据导入”功能，选择系统内置报表进行报表导入。五、 计算方案本版本系统提供计算式报表的计算方案设置功能，可实现预先计算报表，减少报表查看时的计算等待时间。 【操作界面】：报表列表计算方案设置 计算策略 目前方案设置的策略为按周期间隔配置，可对汇总表设置计算方案如下：每日更新一次： 实现流程：六、 权限管理系统支持按角色、用户组、用户三个维度对系统样表、自定义报表进行权限管理，且分为三个权限等级：查看、修改、删除。方便大量报表授权操作，系统支持批量授权方式。 【操作界面】：报表授权、样表授权 报表管理员角色为方便用户进行系统内置报表授权，系统内置了报表管理员角色rw_admin，该角色默认具备系统内置样表以及所有自定义报表的删除权限。七、 应用发布当前版本用户可将自定义报表发布到主框架的多个位置，方便用户快速查阅应用。 快捷功能 igoogle功能面板 自定义功能树 报表（报表管理对象）八、 报表导航该功能用于展示当前用户具备权限报表的应用位置记录，效果如下：九、 主题分析该功能用于实现报表仓库报表、财务中心自定义报表、项目管理自定义报表以及系统内置业务固定报表按角色实现主题分析。l 业务流程l 实现效果： 主题维护 主题角色关联 角色用户关联【操作界面】：企业权限中心授权管理用户角色定义 主题分析十、 应用技巧集锦10.1 数据源定义10.1.1 存储过程应用 首先在对应账套数据库建立存储过程 数据源定义时，直接在查询定义区选择“存储过程”选项，并在定义区输入存储过程名称 若存储过程中含参数需从系统变量、lform报表获取，则需在“查询条件设置”中进行参数 应用示例l 储存过程定义：create proc test (logid varchar(200)asselect logid,u_name from secuser where logid =logid 注意：该存储过程中logid为必输参数l 数据源设置10.1.2 参数多值应用参数多值指的是数据源中的参数可接收多个值进行查询操作。 查询条件设置多值参数l 数据源sql定义时对于输入多值的参数需用 进行标记l 如上 进行标识的参数名必须与查询条件的“别名”或“参数名”一致（参数名与别名都存在时以别名为准