金蝶eas v82元数据升级指南

《金蝶eas v82元数据升级指南》由会员分享，可在线阅读，更多相关《金蝶eas v82元数据升级指南（29页珍藏版）》请在金锄头文库上搜索。

1、 1 / 29 金蝶金蝶 EASEAS V V8 8. .2 2 元数据升级指南元数据升级指南 金蝶软件（中国）有限公司 2016 年 6 月 金蝶 EASV8.2 元数据升级指南 2 / 29 前言 概述 本文档针对元数据升级相关背景概念、应用场景、操作步骤、注意事项、常见问题和相关规范 做统一梳理，以释众惑。 读者对象 本手册主要适用于以下用户： 实施人员 二次开发人员 约定 符号约定 在本文中可能出现下列标志，它们所代表的含义如下。 符号 说明 表示有潜在风险， 如果忽视这些文本， 可能导致操作错误、 数据丢失、设备性能降低或不可预知的结果。 表示可以帮助您获取更多相关信息或提示您通过其

2、它方式 也可以获得相同结果。 强调或补充说明所描述的信息。 内容约定 本文档以 EASV7.5、EAS V7.0.3、EAS V7.0.1、BOS V6.3.1 版本为参照，其他版本元数据升级 可以参考使用。 金蝶 EASV8.2 元数据升级指南 3 / 29 目录 1 概述 . 4 1.1 基本概念 . 4 1.2 元数据升级的必要条件 . 5 2 BOS 开发工具元数据升级操作介绍 6 2.1 整体操作流程 . 6 2.2 准备二次开发列表 . 6 2.3 准备三份元数据 . 7 2.4 元数据差异检查（可选步骤） . 10 2.5 元数据升级 . 12 2.6 数据表差异检查 . 15

3、2.7 调整控件位置 . 17 2.8 发布 . 17 2.9 重构单据处理 . 18 2.9.1 库存调拨单 18 2.9.2 采购申请单(PurRequest) . 18 2.10 部署 . 19 2.11 测试 . 20 3 补丁升级涉及的元数据合并 . 21 4 服务器端元数据升级介绍 . 23 5 升级合并常见问题分析处理 . 25 5.1 服务端合并元数据日志的收集 . 25 5.2 元数据升级中常见的问题 . 26 5.2.1 BOS 工具合并元数据问题 26 5.2.2 服务器端自动合并元数据问题 27 金蝶 EASV8.2 元数据升级指南 4 / 29 1 概述 基于 BOS

4、 开发的软件系统，其工作产品包括：元数据、Java 代码（含 BOS 生成的代码、开发 人员编写的代码） 、数据库脚本（含 BOS 生成的脚本、开发人员编写的脚本） 、初始数据。对 于该类软件系统的版本升级同时考虑元数据、Java 代码、数据库脚本、初始数据的同步升级， 其中元数据升级是其它升级的基础，因此，优先保证元数据的可升级特性是 EAS 标准产品、 EAS 客户化系统可版本升级的根基。 1.1 基本概念 在进行元数据的升级合并之前，必须了解元数据升级过程中需要使用到的几个基本概念，此 处以实际应用场景为例，对这些概念进行一一介绍。 基线版本 EAS 标准版本发布后的元数据 客户版本 基

5、于 EAS 标准版本客户化后的元数据 升级版本 EAS 标准产品升级（版本升级或者补丁升级）后的元数据 客户化升级版本 即【客户版本】 + 【升级版本】后的元数据局 也叫元数据合并这一概念，升级后的元数据，称之为客户升级版客户升级版。 金蝶 EASV8.2 元数据升级指南 5 / 29 BOS 工具合并 由于实际二次开发、版本升级的内容涉及的元数据内容之巨，非人力编辑所能为，因此，BOS 工具提供了元数据升级的功能(后面章节会重点介绍)。此种方式为：BOS 工具合并工具合并。 服务器端合并 很多项目二次开发阶段结束之后， 进入了运维期， 在此期间出现产品问题， 也需要更新版本(安 装补丁) 来

