金蝶EASV81子系统树指引Word文档格式.docx
《金蝶EASV81子系统树指引Word文档格式.docx》由会员分享，可在线阅读，更多相关《金蝶EASV81子系统树指引Word文档格式.docx（17页珍藏版）》请在冰豆网上搜索。
4子系统树的生成及加载9
4.1子系统树的生成9
4.2子系统树的加载11
5子系统树的特殊维护12
5.1改变节点上下级12
5.2新增子系统树12
6常见问题分析处理12
6.1子系统树问题的排查步骤12
6.2通用方法15
6.3典型子系统树问题案例16
1子系统树概述
BOS平台中存在多个业务功能相对独立的子系统，如权限、预警、单据转换、编码规则、工作流等。
每个子系统都会根据自身的业务，管理辖下的所有相关的业务单元，子系统树即是管理、展示该业务子系统的目录结构的对象。
1特点
存在多个子系统树。
子系统树具有数据量大,生成过程持续时间长，占用资源多，生成后相对稳定。
2类型
主要存在如下子系统树：
参数树、BOTP树、编码规则树、字段权限树、预警树、查询树、子系统实体树、缓存树、包树、子系统树、对帐中心树。
3子系统整体介绍
如下图实示，系统平台在生成子系统树的时候，是根据子系统树相关的配置文件，如subsystem_bos.xml、subsystem_eas.xml等，生成各个子系统所需要的目录树文件*.mdbview。
在运行期，加载已经生成的各种*.mdbview文件，提供个各个子系统使用。
图1-1子系统树体系简图
2子系统树数据组成
表2-1子系统树数据组成表
子系统树类型
数据组成
参数树
由元数据包组成。
参数树在参数管理、参数设置中使用。
在“参数管理”中出现的是完整的参数树，在“参数设置”中出现的子系统树,是将没有参数的节点过滤后的参数树。
BOTP树
由元数据包，实体组成。
实体必须继承于CoreBillBase，并且没有设置扩展属性nobotp。
预警树
由元数据包，实体，功能组成。
编码规则树
实体必须设置了扩展属性，codingRuleEnabled,其值为true;
字段权限树
实体必须继承于ObjectBase，并且设置扩展属性enableFieldPermission，其值为true。
由元数据包，实体，FAÇ
ADE组成。
查询树
由元数据包，关联查询QUERY组成。
子系统实体树
缓存树
实体必须设置了扩展属性，isConfigCache,其值为true。
包树
子系统树
由元数据包，实体，功能，数据表，界面，关联查询，业务功能组成。
3子系统树存放的位置和相关的配置文件
标准产品，默认子系统树存储在元数据文件mdbview-metas.jar中。
如果有二次开发，通过bim生成子系统树，发布和部署，会存储在sp（旧版本升级上来的二次开发）或bim目录下的*.jar中。
如果有做过子系统树的客户化定制，定制的内容会存储在Server\server\profiles\server1\config\subsystem的文件夹下
相关文件如下表所示。
表3-1相关文件表
文件
位置
用途
SubSystem_bos.xml
SubSystem_eas.xml
SubSystem_industry.xml
SubSystem.xml（V60解耦之前版本使用）
服务端：
Eas\server\properties
配置当前系统所有元数据目录路径。
生成子系统树的时候，根据此配置文件中的目录进行搜索遍历路径下的所有元数据。
SubSystemChangeParent_bos.xml
SubSystemChangeParent_eas.xml
SubSystemChangeParent_industry.xml
SubSystemChangeParent.xml（V60解耦之前版本使用）
调整子系统树节点的上下级
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（服务端加载使用）
Eas\server\deploy\fileserver.ear\easWebClient\metas（提供给客户端下载）
eas\client\metas
二次开发所有的元数据。
如果在部署到服务器之前，在bos工具中生成过子系统树，则此二次开发包根目录下会包含有二次开发相关的子系统树文件*.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根据需要对相关元数据设置扩展属性
对于某些子系统树需要对元数据的扩展属性进行过滤，例如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文件来更改默认元数据的上下级关系。
满足某些子系统树节点在显示的时候，调整目录树位置的需要。
eas\server\properties\SubSystemChangeParent.xml
解决方案根目录下\SubSystemChangeParent.xml
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子系统树的加载
上图为子系统树文件的加载优先级顺序，在系统存在多份mdbview子系统树文件的情况下，按照上述优先级顺序进行加载。
“Server\server\profiles\server1\config\subsystem”的文件夹下的子系统树一般项目中不会有，主要针对做过子系统树的客户化定制的项目。
5子系统树的特殊维护
5.1改变节点上下级
对于需要显示时改变默认的元数据上的上下级关系则需要修改Server\server\properties\SubSystemChangeParent.xml文件，此文件一项配置如下
<
changeParentfullName="
com.kingdee.eas.cm.bb.app.DeptIndirectFeeWork"
newParent="
com.kingdee.eas.cm.dp"
/>
其中fullName表示一个需要改变位置的元数据，newParent为改变后的位置。
5.2新增子系统树
如果要新增子系统树，需要修改Server\server\properties\SubSystemFilter.xml文件，具体可以参考该配置文件已有的相关子系统树节点。
<
!
--例子
subSystemFilter>
name>
com_kingdee_eas_base_botp<
/name>
metaDataTypes>
metaDataType>
enty<
/metaDataType>
/metaDataTypes>
extendedPropertys>
extendedProperty>
type>
/type>
nobotp<
value>
false<
/value>
/extendedProperty>
/extendedPropertys>
entityChain>
com.kingdee.eas.framework.app.CoreBillBase<
/entityChain>
package>
/package>
/subSystemFilter>
-->
6常见问题分析处理
6.1子系统树问题的排查步骤
子系统树问题排查步骤如下图所示。
步骤
操作
处理
1
服务器重新生成子系统树
略
2
确认现场环境是否有部署二次开发
如果有，执行第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文件，删除其中标准产品的路径：
如里面包含有如下信息，那么就删除该行：
row…./>
，而其中二次开发的路径要保留。
rowfullname="
com.kingdee.eas.fi"
name="
fi"
alias_l1="
"
alias_l2="
财务系统"
alias_l3="
財務系統"
isleaf="
0"
parent="
com.kingdee.eas"
步骤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设计开发工具直接新建的元数据，且该元数据所在路径也是通过设计开发工具新建，直接在设计开发工具中发布，导致此路径相关的元数据在相关的子系统树中看不到。
需要手工修改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工具将
com.kingdee.eas.scm"
scm"
供应链管理"
供應鏈管理"
/>
com.kingdee.eas.scm.cal"
calculate"
存货核算"
存貨覈算"
1"
相关的目录追加更新到在subSystem_box.xml中，而“存货核算”参数由于之前版本的子系统树配置文件定义的时候有些特殊，导致由工具生成更新到subSystem_box.xml中的节点描述，跟标准产品的subSystem_eas.xml文件中的对应节点描述不一致，最终使得生成的参数节点子系统树丢失“存货核算”。
处理：
删除subSystem_box.xml中的有关供应链“com.kingdee.eas.scm”，以及其子目录的所有目录节点。
然后重新生成子系树。
7）由于手工部署导致的子系统树问题
某些项目由于各种原因，会出现二次开发手工部署元数据的问题，并且，部署到服务器的元数据包，命名没有按照规范统一命名为sp-bim-metas.jar，导致服务器元数据目录下存在各式各样名称的二次开发的元数据包，且有些元数据包中还包含了*.mdbview文件。
服务端生成子系统树，mdbview-metas.jar包中的*.mdbview。
那些没有及时更新的自定义名称的二次开发元数据包中的子系统树，导致了各种各样的子系统树问题。
删除相关的自定义名称的二次开发包中的*.mdbview文件。
升级会员 