XX电网公司 企业级 资产管理系统 资产管理详细设计说明书.doc

广东电网公司企业级资产管理系统详细设计说明书资产管理系统广东电网公司深圳市康拓普信息技术有限公司二零一零年六月目 录1设备资产管理11.1基础数据1修订记录11.1.1技术对象节点11.1.2功能位置21.1.3设备资产31.1.4部件41.1.5变电站41.1.6线路51.1.7通信节点61.1.8调度节点61.1.9电厂61.1.10类别71.1.11建设记录81.1.12台帐模板管理92工单管理14修订记录142.1概述142.1.1业务逻辑设计163输网资产变更管理223.1资产变更223.1.1概述223.1.2业务逻辑设计223.2正式台帐维护243.2.1概述243.2.2业务逻辑设计244设备资产台帐264.1设备台帐维护264.1.1概述264.1.2业务逻辑设计264.2设备台帐树复制粘贴324.2.1概述324.2.2业务逻辑设计334.3资产浏览354.3.1概述354.3.2业务逻辑设计354.4资产维护354.4.1概述354.4.2业务逻辑设计365设备建设375.1设备资产台帐初设375.1.1概述375.1.2业务逻辑设计375.2资产关联费用结构405.2.1概述405.2.2业务逻辑设计405.3物料装卸415.3.1概述415.3.2业务逻辑设计425.3.3数据库设计475.3.4表现层设计475.4电子化移交505.4.1概述505.4.2业务逻辑设计501 设备资产管理1.1 基础数据修订记录版本修订说明作者审核审核日期V1.0新建单俊、夏成文符曦2009-12-11所有权声明：深圳市康拓普信息技术有限公司版权所有 不得复制Copyright © 2009 by Shenzhen Comtop Information Technology Co., Ltd1.1.1 技术对象节点1.1.1.1 概述包路径：top.lcam.asset.masterdata.techobjectnode.appservice.impl. TechObjectNodeBizService。提供技术对象节点新增、修改、删除、读取基本的CRUD方法。1.1.1.2 业务逻辑设计1.1.1.2.1 TechObjectNodeBizService类名TechObjectNodeBizService说明技术对象节点BizService依赖服务声明1.1.1.2.1.1 readFullPathListByNodeId方法readFullPathListByNodeId说明根据技术对象节点id读取对象在台帐中的全路径输入技术对象节点id输出技术对象节点路径List处理调用TechObjectNodeDAO根据技术对象节点id级联读取技术对象节点的父节点列表new技术对象节点list遍历技术对象节点的父节点列表，给技术对象节点list 赋值返回技术对象节点list1.1.2 功能位置1.1.2.1 概述包路径：top.lcam.asset.masterdata.functionlocation. appservice.impl. FunctionLocationBizService。提供功能位置新增、修改、删除、读取基本的CRUD方法。1.1.2.2 业务逻辑设计1.1.2.2.1 FunctionLocationBizService类名FunctionLocationBizService说明功能位置BizService依赖服务声明1.1.2.2.1.1 readFunctionLocation方法readFullPathListByNodeId说明根据功能位置id读取功能位置基本信息输入功能位置id输出功能位置基本信息处理根据功能位置id读取功能位置基本信息1.1.2.2.1.2 insertFunctionLocation方法insertFunctionLocation说明新增功能位置输入功能位置vo输出功能位置id处理生成功能位置id保存功能位置信息1.1.3 设备资产1.1.3.1 概述包路径：top.lcam.asset.masterdata.asset. appservice.impl. AssetOverAllBizService。提供资产综合服务包括设备资产、资产卡片、资产价值信息的增、删、改、查。1.1.3.2 业务逻辑设计1.1.3.2.1 AssetOverAllBizService 类名AssetOverAllBizService说明设备资产综合服务BizService依赖服务声明AssetBizService、AssetCardBizService、AssetValueBizService1.1.3.2.1.1 insertAssetOverAll方法insertAssetOverAll说明新增设备资产、资产卡片、资产价值信息输入存有设备资产、资产卡片和资产价值信息的map输出包装设备资产、资产卡片、资产价值信息的AssetOverAllVO处理根据map的数据new AssetVO ，新增设备If（设备具有资产价值） 根据map的数据new AssetCardVO，新增资产卡片 根据map的数据new AssetValueVO，新增资产价值信息1.1.4 部件1.1.4.1 概述包路径：top.lcam.asset.masterdata.parts. appservice.impl. PartsBizService。提供功能部件新增、修改、删除、读取基本的CRUD方法。1.1.4.1.1 PartsBizService类名PartsBizService说明部件BizService依赖服务声明1.1.4.1.1.1 queryPartsListByDeviceId方法queryPartsListByDeviceId说明根据设备id查询设备下的部件输入设备id输出部件List处理组装查询条件deviceId=参数设备id调用queryPartsList查询为上步组装的查询条件1.1.5 变电站1.1.5.1 概述包路径：top.lcam.asset.masterdata.substation. appservice.impl. SubstationBizService。提供变电站新增、修改、删除、读取基本的CRUD方法。1.1.5.1.1 SubstationBizService类名SubstationBizService说明变电站BizService，变电站的新增、修改、删除、列表查询的原子方法依赖服务声明1.1.6 线路1.1.6.1 概述包路径：top.lcam.asset.masterdata.line. appservice.impl. LineBizService。提供线路新增、修改、删除、读取基本的CRUD方法。1.1.6.1.1 LineBizService类名LineBizService说明线路BizService依赖服务声明1.1.6.1.1.1 deleteLine方法deleteLine说明删除线路信息输入线路id输出是否删除成功，1删除成功，其他失败处理查询线路对应的功能位置信息删除功能位置删除线路1.1.7 通信节点1.1.7.1 概述包路径：munication. appservice.impl. CommunicationBizService。提供通信节点新增、修改、删除、读取基本的CRUD方法。1.1.7.1.1 CommunicationBizService类名CommunicationBizService说明通信节点BizService，通信节点的新增、修改、删除、列表查询的原子方法依赖服务声明1.1.8 调度节点1.1.8.1 概述包路径：top.lcam.asset.masterdata.dispatch. appservice.impl. DispatchBizService。提供调度节点新增、修改、删除、读取基本的CRUD方法。1.1.8.1.1 DispatchBizService类名DispatchBizService说明调度节点BizService，调度节点的新增、修改、删除、列表查询的原子方法依赖服务声明1.1.9 电厂1.1.9.1 概述包路径：top.lcam.asset.masterdata.powerplant. appservice.impl. PowerPlantBizService。提供电厂新增、修改、删除、读取基本的CRUD方法和查询方法。1.1.9.1.1 PowerPlantBizService类名PowerPlantBizService说明电厂BizService，电厂的新增、修改、删除、列表查询的原子方法依赖服务声明1.1.10 类别1.1.10.1 概述包路径：top.lcam.asset.masterdata.assetclassify. appservice.impl.AssetClassifyBizService提供资产类别、功能位置类别、特征组、特征的维护。1.1.10.2 业务逻辑设计1.1.10.2.1 AssetClassifyBizService类名AssetClassifyBizService说明资产类别BizService依赖服务声明1.1.10.2.1.1 deleteAssetClassifyFeatureValue方法deleteAssetClassifyFeatureValue说明删除特征值输入特征id输出Int （1表示操作成功）处理根据特征id查找特征类别关联根据特征类别关联的类别id查找设备特征值删除设备特征关联删除设备特征If（设备特征值 ！= null） 删除设备特征值1.1.11 建设记录1.1.11.1 概述包路径： top.lcam.asset.masterdata.buildrecord.appservice.impl. BuildRecordBizService提供资产建设记录的产生，通过建设记录查看资产的安装历程，功能位置下的设备安装情况。1.1.11.2 业务逻辑设计1.1.11.2.1 BuildRecordBizService类名BuildRecordBizService说明资产建设记录 BizService依赖服务声明1.1.11.2.1.1 insertBuildRecord方法insertBuildRecord说明新增建设记录输入Vo输出Int （1表示操作成功）处理根据设备在业务中的处理，在产生设备记录的时候，新增建设记录。记录建设类型，安装到的功能位置，时间。1.1.11.2.1.2 queryBuildRecordViewList方法queryBuildRecordViewList说明查询建设记录（设备或者功能位置的安装历史）输入ObjectId 设备对象id 或者 installId 安装到对象的Id 输出List<BuildRecordViewVO> 建设记录视图对象集合处理为了满足 1. 查看设备在历史上，所有安装的功能位置 2. 某功能位置下安装了哪些设备通过建设记录将设备，安装到的功能位置对象组合成安装历史视图create or replace view v_asset_build_record asselect x.device_build_record_id,x.build_type,x.build_date, x.project_id, x.subproject_id,x.object_id, x.object_node_type, x.install_object_id, x.install_node_type, x.type, x.local_code, a.name as device_name, a.code as device_code, a.current_status, a.status_date, f.code as func_code, f.name as func_name, n.full_path from am_asset a,am_function_location f, am_tech_object_node n, (select device_build_record_id, build_type,build_date, project_id, subproject_id, object_id, object_node_type,install_object_id, install_node_type, type, local_code from am_build_record where object_node_type = 2 and install_node_type = 1) x where f.function_location_id = x.install_object_id and a.device_id = x.object_id and n.tech_object_id(+) = a.device_id建立视图后，该视图是所有建设记录中涉及到的设备（已过滤掉已经不在设备表中存在的数据）和其对应的功能位置的相关信息。直接通过传入参数进行查询。1.1.12 台帐模板管理1.1.12.1 概述包路径：top.lcam.asset.masterdata.assetaccounttemplate.appservice.impl. AssetAccountTemplateBizService。提供台帐模板的新增、修改、删除、读取基本的CRUD方法和查询方法。1.1.12.2 业务逻辑设计1.1.12.2.1 AssetAccountTemplateBizService类名AssetAccountTemplateBizService说明台帐模板BizService依赖服务声明TechObjectNodeTemplateBizService、FunctionlocationTemplateBizService、SubstationTemplateBizService、LineTempalteBizService、AssetTemplateBizService、PartsTemplateBizService1.1.12.2.1.1 insertFunctionLocationTemplate方法insertFunctionLocationTemplate说明新增功能位置模板输入功能位置模板VO输出技术对象节点ID处理定义变量功能位置模板VOIf（psrType=变电站） 插入变电站信息位置模板VO.siteId = 变电站IDelse （psrType=线路） 插入线路信息位置模板VO.siteId = 线路ID调用insertCommonFunctionLocationTemplate（新增功能位置模板）方法，新增功能位置及技术对象模板节点，返回技术对象模板节点id1.1.12.2.1.2 insertAssetAccountTemplate方法insertAssetAccountTemplate说明新增台帐模板输入台帐模板VO输出台帐模板ID处理定义变量功能位置模板VO调用insertFunctionLocationTemplate，新增功能位置技术对象节点等并返回技术对象节点id将技术对象节点id赋给台帐模板VO，新增台帐模板1.1.12.2.1.3 deleteAssetAccountTemplate方法deleteAssetAccountTemplate说明删除台帐模板输入台帐模板id输出1删除成功，0删除失败处理根据台帐模板id读取台帐模板VO根据台帐模板vo的技术对象节点模板id，调用TechObjectNodeTemplateBizService的级联删除台帐模板方法删除台帐模板1.1.12.2.2 TechObjectNodeTemplateBizService类名TechObjectNodeTemplateBizService说明技术对象节点模板BizService依赖服务声明FunctionlocationTemplateBizService1.1.12.2.2.1 deleteTechObjectNodeCascade方法deleteTechObjectNodeCascade说明级联删除台帐模板输入技术对象模板节点ID输出删除成功返回1处理根据技术对象模板节点ID读取技术对象节点模板VO调用删除子节点方法deleteSubNodesIf（技术对象节点模板VO.nodeType = 功能位置） 根据技术对象节点模板VO.techObjectId读取功能位置模板VO 拼删除功能位置模板SQL If（功能位置模板VO.objectType=变电站） 拼删除变电站模板SQLelse if（功能位置模板VO.objectType=线路） 拼删除线路模板SQLelse if（技术对象节点模板VO.nodeType = 资产） 拼删除资产模板SQL else/部件模板 拼删除部件模板SQL拼删除技术对象节点模板SQL拼删除特征值SQL执行批量删除1.1.12.2.2.2 deleteSubNodes方法deleteSubNodes说明删除子节点（private方法）输入技术对象模板节点ID输出删除成功返回1处理If（技术对象模板节点ID 为空） return 0;1、根据技术对象模板节点ID查询该节点下的子功能位置技术对象模板节点list根据子功能位置技术对象模板节点list，拼子技术对象模板节点和子功能位置模板字符串2、根据技术对象模板节点ID查询该节点下的子设备技术对象模板节点list根据子设备技术对象模板节点list，拼子技术对象模板节点和子设备模板字符串3、根据技术对象模板节点ID查询该节点下的子部件技术对象模板节点list根据子部件技术对象模板节点list，拼子技术对象模板节点和子部件模板字符串4、if（子技术对象模板节点不为空） 签套调用deleteSubNodes（子技术对象模板节点）/存在子节点时，调用该方法本身删除子节点 拼删除子技术对象模板节点、功能位置模板、设备模板、部件模板、特征值SQLList If（子功能位置模板不为空） 拼删除变电站模板、线路模板SQLList5、批量删除，参数为SQLList注：SQLList是一个List，存放删除表的sql，删除的条件为主键= id1 or主键= id1，如，FUNCTION_LOCATION_ID = id1 or FUNCTION_LOCATION_ID = id22 工单管理修订记录版本修订说明作者审核审核日期V1.0新建单俊符曦2010-1-5所有权声明：深圳市康拓普信息技术有限公司版权所有 不得复制Copyright © 2009 by Shenzhen Comtop Information Technology Co., Ltd.2.1 概述包路径：top.lcam.asset.workorder.appservice.WorkOrderBizService.工作包：top.lcam.asset.workorder.appservice.StandardPackageBizService主要业务：工单执行列表查询，WorkOrderExecutingListAction调用WorkOrderBizService查询的执行中的工单（查询条件流程在该节点且该用户有权限查看的执行中工单）返回工单List，迭代工单List，查询工单的物料需求明细并调用RequirementBizService查询物料的状态（未申购、已申购、已到货等）。工单核算列表查询,WorkOrderBalanceListAction调用WorkOrderBizService的queryWorkOrderList方法（查询条件流程在该节点且该用户有权限查看的待核算工单）查询待核算的工单列表，得到工单List，迭代工单List，调用WorkOrderBizService查询工单服务需求，根据返回的服务需求list，调用ServiceContractBizService查询合同的付款状态。工单核算维护对象成本列表查询：工单关闭：2.1.1 业务逻辑设计2.1.1.1 WorkOrderBizService类名WorkOrderBizService说明AssetBizService、DeviceAccountBizService依赖服务声明2.1.1.1.1 generateAssetMaintainCost方法generateAssetMaintainCost说明工单关闭时生成工单维护对象的维护成本输入工单id输出处理1、 根据工单id，调用WorkOrderDAO的queryWorkOrderObject方法查询工单的维护对象及对象的维护成本：lstWorkOrderObject。2、 迭代lstWorkOrderObject（维护对象只能是功能位置、资产设备或其它资产）定义变量资产价值映射Map：mapAssetValue，资产价值总额：iTotalValueIf（工作对象是功能位置）调用DeviceAccountBizService的queryAssetByFunctionLocationId查询功能位置下的资产设备iTotalValue+= calculateAssetValue（）else 调用AssetBizService查询资产设备或者资产的资产信息mapAssetValue.put(资产id，资产价值)iTotalValue+=资产价值3、 调用apportionAssetCost()方法生成分摊和生成资产的维护成本2.1.1.1.2 calculateAssetValue方法calculateAssetValue说明计算资产价值输入资产设备列表：lstAsset，资产价值映射：Map mapAssetValue输出资产总价值处理定义变量资产总价值iTotalValue迭代lstAsset 调用AssetBizService查询资产设备对应的资产信息mapAssetValue.put(资产id，资产value)/迭代的该条记录的资产id和资产价值iTotalValue+=资产valuereturn iTotalValue2.1.1.1.3 apportionAssetCost方法apportionAssetCost说明分摊和生成资产的维护成本输入资产和资产价值映射map：mapAssetValue，服务总成本：totalServiceCost，材料总成本：totalmaterialCost，总资产价值：totalVlaue，工单id输出处理遍历mapAssetValue 得到该记录的资产id和资产value 插入资产维护成本数据，即该资产id在该工单的维护成本的维护成本 查询工单是否存在该资产的维护成本信息 If（工单已存在该资产的维护成本） 修改该条记录的维护费用，材料费=原值+ (totalmaterialCost *(资产价值/ totalVlaue)服务费=原值+ (totalServiceCost *(资产价值/ totalVlaue)else材料费= totalmaterialCost *(资产价值/ totalVlaue)服务费= totalServiceCost *(资产价值/ totalVlaue) 新增一条资产维护成本记录，values（资产id，工单id，材料费，服务费）2.1.1.1.4 insertWorkObject方法insertWorkObject说明插入工单工作对象输入工作对象列表lstWorkObject输出处理迭代lstWorkObject If（当前结点设备但是是非资产设备） Continue;else if(当前结点是功能位置) 插入工作维护对象，工作维护对象类型为0（功能位置）else if(当前结点是资产设备) 插入工作维护对象，工作维护对象类型为1（资产设备） else)/资产 插入工作维护对象，工作维护对象类型为2（资产）2.1.1.1.5 queryBalanceStatus方法queryBalanceStatus说明查询工单的核算状态输入工单id输出工单核算状态(1,核算已完成；0核算未完成)处理ReadWorkorder得到workorderVO调用ProjectInfoBizService. readProject参数 workorderVO.projectId得到项目状态2.1.1.1.6 batchUpdateWorkorderMaterial方法batchUpdateWorkorderMaterial说明从标准物料导入物料输入标准物料数组id：standardMaterialId；工单VO：workorderVO输出导入标准物料数量处理定义新增工单物料列表：lstinsertWorkorderMaterialVO定义更新工单物料列表：lstupdateWorkorderMaterialVO循环遍历数组standardMaterialId调用standardPackageBizService.readStandardMaterial查询标准物料，参数当前标准物料明细id，得到标准物料VO，查询该工单是否已存在该类型物料If 存在 获得标准物料数量，将该类型物料插入lstupdateWorkorderMaterialVOElse 将该类型物料插入lstinsertWorkorderMaterialVOIf lstinsertWorkorderMaterialVO 不为空 批量插入工单物料If lstupdateWorkorderMaterialVO不为空 批量更新工单物料2.1.1.1.7 batchUpdateWorkorderService方法batchUpdateWorkorderService说明导入标准服务输入标准服务数组id：serviceId；工单VO：workorderVO输出导入标准服务数量处理定义新增工单服务列表：lstinsertWorkorderServiceVO定义更新工单服务列表：lstupdateWorkorderServiceVO循环遍历数组serviceId调用standardPackageBizService. readStandardService查询标准服务，参数当前标准服务明细id，得到标准服务VO，查询该工单是否已存在该类型服务If 存在 获得标准服务工时，将该类型服务插入lstupdateWorkorderServiceVOElse 将该类型服务工时插入lstinsertWorkorderServiceVOIf lstinsertWorkorderServiceVO不为空 批量插入工单服务If lstupdateWorkorderServiceVO不为空 批量更新工单服务2.1.1.2 WorkOrderDAO类名WorkOrderDAO说明依赖服务声明2.1.1.2.1 queryWorkOrderList方法queryWorkOrderList说明查询工单列表输入查询条件List输出符合查询条件的工单处理SELECT PROD_WORKORDER .* FROM PROD_WORKORDER, WFT_FLOWCONTROLWhere WFT_FLOWCONTROL.WORKID = PROD_WORKORDER.WORKORDER_ID AND PROD_WORKORDER.FLOW_STATE = ?AND WFT_FLOWCONTROL.WORKFLOWID = ? AND WFT_FLOWCONTROL.TRANSACTORID= ? AND WFT_FLOWCONTROL.TRANSFLAG=3 输网资产变更管理修订记录版本说明作者批准批准日期V1.0新建赵敏全符曦2010-1-8所有权声明：深圳市康拓普信息技术有限公司版权所有 不得复制Copyright © 2009 by Shenzhen Comtop Information Technology Co., Ltd.3.1 资产变更3.1.1 概述包路径：top.lcam.asset.assetchange.Bizservice.impl.AssetChangeBillBizService3.1.2 业务逻辑设计3.1.2.1 AssetChangeBillBizService类名AssetChangeBillBizService说明输网资产变更依赖服务声明WorkspaceBizService3.1.2.2 insertAssetChangeBill方法insertAssetChangeBill说明生成资产增加/减少申请单输入变更记录，资产变更类型输出String （” 表示不成功、新技术节点 表示操作成功）处理1 调用AssetChangeBizService资产增加/减少申请单新增方法2 返回资产增加/减少申请单3.1.2.3 appendAssetChangeBillDeatil方法appendAssetChangeBillDetail说明追加一条变更记录到已有的资产增加/减少申请单中输入变更记录，资产变更类型输出String （” 表示不成功、新技术节点 表示操作成功）处理1 调用AssetChangeBizService资产增加/减少申请单新增方法2 返回资产增加/减少申请单3.1.2.4 queryWorkspaceList方法queryWorkspaceList说明查询工作区列表（包括变更内容信息）输入变更输出工作区list处理根据变更查找出所有工作区，再根据工作区分别查找出自己变更区下面的变更内容（需区分新增、删除和修改）数量：SELECT CHANGE_CONTENT_TYPE,TECH_OBJECT_NODE_ID,COUNT(1) 变更内容数量 FROM AM_CHANGE_RECORD RWHERE R.CHANGE_ID=变更GROUP BY CHANGE_CONTENT_TYPE,TECH_OBJECT_NODE_ID3.1.2.5 insertWorkspace方法insertWorkspace说明新增变更工作区输入工作区技术节点输出String （” 表示不成功、新节点 表示操作成功）处理1 根据选择的技术节点调用TechObjectNodeBizService读取方法得到TechObjectNodeVO;2 调用TechObjectNodeDAO的方法readFullPathByNodeI