组件设计文档-MBOM构型管理

Confidential-PTCProprietaryFILENAMEComponentDesignDocument.docLastprintedPRINTDATE\@"MMM/dd/yyyy"May/08/2008|PagePAGE29ofNUMPAGES31ComponentDesignDocument组件设计文档－MBOM构型管理珠海通用飞机工业集团有限责任公司珠海

DocumentPropertiesFileNameStatus组件设计文档－MBOM构型管理第1稿ChangeHistoryDateAuthorVersionDescription2014/05/20梁海林0.1初稿ApproversApproverApprovalDateComments

目录1. 介绍 51.1. 目标 51.2. 范围 51.3. 文档概要 51.4. 标准 52. 组件概要 52.1. 背景 52.2. 设计概要 53. 设计 63.1. 包结构 63.1.1. 实现技术 73.1.2. 显示处理 73.2. 对象存储位置 73.3. 对象模型 73.3.1. AO件 73.3.2. FO件 83.3.3. AO文档 93.3.4. FO文档 103.3.5. WTGroup 113.4. 参装件与AO/FO文档关系表 113.5. MBOM顶层导入 123.5.1. 功能描述 123.5.2. 入口界面 123.5.3. MBOM导入模板 123.5.4. 导入界面 133.5.5. 页面Action 133.6. AO/FO导入 143.6.1. 功能描述 143.6.2. 入口界面 143.6.3. 导入模板 143.6.4. 导入界面 153.6.5. 页面Action 153.7. AO/FO分工 163.7.1. 入口菜单 163.7.2. 界面 173.7.3. 界面Action 183.8. AO/FO编制 203.8.1. 入口界面 203.8.2. 编制界面 203.8.3. 页面Action与查询逻辑 213.9. CAPP系统集成 243.9.1. CAPP调用PDM接口 243.9.2. PDM调用CAPP接口 243.10. MBOM查询 243.10.1. 入口界面 243.10.2. 查询界面 243.10.3. 页面Action与逻辑 263.11. 参装件反查AO文档 273.11.1. 入口界面 273.11.2. 查询界面 273.11.3. 页面Action与逻辑 273.12. AO文档审批流程 283.13. FO文档审批流程 294. 单元测试 295. 维护和升级 296. 风险 296.1. 技术风险 296.2. 不确定因素 296.3. 遗留问题 29

Overview概要本文档包括EBOM构型管理的详细设计信息。此组件的开发工作将基于本文档进行。介绍目标本文档描述了EBOM构型管理组件的详细设计。开发本组件将按照此文档的要求进行。范围GAC的EBOM构型管理相关功能。文档概要第2节提供了概要设计说明。第3节描述了设计细节信息。第4节给出了单元测试。第5节是本组件在升级和维护需要考虑的内容。第6节是风险分析。标准N/A组件概要背景通飞设计平台VPM中管理机型设计中的所有数模信息，所有的EBOM顶层结构、设计数模、EO更改等信息均需要通过数据接口发送到PDM系统中。设计概要EBOM构型管理主要包含如下内容：数据接收自动同步VPM系统中的顶层件结构首次承接VCI/LCI组件的EBOM数据数据接收EBOM结构搭建R模型数据处理EO更改信息接收零组件EO（新增、换版、临时更改）有效性更改EOR模型更改EO数据接收单管理EBOM构型管理EBOM查询EBOM下载EO更改贯彻EO更改贯彻流程设计包结构Java类的包结构：WT_HOME/codebase/ext/gac/ebom；WT_HOME/codebase/ext/gac/pbom；WT_HOME/codebase/ext/gac/mbom；WT_HOME/codebase/ext/gac/aofoJSP页面的包结构：WT_HOME/codebase/netmarkets/jsp/ext/gac/ebom；WT_HOME/codebase/netmarkets/jsp/ext/gac/pbom；WT_HOME/codebase/netmarkets/jsp/ext/gac/mbom；WT_HOME/codebase/netmarkets/jsp/ext/gac/aofoTASKS的包结构：WT_HOME/tasks/ext/gac/ebom；WT_HOME/tasks/ext/gac/pbom；WT_HOME/tasks/ext/gac/mbom；WT_HOME/tasks/ext/gac/aofo实现技术基于10.2M010客制化技术实现显示处理定制的用户界面的外观、字体、颜色要求与OOTB的Windchill10.2M010系统界面风格统一。对象存储位置如下描述了系统对象及其存储位置。资料夹结构说明TA600产品库/Default

