.用友NC报表教程（全）5X&6X用友NC-UAP2022-04-25目录第一章前言 (1)1.背景 (1)2.入门 (2)3.小结 (8)第二章对象管理 (9)1.对象树 (9)1.1对象编辑 (10)1.2对象导入导出 (10)2.数据源 (11)3.首选项 (14)4.资源权限 (15)第三章查询模型 (16)1.参数控制 (17)2.SQL设计 (19)2.1数据字典 (19)2.2向导设计 (20)2.3手工设计 (25)3.数据交叉 (27)3.1投影交叉 (28)3.2旋转交叉 (31)4.代码嵌入 (37)4.1SQL整理 (37)4.2数据加工 (39)4.3穿透规则 (43)5.查询执行 (49)6.查询集成 (51)6.1复合查询 (51)6.2物化查询 (52)6.3合并查询 (54)7.数据权限 (54)第四章格式模型 (56)1.引用查询 (57)2.格式设计 (58)2.1控件管理 (58)2.2属性绑定 (66)2.3行列格式设计 (68)2.4预定义数据处理 (71)3.报表浏览 (78)3.1界面初始化 (78)3.2数据处理 (80)3.3控件连动 (84)3.4报表打印 (85)第五章报表发布 (88)1.发布为功能节点 (88)1.1 手动挂接 (88)1.2 向导发布 (89)2.轻量化报表展现 (91)第六章插件开发 (96)1．生成插件 (96)2．设计插件 (102)3．管理插件 (102)4．开发小结 (103)第七章查询引擎V5新特性 (104)1.V5.0新特性 (104)2.V5.01功能变更清单 (104)3.V5.011功能变更清单 (104)4.V5.02新增功能描述 (105)4.1参数重构 (105)4.2分页技术 (109)4.3SQL代码辅助器 (112)4.4数据字典级别权限控制 (113)5.V5.02功能变更清单 (116)6.V5.5功能变更清单 (117)附录 (119)1.查询引擎FAQ之参数篇 (119)2.交叉表的使用样例 (121)3.查询与格式对象安装盘预置方案 (126)4.查询引擎报表联查业务节点应用方案 (127)5.查询引擎与三大模板集成方案 (132)6.基于QE底层的查询个性化设计方案 (140)7.个性化控制类（JAVADOC） (145)第一章前言查询引擎（Query Engine，简称QE）的功能定位是，一个面向高级实施人员和专业开发人员的查询建模产品，可以全面支持复杂查询的设计和个性化的报表展现。
1. 背景查询引擎在功能流程和查询模型方面参考了其前身产品“自定义查询”的理念，在界面设计方面汲取了Form Design的思路，同时融入了DW的技术，并依赖于通用的NC数据字典。
（1）自定义查询：NC于2000年开始研发的一个面向中级实施人员和二次开发人员的查询报表工具，由查询管理中心、报表格式设计、报表浏览、报表权限控制和数据加工厂几个模块构成，此工具首次提出了基于数据字典来管理数据并建立查询对象的思路，能够提供比较丰富的查询分析、数据加工和报表展现功能。
（2）Form Design：NC于2003年开始研发的一种界面开发模式，定位于支持功能建模。
（3）数据字典：一种管理数据库逻辑结构的机制，存在于物理数据库和用户接口之间。
NC于2002年开始研发数据字典，最开始只用于自定义查询，后来经过功能强化和逐步推广，成为现在的DDC（Data Dictionary Control）。
其功能包括数据库对象的管理与编辑、数据字典的解析生成等。
（4）数据仓库：NC的一个独立产品，能够按照指定的入仓规则从多个业务数据库抽取数据，并通过入仓服务定期把数据加载到数据仓库。
产品的需求背景如下所述。
（1）复杂查询报表的需求：在实际的业务查询中，开发人员经常会遇到以下一些棘手的问题——复杂的SQL，从不同的查询条件得到完全不同的查询结果，查询结果的复合，业务逻辑代码和大量数据加工算法的介入，各种各样的数据交叉和数据处理手段等等；在展现格式方面，通常要求灵活、友好、可视化、个性化的设计界面，丰富的展现控件和统计图表，依据数据对单元格、列表头和行表头的格式进行设置，表单控件之间的连动等等。
这一切都对早期的查询报表工具提出了艰巨的要求。
（2）二次开发的需求：随着NC对行业用户的拓展，由业务组程序员在通用软件中针对每个查询报表需求进行开发的方案已经变得不太现实，一线人员越来越频繁的面临来自用户的个性化报表实施压力。
实施团队迫切要求一个强大而且易用的二次开发工具，尽管功能的强大和易用往往存在着一些矛盾。
（3）工具整合的需求：自定义查询在推出后，在实施中得到了一定的应用，但局限于出复杂程度不太高的查询报表。
IUFO是公司的传统报表产品，它更偏重于报表的管理方面，比如报表的发布、审核、校验等等。
数据仓库使查询的应用由单数据源拓展到了多数据源，并且提供定时同步业务数据的功能。
为了有效地实现资源共享，结合发挥各个工具的优势，NC决策层一直在推动相关产品的整合。
（4）查询分析软件发展潮流的需求：近几年来，查询分析、数据挖掘、商业智能的研究不论在企业应用还是在学术领域都成为热点，ERP软件的数据建模和查询建模功能已经成为代表产品水平的重要指标。
2. 入门现在让我们来看一个最基本的查询样例，作为入门，我们知道在任何ERP系统中都存在公司和用户的概念，下面我们做一个查询某公司下用户的查询。
1.进入客户化→自定义查询→查询引擎管理界面图一-12.在“查询设计”树下新建一个目录，“jl测试用例”，并在这个目录下面创建一个查询对象――用户查询。
图一-23.选择参数定义，这里我们定义一个名为corp,显示名为“公司”的参数，注意这里的数据类型选择编码参照，枚举项中选择这个编码参照的类型，我们将根据这个参数选取的值来确定待选公司，并且在查询中根据这个参数选取的值来进行结果筛选。
图一-34.制作查询定义，制作一个查询定义的具体流程实际上就是为了生成一条SQL语句，查询数据源去获取数据，但是这个生成SQL语句的过程被我们用图形化界面代替了，用户只需要了解基本的SQL规则就可以了，无需亲自手动去写纷繁复杂的SQL语句，同时我们也支持手工SQL。
图一-4用户可以通过增加表来增加数据字典中的数据表，也可以点击临时表引用前面做好的查询定义对象，引用查询定义对象相当于设计了一个复合查询，关于复合查询的定义参见第二章第六节查询集成。
这里我们选择增加表来增加一个sm_user表，这张表里面存储的是NC系统的用户信息。
图一-5在选择字段页签下选择“用户名”等字段，这里的字段表达式可以是某表的字段，也可以是字段的运算或者函数处理表达式，例如：len(sm_er_name)，就是代表user_name这个字段的字符串长度。
显示名可以是用户自定义的字符串，将来显示在报表的列表头区域。
图一-6前面我们提到这个查询必须按照公司为条件，过滤查询出来的用户，实际上就是为SQL语句生成一个where条件，我们支持两种条件，固定和待定，顾名思义固定条件写好之后就不能变化，而待定条件是跟参数设置相关的，可以根据用户输入参数变化。
我们在这里选取待定条件，用户表的公司编码字段等于前面我们设置过的corp。
关于查询定义的设计后面的章节将有更详细的论述，这里只介绍最基本的功能。
5.制作格式设计图一-7新建格式设计文件夹以及对象的方式与新建查询对象的方法一样，这里略去不讲。
生成新的格式设计对象之后可点菜单中的界面模型→引用查询，来绑定我们刚才做好的查询设计对象“用户查询”。
图一-8选取刚才做好的查询之后我们在点击界面模型→格式设计，这里可以选取我们预置的几种界面模型之一，例如这张表我们选取表头+表体格式。
图一-9最后点菜单中的浏览，让我们浏览一下制作出的第一张报表，图一-10点浏览之后我们会看到一个选择参数的对话框，在这个参数对话框中我们可以设置自己的参数值，比如我们选取sunny_corp这个公司，点确定，则可以浏览这个公司下的所有用户，如下图。
图一-11选择表头区域的公司参照，我们可以浏览不同公司下的用户。
至此一个最简单的自定义查询已经制作完毕，我们可以将做好的查询作为独立节点发布到NC系统下供用户使用。
3. 小结在本章中我们介绍了查询引擎的发展历史以及产品的需求背景，通过一个入门样例，让用户初步了解了查询引擎的基本功能，在后面的章节中我们将详细介绍查询引擎的各项功能，并通过一些样例使得用户能够使用本产品进行快速便捷的二次开发。
下图是对查询引擎开发流程的一个示意：图一-12 查询建模体系第二章对象管理1. 对象树查询引擎的管理调度功能由主界面完成，主界面左侧为一棵对象树，树上挂有代表查询对象和界面对象的节点，右侧为显示当前选中对象基本属性的属性框。
图二-1 管理调度主界面· 对象树（ObjectTree）：对象树是一个支持层次管理的数据结构，它维护自身的加载、存储和节点的目录管理，每个节点的信息主体存储在数据库的一个BLOB字段中。
对象树上的节点通常分为目录（Folder）和对象两类，并支持快速定位（在树获得焦点时用ctrl-f 快捷键可弹出查找对话框，支持按编码或名称来模糊查找）。
· 属性框（ObjectInspector）：一个自动显示对象的属性和取值的控件，取值部分会根据属性的数据类型采用不同的渲染器来展示，不同的编辑器来编辑。
1.1对象编辑目录的编辑操作如下：（1）增加/删除/修改：在根节点或目录节点之下可以增加目录，删除目录时会删除目录下的所有对象。
目录的可修改属性为目录名称。
同一目录下的目录和对象不能重名。
（2）复制/剪切/粘贴：在查询子树或格式子树下，可以将一个目录及其下属内容从某位置拷贝或移动到另一个位置。
对象分为查询对象和格式对象，其编辑操作如下：（1）增加/删除/修改：在根节点或目录节点之下可以增加查询对象或者界面对象。
前者的属性为编码、名称和数据源，后者的属性为编码和名称，其中编码一经使用，就不再建议作任何修改，因为此编码可能被其它对象引用。
请注意对象的唯一标识是编码而不是显示名称，一个查询对象或是格式设计对象可以有多个显示名称但是只能有唯一的编码。
（2）复制/剪切/粘贴：在查询或格式子树下，可以将一个对象从某位置拷贝或移动到另一个位置。
请注意这里的复制粘贴都是在同一棵树下的，如果复制格式设计对象到查询对象树下则会出错。
1.2对象导入导出（1）导出：选中某个对象，可将其导出为XML文件，文件里描述了对象的所有信息；也可选中某个目录，将该目录下所有的子目录和对象都导出到指定位置（保持原有的目录级次）。