UAP报表二次开发手册.docVIP

UAP报表二次开发手册 v.871 1. 数据源定义 报表数据源可分为实体关系查询，SQL脚本查询和自定义查询三个类型，如下图所示： 图1.1 其中数据源名称和数据源描述是为了标识数据源以及说明数据源的功能。 1.1查看或修改现有数据源 “查看或修改现有数据源”是指对原先已经创建的数据源进行修改（系统预置的数据源不允许修改），或者可以在新建报表时选择已存在的数据源，如下图： 图1.2 选“下一步”： 图1.3 则列所有已存在的数据源，选择其中一个，按“下一步”： 图1.4 功能列表是数据引擎内部使用机制，直接选“下一步”： 图1.5 这个是设置报表数据源的最后一个步骤，由于选定的数据源为自定义查询类型，所以第一个页签为自定义查询组件的相关信息（关于自定义查询组件的具体情况，请查阅本手册1.3单元）；第二个页签如下图： 图1.6 查询结果列是指该数据查询结果的具体情况，包括列名称，列的数据类型，列的区域语言描述。这些信息将构成报表格式设计时的数据源信息（关于这部分内容的详细情况请参阅UAP报表设计时帮助文档）。 另一个页签为“过滤条件设置”，如下图： 图1.7 具体包括过滤条件名称，过滤条件的区域语言描述，这个将在过滤条件的数据源下拉列表中出现，这些信息将用来设置从过滤控件读去用户输入条件值来对查询的结果进行过滤（具体情况清参阅本手册2.2单元）。 之后，选择“完成”即结束数据源定义而进入报表格式定义。 1.2实体关系查询 在图1.1步骤中选定“实体关系查询”，点击“下一步”则进入实体关系查询类型的数据源定义： 图1.8 这里必须要添加至少一个关联实体，点击“添加”，则可选择系统已经定义好的实体： 图1.9 选定实体，然后点击“确定”： 图1.10 点击“下一步”（如果选择了多个实体，则还需要定义实体之间的关系。关于如何定义一个实体以及如何定义实体之间的关系，请参阅数据引擎的相关文档）： 图1.11 接着必须添加结果列，即图1.6中的“查询结果列”。点击“添加”： 图1.12 这里弹出的列表为选定的单个实体或多个实体能查询到的所有的结果列的信息。选定需要的查询结果列后，点击“确定”： 图1.13 这个步骤中，“行数据权限”可以用来限制用户查询某些具体行数据的权限（行数据权限的设置以及其他高级功能的使用方法请查阅数据引擎相关文档）。 1.3 SQL脚本查询 在图1.1步骤中选定“SQL脚本查询”，点击“下一步”则进入SQL脚本查询类型的数据源定义： 图1.14 SQL脚本查询类型又分为SQL脚本和存储过程两个类别，可通过第一个页签的左上端的下拉列表中选择相应的类别（具体如何定义两种类别请查阅数据引擎相关文档）。其他三个页签中，“查询结果列”和“过滤条件设置”已经在前面的单元中说明，此处不在详述。其中，这种数据源类型有一个“查询参数设置”页签，如下图： 图1.15 如果脚本类型中选择的是“存储过程”，则此处可以使用“刷新”按钮来获取存储过程所需要的参数；而SQL脚本类型则需要手动填写参数的信息。需要注意的是，参数的名称必须与存储过程或SQL脚本的名称完全一致。运行时查询参数的具体值来源是通过过滤条件获得的，因此查询参数需要和过滤条件绑定在一起（绑定方法请参阅本手册2.2单元）。 1.4 自定义查询 自定义查询是指提供一个COM组件（通常为VB6.0组件）或.NET组件（通常为C#组件）来提供获取数据的方法（SQL脚本，存储过程或数据库临时表）。关于自定义查询组件的建立方法请参阅本手册3.2单元。 在图1.1步骤中选定“自定义查询”，点击“下一步”则进入自定义查询类型的数据源定义： 图1.16 其中数据服务信息指的是自定义组件的相关信息，关于自定义查询组件的建立方法请参阅本手册3.2单元。 2. 报表过滤条件 2.1 过滤条件设计 除了UAP本身单独提供了过滤条件的设计工具，报表本身也提供了专门为报表设计过滤条件的快捷方式。以下是报表设计过滤条件的入口： 图 2.1 图 2.2 点击“标准条件”进入过滤条件设计器： 图 2.3 界面说明： 是否支持高级条件：选此项后，在运行时过滤窗口中会出现“高级条件”页签，用于用户自由选择过滤条件的组合。 规则组件：此项定义由过滤控件回调的规则组件类。 是否取消二次开发：此复选项只有在以“U870”项目进入UAP时才会显示，如果被选中，那么以其它项目进入UAP的过滤设计器不能新增和删除过滤条件。 此处可新增或修改一个过滤条件。双击某个已存在的过滤条件，则进入这个条件的修改界面： 图 2.4 界面说明： 语种：设置过滤条件项显示的语种。 中文简体名称：过滤条件项的键值，唯一标识此过滤条件项，不能重复。可以以字母、数字或汉字来命名。 标题：在运行时过滤窗口中显示的文字，支持多语种设置。 编辑类型：过