报表功能使用说明docx - urtracker

《报表功能使用说明docx - urtracker》由会员分享，可在线阅读，更多相关《报表功能使用说明docx - urtracker（20页珍藏版）》请在金锄头文库上搜索。

1、1 概述概述为满足客户个性化的统计和报表需求，我们在 URTracker 中开发了“报表”功能。报表功 能主要定义、存储、执行和输出自定义的 SQL 查询语句，并提供相应的操作界面和权限控 制。1.1 报表目录报表目录报表目录用于将相关或类似的报表进行分组，以便于管理和查找。1.2 支持的报表类型支持的报表类型根据报表定义的方式，URTracker 目前支持如下类型的报表：报表类型报表类型实现方式实现方式定义方式定义方式主要应用主要应用备注备注内置报表加载和运行系 统预定义的一 些报表控件。选择要使用的报 表控件，并根据 需要提供一个参 数。用于提供一些比 较通过且较为复 杂的查询统计。 或实

2、现特殊的交 互功能。允许输入参数的 报表控件可以实 现对同一类型对 象的查询。单个查询运行一个固定 的 SQL 查询语 句，显示结果 集表格。输入需要运行的 SQL 查询语句。比较简单的，需 经常进行的查询 统计。多个查询运行多个 SQL 查询语句并按 顺序显示结果。定义多个查询以 及查询中用到的 参数宏。输出一组相关的 查询统计结果。可以接收参数， 并在运行时替 换 SQL 语句中 的对应部分。RDL 报表加载和显示 SQL Server 报 表服务中定义 的报表。指定 SQL Server 报表服务的参数， 报表路径等相关 参数。一些比较复杂或 者对展示方式有 特殊要求的报表。2 报表的权

3、限控制报表的权限控制2.1 浏览报表浏览报表报表的浏览全选通过两个级别控制。第一级别为报表功能级别，通过系统角色权限控 制。第二级别为具体报表的权限，通过报表本身的权限设置控制。报表功能权限报表功能权限由于大部分使用者更多关注的是和自己有关的事务，所以默认是不给普通用户开放查 看报表权限的。 如果需要允许某些用户账号使用报表功能，请在系统角色权限设置页面中单独创建一 个角色，赋予“报表-浏览报表”权限。将需要使用报表功能的账号加入此角色即可。浏览某个报表的权限浏览某个报表的权限 在创建或编辑报表时，可以指定该报表允许哪些人浏览。如果设置为“所有人可以访问” ， 那么所有有使用报表功能的人都可以

4、查看此报表。2.2 报表管理权限报表管理权限具有系统管理权限权限的账号或者“报表-管理报表”系统权限的账号可以管理报表目录、 添加、删除或编辑报表。3 报表目录管理报表目录管理具有管理报表权限的账号，浏览“报表”页面，点击“管理/添加报表”链接，即可进入报 表管理界面。在此界面中，您可以管理报表目录或添加、编辑、删除报表。如下图所示：该页面左侧显示了当前系统中已定义的报表目录和报表。点击某个目录或报表即可选择该 对象。在右侧会显示针对该对象的操作界面。选中“隐藏报表” ，可以在左侧只显示报表目 录，从而方便您对目录本身的管理操作。3.1 创建目录创建目录创建顶级目录创建顶级目录在目录名称中输入

5、要创建目录的名称，然后点击“添加顶级目录”即可。为某个目录创建子目录为某个目录创建子目录先在左侧的目录树种选中要创建子目录的目录，然后在右侧“添加报表目录”区域中输入 目录名称、说明，然后点击“添加选中目录的子目录”按钮。3.2 目录更改目录更改更改目录名称更改目录名称 在左侧目录树中选中要操作的目录。在右侧“编辑目录”区域中，输入新的目录名称，点 击“更新”按钮即可。删除目录删除目录 只有空的目录才能删除。在左侧目录树种选择要删除的空目录，然后在右侧“编辑目录” 区域中点击“删除”按钮即可。调整目录顺序调整目录顺序 从左侧选中要操作的目录，在右侧“调整顺序”区域中点击“向上移动”或“向下移动

