NCV5安装盘配置与升级技术红皮书.docx

1、NCV5安装盘配置与升级技术红皮书安装盘配置与升级技术红皮书NC-UAP 5.0用友NC-UAP2018-09-21目 录第一章 安装盘结构及配置文件说明 11. 安装盘结构 12. 产品结构 13. 模块结构 2第二章 安装升级方案相关说明 51. 新建账套 52. 升级账套 53. NC业务产品的安装升级 64. 新建公司账 75. 安装改进： 8第一章 安装盘结构及配置文件说明1. 安装盘结构安装盘包含一个到多个产品，安装盘的目录结构如下图所示：安装盘下面可以放一个到多个产品，表现形式上为一个目录。目录的名称必须为产品的模块标识名称，如客户化为uap，2. 产品结构 一个产品包含一个到多

2、个模块。产品的目录结构为下图所示：对于一个产品来说，其配置文件（setup.ini）中的内容为code=10 产品编码name=客户化 产品名称version=5.0 产品版本号disk.type=new 是否是全新安装，new为全新安装，patch为补丁安装previous.generation.code=10 自身依赖的前一个版本号required.related.module= 依赖的其他产品3. 模块结构模块下面包含着该模块相关的多个jar包， 运行安装程序，将解压模块下的所有jar包到指定的nchome目录下，形成ncv5的目录结构（如下图所示）。所以在压缩jar包时需要安装该目录结

3、构进行压缩。配置文件setup.ini中配置着该模块的相关信息。 code * 该模块的编码 name * 该模块的名称 version * 该模块的版本号 disk.type * 该模块安装盘的类型， * new 表示全新的安装盘 * patch表示为补丁盘 previous.generation.code *依赖的前一个产品编码，目前主要用于客户化 must.selected * 表示该模块是否必须被选中 * 取值为true/false 或 y/n * 默认为false 或 n preversion * 该模块自身依赖的版本号 required.related.module * 依赖其它的

4、模块 * 表示为code,name, version1, version2,.&code,name, version1, version2,. product.package * 代码和文件包 help.package; * 帮助压缩文件的文件名或目录名 db.create.script; * 数据库建库脚本包 dataupdateclass; /*数据升级程序的类名。如果需要注册多个升级调整程序，可以在 dataupdateclass后面附加序数来指定，例如 dataupdateclass01= classname1 dataupdateclass02=classname2 dataupda

5、teclass03=classname3 bill.templet.script/*单据模板脚本压缩文件的文件名或目录名*/ query.templet.script/*查询模板脚本压缩文件的文件名或目录名*/report.templet.script;/*报表模板脚本压缩文件的文件名或目录名*/ print.templet.script; /*打印模板脚本压缩文件的文件名或目录名*/ sys.templet.script; /*默认模板脚本压缩文件的文件名或目录名*/bill.type.script; /*单据类型脚本压缩文件的文件名或目录名*/ busi.type.script;/*业务类

6、型脚本压缩文件的文件名或目录名*/system.type.script; /*系统类型脚本压缩文件的文件名或目录名*/ subj.class.script; /*科目分类脚本压缩文件的文件名或目录名*/voucher.templet.script; /*凭证模板脚本压缩文件的文件名或目录名*/project.templet.script; /*项目模板脚本压缩文件的文件名或目录名*/business.script; /*产品组内脚本压缩文件的文件名或目录名*/menu.script; /*菜单脚本压缩文件的文件名或目录名*/ml.script; /*多语言脚本*/ddc.initdata; /

7、*数据字典初始化数据*/ hasdynamictempletdata; /* 是否有动态摸板数据*/ need_deploy_ejb; /* 是否需要重新部署ejb*/containproductcode; /*包含的产品编码*/“resourceupdateclass”/* 产品代码复制时的代码调整注册类*/详细也可参考ConfigKey接口里的说明。 第二章 安装升级方案相关说明1. 新建账套步骤：1. 运行客户化安装盘的安装程序，把代码安装到指定目录作为系统运行环境。2. 进入新建帐套界面录入帐套信息再新建账套。3. 判定是否可以安装。4. 利用./ncscript/目录下的建库脚本来建

8、库表。5. 利用./ncscript/init_data/目录下指定安装语种的初始化数据脚本安装库表数据。6. 利用./ierp/bin/InitAccount.dat配置文件中注册的初始化数据接口nc.bs.pub.IInitData的initAccountData方法依次初始化数据。7. 保存客户化版本信息和账套信息。接口描述：nc.bs.pub.IInitData：initAccountData(String dataSourceName)表示建帐时初始化数据，在新建账套时使用；initCorpData(String pkCorp)表示初始化公司数据，在新建账套时没有作用，在建公司账时会

9、使用该接口方法。接口注册在./ierp/bin/InitAccount.dat文件中，目前只有nc.bs.sm.cmenu.CustomMenuBO；格式如下：total=11=nc.bs.sm.cmenu.CustomMenuBO, 插入图片备注：对于需要进行分语种安装的数据脚本，在制作安装盘时就需要将这些脚本分语种目录放置，在新建账套或账套升级时，会根据账套的默认语种选择安装。2. 升级账套步骤：1. 运行客户化安装盘的安装程序，把代码安装到系统运行环境目录下，便完成客户化的代码升级。2. 进入帐套管理界面升级账套。3. 对数据库物理布局进行校验，判定是否可以升级。4. 处理3.1以前版本

