计算机软件及应用报表平台软件需求说明书

1、软件需求说明书上海华腾软件系统有限公司文档信息文档版本号起草人起草日期审核人审核日期批准人批准日期预期接收人华腾方：客户方：监理方：修订记录版本日期作者说明本文档中的所有内容为上海华腾软件系统有限公司的机密和专属所有。未经上海华腾软件系统有限公司的明确书面许可，任何组织或个人不得以任何目的、任何形式及任何手段复制或传播本文档部分或全部内容。目录1 前言6 目的6 范围6 定义6 参考资料错误!未定义书签。 文档约定错误!未定义书签。2 系统概述7 目标7 用户特点错误!未定义书签。 假定和约束73 需求规定错误!未定义书签。 功能需求7 <功能需求1>错误!未定义书签。 <功

2、能需求2>错误!未定义书签。 性能需求49 设计约束50 其他要求504 运行环境规定50 设备50 支持软件515 附录51 数据要求51 报表格式52 操作权限52 配置参数53 用户界面531 前言1.1 目的本说明书的目的在于阐明报表平台产品(以下简称本产品)的各项需求，并给出本系统的总体设计。本需求为编制如下文档提供基本依据：l “软件开发计划”l “软件架构设计书”l “软件概要设计说明书”l “软件测试计划”l “软件安装手册”l “系统使用手册”本规格与“软件架构设计书”、“软件概要设计说明书”一起，为编程与集成测试提供基本依据。本规格为编制其它有关文件提供基本依据。本规

3、格为软件质量保证人员提供工作依据。本规格将作为日后软件确认测试和系统验收之准则。1.2 范围系统名称：TopReport任务提出者：上海华腾软件系统有限公司开发者：金融服务事业五部F52用户：公司各需要报表平台产品的实施项目 预期读者包括：软件设计人员、软件测试人员、技术管理人员。1.3 定义即席查询即席查询（Ad Hoc）是用户根据自己的需求，灵活的选择查询条件，系统能够根据用户的选择生成相应的统计报表。即席查询与普通应用查询最大的不同是普通的应用查询是定制开发的，而即席查询是由用户自定义查询条件的。2 系统概述2.1 目标本软件系统的建设目标是建设一个可以进行快速报表设计，展现的基础平台:

4、Ø 支持即席查询和定制报表。Ø 支持excel和ireport设计报表。Ø 可做为报表模块集成到FlowPower平台中。2.2 产品定位人员角色产品价值业务人员n 灵活的即席查询n 丰富的报表展现形式，支持定制报表和仪表盘n 流程具有更大的灵活性，并能自行调整开发和维护人员n 快速的报表设计与开发n 报表热部署n 技术架构由专门的产品组支持和维护，因此应用开发人员可以更专注于客户需求分析以及业务需求的开发，提高项目质量系统管理人员n 系统可以比较容易的进行部署n 报表权限可灵活配置n 系统能够确保稳定、可靠及安全管理层n 统一了报表的开发与维护模式n 系统模块化

5、程度高，方便应用集成的实现n 降低了报表系统开发的成本2.3 假定和约束本软件仅考虑报表设计与展现，不涉及ETL(数据提取，转换和加载)和数据挖掘等内容,但应考虑预留将来扩展的接口。3 功能需求3.1 功能综述本软件系统包含系统管理，数据集管理，报表管理，报表展现四大模块：开发过程开发过程概要开发过程用例图系统管理用户管理机构管理用户组管理报表目录管理单点登录权限管理系统参数管理数据管理数据源管理数据集管理数据集参数数据集字段报表管理模板管理定制报表即席查询设计报表操作权限配置报表发布报表设计导入与导出定时报表配置报表展现即席查询展现定制报表展现报表打印报表下载3.2 开发过程3.2.1 开发

6、过程概要简要而言：报表就是用表格、图表等格式来动态显示数据。具备多样化的格式和动态的数据。多样化的格式：在报表系统中十分复杂的格式排版可以使用本地设计软件制作成报表模板文件，简单样式的可以在线设计即席查询式报表来定制；动态的数据：数据集是通过自定义查询语句来向数据源获取动态的数据，并且可以配置传入参数，所以其获取数据的方式是十分灵活的，另外在即席查询中，用户可以自己在页面上动态地填写查询条件表单，即时地刷新数据，更进一步地加强了数据的动态实时性。下图阐述了一个报表被创建的整个过程。系统开发人员配置数据源和数据集，给报表提供了动态数据获取方式；业务实施人员通过具体需求，确定报表的格式，排版十分复

7、杂使用本地的设计工具预先绘制模板，并上传到服务器，生成定制报表，排版简单，但要求很强的即时性和查询灵活性，则在web页面上直接设计即席查询报表，最后上报管理员审核发布；报表使用者访问发布后的报表页面，查看或者下载报表。3.2.2 开发过程用例图3.3 系统管理3.3.1 用户管理3.3.1.1 新增用户功能概述系统管理员可以新增用户输入（1） 用户编号（2） 用户名（3） 密码（输入两次）（4） 邮箱输入项说明（1） 用户编号，数字必填项，用户在系统中的唯一标识（2） 用户名，文本必填项，用户在系统中的显示名称（3） 密码，密码输入框，必填项（4） 邮箱，文本选填项检查（1） 用户编号应该为固