6、” 即可调整该目录的显示顺序。移动目录或项目移动目录或项目本操作用于将一个目录或项目移动到另外一个目录下。请从左侧目录树中选择要移动的目 录或项目，在右侧选择目标目录，然后点击“移动到目标目录下”按钮即可。合并目录合并目录 合并目录用于将源目录中的内容移动到目标目录下，而源目录本身不动。请从左侧目录树 中选择要合并的目录，在右侧选择目标目录，然后点击“合并到目标目录下”按钮即可。 如果要将某个目录更改为顶级目录，请选择一个子目录，然后点击“更改为顶级目录”即 可。4 创建报表创建报表您可以通过两个途径进入创建报表的页面。 方式一：从左侧目录树中选中要在其中创建报表的目录，然后点击右侧“编辑目录

7、”区域 中的“在此目录下创建报表”按钮。方式二：直接点击报表目录后的“+”图标即可。如下图所示：创建报表页面的布局如下图所示：报表名称、说明、权限定义部分是对所有的报表类型都相同的。报表定义输入表单根据您 所选择的报表类型的不同而变化。输入报表的名称、说明、访问权限以及报表定义信息后，点击“保存报表” ，即可生成报表。 您可以返回到报表管理页面中进行编辑或预览。5 报表类型及定义报表类型及定义5.1 内置报表内置报表内置报表使用我们开发好的报表控件来现实一些针对某些特殊的需求统计结果。 在使用内置报表时，您首先从“报表控件”下拉框中选择一个要使用的报表控件，然后根 据需要在下面的“参数”框中输

8、入参数。下面针对具体的内置报表控件进行说明。5.1.1 在全局范围内查询事务清单在全局范围内查询事务清单用途：根据指定的过滤条件查询事务清单。 参数：SELECT 语句 WHERE 后的部分。如“查询当前系统中所有跟踪中的事务” ，参数为“IsClosed=0”即可。 示例：欲查询系统中所有提交给工作组（未被领取的）的事务清单。报表定义如下图所示：报表运行界面如下图所示：支持分页、排序和导出功能。5.1.2 在所有跟踪中的事务中搜索在所有跟踪中的事务中搜索用途：运行时，根据所属项目、创建人、待办人、标题关键词等条件查询事务。 参数：不需要参数。5.1.3 系统概况系统概况用途：显示当前系统的基

9、本情况，如项目数、账号数、事务数等。 参数：不需要参数。 示例：5.1.4 所有项目的概况统计所有项目的概况统计用途：统计各个项目的基本情况。 参数：不需要参数。 示例：5.1.5 所有部门的概况统计所有部门的概况统计.用途：统计各部门的基本情况。 参数：不需要参数。 示例：5.1.6 针对某个部门的详情统计针对某个部门的详情统计用途：统计某个部门参与事务处理的情况，以及各部门成员的基本情况。 参数：要统计部门的 ID。示例：5.1.7 所有系统成员事务数统计所有系统成员事务数统计用途：统计所有系统成员在一段时间内创建、处理的事务数量。 参数：不需要参数。 示例：5.1.8 输入和执行输入和执

10、行 SQL 查询语句查询语句用途：用于在运行时执行任意输入的 SQL SELECT 语句。参数：不需要参数 示例：5.2 单个查询（执行和输出单个固定的单个查询（执行和输出单个固定的 SQL 查询语句）查询语句）本报表类型用于运行和输出一个固定的 SQL SELECT 查询语句。 在定义报表时，选择报表类型“单个查询” ，然后输入要执行的 SQL 查询语句即可。 报表定义界面如下图所示：报表运行界面如下图所示：您可以将报表运行结果导出为 excel 文件。5.2.1 示例查询语句示例查询语句各项目的流程复杂程度各项目的流程复杂程度 select p.ProjectID as 项目 ID,p.N

