金蝶EAS-EASCloud子系统树指引.docx

金蝶BOS子系统树指引文档版本V1.0发布日期2015年12月金蝶软件（中国）有限公司地址深圳市高新技术产业园南区科技南十二路2号金蝶软件园KingdeeSoftware（China）Co.,Ltd邮编518057网址http://www.kingdee.comhttp://dev.kingdee.com客户服务电话86-755-26612299客户服务传真86-755-26615016客户服务邮箱webmaster@kingdee.com版权所有©金蝶软件（中国）有限公司本书著作权属于金蝶软件(中国)有限公司所有，在未经本公司许可的情况下，任何单位或个人不得以任何方式对本书的部分或全部内容擅自进行增删，改编，节录，翻译，翻印，改写。注意由于产品版本升级或其他原因，本文档内容会不定期进行更新。除非另有约定，本文档仅作为使用指导，本文档中的所有陈述、信息和建议不构成任何明示或暗示的担保。金蝶BOS子系统树指引目录目录1子系统树概述.................................................................................................................52子系统树数据组成...........................................................................................................63子系统树存放的位置和相关的配置文件...............................................................................64子系统树的生成及加载.....................................................................................................94.1子系统树的生成...............................................................................................................................................94.2子系统树的加载..............................................................................................................................................115子系统树的特殊维护......................................................................................................125.1改变节点上下级.............................................................................................................................................125.2新增子系统树.................................................................................................................................................126常见问题分析处理.........................................................................................................126.1子系统树问题的排查步骤.............................................................................................................................126.2通用方法.........................................................................................................................................................156.3典型子系统树问题案例.................................................................................................................................16文档版本V2.0(2015-9-19)版权所有©金蝶软件（中国）有限公司iii金蝶BOS子系统树指引Error:ReferencesourcenotfoundError:Referencesourcenotfound1子系统树概述BOS平台中存在多个业务功能相对独立的子系统，如权限、预警、单据转换、编码规则、工作流等。每个子系统都会根据自身的业务，管理辖下的所有相关的业务单元，子系统树即是管理、展示该业务子系统的目录结构的对象。特点存在多个子系统树。子系统树具有数据量大,生成过程持续时间长，占用资源多，生成后相对稳定。类型主要存在如下子系统树：参数树、BOTP树、编码规则树、字段权限树、预警树、查询树、子系统实体树、缓存树、包树、子系统树、对帐中心树。子系统整体介绍如下图实示，系统平台在生成子系统树的时候，是根据子系统树相关的配置文件，如subsystem_bos.xml、subsystem_eas.xml等，生成各个子系统所需要的目录树文件*.mdbview。在运行期，加载已经生成的各种*.mdbview文件，提供个各个子系统使用。图1-1子系统树体系简图文档版本V2.0(2015-9-19)版权所有©金蝶软件（中国）有限公司5金蝶BOS子系统树指引Error:ReferencesourcenotfoundError:Referencesourcenotfound2子系统树数据组成表2-1子系统树数据组成表子系统树类型数据组成参数树由元数据包组成。参数树在参数管理、参数设置中使用。在“参数管理”中出现的是完整的参数树，在“参数设置”中出现的子系统树,是将没有参数的节点过滤后的参数树。BOTP树由元数据包，实体组成。实体必须继承于CoreBillBase，并且没有设置扩展属性nobotp。预警树由元数据包，实体，功能组成。编码规则树由元数据包，实体组成。实体必须设置了扩展属性，codingRuleEnabled,其值为true;字段权限树由元数据包，实体组成。实体必须继承于ObjectBase，并且设置扩展属性enableFieldPermission，其值为true。预警树由元数据包，实体，FAÇADE组成。查询树由元数据包，关联查询QUERY组成。子系统实体树由元数据包，实体组成。缓存树由元数据包，实体组成。实体必须设置了扩展属性，isConfigCache,其值为true。包树由元数据包组成。子系统树由元数据包，实体，功能，数据表，界面，关联查询，业务功能组成。3子系统树存放的位置和相关的配置文件标准产品，默认子系统树存储在元数据文件mdbview-metas.jar中。文档版本V2.0(2015-9-19)版权所有©金蝶软件（中国）有限公司6金蝶BOS子系统树指引Error:ReferencesourcenotfoundError:Referencesourcenotfound如果有二次开发，通过bim生成子系统树，发布和部署，会存储在sp（旧版本升级上来的二次开发）或bim目录下的*.jar中。如果有做过子系统树的客户化定制，定制的内容会存储在Server\server\profiles\server1\config\subsystem的文件夹下相关文件如下表所示。表3-1相关文件表文件位置用途SubSystem_bos.xmlSubSystem_eas.xmlSubSystem_industry.xmlSubSystem.xml(V60解耦之前版本使用)服务端：Eas\server\properties配置当前系统所有元数据目录路径。生成子系统树的时候，根据此配置文件中的目录进行搜索遍历路径下的所有元数据。SubSystemChangeParent_bos.xmlSubSystemChangeParent_eas.xmlSubSystemChangeParent_industry.xmlSubSystemChangeParent.xml(V60解耦之前版本使用)服务端：Eas\server\properties调整子系统树节点的上下级SubSystemFilter.xml服务端：eas\server\properties新增子系统树使用mdbview-metas.jar服务端：Eas\server\metas\bos(服务端加载使用)Eas\server\deploy\fileserver.ear\easWebClient\metas\bos(提供给客户端下载)客户端：eas\client\metas\bos默认标准产品的所有子系统树文件存贮的包。部署二次开发，安装补丁，重新生成子系统树，会更新此包内容。sp-bim-metas.jar（7.0*或之前版本）服务端：Eas\server\metas(服务端加载使用)二次开发所有的元数据。如果在部署到服务器之前，在bos工具中生成过子系统树，则此二次开发文档版本V2.0(2015-9-19)版权所有©金蝶软件（中国）有限公司7金蝶BOS子系统树指引Error:ReferencesourcenotfoundError:ReferencesourcenotfoundEas\server\deploy\fileserver.ear\easWebClient\metas(提供给客户端下载)客户端：eas\client\metas包根目录下会包含有二次开发相关的子系统树文件*.mdbview，那么在服务端重新生成子系统树之后，此二次开发包中的*.mdbview文件会被更新。相同内容的*.mdbview也会更新到mdbview-metas.jar中。如果sp-bim-metas.jar本身不包含*.mdbview，那么服务端重新生成子系统树，也不会更新到此包中。sp-bim-metas_updater.jar（7.0*或之前版本）服务端：Eas\server\deploy\fileserver.ear\easWebClient\metas客户端：eas\client\metas此包是作为增量部署所使用，在某些EAS版本中会看到。其内容有时为空，有时包含*.mdbview。对于包含有子系统树文件的此包来说，需要注意其中的文件是否根据重新生成而更新(通过查看其中的*.mdbview文件的时间来判断)。4子系统树的生成及加载4.1子系统树的生成步骤1根据需要对相关元数据设置扩展属性文档版本V2.0(2015-9-19)版权所有©金蝶软件（中国）有限公司8金蝶BOS子系统树指引Error:ReferencesourcenotfoundError:Referencesourcenotfound对于某些子系统树需要对元数据的扩展属性进行过滤，例如codingrule的子系统树，需要配置codingruleenable的扩展属性；botp的子系统树，需要配置nobotp的扩展属性。（详细说明请参考标准产品的子系统树说明描述。）步骤2将对应的元数据所在的目录加入到子系统树目录配置文件中。系统生成子系统树的过程中，会根据“子系统树目录配置文件”中配置的路径（默认包括app、client目录），遍历其下的元数据，但不会遍历其他的子目录。子系统树目录配置文件：BOSV6.0解耦之前版本：−服务端环境：eas\server\properties\SubSystem.xml−开发环境：解决方案根目录下\SubSystem.xmlBOSV6.0解耦之后版本：−服务端环境：eas\server\properties\SubSystem_bos.xml(二次开发使用)eas\server\properties\SubSystem_eas.xml(标准产品使用)eas\server\properties\SubSystem_industry.xml(行业产品使用)−开发环境：在解决方案根目录下\SubSystem_bos.xml、SubSystem_eas.xml、SubSystem_industry.xml对于标准产品SubSystem_eas.xml、和行业产品SubSystem_industry.xml，这个2个配置文件，一般不需要现场维护，产品出厂设置即可。对于SubSystem_bos.xml，如果现场有二次开发的内容，特别是开发的元数据所在的路径是新建的，务必检查确认SubSystem_bos.xml文件中已经包含对应的二次开发的元数据所在的路径。步骤3是否要修改节点的上下级关系可以通过修改SubSystemChangeParent.xml文件来更改默认元数据的上下级关系。满足某些子系统树节点在显示的时候，调整目录树位置的需要。BOSV6.0解耦之前版本：−服务端环境：eas\server\properties\SubSystemChangeParent.xml−开发环境：解决方案根目录下\SubSystemChangeParent.xmlBOSV6.0解耦之后版本：文档版本V2.0(2015-9-19)版权所有©金蝶软件（中国）有限公司92、sp下的.jar中的mdbview文件3、bim下的.jar中的mdbview文件4、mdbview-metas.jar中的mdbview文件1、Server\server\profiles\server1\config\subsystem的文件夹下金蝶BOS子系统树指引Error:ReferencesourcenotfoundError:Referencesourcenotfound−服务端环境：eas\server\properties\SubSystemChangeParent_bos.xml(二次开发使用)eas\server\properties\SubSystemChangeParent_eas.xml(标准产品使用)−开发环境：在解决方案根目录下\SubSystemChangeParent_bos.xml、SubSystemChangeParent_eas.xml步骤4生成子系统树生成操作：在服务端主控台上，通过选择“工具-产生子系统树”菜单生成。主要在以下情况使用：新安装补丁出现异常中断，手工执行生成(安装补丁默认会执行生成子系统树步骤)，部署二次开发的内容。凡涉及到服务端元数据内容更新的，都需要在服务端重新生成子系统树。BOS开发环境在BOS开发环境，通过选择菜单“BOS建模工具-工具-生成子系统树”，或者“BOS建模工具-工具-从包更新子系统树”来生成。生成文件及路径：服务端主控台生成操作，会生成各种业务领域的mdbview为扩展名的子系统树元数据文件，新生成的mdbview文件会更新到服务端：eas\server\metas\bos\mdbview-metas.jar，eas\server\deploy\fileserver.ear\easWebClient\metas\bos\mdbview-metas.jar中；BOS开发工具生成子系统树，会重新生成解决方案根目录下/metadata以及deploy_meta目录下的所有mdbview文件。4.2子系统树的加载文档版本V2.0(2015-9-19)版权所有©金蝶软件（中国）有限公司10金蝶BOS子系统树指引Error:ReferencesourcenotfoundError:Referencesourcenotfound上图为子系统树文件的加载优先级顺序，在系统存在多份mdbview子系统树文件的情况下，按照上述优先级顺序进行加载。“Server\server\profiles\server1\config\subsystem”的文件夹下的子系统树一般项目中不会有，主要针对做过子系统树的客户化定制的项目。5子系统树的特殊维护5.1改变节点上下级对于需要显示时改变默认的元数据上的上下级关系则需要修改Server\server\properties\SubSystemChangeParent.xml文件，此文件一项配置如下其中fullName表示一个需要改变位置的元数据，newParent为改变后的位置。5.2新增子系统树如果要新增子系统树，需要修改Server\server\properties\SubSystemFilter.xml文件，具体可以参考该配置文件已有的相关子系统树节点。文档版本V2.0(2015-9-19)版权所有©金蝶软件（中国）有限公司11金蝶BOS子系统树指引Error:ReferencesourcenotfoundError:Referencesourcenotfound6常见问题分析处理6.1子系统树问题的排查步骤子系统树问题排查步骤如下图所示。文档版本V2.0(2015-9-19)版权所有©金蝶软件（中国）有限公司12金蝶BOS子系统树指引Error:ReferencesourcenotfoundError:Referencesourcenotfound步骤操作处理1服务器重新生成子系统树略文档版本V2.0(2015-9-19)版权所有©金蝶软件（中国）有限公司13金蝶BOS子系统树指引Error:ReferencesourcenotfoundError:Referencesourcenotfound2确认现场环境是否有部署二次开发如果有，执行第3步，检查服务器二次开发文件中是否有*.mdbview文件。如果没有，则跳到第4步，检查mdbview-metas.jar是否有重新生成。3检查服务器sp和bim下的二次开发jar包和Server\server\profiles\server1\config\subsystem（所有实例下的，这里sever1为实例命）文件中是否有*.mdbview文件如果有，则将这些.mdbview文件备份后移除，重启服务后看看子系统树是否正确。如果没有，则跳至5，检查SubSystem_bos.xml是否存在缺失的二次开发路径。4检查服务端的mdbview-metas.jar中的*.mdbview文件，查看是否最近重新生成子系统树的时间如果时间跟最近生成子系统树的时间不一致，则mdbview-metas.jar中的子系统树没有正确更新，需要重新生成验证，并查看服务端生成过子系统树程中是否有异常(查看控制台日志)。5检查服务器环境的SubSystem_bos.xml文件跟BOS下的同名文件，对比是否有差异检查下解决方案根目录下的SubSystem_bos.xml文件，跟BOS上的同名文件是否存在差异？SubSystem_bos.xml文件一般包含有二次开发的元数据的路径，如果某些项目存在手工部署的情况，那么此配置文件一般难保证二次开发会得同步更新到服务器，需要人工比较之后，手工修改，将二次开发相关的路径更新到服务器上对应的配置文件中。然后重新生成子系统树验证。以上问题分析处理的核心步骤：检查服务器、客户端的包更新情况，检查子系统树配置文件情况。6.2通用方法子系统树问题大多因为系统有过二次开发导致，针对有二次开发的子系统树问题，此提供一通用方法，步骤：步骤1检查subSystem_bos.xml文件，删除其中标准产品的路径：如里面包含有如下信息，那么就删除该行：，而其中二次开发的路径要保留。文档版本V2.0(2015-9-19)版权所有©金蝶软件（中国）有限公司14金蝶BOS子系统树指引Error:ReferencesourcenotfoundError:Referencesourcenotfound步骤2删除服务器上(2处)lib包中的根目录下的所有*.mdbview文件。步骤3如果server\deploy\fileserver.ear\easWebClient\metas下有*.mdbview，则将其剪切到备份路径(或删除)。步骤4在服务端主控台重新生成子系统树。6.3典型子系统树问题案例1）二次开发的内容在编码规则、单据转换等子系统树目录中看不到分析处理：这里是指二次开发的相关的内容，在所有子系统树目录中看不到，根据上面的分析步骤，如果开发环境就看不见，那么则可能是开发的元数据目录在没有更新到SubSystem_bos.xml文件中。在bos开发工具中，如果是通过“建模工具”新建的组别，在该组别下新建的业务单元，发布的时候，工具是会自动更新当前新建组别到SubSystem_bos.xml文件中的，如果是通过“设计开发工具”新建的包，则直接发布该包下新建的元数据，其包路径不会自动更新到SubSystem_bos.xml文件中，因此，需要检查确认下SubSystem_bos.xml文件中是否存在新建的二次开发的路径，然后再行生成子系统树验证2）二次开发的内容在开发环境，各个子系统树正常，部署到服务器之后，服务器端重新生成子系统树，但是看不见二次开发的内容分析处理：首先根据上述的分析步骤，检查对应的jar包是否正确更新，在正确更新的基础上，检查服务器上的SubSystem_bos.xml跟bos开发环境下的SubSystem_bos.xml是否有差异，是否二次开发的相关路径没有正确更新。手工修复一致后，重新生成子系统树验证。3）部署到服务器上的二次开发的内容，各个子系统树里能看见部分二次开发的内容，另外部分的二次开发的内容找不到分析处理：结合上述各问题的分析，应该是部分二次开发的内容是通过bos设计开发工具直接新建的元数据，且该元数据所在路径也是通过设计开发工具新建，直接在设计开发工具中发布，导致文档版本V2.0(2015-9-19)版权所有©金蝶软件（中国）有限公司15金蝶BOS子系统树指引Error:ReferencesourcenotfoundError:Referencesourcenotfound此路径相关的元数据在相关的子系统树中看不到。需要手工修改SubSystem_bos.xml，保证相关的路径在此文件中正确配置，再行重新生成子系统树验证。4）行业版产品，做了二次开发，部署到服务器，各个子系统树目录结构不正确，丢失子目录、丢失各个节点等现象分析处理：根据之前的类似的问题，在SubSystem_bos.xml、SubSystem_eas.xml、SubSystem_industry.xml三份子系统树的配置文件中，各xml文件中的路径一般不会有重复，某些情况下，通过bos工具修改发布标准产品的单据，或者行业的单据，会将单据相关的路径做为二次开发的路径更新到SubSystem_bos.xml文件中，而此单据的路径本来在SubSystem_eas.xml或者SubSystem_industry.xml中就已经存在，生成子系统树的时候，出现问题中描述现象。需要手工删除在SubSystem_bos.xml中，和SubSystem_eas.xml及SubSystem_industry.xml中重复的目录，然后重新生成子系统树验证。5）服务端生成子系统树异常分析处理：服务端生成子系统树的问题一般两种原因：服务端的目录的读写权限导致生成子系统树异常，需要对EAS服务端的安装目录的权限重新设置，特别是EAS服务端目录下的JDK目录，需要设置可读写的权限。某些项目上，备份服务端的元数据文件，直接保存在系统元数据的文件夹，并且备份的文件命名中包含有中文。以上情况，检查处理后重新新生成并验证。6）二次开发部署之后，重新生成了子系统树，“参数管理-财务系统-存货核算”节点丢失分析：该问题的项目，对供应链下的某单据进行发布，bos工具将相关的目录追加更新到在subSystem_box.xml中，而“存货核算”参数由于之前版本的子系统树配置文件定义的时候有些特殊，导致由工具生成更新到subSystem_box.xml中的节点描文档版本V2.0(2015-9-19)版权所有©金蝶软件（中国）有限公司16金蝶BOS子系统树指引Error:ReferencesourcenotfoundError:Referencesourcenotfound述，跟标准产品的subSystem_eas.xml文件中的对应节点描述不一致，最终使得生成的参数节点子系统树丢失“存货核算”。处理：删除subSystem_box.xml中的有关供应链“com.kingdee.eas.scm”，以及其子目录的所有目录节点。然后重新生成子系树。7）由于手工部署导致的子系统树问题分析：某些项目由于各种原因，会出现二次开发手工部署元数据的问题，并且，部署到服务器的元数据包，命名没有按照规范统一命名为sp-bim-metas.jar，导致服务器元数据目录下存在各式各样名称的二次开发的元数据包，且有些元数据包中还包含了*.mdbview文件。服务端生成子系统树，mdbview-metas.jar包中的*.mdbview。那些没有及时更新的自定义名称的二次开发元数据包中的子系统树，导致了各种各样的子系统树问题。处理：删除相关的自定义名称的二次开发包中的*.mdbview文件。文档版本V2.0(2015-9-19)版权所有©金蝶软件（中国）有限公司17