8、定长度的整数（2） 用户名无重复（3） 邮箱格式是否正确（4） 密码必须为6位处理系统存储用户信息，并将新创建的用户加入到默认用户组中输出（1） 用户编号（2） 用户名（3） 创建人（4） 创建时间3.3.1.2 查询用户查询用户详细信息输入（1） 用户编号（2） 查询用户名输入项说明（1） 用户编号，文本可填项，精确匹配，为空则查询全部（2） 查询用户名，文本可选项，模糊匹配，当为空则查询全部处理系统根据查询条件查询用户信息输出（1） 查询到的用户信息列表3.3.1.3 修改用户功能概述配置修改用户信息3.3.1.3.1 用户基本信息修改输入（1） 新用户名（2） 新邮箱地址输入项说明（1）

9、 新用户名，文本必填项，默认值为原始用户名（2） 新邮箱地址，文本选填项检查（1） 新用户名无重复（2） 邮箱地址格式是否合法（3） 当前操作员应具有用户管理权限或者操作的用户为自己处理系统更新用户信息输出（1） 用户编号（2） 新用户名（3） 新邮箱地址（4） 最近修改人（5） 最近修改日期3.3.1.3.2 修改密码功能概述用户修改自己的密码输入（1） 旧密码（2） 新密码（输入两次）输入项说明（1） 旧密码，密码输入框，必输项（2） 新密码，密码输入框，必输项检查（1） 旧密码，应与用户当前密码一致，6位（2） 新密码，长度为6位处理系统更新用户密码输出（1） 用户编号（2） 用户名（3

10、） 最近修改人（4） 最近修改时间3.3.1.3.3 重置密码在用户遗忘密码时，可以对其进行重置密码的操作，密码将被重置输入（1） 待重置的用户检查（1） 当前操作员是否具有用户管理权限处理系统重置用户的密码输出（1） 用户编号（2） 用户名（3） 最近修改人（4） 最近修改日期3.3.1.4 删除用户功能概述从系统中删除用户信息输入（1） 待删除的用户检查（1） 当前操作用户必须拥有用户管理的权限（2） 待删除的用户不能为当前操作员处理系统删除存储的用户信息，清空该用户的历史日志文件输出（1） 删除操作执行结果3.3.2 机构管理功能概述机构管理用于对用户进行分类归档，统一管理。机构具有树形

11、结构的上下级层次关系，具有机构管理权限的用户可以对机构、机构下人员进行统一的配置管理。3.3.2.1 创建机构输入（1） 机构名称（2） 机构描述（3） 上级机构检查（1） 机构名称，格式合法，且无重复处理保存机构信息，显示保存操作结果输出（1） 机构名称（2） 机构描述（3） 上级机构名称（4） 创建人（5） 创建时间3.3.2.2 查询机构输入（1） 机构名称（2） 上级机构输入项说明（1） 机构名称，文本输入框，模糊匹配机构名称，为空时忽略该查询条件，查询所有（2） 上级机构，列表选项，匹配上级机构，为空时匹配所有检查（1） 机构名称，格式合法，无非法字符处理根据用户输入的查询条件返回匹

12、配到的查询结果输出（1） 匹配到的机构查询结果3.3.2.3 修改机构3.3.2.3.1 基础信息修改功能概述修改机构的基础配置信息界面原型以树的方式显示机构的层次，可以通过拖曳树节点调整层次，双击某个树节点可以弹出编辑菜单，进行机构的属性修改3.3.2.3.2 成员修改功能概述调整机构成员构成输入（1） 用户列表输入项说明（1） 用户列表，拖曳列表必填项检查（1） 当前操作员是否具有机构管理权限界面原型处理存储更新机构当前成员信息输出（1） 机构编号（2） 机构名称（3） 机构成员列表（4） 最近修改人（5） 最近修改时间3.3.3 用户组管理功能概述报表平台中的用户组等同于“角色”，用于配

13、置一组权限，方便统一管理。对这个用户组赋予一定的权限，那么该组内的用户就具有相同的权限。用户组操作包括创建用户组、修改用户组权限、调整用户组成员、删除用户组等操作。3.3.3.1 创建用户组功能概述创建一个新的用户组，该用户组在第一次创建后无任何权限和成员。输入（1） 用户组编号（2） 用户组名称（3） 用户组描述输入项说明（1） 用户组编号，数字必输项，用户组在系统中的唯一标识（2） 用户组名称，文本必输项，用户组在系统中的显示名称，全局唯一（3） 用户组描述，文本选填项，简介用户组的文字检查（1） 用户组编号，应为指定位数的整数，且无重复（2） 用户组名称长度合法，无重复（3） 用户组描述