6、处理。同样，更新的版本的内容跟已经部署运行的二次开发的内容也会存在上述冲 突的问题。因此，在服务端主控台提供了自动合并的功能，以方便用户在更新补丁的时候， 服务器能自动进行元数据升级合并的操作。此中方式为：服务器端合并。服务器端合并。 1.2 元数据升级的必要条件 元数据升级的必要条件，实际项目可依此判断是否要进行元数据合并： 项目有过二次开发，且二次开发是在标准产品业务单元上进行。 在已经进行二次开发的解决方案(EAS 服务器)上，安装补丁（更新版本） 。 目前产品自 V7.0.1 提供了动态扩展平台，通过只存储元数据片段的方式彻底解决了元数 据升级合并的问题，在碰到元数据合并升级的情况时，

7、强烈建议基于标准产品改造的内强烈建议基于标准产品改造的内 容迁移到容迁移到 DEP 扩展平台上进行开发扩展平台上进行开发； 如果安装更新的补丁包含框架元数据（补丁中会有说明） ，则无论二次开发的内容是否是全新 开发的模块，则都需要进行元数据合并。 金蝶 EASV8.2 元数据升级指南 6 / 29 2 BOS 开发工具元数据升级操作介绍 2.1 整体操作流程 使用 BOS 工具升级(合并)元数据的过程如下： 元数据升级流程图 2.2 准备二次开发列表 1. 二次开二次开发修改的元数据列表发修改的元数据列表元数据升级后检查元数据是否正确合并,； 金蝶 EASV8.2 元数据升级指南 7 / 29

8、 2. 二次开发的功能点列表二次开发的功能点列表用于完成元数据升级、 部署后， 验证二次开发的功能是否正确， 如果有问题及时在 BIM 中进行代码调整，进行调试，以保证功能的正确性。 3. 升级前对二次开发的内容做好备份，避免中途操作有误删除其中的内容。升级前对二次开发的内容做好备份，避免中途操作有误删除其中的内容。 完成升级验证后， 建议将解决方案下所有内容提交到 cvs 中， 做为新版本二次开发的基线版本。 2.3 准备三份元数据 元数据是否成功升级，三份元数据选择至关重要。 我们在新建的目录路径下分别准备三份元数据如下： 上图中： base 目录放置基线版本基线版本元数据 custome

9、r 目录放置客户版本客户版本元数据 new 目录放置升级版本升级版本元数据 megerd 目录用于放置升级合并的结果输出 金蝶 EASV8.2 元数据升级指南 8 / 29 1）基线版本（旧版标准产品基线元数据） ： 旧版本解决方案下的 basemetas（二次开发的基线元数据，首选这个首选这个，可能和生产环境的不同 步） 。或者客户 eas 旧版本 server 端 metas 目录下的元数据，除去除去二次开发的元数据包二次开发的元数据包(V7.5 版版 本以前为本以前为 sp-bim-metas.jar，V7.5 版本以后为版本以后为 meta/bim/目录下元数据目录下元数据)（生产环境

10、的） 。 2）客户版本（旧版二次开发元数据）: 旧版本解决方案下的 metadata 目录（包含完整的二次开发内容，首选这个首选这个，但可能没经过生 产环境的验证） 。或者客户 eas 旧版本 server 端 metas 目录下的元数据（生产环境的比较正确， 但可能不包含最新的二次开发内容） 。 金蝶 EASV8.2 元数据升级指南 9 / 29 3）升级版本（新版标准产品元数据）: 新版本解决方案下的 basemetas。 或者 eas 新版本 server 端 metas 目录下的元数据， 不包括不包括二次二次 开发的元数据包开发的元数据包(V7.5 版本以前为版本以前为 sp-bim-

11、metas.jar，V7.5 版本以后为版本以后为 meta/bim/目录下元数目录下元数 据据) 金蝶 EASV8.2 元数据升级指南 10 / 29 4）升级前元数据的检查项 检查项目 处理方法 检查三份元数据是否正确，此项需要对相关 的开发版本很清楚的二次开发人员确认； 负责此项目二次开发， 或者了解项目二次开 发的人员检查确认 三份元数据中， 基线版本和升级版本(新版本) 中务必不能包含有二次开发的内容，特别是 不能含有现场二次开发的元数据包； 如果基线版本和升级版本中包含二次开发 的内容，务必删除 元数据目录中不要有备份的元数据； 有则删除 Bos 工具的安装目录中不要有中文路径；