设计数据第一层

零部件E视图零部件、数模

工程更改指令存储EO

工程更改建议存储ECP临时更改单存储临改单

数据接收单存储数据接收单

顶层数据接收单

存储顶层数据接收单

工艺数据第一层

零部件存储P视图零部件

AO存储AO文档、AO件

FO存储FO文档、FO件

制造数据第一层

零部件存储M视图零部件

技术文件

类型1

类型2

现场单据

协调单对象模型软类型、生命周期、工作流程、对象初始化规则等全部定义在站点下。AO件类型定义类型显示名WTPart|AOPartAO件生命周期caiga部件生命周期软属性定义AttributeNameDisplayNameType说明PartNumber零组件图号String单行belongDeptDepartment所属车间String单行GongWei所属工位/专业String单行DP_PartVersion_C1Responsible负责人String单行格式：张三(zhangsan);李四(GA10032)对象初始化规则手工编号FO件类型定义类型显示名WTPart|FOPartFO件生命周期caiga部件生命周期软属性定义AttributeNameDisplayNameType说明PartNumber零组件图号String单行belongDeptDepartment所属车间String单行GongWei所属工位/专业String单行DP_PartVersion_C1Responsible负责人String单行格式：张三(zhangsan);李四(GA10032)对象初始化规则手工编号AO文档类型定义类型显示名WTDocument|AODocAO文档生命周期AO文档生命周期序号状态内部值是否定制说明关联流程1正在工作InWork否可以设置到其他任意状态无2重新工作ReWork否可以设置到正在审阅、已发布、已作废状态无3正在审阅UnderReview否可以设置到已发布、已作废状态无4已发布Released否可以设置到已作废状态升版后进入到【正在工作】状态无5已废弃Obsoleted否预留状态，表明废弃无软属性定义AttributeNameDisplayNameType说明PartNumber零组件图号String单行belongDeptDepartment所属车间String单行GongWei所属工位/专业String单行DP_MaitanLevelEffective有效性String单行CompleteDate完成时间String格式：yyyy-MM-DDhh:mm:ssDetailType类型String单行，值：关键AO、一般AO…..其他属性待与CAPP确认对象初始化规则手工编号FO文档类型定义类型显示名WTDocument|FODocFO文档生命周期FO文档生命周期序号状态内部值是否定制说明关联流程1正在工作InWork否可以设置到其他任意状态无2重新工作ReWork否可以设置到正在审阅、已发布、已作废状态无3正在审阅UnderReview否可以设置到已发布、已作废状态无4已发布Released否可以设置到已作废状态升版后进入到【正在工作】状态无5已废弃Obsoleted否预留状态，表明废弃无软属性定义AttributeNameDisplayNameType说明PartNumber零组件图号String单行belongDeptDepartment所属车间String单行GongWei所属工位/专业String单行DP_MaitanLevelEffective有效性String单行CompleteDate完成时间String单行格式：yyyy-MM-DDhh:mm:ssDetailType类型String单行值：关键FO、一般FO…..其他属性待与CAPP确认对象初始化规则手工编号WTGroup序号组名说明1产品数据组数据接收、工艺分工参装件与AO/FO文档关系表在PDM系统中建立模型文件AOFOReferencePart.java（继承WTObject）序号属性类型显示值说明1docNumberStringAO/FO编号2versionString大版本号AOFO文档大版本号3docTypeString类型AODoc、FODOc4RefPartNumberString参装件号P视图部件编号5RefPartVersionString参装件版本P视图部件版本MBOM顶层导入功能描述通过导入Excel模板的方式实现生成MBOM的顶层结构入口界面入口：导航菜单MBOM构型管理的操作菜单中权限：只有[产品数据组]成员或系统管理员组（Administrators）成员可见MBOM导入模板MBOM顶层导入模板SVN存储位置：codebase/ext/template/MBOMImportTemplate.xls导入界面页面Action序号操作类型操作说明1模板下载链接点击后下载MBOM顶层模板(空模板，存在服务器本地)Codebase/ext/template/2型号下拉菜单查询系统中所有成品,做成下拉菜单.将查找到的第一个作为默认值.(成品编号作为显示值以及内部值)3MBOM顶层导入文件文件选择框用户点击浏览后,选择本地文件.(Excel文件)4校验按钮执行校验:如果MBOM顶层导入文件没有填写,提示用户选择MBOM顶层导入文件(Excel)如果型号没有选择，则提示用户选择型号。上传MBOM顶层导入文件到PDM服务器临时目录Codebase/ext/gac/mbom/tmp/(如果目录不存在，则自动创建)读取Excel表,分析数据,对数据进行校验如果编号填写,则名称和上级件号必须填写(除当前选择的型号外)BOM关系不能循环调用，否则提示错误。如果校验成功：提示用户校验成功如果校验失败：提示用户校验错误的信息。5导入按钮执行数据校验（参考校验按钮操作），如果校验有错误，则提示用户错误信息。如果校验没有错误，则执行MBOM顶层导入按照Excel中的部件描述，如果零组件不存在，直接创建零部件（编号、名称、零组件图号（IBA）、所属车间（IBA），视图为Manufacturing），如果存在，不创建、不更新存储位置见3.2章节。（部件创建者、更新者为当前用户，忽略权限）建立MBOM结构按照填写的父件号（M视图）建立BOM结构（WTPartUsageLink）AO/FO导入功能描述通过文件导入方式，实现批量导入AO/FO（部件）功能入口界面入口：【MBOM构型】导航菜单中显示链接【AO/FO导入】权限：各中心（装配、试飞、复材、交付）负责人可见（管理员组成员也可见）获取当前用户所在的所有组，如果组名以”_负责人”结尾，则中心名称即为组名在“_”之前部分。参考EO贯彻中获取中心负责人功能。导入模板AO/FO导入模板SVN存储位置：codebase/ext/template/AOImportTemplate.xls导入界面页面Action序号操作类型操作说明1模板下载链接点击后下载AO/FO导入模板(空模板，存在服务器本地)Codebase/ext/template/2型号下拉菜单查询系统中所有成品,做成下拉菜单.将查找到的第一个作为默认值.(成品编号作为显示值以及内部值)3AO/FO导入文件文件选择框用户点击浏览后,选择本地文件.(Excel文件)4校验按钮执行校验:如果AO/FO导入文件没有填写,提示用户选择导入文件(Excel)如果型号没有选择，则提示用户选择型号。上传导入文件到PDM服务器临时目录Codebase/ext/gac/mbom/tmp/(如果目录不存在，则自动创建)读取Excel表,分析数据,对数据进行校验a.如果编号填写,则名称、类型、所属工位/专业、所属车间必须填写。b.类型不能为空，且值必须为AO或FO，其他值提示用户错误。c.所属工位对应的零部件必须存在（件号=输入的工位号，视图为M）d.如果填写了零组件图号，则图号必须存在（P视图部件），否则提示错误。e.任意两行的编号不能重复，如果重复提示用户错误。f.不允许出现循环引用BOM的情况。g.车间值验证：CSCProperties中新增属性ext.gac.mbom.departmentLists=车间1;车间2；车间3ext.gac.mbom.departmentCodes=车间代号1；车间代号2；车间代号3如果用户输入的车间值在departmentCodes中，则通过，否则提示用户车间值输入错误。h.如果编号为空，忽略整行。i.如果所输入编号对应的零部件已经存在，则提示警告信息。（非错误）如果校验成功：提示用户校验成功如果校验失败：提示用户校验错误或警告的信息。5导入按钮执行数据校验（参考校验按钮操作），如果校验有错误，则提示用户错误信息和警告信息，如果没有错误，只有警告信息，继续执行导入，并提示用户警告信息：如果校验没有错误，则逐行处理执行导入：按照Excel中的部件描述，如果零组件不存在，直接创建零部件（编号、名称、零组件图号（IBA）、所属车间（IBA）、工位/专业（IBA），视图为Manufacturing）按照类型设置部件类型（AO件、FO件），如果存在，不创建、不更新存储位置见3.2章节。（部件创建者、更新者为当前用户，忽略权限）如果零部件不存在（导入时需要新建的行），建立BOM结构将AO、FO件挂在填写的工位/专业零件下，建立BOM结构（WTPartUsageLink），如果零部件在导入前已经存在不更新BOM结构。导入成功后，提示用户导入成功，如果失败，提示错误信息AO/FO分工入口菜单菜单：MBOM构型管理菜单中，显示AO/FO分工权限：华南公司各中心负责人显示，其他角色不显示在CSCProperties中读取属性ext.gac.mbom.departmentLists=装配中心;交付中心;试飞中心;复材中心如果当前用户在任意装配中心_负责人、交付中心_负责人、试飞中心_负责人、复材中心负责人组中则显示。（department+“_负责人”组成员可见），系统管理员组成员可见，其他人员不可见界面点击【修改编制人员】链接时显示如下页面：界面Action过滤条件序号操作类型操作说明1机型产品下拉框查询系统中所有成品,做成下拉菜单.将查找到的第一个作为默认值.(成品编号作为显示值以及内部值)2AO/FO编号输入框根据编号查询、允许模糊查询AO/FO名称输入框根据名称查询、允许模糊查询3工位/专业下拉框按照中心代码(页面中获取的)查找零部件（编号、M视图），查找到后列出此部件的第一层子件（编号）作为工位/专业的内部值与显示值。默认为空注：此值对应着AO件与FO件的父件号4类型下拉框AO、FO默认为空、必选如果选AO，查找AO件类型部件如果选FO，查找FO件类型部件5对应零组件号文本框对应AO件、FO件的软属性：零组件号6查询按钮点击后按照所选条件过滤以中心代码为编号的零部件（机型产品所在容器内）下挂接的AO件或FO件。如果填写了工位，则只过滤该工位下的AO件及FO件，显示查询结果新建AO/FO件序号操作类型操作说明1机型产品下拉框查询系统中所有成品,做成下拉菜单.将查找到的第一个作为默认值.(成品编号作为显示值以及内部值)必选项2华南公司中心显示文本根据当前用户所在的组进行判断。查询该用户所在所有的组，如果组名如”XXX_负责人”组，那么取改组名“_”前的字符作为中心的值（设置隐藏值，中心名称、中心代码）ext.gac.mbom.departmentLists=装配中心;交付中心;试飞中心;复材中心ext.gac.mbom.departmentCodes=代号1;代号2;代号3;代号4根据中心在departmentLists中的位置，从departmentCodes取得其相应的代号。3工位/专业下拉框按照中心代码(上一步中获取)查找零部件（编号、M视图），查找到后列出此部件的第一层子件（编号）作为工位/专业的内部值与显示值。默认为空、必选项此值对应着AO件与FO件的父件号4类型下拉框AO、FO默认为空、必选项如果选AO，查找AO件类型部件如果选FO，查找FO件类型部件5对应零组件号文本框对应AO件、FO件的软属性：零组件号可选项6华南公司中心代号文本框默认值为中心代号，用户不可以修改。对应所属车间软属性。7创建按钮点击后验证必填项是否填写，如果没有填写提示输入XXX。如果填写了对应零组件图号，则图号对应的P视图的零部件必须存在，否则提示错误。验证通过后，在系统中查找所输入编号的零件是否存在，如果不存在则创建AO/FO件号（M视图），设置IBA属性（工位/专业代号、对应零组件图号、所属车间），然后将该AO/FO件作为子件挂在所选工位/专业件号BOM结构下（WTPartUsageLink）。如果存在则提示用户该AO/FO件号已经存在。采用ajax执行创建过程，创建成功后提示用户AO/FO件号已经创建。查询结果点击【查询】时刷新此table结果。序号操作类型操作说明1编号查询到的零部件的编号（AO件、FO件），显示为链接2名称查询到的零部件的名称（AO件、FO件）3版本查询到的零部件的版本（AO件、FO件）4类型查询到的零部件的类型（AO件、FO件）5所属工位/专业代号查询到的零部件的软属性值：所属车间6华南公司中心代号查询到的零部件的软属性值：所属车间7编制人员查询到的零部件的软属性值：负责人8操作显示为链接“修改编制人员”，点击后弹出如下页面：标题根据当前的中心名称设置人员列表从组中获取，组名：中心名称+”_”+工艺员，如组：装配中心_工艺员初始值时从当前行的零部件号(AO件、FO件)的软属性中（负责人）获取已选择编制人员值（值格式：张三(GA00130);李四(GA00131),需对其进行拆分）点击确定后按照用户勾选的用户进行保存，更新对应件号的软属性“负责人”的值，格式为：用户全名(用户登陆名)，多个用户采用应为分号”;”进行分割。保存成功后，刷新表格中的行数据（编制人员列）AO/FO编制入口界面编制界面页面Action与查询逻辑序号操作类型操作说明1机型产品下拉查询系统中所有成品,做成下拉菜单.将查找到的第一个作为默认值.(成品编号作为显示值以及内部值)必填项2类型下拉AO、FO，默认为空表示查询AO和FO3状态下拉编制、正在审阅、重新工作、已发布、已废弃，默认为空（对应AO/FO文档的生命周期状态）4AO/FO编号输入框AO件、FO件的编号5只过滤个人AO/FOCheckbox默认为选中、如果取消勾选，表示查询该中心下所有AO/FO6开始过滤按钮查询过滤，显示查询结果。GetRoot：首先获取当前用户所属中心，方法为获取该用户所有所在组，如果组名为XXXX_工艺员，则XXXX即为该用户所在中心的名称。通过CSCProperties获取中心的code值（对应的departmentCodes值），然后查找与此code值同编号的WTPart（M视图），此零部件即为该中心在MBOM中的Part节点，如果此部件不存在则没有返回结果，如果有则执行如下操作：根据用户输入的条件查询该中心在MBOM中的Part节点下所有的AO件和FO件（按照FO/AO编号、类型筛选），不按照状态进行过滤。（AO件与FO件的containerName与型号的containerName相同），得到的值即为根节点（AO件、FO件）如果选择了只过滤本人AO/FO，则获取当前用户名（登陆名），查询AO件或FO件的软属性【负责人】的值like‘(‘+登录名+‘)’的件号作为根节点，负责人的值格式为：张三(GA10030);李四(GA10031)，参考AO/FO分工。GetNodes：如果当前所点击父项为AO件或FO件，则查找AO件或FO件对应的WTPartDescribeLink中的WTDocument（AO、FO文档）最新版本，如果用户填写了状态，查找子节点时，如果子节点是AO文档或FO文档，需要按照状态过滤AO文档或FO文档。如果当前所点击父项为AO文档，则查找参装件表中此版本AO文档对应的参装件号作为子节点（参装件子节点需要查找对应的WTPart（P视图））（注：FO文档不查询参装件号）如果当前所点击父项为参装件或FO文档（除上述两种类型外可以认为是参装件），没有子节点展示。查询显示：7编号链接AO件、FO件、AO文档、FO文档的编号、参装件的编号显示为链接8名称文本AO件、FO件、AO文档、FO文档、参装件名称9版本文本对象版本10类型文本如果是部件显示部件类型，如果是AO/FO文档显示软属性【类型】的值11零件图号文本软属性【零组件图号】12所属工位/专业链接软属性【所属工位/专业】13所属车间文本软属性【所属车间】14状态文本对象的生命周期状态15有效性文本软属性【有效性】16负责人文本如果为AO件或FO件，则为其软属性【负责人】如果为AO文档或FO文档，则为其创建者全名其他类型对象为空17完成时间文本软属性【完成时间】18选择AO/FO类型下拉框在CSCProperties中新增配置属性ext.gac.AOType=原始AO;生产AO;质量AO;AAOext.gac.AOType=原始FO;生产FO;质量FO读取这个配置属性，并使用英文分号“;”进行分割，按照对象类型为AO件还是FO件分别读取配置属性进行展示。默认为空，只有当前对象为AO件或FO件时才显示，其他类型对象均显示空值。19操作链接操作列中显示菜单的前提条件（针对如下1、2的情况）。仅当当前登录用户是AO件或FO件软属性【负责人】判断：【负责人】like‘(’+CurrentUser.getName()+’)’如果当前对象是AO件或FO件，显示【创建】链接如果是AO文档或FO文档如果为编制状态，显示【修改】【提交签审】（如果没有关联正在工作中的工作流程才显示提交签审）链接如果为已发布状态，显示【修订】链接如果为重新工作状态，显示【修改】链接其他类型对象没有链接显示20创建链接点击创建链接后，首先判断本行的AO/FO类型是否选择，如果没有选择，提示用户选择类型，如果选择了类型，则执行如下脚本：Window.open(‘第三方协议名称://<action>新建</action><type>AO或FO</type><number>编号</number><GongWei>所属工位专业</GongWei><Department>所属车间</Department><DetailType>选择的AO/FO类型</DetailType>’);其中：第三方协议名称为CSCProperties中的配置属性ext.gac.capp.3rdPartyProtocol=capp该方法使用src/ext/gac/capp/CAPPIntegrationUtil.java中的getCAPPProtocolURL（WTpart，”创建”）方法（以上传到SVN中）。21修改链接Window.open(‘第三方协议名称://xml参数’);其中：第三方协议名称为CSCProperties中的配置属性ext.gac.capp.3rdPartyProtocol=capp该方法使用src/ext/gac/capp/CAPPIntegrationUtil.java中的getCAPPProtocolURL（WTDocument,”修改”）方法（以上传到SVN中）。22提交签审链接只有当前AO文档或FO文档为编制（InWork）状态时显示，并且AO文档或FO文档没有处于非已关闭的工作流程。点击后，将该行的文档（AO文档、FO文档）启动相应的签审流程，如果成功，提示用户“签审流程启动成功”，然后刷新页面table中的行数据。（提交审签链接应该消失）入口二：此链接功能在AO文档或FO文档的操作菜单中也存在：23修订链接点击后，将该行的文档（AO文档、FO文档）升版，并复制相应的软属性及使用到的参装件号（参装件与AO对应表）、同时设置软属性【完成时间】的值为空，成功后提示用户成功，并刷新该条数据。（刷新后状态为编制，应该显示“修改”及“提交审签”按钮）。CAPP系统集成待完成CAPP调用PDM接口PDM调用CAPP接口MBOM查询入口界面查询界面页面Action与逻辑序号操作类型操作说明1机型产品下拉菜单查询系统中所有成品,做成下拉菜单.将查找到的第一个作为默认值.(成品编号作为显示值以及内部值)必选项2批架次号输入框只能输入1-9999的自然数.非必填项3Part编号输入框对应M视图零部件必填项。精确查找。4工位/专业视图按钮GetRoot方法:根据用户输入的Part编号查询系统中对应的M视图零部件，如果存在即为根节点。GetNodes方法:如果当前父项为WTPart（非AO件及FO件）则查找该Part的BOM结构中所有第一层子件作为子节点（不包括FO件）如果当前父项为AO件，则查找AO件对应的AO文档（WTPartDescribeLink），如果用户输入了批架次，则按照批架次过滤，符合批架次条件的AO文档才显示。如果当前父项为AO文档，则查找AO文档的参装件（参装件与AO/FO关系表，P视图部件）作为子节点如果当前父项为参装件，则查找该参装件对应的FO件（参装件与FO关系表）如果当前父项为FO件，则查找FO关联的FO文档（WTPartDescribeLink），如果用户输入了批架次，则按照批架次过滤，符合批架次条件的FO文档才显示。如果当前父项为FO文档，则没有子节点。5关系视图按钮GetRoot方法：根据用户输入的Part编号查询系统中对应的M视图零部件，如果存在即为根节点。GetNodes方法:如果当前父项为WTPart（非AO件及FO件）则查找该Part的BOM结构中所有第一层子件作为子节点（不包括FO件），如果子节点为AO件，则判断AO件对应的AO文档的软属性【下一级AO文档】（父件）为空或不存在（文档号不存在）则显示为子节点，否则不显示如果当前父项为AO件，则查找AO件对应的AO文档（WTPartDescribeLink），如果用户输入了批架次，则按照批架次过滤，符合批架次条件的AO文档才显示为子节点，再查询下级AO件，方法为：查找系统中所有的AO文档并且AO文档的软属性【下一级AO文档】为当前AO件对应的AO文档号，如果查到结果，则将查到的AO文档对应的AO件作为子节点显示。如果没有结果，则不展示。如果当前父项为AO文档，则查询AO文档对应的参装件（参装件与AO关系表）如果当前父项为参装件（视图为P视图的部件），则查找该部件对应的FO件（FO文档与参装件关系表，表中记录的是FO文档，需要通过FO文档查找FO件）如果当前父项为FO件，则查找FO件对应的FO文档。参装件反查AO文档入口界面查询界面页面Action与逻辑序号操作类型操作说明1机型产品