14、，应小于100个汉字（4） 当前操作用户应具有用户组管理权限处理存储用户组信息输出（1） 用户组编号（2） 用户组名称（3） 用户组描述（4） 创建人（5） 创建时间3.3.3.2 修改用户组3.3.3.3 删除用户组系统管理员删除用户组输入（1） 待删除的用户组检查（1） 当前操作人是否拥有用户组管理权限（2） 不能删除自己所在的用户组，并且待删除的用户组不能为系统预置的用户组（如：默认用户组、超级管理员组等）（3） 待删除的用户组下不能存在下级用户组处理删除用户组，并移除与该用户组相关联的数据输出（1） 删除操作的执行结果3.3.4 报表目录管理报表目录用于归档存放报表，方便分类查找查看。

15、报表目录分为公用目录和个人目录。公用目录公用目录是公有的，但同时对于每个用户，又受带资源权限（详见3.3.6.2资源权限的授予与解除）所约束。每个用户只能看到拥有查看权的目录或者报表，也就是说只能看到公用目录中自己拥有权限的那一部分。对公用目录的新增、移动、修改、删除操作，必须具备目录管理权限的用户才可以执行。个人目录则是每个用户专属的，用户可以任意管理自己的个人目录结构。3.3.5 单点登录功能概述接入外部单点登录平台，提供统一的用户登录。3.3.5.1 用户组或用户信息导入功能概述报表系统从单点登录服务器获取用户组信息，同步转换更新到本地系统库。同步操作可以设定为定时任务，确保两者数据保持

16、一致。界面原型输入（1） 信息服务地址（2） 验证信息（3） 用户组或用户信息转换器（4） 定时任务输入项说明（1） 信息服务地址，必填项，系统从该地址（如WebService）获取用户组或用户信息（2） 验证信息，调用获取用户组或用户信息服务时可能会需要的身份验证信息（3） 用户组或用户信息转换器，选填项，外部用户组或用户信息可能与本地的存在不能自动转换的情况，这时候可以指定一个转换类，用于在同步信息时进行必要的转换（4） 定时任务，文本必填项，格式参考CRON表达式，为空时表示不设置定时同步检查（1） 信息服务地址，服务必须可用（2） 用户组或用户信息转换器，如果填写了值，则检测类路径下是

17、否有该转换器类（3） 定时任务，是否为正确的CRON表达式处理保存同步配置信息，调用远程服务获取用户/用户组信息，转换存储至本地系统。如果配置了CRON表达式，创建定时任务并执行调度。 输出（1） 同步操作的执行结果3.3.5.2 单点登录的接入输入（1） 单点登录用户标识（2） 单点登录用户组输入项说明（1） 单点登录用户标识，用户通过SSO成功登录后，获取到的该单点登录系统的账户标识（2） 单点登录用户组，用户通过SSO成功登录后，获取到的所属用户组信息检查（1） 外部单点登录是否成功，并与本报表系统正确接入处理查询系统中是否存在该外部ID为本次单点登录的ID，如果不存在，则创建一个用户，

18、并设置该用户的外部ID属性为本次登录的ID，加入到默认的用户组。登录流程3.3.5.3 单点登录用户的权限第一次从单点登录服务器登录后会产生一条新的用户记录，并被匹配加入到对应的用户组中，所以第一次登录后，用户拥有默认用户组中的所有权限。之后，就像操作本地用户一样操作该新生成的用户即可3.3.6 权限管理功能概述本系统中权限体系分为两种：一种是菜单权限（系统的开发配置管理），一般被开发和管理人员所拥有；另一种是资源权限（目录和报表的查看权限），一般被查看报表的用户所具有。另外，拥有管理权限的用户同时拥有查看权限。关系图机构包含了用户，用户委派了用户组，而用户组可以绑定菜单权限和资源权限。菜单权

19、限菜单权限用于限定登录用户访问的操作页面。如拥有报表设计权限的用户可以访问报表设计页面进行报表设计配置。目前预置的菜单权限类型如下：（1） 数据管理a) 数据源管理（数据源的增删改查）b) 数据集管理（数据集的增删改查操作）c) 参数管理（参数的增删改查操作）（2） 报表设计a) 模板管理（模板的增删改查操作）b) 即席查询管理（即席查询的增删改查操作）c) 定制报表管理（定制报表的增删改查操作）d) 定时报表管理（定时报表的增删改查操作）e) 报表设计导入与导出（导入导出操作）（3） 系统管理a) 用户管理（用户的增删改查操作）b) 机构管理（机构的增删改查，以及机构的层级、下属人员管理等操

