金蝶EASV81子系统树指引Word文档格式.docx
- 文档编号:22469389
- 上传时间:2023-02-04
- 格式:DOCX
- 页数:17
- 大小:179.04KB
金蝶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文件。
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 金蝶 EASV81 子系统 指引