NCV55元数据建模及管理红皮书分解Word下载.docx
《NCV55元数据建模及管理红皮书分解Word下载.docx》由会员分享，可在线阅读，更多相关《NCV55元数据建模及管理红皮书分解Word下载.docx（26页珍藏版）》请在冰豆网上搜索。
第四章元数据典型应用21
1.基于元数据创建单据模板21
2.在流程平台中使用元数据：
22
3.某个实体作为参照使用：
23
4.元数据查询25
5.基于元数据的数据访问26
6.自定义项如何使用：
28
第一章
前言
本文档主要介绍了如何基于元数据进行业务建模，以及如何在运行时对元数据进行管理。
最后列举了元数据的一些典型应用。
目的是尽可能地让大家在使用元数据的时候更加方便。
关于元数据本身的代码架构，以及元数据的基本概念，请参见《NCV5.5-元数据开发红皮书》。
第二章
基于元数据的业务建模
1.模型设计器
在基于元数据建模之前，我们先来认识一下模型设计器。
NC模型设计器
模型设计器有5个重要的组成部分，如图所示。
1是资源浏览器，2是工具面板，3是画布，4：
属性面板，5：
模型视图。
2.创建组件
在资源浏览器中点右键，可以新建目录或者新建模型文件（见下图）。
模型文件（bmf文件）即对应元数据中的一个组件（IComponent）。
组件描述的是一个相对独立和完整的业务块，主要是从业务层次上进行划分，比如“销售订单”可以作为一个组件，“客商档案”也可以作为一个组件，划分组件时，注意组件间的重用，且注意不要形成相互依赖。
组件属于模块，一个模块可以包含多个组件。
资源浏览器中组件所属的目录和组件的模块没有关系，目录只是为了更好的组织和管理bmf文件。
组件是部署的基本单元，一个典型的组件会包含若干个有相互关系的实体（但只能有一个主实体），以及业务接口、枚举类型等，另外组件里还可以有服务和操作。
点击中间画布空白区域，可以设置组件信息：
1）版本号：
记录组件当前版本，防止旧版本覆盖新版本。
版本号是自动生成的，每点击一次保存，就会增加1。
2）代码风格：
有NC传统样式和标准样式两种，主要针对主子表及多子表结构，传统样式生成AGGVO，标准样式为OO
3）多语言资源模块：
对应以前多语言里的文件夹名，现在按照组件划分
4）是否预加载：
默认false。
如果选择true，而且所用的数据源也配置为预加载元数据（在preload-datasource.properties中配置），那么该组件就会在中间件启动时被预先加载。
5）主实体:
一个组件里如果有实体，则必须设置一个主实体
6）名称：
该组件的名称。
必须全局唯一。
3.创建实体
从工具箱中拖一个实体到中间的画布上。
创建实体的要点：
1）主属性：
实体必须设置主属性（对应数据库表的主键）。
2）访问器：
当组件代码样风格选择传统样式时，针对主子表或者多字表中主表对应的实体，访问器要设置为AggVO,即聚合VO访问器，其他的一律选择NCVO，访问器的作用在于适配模型与java代码的不一致性。
访问器类型有POJO，NCVO，AggVO。
3）包装类名：
如果访问器类型是AggVO，则需要生成一个聚合VO类型的包装类。
4）动态信息修改类：
用于动态修改实体，比如运行时增加或者设置某些属性。
5）可见性：
public，protected，default，private
6）扩展标签：
可以给实体加任意的标签，查询时可根据标签过滤。
7）缺省表名：
生成数据库时对应的表名。
8）业务接口实现类：
如果实体实现了业务接口，这里可以注册实现类。
在“创建接口”小节中，将详细介绍接口实现类的四种情况。
3.1实体的属性
实体可以有若干属性和操作，还可以实现接口，设置参照。
实体中属性的设置要点如下：
1）对于设置为AggVO样式的实体，请检查子表属性（1-n聚合关系），比如上图中的[订单明细]，访问策略要设置为BodyOfAggVOAccessor。
2）类型样式：
目前支持Single、REF、ARRAY、LIST四种，具体可参考《元数据开发红皮书》。
3）类型：
可以自行选择，当建立实体间关系时，也会自动设置；
主键一定要设置为UFID类型。
目前元数据支持如下基本类型：
4）字段名称：
生成数据库表列的名称
5）计算属性：
由其他属性计算得到，本身不需要保存到数据库，不会生成数据库的列。
6）空：
是否可以为空。
7）授权：
用于权限控制。
8）扩展标签：
可以自由的给属性加上标注，比如@uniqueCheck，在程序中便可以通过这个标签来过滤属性。
List<
IAttribute>
nc.md.model.impl.MDBean.getAttributes（Stringtag）
3.2实体的操作
3.3实体和属性的参照设置
1）在实体的模型视图上选择参照页签，点击左上角的“设置参照”，弹出参照选择对话框（参照必须先在bd_refinfo表注册才会在这个对话框中出现）
2）为实体选择对应的参照，可以多选。
点击OK后，选择的参照就会出现在模型视图的参照页签。
此处的参照表示该实体可以通过这些参照被引用，比如人员对应的参照为人员档案和人员管理档案参照，如果某个实体的属性是人员类型，类型样式是参照，则可以将该属性设置成人员档案或人员管理档案参照。
3）必须给实体设置一个缺省参照。
4）为属性设置参照：
类型样式选择REF，类型选择某个实体，在参照名称下拉框中将出现该实体对应的参照，从中选择一个与该属性绑定。
如果没有设置参照名称，则获取属性的参照时，将取实体的缺省参照。
3.4创建自定义实体
从工具箱中拖一个实体到画布上，选中该实体，点右键，选择特性->
自定义档案，则该实体将被创建为自定义实体，其属性也将由系统自动生成。
如下图所示。
4.创建接口
在设计器上，业务接口只能增加属性，相应会生成get方法，比如增加一个name属性，会生成一个getName（）方法，方法的返回值可以自由选择。
实际上，如果希望灵活运用业务接口，你可以摆脱设计器的限制，你在设计器上设计出一个业务接口，生成代码后，可以给业务接口增加任何方法，当然实现类也由你自己实现，此时只是通过元数据来管理你的业务接口而已。
业务接口的实现类可以分为四种情况，优先级从高到低排列如下：
1）实体和特定业务接口连线上的实现类
2）实体上注册的实现类
3）业务接口上注册的实现类
4）系统根据映射关系自动生成的实现类
实体实现了某个接口以后，如果没有在模型中注册接口实现类，则必须设置“业务接口属性映射”。
系统会根据属性映射生成默认的接口实现类，类名的规则是：
接口名去掉开头的I，后面再加上Impl。
业务接口实现类必须有且仅有一个参数为NCObject的构造函数。
业务接口的使用详见元数据开发红皮书。
5.创建枚举
创建一个枚举类型时，要注意以下几点：
1）枚举类型必须设置返回值类型，当前支持Integer和String两种
2）如果是自定义枚举，需要注册自定义枚举值实现类
3）枚举类型不对应java类，枚举类型的fullClassName为其返回类型，即int或者String
4）可以为属性设置类型为枚举类型，如下图所示：
5）通过IAttribute.getDataType（）便可以得到IType,如果为枚举类型，则可转型为IEnumType,通过IEnumType.getEnumValues（）得到枚举类型列表。
6.实体间的关系
目前元数据的关系支持关联、关联引用、1-1聚合、1-多聚合、1-n关联（持久层暂不支持），以及自关联。
暂不支持跨组件的1-1聚合、1-多聚合、1-多关联、继承。
设置关系的注意事项：
1）关系中必须设置源属性。
2）注意：
设置了关系后，属性的类型便会发生变化，但删除关系后，属性的类型不会恢复，务必要检查。
另外，修改过带有关系的属性后，需要重新设置关系（即重新拉线）。
7.元数据发布
元数据发布的最小单元是组件。
选中某个组件，或者在画布中点击右键，即可发布元数据。
注意事项：
1）必须保存后才能发布
2）发布时必须启动NC中间件，因为元数据会发布到数据库中，数据库为默认数据源
3）发布时会一起发布被依赖的组件，支持双向依赖，循环依赖。
4）如果发布元数据时忽略版本，则完全以本地的模型文件为准，可能造成库中新版本的模型被覆盖，非特殊情况不推荐使用。
5）开发环境的发布只是为了开发人员测试需要，提交产品时只需要将bmf文件提交到相应模块的METADATA目录下，安装帐套时会自行发布到数据库中。
导出JAVA代码：
1）可以在组件里设置代码风格，对于主子表结构，V55基本上选择AggVO，这样生成的代码和以前的兼容。
2）必须启动NC中间件。
3）导出java文件前，必须确保最新修改的组件已经被发布。
4）生成的代码都实现了SuperVO。
生成建库脚本：
1）生成建库脚本前，必须确保元数据已经被发布到数据库。
2）建库脚本可以直接在当前数据源所对应的数据库执行。
3）对于聚合关系，不管是1-1还是1-多，均会在子表里生成外键。
注册服务并发布：
1）服务可以在模块间调用，操作只可以在模块内调用
2）服务在设计器里无需建立，直接注册java接口和实现类即可
3）发布服务，可以直接形成upm/usm文件，upm/usm是基于原有module文件优化而来，具体参考中间件培训文档。
第三章
元数据管理
元数据管理工具主要用于在运行时对已发布的元数据进行管理。
它包含以下功能：
1）对元数据信息进行浏览，修改元数据的显示名称、描述信息等可编辑字段；
2）维护枚举类型；
3）元数据的升级；
4）元数据恢复到系统默认状态。
8.元数据信息浏览和修改
元数据管理功能节点在“客户化/二次开发工具/系统管理工具/”下。
界面如下图所示：
左侧面板中是一棵元数据树，树的第一级是模块，选中某个模块，会显示该模块下的所有组件和子模块。
选中某个组件，右侧面板上将显示该组件所有的实体，枚举，值对象，分别显示在不同的页签上（组件中的业务接口目前并没有在此处显示）：
选中某个实体，可以看到该实体的属性，及该实体实现的接口信息：
点击“修改”按钮，可以修改当前页签上的蓝色字段。
9.枚举类型的维护
可以在元数据管理节点增加用户自定义的枚举类型，或者修改已有的枚举类型。
选中组件，可以新增枚举，如下图所示：
选中枚举，点击“枚举”按钮下的子按钮“修改”，即弹出枚举类型维护对话框：
在该对话框上可以对枚举类型的各项信息进行修改。
10.元数据升级：
点击升级按钮，会弹出文件选择对话框，可以选择要升级的bmf文件。
应用场景：
在元数据发布以后，如果对个别组件又进行了修改，此时可以在元数据管理节点对修改过的bmf文件进行升级。
升级时会将该组件及其依赖的组件重新发布。
例外情况是如果组件的版本低于数据库中的版本，则不会重新发布。
11.恢复到系统默认状态：
选中某个组件，点击“系统默认”，将从数据库中删除用户在运行时修改过的内容，恢复到刚发布或者升级后的状态。
第四章
元数据典型应用
12.基于元数据创建单据模板
在单据模板设置界面选择元数据组件：
模板上不再需要定义公式，直接从元数据模型树上拖拉需要显示的业务字段即可。
13.在流程平台中使用元数据
首先单据类型必须支持元数据。
在单据类型管理界面，选择该单据类型所属的元数据组件，如果不选，认为该单据类型不支持元数据。
对于支持元数据的单据类型，在审批流转移条件设置和工作项配置的时候就可以选择元数据。
数据交换管理界面也会以元数据而不是传统单据的样式展现：
14.某个实体作为参照使用
通常情况下需要经过以下几个步骤：
（1）实体必须实现基本档案接口（IBODObject），否则无法正确显示名称和编码。
（2）设置实体的业务接口属性映射。
（3）建一个实现了IRefModel的参照类，并在bd_refinfo表中注册。
（4）为实体设置参照。
在实体的模型视图中选择参照页签，点击“设置参照”，详见3.3节实体和属性的参照设置。
以上只是针对一般情况，对于特殊情况，比如说接口的属性不能直接映射实体的属性，那么就需要开发人员另外去写接口实现类了。
15.自定义项如何使用
如果在单据模板上需要有自定义项，则可以在模型设计器中给实体增加一个属性，将其类型设为“自定义项”。
类型为“自定义项”的属性可以在元数据管理界面修改它的类型和类型样式。
双击自定义项属性的类型编辑框，弹出元数据实体选择框，
16.元数据查询
元数据对外部提供的查询服务主要有两个：
（1）MDBaseQueryFacade：
前后台均可调用，提供元数据基本的一些查询，如查询模块、组件、实体、值对象、属性等。
支持前台缓存功能。
如果开发人员在开发环境需要频繁的修改元数据，则为了避免必须重启JStarter才能使得修改生效，可以在JStarter的启动参数里增加参数，在开发时临时关闭前台缓存功能。
-Dnc.md.detectEachTime=true
（2）MDQueryService：
后台查询，前台请不要调用。
MDQueryService服务为元数据自身查询服务的统一入口，通过此入口类可以请求不同的查询服务。
在后台，如果是一些简单查询，比如通过名称，则优先使用nc.md.MDBaseQueryFacade提供的查询方法。
特别注意：
前台全部使用MDBaseQueryFacade，否则会导致严重后果。
在元数据中，属性的查找都是通过先查找Bean，再调用Bean的相关方法来实现的（bean.getAttributeByID（attributeID））。
17.基于元数据的数据访问
元数据的数据访问，是指在得到了Bean的情况下，要取得属性的值。
元数据取数完全基于模型角度，不用了解数据库结构。
可以支持复杂条件查询，支持批量取数，有效提高数据访问效率。
基于元数据的数据访问主要用到DASFacade及NCObject类。
详见元数据开发红皮书。
升级会员 