20、作）c) 用户组管理（用户组的增删改查）d) 目录管理（目录的新增、移动、删除、重命名等操作）e) 权限管理（权限分配操作）f) 系统参数管理（管理系统参数）g) 日志查看（查看日志）资源权限资源权限是针对某个资源（目录或者报表）是否具备查看权3.3.6.1 菜单权限的授予与解除界面原型输入（1） 用户组（2） 权限树输入项说明（1） 要操作的用户组（2） 权限树，可复选树，选中表示该用户组拥有对应的权限处理存储更新修改后的用户组权限输出（1） 用户组名称（2） 用户组当前拥有的权限（3） 最后修改人（4） 修改时间3.3.6.2 资源权限的授予与解除功能概述为指定用户组分配目录或者报表的查看

21、权。输入（1） 用户组（2） 目录或者报表检查（1） 当前操作用户是否拥有权限管理权限处理为用户组分配选中的目录或者报表的资源查看权限。输出（1） 授权操作执行结果3.3.7 系统参数管理功能概述系统参数是指系统在运行时所需的一些全局设置。每个参数项由参数段编号（用于给参数分类别）、参数编号、参数名、参数值和备注说明组成。3.3.7.1 系统预置参数系统预置了很多参数项供用户调整配置，随着系统的功能完善，后续也会追加更多的参数项。例：当前系统预置的部分参数：（1） 报表平台基础目录，报表平台的根路径（2） 定时报表生成目录，用于定时任务生成报表后存放，相对目录（3） 临时目录，系统运行过程中产

22、生的临时文件存放路径，相对目录（4） 日期格式，日期格式化字符串（5） 报表预览的默认数据量，整数（6） 报表默认分页大小，整数（7） 上下级用户组权限传递，（0 不传递；1 传递），传递时表示上级用户组除了拥有自有权限之外，同时也拥有其所有下级用户组的权限（8） 系统编码，报表系统所使用的默认编码（9） 空值处理，当值为空时的显示样式（10） 报表发布审核，发布报表是否需要审核确认3.3.7.2 查询系统参数输入（1） 参数段编号（2） 参数编号（3） 参数名输入项说明（1） 参数段编号，下拉可选项，为空时表示忽略参数段，查询全部（2） 参数编号，文本选填项，精确匹配，为空时表示查询全部（3

23、） 参数名，文本选填项，模糊匹配，为空时标识查询全部处理查找满足条件的系统参数信息输出（1） 匹配到的系统参数信息列表3.3.7.3 修改系统参数输入（1） 参数值（2） 备注处理更新对应系统参数的参数值和备注信息输出（1） 参数段编号（2） 参数编号（3） 参数名（4） 参数值（5） 备注3.4 数据管理数据主要包括数据源，数据集和参数的定义，为报表提供了多样化的数据获取方式。3.4.1 数据源管理管理报表平台可用的数据源，报表生成所需的数据从给定的数据源中获取。因目前仅支持数据库类型的数据源，后续可以扩展其他类型的数据源3.4.1.1 创建数据源输入（1） 数据源编号（2） 数据源名称（3

24、） 是否使用JNDI（4） JNDI名称（5） 驱动（6） 用户名（7） 密码（8） IP地址（9） 端口（10） 数据库（11） URL（12） 最大闲置数（13） 最大连接数（14） 超时（15） 验证查询输入项说明（1） 数据源编号，自动生成，该数据源在系统中的唯一标识（2） 数据源名称，文本必填项，该数据源在系统中的显示名称（3） 是否使用JNDI，复选框，勾选表示使用JNDI，需另外填写JNDI名称，其余项均不需要输入（4） JNDI名称，文本选填项，当启用JNDI时必须填写（5） 驱动，JDBC驱动类名（6） 用户名，数据库登录名（7） 密码，数据库登录密码，密码输入框（8） IP

25、地址，数据库IP地址，IP输入框（9） 端口，数字框，范围限定为0 - 65535（10） URL，JDBC连接地址，系统自动辅助生成，也可自行修改（11） 最大闲置数，数字框，当前保持的最大闲置连接数量（12） 最大连接数，数字框连接池在同一时间能分配的最大连接数量（13） 超时，数字框，数据库超时时间（毫秒）（14） 查询验证，可选输入项，用来校验连接池中连接的是否能正常工作的SELECT语句检查（1） 数据源名称，格式合法，且无重复（2） 当勾选JNDI时，检查是否填写了JNDI名称，当未勾选JNDI时，其余的项是否都输入了值（3） JNDI名称，是否符合JNDI命名规则（4） IP地址

26、，是否符合IPv4地址格式（5） 端口号，是否在限定的数字范围内（6） 验证填写的JNDI或者JDBC数据源是否能够正常联通处理系统验证数据源连通性，联通成功则存储更新数据源信息，并创建数据源连接池输出（1） 存储成功的数据源信息（2） 创建人（3） 创建时间（4） 若失败则输出错误信息3.4.1.2 查询数据源输入（1） 数据源名称输入项说明（1） 数据源名称，文本选填项，模糊匹配，为空时查询所有检查（1） 数据源名称，格式合法处理根据查询条件查询数据源信息输出（1） 匹配到的数据源信息列表3.4.1.3 修改数据源输入（1） 数据源名称（2） 是否使用JNDI（3） JNDI名称（4） I

