用友NC报表开发教程全（最全）.pdf

用友用友 NCNC 报表教程（全）报表教程（全）5X&6X5X&6X用友 NC-UAP3/22/2021可修编-目目录录第一章前言第一章前言 1 11.背景 12.入门 23.小结 8第二章对象管理第二章对象管理 8 81.对象树 81.1对象编辑91.2对象导入导出102.数据源 113.首选项 134.资源权限 15第三章查询模型第三章查询模型 15151.参数控制 162.SQL 设计 182.1数据字典182.2向导设计192.3手工设计253.数据交叉 263.1投影交叉283.2旋转交叉314.代码嵌入 364.1SQL整理364.2数据加工384.3穿透规则425.查询执行 48可修编-6.查询集成 506.1复合查询506.2物化查询516.3合并查询537.数据权限 53第四章格式模型第四章格式模型 54541.引用查询 552.格式设计 562.1控件管理562.2属性绑定632.3行列格式设计652.4预定义数据处理683.报表浏览 753.1界面初始化753.2数据处理773.3控件连动813.4报表打印82第五章报表发布第五章报表发布 85851.发布为功能节点 851.1 手动挂接851.2 向导发布862.轻量化报表展现 88第六章插件开发第六章插件开发 92921生成插件 922设计插件 993管理插件 994开发小结 100可修编-第七章查询引擎第七章查询引擎 V5V5 新特性新特性 1011011.V5.0 新特性 1012.V5.01 功能变更清单 1013.V5.011 功能变更清单 1014.V5.02 新增功能描述 1024.1参数重构1024.2分页技术1064.3SQL代码辅助器1094.4数据字典级别权限控制 1105.V5.02 功能变更清单 1136.V5.5 功能变更清单 114附录附录 1151151.查询引擎 FAQ 之参数篇 1152.交叉表的使用样例 1173.查询与格式对象安装盘预置方案 1234.查询引擎报表联查业务节点应用方案 1235.查询引擎与三大模板集成方案 1296.基于 QE 底层的查询个性化设计方案 1377.个性化控制类（JAVADOC）142可修编-第一章第一章 前前言言查询引擎（Query Engine，简称 QE）的功能定位是，一个面向高级实施人员和专业开发人员的查询建模产品，可以全面支持复杂查询的设计和个性化的报表展现。

1. 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. 2.入门入门现在让我们来看一个最基本的查询样例，作为入门，我们知道在任何 ERP 系统中都存在公司和用户的概念，下面我们做一个查询某公司下用户的查询1.进入客户化自定义查询查询引擎管理界面图 一 12.在“查询设计”树下新建一个目录， “jl 测试用例” ，并在这个目录下面创建一个查询对象用户查询可修编-图 一 23.选择参数定义，这里我们定义一个名为 corp,显示名为“公司”的参数，注意这里的数据类型选择编码参照， 枚举项中选择这个编码参照的类型， 我们将根据这个参数选取的值来确定待选公司，并且在查询中根据这个参数选取的值来进行结果筛选图 一 34.制作查询定义，制作一个查询定义的具体流程实际上就是为了生成一条 SQL 语句，查询数据源去获取数据，但是这个生成 SQL 语句的过程被我们用图形化界面代替了，用户只需要了解基本的 SQL 规则就可以了，无需亲自手动去写纷繁复杂的 SQL 语句，同可修编-时我们也支持手工 SQL。

图 一 4用户可以通过增加表来增加数据字典中的数据表， 也可以点击临时表引用前面做好的查询定义对象， 引用查询定义对象相当于设计了一个复合查询， 关于复合查询的定义参见第二章第六节查询集成这里我们选择增加表来增加一个sm_user 表，这表里面存储的是NC 系统的用户信息图 一 5在选择字段页签下选择“用户名”等字段，这里的字段表达式可以是某表的字段， 也可以是字段的运算或者函数处理表达式，例如： len(sm_user.user_name)，就是代表user_name 这个字段的字符串长度显示名可以是用户自定义的字符串，将来显示在报表的列表头区域可修编-图 一 6前面我们提到这个查询必须按照公司为条件，过滤查询出来的用户，实际上就是为 SQL 语句生成一个 where 条件，我们支持两种条件，固定和待定， 顾名思义固定条件写好之后就不能变化，而待定条件是跟参数设置相关的， 可以根据用户输入参数变化 我们在这里选取待定条件， 用户表的公司编码字段等于前面我们设置过的corp 关于查询定义的设计后面的章节将有更详细的论述，这里只介绍最基本的功能5.制作格式设计可修编-图 一 7新建格式设计文件夹以及对象的方式与新建查询对象的方法一样， 这里略去不讲。