12、如果有的话， 需要修改中文路径变为非中文 即可 客户版本的元数据只能选择目录形式 如果有其他二次开发包，则需要将所有的 jar 包解压到统一的目录，然后作为客户版 元数据，参与合并 2.4 元数据差异检查（可选步骤） 金蝶 EASV8.2 元数据升级指南 11 / 29 打开元数据升级检查菜单，选择基线元数据和客户化元数据路径 检查的结果展示在元数据约束视图里。 金蝶 EASV8.2 元数据升级指南 12 / 29 这些违反升级约束的修改，可以先不处理，因为升级过程中按照一定的策略会忽略掉大部分 违反约束的改动。 2.5 元数据升级 在 bim 中打开新版本新版本解决方案。使用上述三份元数据进

13、行升级。 “升级后元数据路径” 所在 硬盘的剩余空间要大于 1G1G。 金蝶 EASV8.2 元数据升级指南 13 / 29 升级的日志信息在 BOSModularbimbim.log 里。升级后元数据目录下的 merged.xml 里记录的 是升级过程中合并过的元数据。 升级结果展示在升级结果视图里。 如果没有fatal 或或 error级别的日志（Fatal 或 error 表示合并失败） ，会弹出更换元数据的对 话框： 金蝶 EASV8.2 元数据升级指南 14 / 29 目标元数据路径目标元数据路径：即我们要替换的解决方案中的客户化元数据路径，一般指定到当前工 作空间下的解决方案的 m

14、etadata 目录(此 metadata 目录内容为二次开发编辑的内容)。 来源元数据路径来源元数据路径：即刚才合并成功之后输出的合并结果，这里指定到刚才输出合并结果 目录 megerd 下的 mn 目录。 备注：合并结果介绍 金蝶 EASV8.2 元数据升级指南 15 / 29 最终合并的元数据文件在 mn 目录下，合并成功后直接使用改 mn 目录下的内容替换。 Merged_result.csv 文件问为升级合并结果日志文件，可以用文本编辑工具打开，查看合并中是 否有异常信息。 如果升级结果里有fatal 或或 error级别的日志，查看描述信息，一般为客户化元数据路径里 缺少了某个元数

15、据导致的。如果合并失败的元数据上做了二次开发，必须修复修复该错误以后重 新做一次升级合并。 如果升级结果里有fatal 或或 error级别的日志，但该业务单元上没有做过二次开发，也可以 不做修复。 使用 bim 菜单中的元数据替换功能用升级后 mn 下的元数据替换当前解决方案下的 metadata 目录。 2.6 数据表差异检查 使用元数据数据表差异检查菜单来做客户化table和升级后的table比较， 展示违反约束的变动。 金蝶 EASV8.2 元数据升级指南 16 / 29 检查结果展示在数据库约束视图里。 金蝶 EASV8.2 元数据升级指南 17 / 29 数据库约束视图里是可能在发

16、布时报数据库约束异常的 table。可以修正这些违反约束的客户 化元数据；也可以现在不处理，等发布时出现违反约束的报错时，再修正。 2.7 调整控件位置 清理一下缓存或者重启一下清理一下缓存或者重启一下，然后在 bim 中打开客户化的业务单元，检查控件，如果有可见性 属性为“是”的控件位置重叠，手工调整控件到适当的位置。 2.8 发布 对于整个包下的业务单元都是客户化的业务单元，使用整包发布； 对于某个包下的业务单元大部分是客户化的业务单元，也可以使用整包发布；如果整包发布 有问题，再单个发布。 发布的时候如果有同步数据库的错误，可以做手工调整： 如果报 Caused by: java.sql.SQLException: ORA-01400: 无法将 NULL 插入 (“WKYG“.“T_CAS_PAYMENTBILL_TEMP“.“FACTRECACCOUNTBANK“)类似的异常。 请找到T_CAS_PAYMENTBILL这个table， 如果客户化不允许FACTRECACCOUNTBANK 字段为空，说明数