27、P地址（5） 端口号（6） 数据库名（7） URL（8） 驱动（9） 用户名（10） 密码（11） 最大闲置数（12） 最大连接数（13） 超时（14） 验证查询输入项说明（注：参考3.3.1.1创建数据源）检查创建数据源）处理检查连通性，成功则更新数据源的配置信息输出（1） 数据源当前的配置信息（2） 最近修改人（3） 最近修改日期（4） 更新失败则输出异常信息3.4.1.4 删除数据源输入（1） 待删除的数据源检查（1） 待删除的数据源，应没有被数据集关联使用处理验证是否有数据集引用了待删除数据源，如果有则弹出警告并列出这些数据集名称，没有则删除数据源输出（1） 删除操作的执行结果（2）

28、删除失败则返回被关联使用中的报表名称列表3.4.2 数据集管理功能概述数据集是数据的集合，通过配置查询，从数据源中获取符合条件的数据来填充数据集。报表在生成时，会使用当前绑定的数据集查询数据，并生成最终报表。3.4.2.1 创建数据集界面原型 左侧为数据集配置主面板，在此面板中用户定义数据集名、查询类型、查询语句等基本信息 右侧为参数配置面板，用户可以在该面板中进行参数的配置，在查询语句中，可以使用通配符$PXXX来表示引用了一个参数输入（1） 数据集编号（2） 数据集名称（3） 查询类型（4） 查询语句（5） 参数输入项说明（1） 数据集编号，自动生成，查询语句在系统中的唯一标识（2） 数据

29、集名称，文本必填项，查询语句的在系统中的显示名称（3） 查询类型，下拉框，必填项，（0 SQL，1 存储过程，2 ibatis动态SQL，3 - JavaBean）（4） 查询语句，文本必填项（5）检查（1） 根据语句类型检查语句内容语法是否正确处理验证数据集是否能正常联通并获取数据，验证成功则存储数据集信息，失败则警告用户并显示错误信息输出（1） 数据集编号（2） 数据集名称（3） 创建人（4） 创建时间3.4.2.2 查询数据集输入（1） 数据集名称（2） 查询类型输入项说明（1） 数据集名称，文本可填项，模糊查询，为空时则查询所有（2） 查询类型，下拉可选项，（0 SQL，1 存储过程，

30、2 ibatis动态SQL，3 JavaBean），为空时查询所有类型处理查找满足查询条件的数据集输出（1） 匹配到的数据集信息列表3.4.2.3 修改数据集输入（1） 数据集名称（2） 数据源（3） 查询类型（4） 查询语句（5） 参数配置输入项说明（注：参考3.3.2.1创建数据集）检查创建数据集）处理验证数据集联通且能正常获取数据，成功后更新数据集信息，失败则警告用户并显示错误信息输出（1） 数据集编号（2） 数据集名称（3） 最近修改人（4） 最近修改时间3.4.2.4 删除数据集输入（1） 待删除的数据集检查（1） 待删除的数据集，应没有被任何报表关联使用处理检查有无报表正在使用数据

31、集，如果有，则警告用户并显示关联的报表名列表，没有则删除数据集输出（1） 删除操作的执行结果3.4.3 数据集参数数据集参数是指用户可以自行制定数据集查询语句中的参数值，从而灵活地获取符合条件的数据来生成报表。通过页面配置添加数据集参数，数据集在查询语句中以通配符$PXXX的方式引用该参数。3.4.3.1 配置参数界面原型输入（1） 参数名称（2） 参数说明（3） 类型（4） 默认值（5） 参数控件绑定输入项说明（1） 参数名称，文本必填项（2） 参数说明，文本选填项，参数的说明文字（3） 类型，下拉框，必填项，（0 字符串，1 双精度浮点数，2 整数，3 长整数，4 超大数字，5 日期，6

32、数据库日期，7 时间戳，8 布尔值）（4） 默认值，文本可选项（5） 参数控件绑定，下拉框，指定参数在页面渲染时候的控件显示方式检查（1） 参数名称，应为字母数字或下划线构成，并且首字母不能为数字（2） 参数说明，100个汉字长度以内（3） 类型和默认值，必须合法匹配处理存储查询参数配置输出（1） 参数名称（2） 参数描述（3） 参数控件绑定3.4.3.2 参数控件化单独的参数只有在配置成控件后，用户才能在页面上便捷地输入实参值。参数控件化就是指通过配置，指定该参数在前台页面时的应该显示的控件，如显示成数字框、日期框、下拉框，其提供选择的数据是动态或者静态的等等。在实际的配置过程中，有些具备通

33、用性的控件化配置，用户可以配置一次后保存为参数模板，以后再次配置时只需要将该模板绑定到该参数上，即可实现控件化，无需繁琐地每次都需要重新配置。通用配置（1） 控件名，参数控件保存时的名称（2） 标签，控件的显示标签，默认值为参数说明（3） 必输项，实参是否必须指定值（4） 描述，控件的描述文字（5） 数据源，控件可能需要sql动态获取选择值，这时需要制定数据源（6） 默认值，实参默认值，用户可以选择使用一条sql语句，或者静态列表，或者一个自定义的对象用于动态地获取默认值（7） 宽度，参数的宽度（8） 编辑类型，参数控件的渲染类型编辑类型配置文本框（1） 输入类型，普通文本、数字（2） 文本长