生成新的格式设计对象之后可点菜单中的界面模型引用查询， 来绑定我们刚才做好的查询设计对象“用户查询”图 一 8选取刚才做好的查询之后我们在点击界面模型格式设计， 这里可以选取我们预置的几种界面模型之一，例如这表我们选取表头+表体格式图 一 9最后点菜单中的浏览，让我们浏览一下制作出的第一报表，可修编-图 一 10点浏览之后我们会看到一个选择参数的对话框， 在这个参数对话框中我们可以设置自己的参数值，比如我们选取 sunny_corp 这个公司，点确定，则可以浏览这个公司下的所有用户，如下图图一 11选择表头区域的公司参照， 我们可以浏览不同公司下的用户 至此一个最简单的自定义查询已经制作完毕，我们可以将做好的查询作为独立节点发布到NC 系统下供用户使用可修编-3. 3.小结小结在本章中我们介绍了查询引擎的发展历史以及产品的需求背景， 通过一个入门样例， 让用户初步了解了查询引擎的基本功能， 在后面的章节中我们将详细介绍查询引擎的各项功能， 并通过一些样例使得用户能够使用本产品进行快速便捷的二次开发下图是对查询引擎开发流程的一个示意：图 一 12 查询建模体系第二章第二章 对对象管理象管理1. 1.对象树对象树查询引擎的管理调度功能由主界面完成， 主界面左侧为一棵对象树， 树上挂有代表查询对象和界面对象的节点，右侧为显示当前选中对象基本属性的属性框。

可修编-图 二 1 管理调度主界面 对象树（ObjectTree） ：对象树是一个支持层次管理的数据结构，它维护自身的加载、存储和节点的目录管理，每个节点的信息主体存储在数据库的一个BLOB 字段中对象树上的节点通常分为目录（Folder）和对象两类，并支持快速定位（在树获得焦点时用ctrl-f 快捷键可弹出查找对话框，支持按编码或名称来模糊查找） 属性框（ObjectInspector） ：一个自动显示对象的属性和取值的控件，取值部分会根据属性的数据类型采用不同的渲染器来展示，不同的编辑器来编辑1.1 对象编辑目录的编辑操作如下：（1）增加/删除/修改： 在根节点或目录节点之下可以增加目录， 删除目录时会删除目录下的所有对象目录的可修改属性为目录名称同一目录下的目录和对象不能重名2）复制/剪切/粘贴： 在查询子树或格式子树下， 可以将一个目录及其下属容从某位置拷贝或移动到另一个位置对象分为查询对象和格式对象，其编辑操作如下：（1）增加/删除/修改： 在根节点或目录节点之下可以增加查询对象或者界面对象 前者的属性为编码、名称和数据源，后者的属性为编码和名称，其中编码一经使用，就不可修编-再建议作任何修改，因为此编码可能被其它对象引用。

请注意对象的唯一标识是编码而不是显示名称，一个查询对象或是格式设计对象可以有多个显示名称但是只能有唯一的编码2）复制/剪切/粘贴： 在查询或格式子树下， 可以将一个对象从某位置拷贝或移动到另一个位置请注意这里的复制粘贴都是在同一棵树下的，如果复制格式设计对象到查询对象树下则会出错1.2 对象导入导出（1）导出：选中某个对象，可将其导出为XML 文件，文件里描述了对象的所有信息；也可选中某个目录，将该目录下所有的子目录和对象都导出到指定位置（保持原有的目录级次） 2）导入：在选中某个目录之后，导入功能可用导出的XML 文件，可以导入到当前目录下此功能可用于对象的跨数据库复制导入时，我们可以选择单个文件，也可以选择一组文件或目录，导入后会保留原目录的级次结构需要注意的是：在导出查询对象或界面对象时，需将其引用的查询对象一并导出才有意义；导入不能违反对象主键及名称的唯一性约束 下图显示了某查询对象所导出的XML 文件图 二 2 导出 XML 文件（3）在导入导出的过程中需要注意的一个问题是数据源的问题，在实际应用中经常出现这样的场景：实施人员在自己的环境（数据源为 home）下做了一对查询模型设计和格式设计，然后导出这一对设计对象为 xml 文件，然后到用户的环境（数据源为customer）下执行导入，发现无法查出数据，并且提示“找不到查询所用数据源” ，可修编-这是因为导出成 XML 文件的时候，记录在 XML 文件中的执行数据源是home，而客户的数据源名称是 customer，与查询模型设计中的数据源不符合，这样查询模型就无法到正确的数据源下去取数，可以在弹出的提示框“是否修改执行数据源为当前数据源” ，选择“是” ，则该查询设。