基于nc元数据及语义脚本的简单报表开发-v2.doc

NC供应链基于NC数据字典及语义脚本的报表开发关键词：报表，语义脚本，NC数据字典1. 目标通过本文介绍，能够让开发者，实施，或者二次开发人员基于NC数据字典或者语义脚本做出用户需求报表。2. 操作指南本文分别介绍基于NC数据字典和基于语义脚本的报表开发。2.1. 基于NC元数据（数据字典）的报表开发2.1.1. 创建语义模型在“开发平台-报表平台-语义模型”节点，可以创建基于全局，集团或者组织的语义模型。本文以创建集团级的语义模型为例，介绍一下语义模型的创建于设计。新增一个语义模型：如下图所示，设计语义模型的时候，选择NC元数据，之后可以在左侧列表中选择需要的元数据，也可以根据需要在右侧勾选某些表的某些字段。本文示例中选择采购订单和采购发票的实体，用以统计订单的开票数量。选择好采购发票和采购订单的相关字段后，显示效果如下： 我们需要在“连接条件”选项里，把采购订单和采购发票的实体关联起来，做为查询的拼接条件。基于nc元数据时，如果同时拖拽主子表，设计器会默认把主子表做关联带出连接条件。 “选择字段”选项里，我们可以根据需要添加/删除字段，这些字段用于后续的界面显示或者排序，或者聚合，或者其他用途等。需要的时候我们可以在这里通过公式进行一些数据项的加减乘除等。 另外注意一点，显示字段的“关联”属性，如果是参照，默认会带出参照的类型，如果物料，业务单元等（只是基于元数据的情况下会带出）。后者用语义脚本做报表的时候，需要在此处手工添加才行。 至此，一个简单的语义模型设计好了，我们可以通过预览功能看一下查询到的数据。如下图所示。 2.1.2. 建立自由表格格式（格式设计）格式设计是自由报表的展现设计，我们可以把语义模型看做数量来源，这里则是负责如何展示这些数据。同样，“开发平台-报表平台-自由报表”节点，我们可以创建基于全局、集团或组织的自由报表格式设计。如图，新建一个自由报表设计： 每个格式设计都需要关联语义模型，可以按下图所示选择之前设计好的语义模型： 注意，对于参照类型的字段，字段下面可以按树形结构展开的，这方便与我们报表内容的展示。比如，查询的时候我们可以只查询出供应商的id，至于供应商的编码，名称，以及其他信息等都可以在树形结构里选择。如下如图所示： 简单的把字段托拽到界面后，预览效果如下图：2.1.3. 发布成报表节点至此，语义模型与格式设计都以及完成，我们下面要做的就是把这些东西发布成一个节点，可以像其他功能节点一样正常使用。报表节点的形式有两种，一种是查询报表，一种是报表（也即订阅报表），订阅报表一般用于定时查询，并将结构通知到消息平台，邮箱等。这里不做过多介绍，可参见报表相关的红皮书。在格式设计节点，可以通过“发布节点”功能新增或追加或删除功能节点，如下图所示： 我们把刚才的报表发布到“采购管理-采购报表”下面，节点号40042020（注意不要与已有节点冲突），节点名称就叫“我的报表-nc元数据”。 同时，我们还需还要发布为菜单； 最后，我们新的报表节点，分配给用户关联的职责，就可以在“采购管理-采购报表”下面看到一个新的节点。2.1.4. 创建节点的查询模版 此时打开新的节点会提示如下信息：这需要我们创建节点的查询模版，这也是后续实现按不同条件查询汇总数据的必要的步骤。 通过“应用管理平台-开发配置工具-模版管理-查询模版初始化”，创建一个新的查询模版，所属功能节点是之前创建的新节点40042020，查询字段的详细说明见下图中描述： 通过“应用管理平台-开发配置工具-系统管理工具-功能节点默认模版设置”，将此查询模版分配给新节点。 此时，再次打开节点，就可以正常查询了：2.2. 基于语义脚本的报表开发基于语义脚本的开发与基于nc元数据的不同点就在语义模型上，其他像查询模版，发布节点等操作相同。所以这里只介绍语义模型的设计。2.2.1. 创建语义模型如图，创建语义模型的时候选择语义脚本： 定义语义脚本的表名（后续查询模版字段的名称要跟此处表名一致），写入查询sql：SELECT po_order.pk_org_v, po_order.dbilldate, po_order.vbillcode, po_order_b.pk_material, po_order_b.cunitid , po_order_b.nnum orderNum, po_invoice_b.nnum invoiceNumFROM po_orderINNER JOIN po_order_bON po_order_b.pk_order=po_order.pk_orderINNER JOIN po_invoice_bON po_invoice_b.pk_order_b=po_order_b.pk_order_bWHERE po_order_b.dr=0AND po_invoice_b.dr=0; 点下一步，可以看到元数据字段，字段中文名称最好明确一下： “连接条件”选项里可以根据需要自行添加需要的过滤条件。在“选择字段”选项里需要手工添加字段： 添加完毕，效果如下： 前面也提到过，基于语义脚本的模型里，字段需要手工关联档案元数据。如下图所示，可以手工关联物料，组织等。至此，一个简单的基于语义脚本的语义模型就建好了。2.2.2. 建立自由报表格式同2.1.2章节操作。2.2.3. 发布报表节点同2.1.