34、度，限制文本输入的最大长度（3） 当选择普通文本时，可选择验证方式，如email、整数、URL、中文、密码、数字或字母等（4） 当选择数字时，可填写最小值、最大值、小数位数、前缀后缀等日期选择框（1） 输入类型，日期、时间（2） 是否可手工输入（3） 日期时间格式化字符串选择与下拉（1） 输入类型，包括静态列表，数据字典，动态下拉，动态下拉树（2） 单选多选（3） 是否可输入（4） 当选择静态列表时，需要填写静态列表可选值，格式为0,上海;1,北京;（5） 当选择数据字典时，需要填写数据字典号（6） 当选择动态下拉时，需要动态下拉数据集名称以及值映射，格式value,displayname（7

35、） 当选择动态下拉树时，需要动态下拉树数据集名称以及值映射，格式value,displayname界面原型3.4.3.3 参数的使用输入（1） 实参值检查（1） 必输项参数是否已输入（2） 实参值数据格式是否正确范例数据集的原型图中，配置了PARAM_AGE和PARAM_GENDER参数，在报表展现时，会弹出参数输入窗处理过程系统获取数据集中的查询语句，拼接用户输入的实参值生成最终查询语句，使用该语句向数据源查询满足条件的数据3.4.3.4 预置参数预置参数使用通配符$Sxxxx表示，以下为预置的参数：（1） PAGE_SIZE，分页大小（2） PAGE_NO，页码（3） USER_ID，当前

36、登录用户号（4） USER_NAME，当前登录用户名（5） GROUP_ID，当前登录用户组号（6） GROUP_NAME，当前登录用户组名（7） CURRENT_TIME，当前时间，格式形如2012-01-01 00:00:00（8） CURRENT_YEAR，当前年份（9） CURRENT_MONTH，当前月份（10） CURRENT_DAY，当前日期（11） CURRENT_HOUR，当前时（12） CURRENT_MINUTE，当前分（13） CURRENT_SECOND，当前秒（14） CURRENT_MILLISECOND，当前毫秒（15） CURRENT_REPORT_NAME，

37、当前报表名称3.4.4 数据集字段数据集被创建之后，用户可以查看编辑其字段信息。每个字段拥有字段标识、字段别名、字段类型（整数、浮点、字符串、日期、时间、日期和时间、未知）和字段长度这几个基本信息，用户可以对其进行更改（注意：转换有风险，如数字转字符串可以，但是字符串转数字则不一定可以转）。另外包括附加属性：字段描述、数据格式。3.4.4.1 设置数据格式数据格式用户定义不同类型数据的默认显示方式，如日期、时间的显示格式；浮点数的位数、前缀后缀等。系统预置的数据格式有：（1） 整数a) 千分位b) 科学计数法c) 百万d) 千万e) 百分比（2） 浮点数a) 两位小数b) 三位小数c) 四位小

38、数d) 整数显示e) 百分比（整数）f) 百分比（两位小数）g) 百分比（三位小数）h) 百分比（四位小数）（3） 字符串（4） 日期a) yyyy-MM-ddb) yyyy年MM月dd日（5） 时间a) HH:mm:ssb) HH时mm分ss秒（6） 日期和时间a) yyyy-MM-dd HH:mm:ssb) yyyy年MM月dd日 HH时mm分ss 秒3.4.4.2 定义数据格式预置的数据格式如果不满足用户所需，用户可以自行定义数据格式，不同类型数据的格式配置项如下表：数据类型所需配置项备注说明整数前缀前缀字符，如“￥”，显示为“￥100”后缀后缀字符，如“元”，显示为“100元”计数法千

39、分位和科学计数法变换系数最后的值=原始值*变换系数浮点数前缀后缀小数位数保留的小数位数计数法变换系数字符串前缀后缀日期格式格式化字符串，如yyyy/MM/dd时间格式格式化字符串，如HH:mm:ss日期和时间格式格式化字符串，如yyyy-MM-dd HH:mm:ss3.5 报表管理报表管理主要包括定制报表和即席查询报表的维护与展现等功能。定制报表是指用户使用专业的报表设计软件，定制格式排版等相对复杂的报表模板，以此模板建立报表，并可生成静态的报表文件；即席查询是指用户在浏览器中设计完整的报表表格，最终可以生成附加查询条件、过滤器、排序器和统计项的在线报表，具有非常强的灵活性。3.5.1 模板管