11、ame as 项目名称,count(s.ProblemStateID) as 状态节点数 FROM Pts_ProblemState s join Pts_Projects p on s.ProjectID = p.ProjectID GROUP BY p.ProjectID,p.NameORDER BY 状态节点数 desc,项目名称各项目事务的平均关闭时间各项目事务的平均关闭时间 select ProjectID,ProjectName,AVG(Datediff(mi,CreateTime,CloseTime ) as 关闭时间(分钟) FROM v_Pts_Problems where

12、IsClosed=1 AND CloseTime is not null GROUP BY ProjectID,ProjectName5.3 多个查询（支持参数）多个查询（支持参数）本报表类型可以实现在同一报表中输出多个相关 SQL 查询语句的结果，并且可以实现在运 行时输入参数。“多个查询”的报表定义界面如下图所示：点击“增加查询”按钮，可以增加一个新的 SQL 查询。如下图所示：查询结果的类型分为两种：单值和表。SQL 语句中，用参数名称替换需要在运行时输入的 值。如下图所示：注意，对于非数字类型的参数，可能需要用单引号将参数名称扩起来并使用类型转换函数 才能避免在 SQL 语句执行过程中

13、出错。上述定义的报表，运行时的样子如下图所示：可以将此结果导出成 Excel 表格。5.4 RDL 报表报表RDL 报表可以加载并显示 SQL Server 报表服务中的报表。SQL Server 报表服务是一个完整的 基于服务器的平台，它可以建立、管理、发布传统的基于纸张的报表或者交互的、基于 Web 的报表。 您需要首先通过 SQL Server 报表工具在报表服务中创建好报表，然后再通过 URTracker 引 用该报表。 RDL 报表的定义界面如下图所示：关于如何在 SQL Server 报表服务中定义报表，请参考 SQL Server 的相关文档或教程。6 其他报表操作其他报表操作6

14、.1 编辑报表编辑报表点击报表后的编辑按钮，即可打开编辑此报表的页面。您也可以先选中要编辑的报表，然后在右侧报表信息区域中点击“编辑报表”链接。如下 图所示：6.2 预览报表预览报表点击报表名称后的预览按钮，或者选中要预览的报表，在右侧“报表信息”区域中点击 “运行报表”链接即可。6.3 删除报表删除报表从左侧目录树种选中要删除的报表，然后点击“报表信息”区域中的“删除报表”按钮即 可。6.4 调整报表在目录中的现实顺序调整报表在目录中的现实顺序从左侧目录树中选择要操作的报表，然后点击右侧“调整顺序”区域中的“向上移动”或 “向下移动”按钮即可。6.5 将报表移动到其他目录将报表移动到其他目录

15、选中要移动的报表，在右侧“目标目录”中，选择要移动到的目录，点击“移动到目标目 录下”按钮即可。7 报表查询常用表结构说明报表查询常用表结构说明7.1 用户表用户表 Accounts_Users主要列说明列名列名说明说明UserID用户 IDEmailAddressEmail 地址DisplayName姓名UserState账号状态。1=未审核，2=普通，3=受限，4=禁用LoginName登录账号7.2 字段定义表字段定义表通过此表可以查询自定义字段在数据库中所对应的列。列名列名说明说明ProjectID所属项目 IDFieldName对应的 Pts_Problems 表中的列名Label字

16、段标题FieldType字段类型InUse对系统字段而言，该系统字段是否使用。7.3 事务表视图事务表视图 v_Pts_Problems事务表 Pts_Problems 存储了系统中所有事务的字段信息。视图 v_Pts_Problems 用来访问该 表中的信息以及一些相关联的字段值。列名列名说明说明ProblemID事务 IDProblemCode事务编码ProjectID事务所属项目 IDProjectName所属项目名称ProblemTypeID事务“类型”字段的值（引用Pts_ProblemType 表）ProblemTypeNameProblemCatalogID事务“模块”字段的值（引用Pts_ProblemCatalogs 表）ProblemCatalogName事务“模块”字段值的显示名ProblemStateID事务状态值的 IDProblemStateName事务状态值的显示名称ProblemSeverityID事务严重级值的 IDProblemSeverityName事务严重级值的显示名称ProblemPriorityID事务优先级