10、的帐套默认语种问题，将其语种名称改为语种编码。5. 利用./au/accountupdate.ini文件中注册的升级接口nc.bs.sm.config.IUpdateAccount的方法doBeforeUpdateDB依次在数据库表结构升级前执行某些处理。6. 利用./ncscript/目录下的建库脚本来升级库表。7. 利用./au/accountupdate.ini文件中注册的升级接口nc.bs.sm.config.IUpdateAccount的方法doBeforeUpdateData依次在数据库初始化数据升级前执行某些处理。8. 进行数据字典的升级。9. 删除客户化模板中的数据和更新实时凭

11、证数据，以及删除单据模板数据。10. 利用./ncscript/init_data/目录下指定安装语种的初始化数据脚本升级库表数据。11. 其他的数据调整。12. 利用./au/accountupdate.ini文件中注册的升级接口nc.bs.sm.config.IUpdateAccount的方法doEndUpdateAccount依次在数据库初始化数据升级级后执行某些处理。13. 保存客户化版本信息。接口描述：nc.bs.sm.config.IUpdateAccount：doBeforeUpdateDB(String dsName, String khhOldVersion , String

12、 khhNewVersion)表示在数据库表结构升级前执行某些处理；doBeforeUpdateData(String dsName, String khhOldVersion, String khhNewVersion)表示在数据库初始化数据升级前执行某些处理；doEndUpdateAccount(String dsName, String khhOldVersion, String khhNewVersion)表示在数据库初始化数据升级后执行某些处理。接口注册在./au/accountupdate.ini文件中，目前内容如下：nc.bs.pf.install.ConvertFileInfo

13、BOnc.bs.bd.service.BDUpdata300sp2To310nc.bs.pub.cquery.UptoDDCBOnc.bs.fipf.pub.AccountPFUpgradeBOnc.bs.pf.update.IsWriteUpdatenc.bs.sm.config.AdjustGroupFlagnc.bs.sm.grouppower.PowerUpgrade4OrgBook3. NC业务产品的安装升级业务产品的安装不区分新安装和升级安装，即只有一套安装盘。1 安装步骤A 运行客户化安装盘的安装程序，将其解压到指定的临时目录。B 登录系统，在“产品安装”节点中进行产品的升级安装

14、2 升级步骤A 从指定的临时目录中复制代码到应用服务器进行代码的安装升级。B 对数据库物理布局进行校验，判定是否可以安装升级。C 利用临时目录中的ncscript/目录下的建库脚本来安装升级库表。D 进行数据字典的升级E 删除安装产品模板中的数据和更新实时凭证数据，以及删除单据模板数据。F 从临时目录中读出sql脚本进行初始化数据的安装升级，在执行这些sql脚本前会根据当前数据库中的数据调整sql语句，即对有主键冲突的sql脚本自动转换为update语句，然后进行数据升级。G 分语种安装的初始化数据，这也是根据正在升级的账套的默认语种选择对应的脚本进行升级。H 执行代码升级程序，凡是需要在最后

15、对数据进行一些处理的，都可以实现nc.bs.sm.install.IUpdateData的updateData方法。实现类注册在安装盘的配置文件中的dataupdateclass项I 处理已建帐公司的初始化数据。（有必要进行优化，见“安装改进”）J 对安装产品的单据模板和查询模板数据进行调整,对报表模板数据进行调整。（现在每次安装都执行，势必影响效率，是否要优化？）K 删除安装源文件接口描述：nc.bs.sm.install.IUpdateData：updateData(String khhOldVersion , String khhNewVersion)表示产品安装升级后的相关数据升级。

16、该接口注册在安装盘的配置文件中的dataupdateclass项。4. 新建公司账步骤：1. 根据选中模块读取./ierp/bin/InitCorp/目录中的dat文件中的初始化数据接口nc.bs.pub.IInitData和建帐接口nc.bs.sm.createcorp.ICreatecorpAccount。2. 判断选中模块的初始化前提。3. 先执行ICreatecorpAccount的方法beforeCreatecorpAccount，再执行IInitData的方法initCorpData，再执行ICreatecorpAccount的方法afterCreatecorpAccount。4.

17、 保存公司启用的功能模块。5. 为结算类公司建立一个结算单位。6. 更改公司目录的建帐标志。接口描述：nc.bs.pub.IInitData：initAccountData(String dataSourceName)在建公司账时不使用；initCorpData(String pkCorp)表示初始化公司数据，在建公司账时会使用该接口方法。nc.bs.sm.createcorp.ICreatecorpAccount：String beforeCreatecorpAccount (String pkCorp)初始化公司数据之前的检查等操作，返回非null表示错误信息，不再执行后续操作，返回nul

18、l表示可以执行初始化数据；String afterCreatecorpAccount(String pkCorp)初始化公司数据之后的检查等操作，返回非null表示错误信息，不再执行后续操作，返回null表示可以执行初始化数据。这两个接口都注册在./ierp/bin/InitCorp/目录的相应模块文件中，目前客户化10模块的格式如下：total=51=nc.bs.pf.pub.PfDataCopy1BO,客户化-参数设置初始化数据2=nc.bs.pf.pub.PfDataCopy2BO,客户化-凭证模板初始化数据 3=nc.bs.pf.pub.PfDataCopy3BO,客户化-项目单据模板初始化数据 4=nc.bs.pf.pub.PfDataCopyBO,客户化-流程平台初始化数据5=nc.bs.gl.initdata.GlInitDataBO,客户化-总账初始化数据5. 安装改进对于业务产品的安装升级，不再执行PfDataCopy，而在建公司账时根据注册自动执行。