40、理报表模板是指用户使用专业设计软件在本地制作复杂的报表并保存为模板文件（附带了复杂的排版格式、查询语句、参数定义等信息）。上传到报表平台后，系统解析这些文件并作为定制报表所需的模板，最后结合实际的数据源生成最终的报表3.5.1.1 创建模板输入（1） 模板名称（2） 模板文件输入项说明（1） 模板名称，文本必输项，模板的显示名称（2） 模板文件，文件上传必输项检查（1） 模板名称，格式合法，且在系统中唯一（2） 模板文件，后缀名应为jasper、xml、jrxml，且能正确编译处理系统编译模板文件，编译成功则存储入库，失败则警告用户并显示错误信息输出（1） 模板名称（2） 创建人（3） 创建时

41、间3.5.1.2 查询模板输入（1） 模板名称输入项说明（1） 模板名称，文本可填项，模糊查询，为空时则查询所有检查（1） 模板名称，格式合法处理查询满足条件的模板信息输出（1） 模板名称（2） 创建人（3） 创建时间3.5.1.3 修改模板输入（1） 新的模板文件输入项说明（1） 新的模板文件，文件上传必输项检查（1） 新的模板文件格式是否为jasper、jrxml、xml，并且能被后台识别编译处理更新模板配置输出（1） 模板名称（2） 最近修改人（3） 最近修改时间3.5.1.4 删除模板输入（1） 模板名输入项说明（1） 模板名，待删除的模板名称检查待模板应没有被其他报表关联使用。处理删

42、除待删除的模板输出（1） 删除操作的执行结果（2） 删除失败时报告失败原因，如果是因为被报表关联使用，则列出被关联的报表名3.5.2 定制报表3.5.2.1 创建定制报表界面原型输入（1） 报表名称（2） 报表描述（3） 报表模板（4） 动态选择模板（5） 数据集类型（6） 数据源（7） 支持的导出类型（8） 所属报表目录（9） 参数绑定输入项说明（1） 报表名称，文本必输项，报表在平台中的唯一标示（2） 报表描述，文本可选项，报表的简介文字（3） 报表模板，列表必选项，定制报表的设计模板（4） 动态选择模板，勾选框，配置不同时间段定制报表所用的模板，设定后，报表会优先匹配指定时间段的模板，没

43、有匹配到则默认使用（4）中选择的模板（5） 数据源，下拉必选项，报表所使用的数据源（6） 支持的导出类型，多选框，（0 PDF，1 HTML,2 CSV,3 XLS,4 RTF,5 TEXT,6 EXCEL,7 IMAGE），允许导出下载的报表文档类型（7） 所属报表目录，目录树单选，报表存放的目录（8） 参数绑定，将模板中附带的参数和具体的参数控件化类型绑定，完成对参数编辑控件的显示定义检查（1） 报表名称，格式合法，无重复（2） 数据源处理系统存储报表定义输出（1） 报表名称（2） 创建人（3） 创建时间3.5.2.2 定制报表预览输入（1） 预览数据量（2） 实参输入项说明（1） 预览数

44、据量，整数必输项，生成预览时获取的实际数据条数，默认读取系统参数中设定的预览数据量（2） 实参，由报表具体参数配置而定，如报表没有配置参数，则无需输入实参检查（1） 输入的实参是否满足参数配置处理系统生成指定数据量的预览报表输出（1） 预览报表HTML页面3.5.2.3 查询定制报表输入（1） 查询报表名输入项说明（1） 查询报表名，文本选填项，模糊查询，为空时查询所有检查（1） 查询报表名应在15个汉字以内处理查找满足条件的定制报表输出（1） 匹配的定制报表信息列表3.5.2.4 修改定制报表修改定制报表是指修改当前定制报表的最新副本，每个报表永远都维持一个最新的副本，用于随时被修改和发布。

45、输入（1） 报表描述（2） 报表模板（3） 数据集类型（4） 数据源（5） 支持的导出类型输入项说明（注：参考.1创建定制报表）检查（注：参考.1创建定制报表）处理保存副本输出（1） 报表名称（2） 最近修改人（3） 最近修改日期3.5.2.5 删除定制报表输入（1） 待删除定制报表处理如果待删除的定制报表已被发布，则检查待删除定制报表所使用的模板在该报表删除后是否可以进行解锁，如果可以，则删除定制报表成功后解锁模板资源。输出（1） 删除操作的执行结果3.5.3 即席查询设计功能概述即席查询是用户根据自己的需求，灵活的选择查询条件，系统能够根据用户的选择生成相应的统计报表。即席查询与普通应用查

46、询最大的不同是普通的应用查询是定制开发的，而即席查询是由用户自定义查询条件的。在本报表平台中，用户可通过页面灵活地定制即席查询，包括设定数据集，查询头，报表样式等。3.5.3.1 创建即席查询输入（1） 即席查询编号（2） 即席查询名称（3） 即席查询描述（4） 数据集（5） 即席查询设计器（6） 所属报表目录输入项说明（1） 即席查询编号，数字，自动生成，即席查询在系统中的唯一标识（2） 即席查询名称，文本必填项，即席查询在系统中的显示名称（3） 即席查询描述，文本选填项，该即席查询的简介文字（4） 数据集，列表必选项，该即席查询所绑定的数据集（5） 即席查询设计器，必输项，包括了定义表头、

47、单元格、查询头和统计分页、页眉页脚、图表等的设计，设计结果将会作为即席查询组成部分存储至系统（6） 所属报表目录，目录树单选，报表存放的目录检查（1） 即席查询名称，名称格式合法（2） 即席查询数据集，检测当前是否可用（3） 即席查询设计器，至少包含一个完整的表头和单元格定义处理系统存储用户设计的即席查询输入（1） 即席查询名称（2） 即席查询描述（3） 创建人（4） 创建时间3.5.3.2 即席查询设计器本设计器由数据集、表头、单元格、统计行、查询头、分页以及标题、页眉和页脚、图表这几个部分组成。用户打开设计器时，左侧显示当前可用的所有控件，右侧显示报表的结构。如下图： 控件区域，用于往右侧

48、拖曳控件 查询头，该区域只接受输入框控件或者参数控件，用于配置查询头 标题，定制报表的标题 页眉，定制页眉 详细，定制报表最重要的数据表格展示部分 统计，定制图表、统计等 页脚，定制页脚3.5.3.2.1 添加数据集在这部分中用户可以选择即席查询所使用的动态数据集。选定之后，系统会使用该数据集查询并列出其字段以及参数配置信息，确认保存后，控件区的数据集会添加该数据集信息界面原型 数据集下拉框，下拉列表为当前可用的所有数据集 参数列表，数据集中附带的所有参数，双击可以查看其原始配置信息 字段列表，数据集查询到的所有字段，点击“+”可以展开查看详细信息（类型、描述和长度），字段可以进行拖曳，单元格

49、以及统计行均会使用拖曳进行匹配*备注：用户可以在一个即席查询中添加多个子数据集3.5.3.2.2 表头在空间区拖曳表格进入表格显示区之后，会显示一个空的表格，如图:右击菜单通过右击某个表头，可以对该表头进行操作： 左侧插入新列，弹出窗口，输入新的列名后，将会在当前列的左侧创建出新列。 右侧插入新列，参考 创建列群组，在当前列的上方创建父表头，如图，在emp_name上创建列群组“测试1”后的效果 重命名，给当前列赋予新的名称，如下图，调整名称后 删除，删除当前的列 左移列，将列在同行位置上左移一格 右移列，参考拖曳拖曳列可以进行列的顺序、结构调整。例：将emp_job拖曳到刚才emp_name

50、->3.5.3.2.3 单元格单元格可以通过拖曳字段到表头列上进行映射匹配，如下图将字段“emp_name”拖曳到“姓名”上，表示“姓名”列显示“emp_name”字段的值拖曳完成后生成一行映射的行数据双击某个单元格可以弹出窗口，进行更详细的单元格配置（包括数据加工，样式设定） 数据加工，用表达式来对字段数据进行加工（字段均使用通配符$xxx代替） 默认显示样式，可以设置单元格的字体格式和背景颜色 附加决策样式，用户可以配置决策在满足决策条件时使用特定样式。会使用排列在最前面条件满足的样式，若没有任何决策被满足，则使用默认样式。3.5.3.2.4 统计行在表格的第二行（统计行）中双击某个

51、单元格，会弹出一个统计配置窗口，用户可以配置具体的统计方式 统计，统计函数，包括（0 求和；1 平均值；2 最大值；3 最小值；），后续可能会增加其他的统计函数；统计方式包括前台和后台，前台是指只统计当前页面上的数据，后台则统计在后台获取所有数据。 显示样式，包括单元格字体颜色和背景颜色3.5.3.2.5 行配置行配置用于定义数据行的分组，整体的样式（优先使用单元格配置的样式）3.5.3.2.6 查询头在即席查询最终页面中会根据所启用的参数和其控件化配置信息来渲染成查询头，如下图原型3.5.3.2.7 分页原型图对即席查询表格进行分页的配置设定，前台分页表示一次获取所有数据，在前台进行分页，后

52、台分页表示每查看一页就往后台查询获取该页的数据。具体实现待定，后台可能智能地拼接生成分页查询语句，或者需要用户在数据集中自己设定，分页所需的参数由预置参数$SPAGE_SIZE、$SPAGE_NO（备注：$Sxxx这种形式的通配符表示系统预置参数，具体详见3.4.3.4预置参数）3.5.3.2.8 其余显示控件用户可以自行添加其余的显示控件，例如，可以拖曳一个富文本作为标题；拖曳文本标签以及系统参数组成页眉或者页脚等等。3.5.3.2.9 图表图表用于直观地展示报表数据。用户可以进行简单的配置，将对应的字段数据展示成柱形图、折线图、饼图、面积图、散点图等。配置时，首先指定图表的公用配置，如显示位置、显示类型、宽度、高度等；接着根据选择的图表类型进行特殊的配置，如柱状图，需指定X轴和Y轴