论文部分内容阅读
摘要：介绍基于Windchill的船舶并行协同设计中文档管理系统功能开发与实现，包括文档提交页面的定制方法和过程、文档审签、文档的拟制与提交、以及文档的组织存储等，使Windchill文档管理系统更适合船舶并行协同设计的要求。
关键字：船舶并行协同设计、文档管理系统、Windchill二次开发、elipse
Abstract:The function and implement of parallel collaborative design document management system of naval based on Windchill was introduced, including the customization method and process of document submit page,document approval process,the establishment and submit, and the storage of document and so on ,this idea makes the document management system more suitable for the requirement of naval parallel collaborative design.
Key words:Naval parallel collaborative design;Document management system;The secondary development of Windchill; elipse
0 引言
在基于PDM的船舶并行协同设计过程中将产生大量的各类设计文档。文档是指船舶设计项目执行过程中产生的任何电子文件的总称，一个文档不等于一个电子文件，它是用来组织电子文件的，表明这些电子文件是谁拟制的，是什么类型的文件，这些电子文件需要谁审批[1]。
1 船舶设计文档的属性
为了便于船舶设计过程中产生的文档的管理和系统的简化，根据面向对象的思想，抽象出各类文档的共性[2]，即文档的属性：
2 船舶文档的类型及船舶设计文档所属各部门类型的定制
船舶研制评估过程中会产生大量的文档，根据文档的类型和性质，可将其分为任务书、论证报告、说明书、计算书、二维图纸文件、三维图形文件等。默认情况下Windchill软件中文档的类型及部门类型军不符合要求，因此我们根据需要来对文档类型进行更改。
在对windchill软件的二次开发过程中，.rbInfo文件分两种：一种是用于下拉列表的，如零部件类型、来源、生命周期状态、角色等，这种用windchillin下的enumCustomize.bat工具来更新。一种是用于显示的，如编号、名称这些显示，这些可以手工更改，然后需要编译生成class文件覆盖系统的相应文件才会生效。对这些文件需要通过resourcebuild命令进行编译，并用Ant –f makejar.xml工具更新codebase下对应的class文件。然后用java wt.tools.boot.MakeJar jar=wt.jar命令建立WT.JAR文件。这样重新打开Windchill时，系统将自动调用新生成的jar文件[3]。
（1）在WindchillsrcwtdocDocumentTypeRB_zh_CN.rbinfo内添加下面代码：
$$TaskBook.value=任务书
$$DemonstrateDocument.value=论证报告
$$2DDocument.value=2D文档
$$3DDocument.value=3D文档
在WindchillsrcwtdocDepartmentListRB_zh_CN.rbinfo内添加下面代码：
HULL.value=船体
ENGINE.value=轮机
ELECTRONIC.value=电气
TOTAL.value=总体
STRUCTURE.value=结构
OUTFIT.value=舾装
（2）在Windchill外壳程序中进入编译后生成文件的路径，例如：cdcodebase。然后执行enumCustomize命令。
（3）在Enumerated type Customization Utility界面中的Enumerated Type项选择$:ptcWindchillcodebasewtdoc中相对应的.RB.ser文件,在Locale下拉菜单中选择zh_CN,点击Save.会弹出一个对话框选择Continue编译文件,显示编译成功,编译完成后会在Windchill系统目录$:ptcWindchillcodebasewtdoc文件夹中生成新的.RB.ser文件。
（4）在外壳程序中执行下面命令行:cd codebase
Ant –f makejar.xml
重新启动Windchill Method Server，文档类型和部门类型的定制即完成。
3 添加属性“图号”及更改创建文档页面文字
Windchill软件中页面上包含的中文字是通过对相应的.rbinfo文件进行编译生成对应的.class文件，进而将汉字编译成Unicode代码，在相关的html页面上通过windchill scrip语言调用相应的class，从而将中文字显示在网页上，实现Windchill二次开发。
（1）在srcext
eidoc下创建一名为docResource.java的类。
（2）在elipse中创建工程,将上面的docResource.java文件加入工程，点击Project—Properties将java文件中涉及到的类以jar包的形式导入工程，将docResource.java文件编译成class文件。并将该class文件放置在codebaseext
eidoc下。
（3）将Widchillcodebase emplatesdoc目录下的CreateWTDocumentGeneralTab_zh_CN
.html中头文件对docRB.class文件的引用更改为对docResource.class文件的引用。
（4）重新启动Windchill软件。
4 文档的拟制与提交
用文档拟制工具（Office,AutoCAD,Pro/ENGINEER等）拟制项目相关的电子文件。进入PDM系统，在个人文件柜下建立一个文档对象，填入上图中需要手工填写的属性。把上面产生的电子文件作为主要文件加入到该文档的主要内容的文件栏位中，然后提交，把新建的文档从个人文件柜中检入到项目共享文件柜的相应目录中，完成该电子文档的提交。
5 文档的审签过程
船舶设计建造过程中的文档需要经历设计、校对、审核、标检、审定五个阶段才能归档。
在审签工作流模板中，存在审阅批准和不批准两种情况，此时要在属性中加入路由条件，这里通过代码实现，其代码如下：
java.util.Vector vect=wt.lifecycle.LifeCycleHelper.service.getSignatures((wt.lifecycle.LifeCycleManaged)primaryBusinessObject);
java.util.Enumeration enum = vect.elements();
wt.lifecycle.LifeCycleSignature sig=null;
while (enum.hasMoreElements()){
sig = (wt.lifecycle.LifeCycleSignature) enum.nextElement();
}
if(sig.isVote())
result="批准";
else
result="不批准";
对于处于审核状态以下的文档，其修改过程如下：选择需要修改的文档属性页执行检出操作，系统会把该文档检出到修改者的个人文件柜的/Check Out子目录下，并显示是否要打开或下载内容文件提示供用户选择。选择下载文件，对该内容文件进行修改后保存。
进入个人文件柜的/Check Out子目录下，点击需要上面检出的文档，在其属性页中点击检入链接，系统提示正在检入文档并弹出需要附上内容文件对话框。把修改完成的内容文件加入到该对话框，选择OK按钮，显示修改完成的文档，版本信息从A.1变成A.2，修改过程完成。
对已经达到审定状态的文档进行修改，则需要履行设计变更过程，在PDM系统中需要记录设计变更请求、设计变更通知，记录设计变更活动是否执行，文档修改后还需要执行审核审批流程[4][5]。
6 结论
通过船舶文档管理系统的设计及实现，免去了一线人员拿着图纸到处跑的无效劳动，同时也可以很好的维护文档数据在传递过程中的一致性，从而显著提高船舶设计工作的效率。
参考文献：
[1]庞士宗，肖平阳，唐加福. 产品数据管理（PDM）—现代企业信息化管理与集成的理想平台. 北京：机械工业出版社，2001.20
[2]范文慧，李涛，熊光楞等. 产品数据管理的原理与实施. 北京：机械工业出版社，2004.6 [3] (美)John Zukowski著. Java 2(J2SE 1.4版)从入门到精通，邱仲潘译. 北京：电子工业出版社，2002
[3] (美)Herbert Schildt著. Java2参考大全，张玉清等译. 北京：清华大学出版社，2002
[4] PTC Corporation. Set up Lifecycles, Projects, Workflow Templates 8.0. PTC Ltd. [6] PTC Corporation. Workflow Tutorial 8.0.www.ptc.com
[5] Workflow Management Coalition. Workflow Management Coalition Reference Model. WFMC TC00-1003, 1994
关键字：船舶并行协同设计、文档管理系统、Windchill二次开发、elipse
Abstract:The function and implement of parallel collaborative design document management system of naval based on Windchill was introduced, including the customization method and process of document submit page,document approval process,the establishment and submit, and the storage of document and so on ,this idea makes the document management system more suitable for the requirement of naval parallel collaborative design.
Key words:Naval parallel collaborative design;Document management system;The secondary development of Windchill; elipse
0 引言
在基于PDM的船舶并行协同设计过程中将产生大量的各类设计文档。文档是指船舶设计项目执行过程中产生的任何电子文件的总称，一个文档不等于一个电子文件，它是用来组织电子文件的，表明这些电子文件是谁拟制的，是什么类型的文件，这些电子文件需要谁审批[1]。
1 船舶设计文档的属性
为了便于船舶设计过程中产生的文档的管理和系统的简化，根据面向对象的思想，抽象出各类文档的共性[2]，即文档的属性：
2 船舶文档的类型及船舶设计文档所属各部门类型的定制
船舶研制评估过程中会产生大量的文档，根据文档的类型和性质，可将其分为任务书、论证报告、说明书、计算书、二维图纸文件、三维图形文件等。默认情况下Windchill软件中文档的类型及部门类型军不符合要求，因此我们根据需要来对文档类型进行更改。
在对windchill软件的二次开发过程中，.rbInfo文件分两种：一种是用于下拉列表的，如零部件类型、来源、生命周期状态、角色等，这种用windchillin下的enumCustomize.bat工具来更新。一种是用于显示的，如编号、名称这些显示，这些可以手工更改，然后需要编译生成class文件覆盖系统的相应文件才会生效。对这些文件需要通过resourcebuild命令进行编译，并用Ant –f makejar.xml工具更新codebase下对应的class文件。然后用java wt.tools.boot.MakeJar jar=wt.jar命令建立WT.JAR文件。这样重新打开Windchill时，系统将自动调用新生成的jar文件[3]。
（1）在WindchillsrcwtdocDocumentTypeRB_zh_CN.rbinfo内添加下面代码：
$$TaskBook.value=任务书
$$DemonstrateDocument.value=论证报告
$$2DDocument.value=2D文档
$$3DDocument.value=3D文档
在WindchillsrcwtdocDepartmentListRB_zh_CN.rbinfo内添加下面代码：
HULL.value=船体
ENGINE.value=轮机
ELECTRONIC.value=电气
TOTAL.value=总体
STRUCTURE.value=结构
OUTFIT.value=舾装
（2）在Windchill外壳程序中进入编译后生成文件的路径，例如：cdcodebase。然后执行enumCustomize命令。
（3）在Enumerated type Customization Utility界面中的Enumerated Type项选择$:ptcWindchillcodebasewtdoc中相对应的.RB.ser文件,在Locale下拉菜单中选择zh_CN,点击Save.会弹出一个对话框选择Continue编译文件,显示编译成功,编译完成后会在Windchill系统目录$:ptcWindchillcodebasewtdoc文件夹中生成新的.RB.ser文件。
（4）在外壳程序中执行下面命令行:cd codebase
Ant –f makejar.xml
重新启动Windchill Method Server，文档类型和部门类型的定制即完成。
3 添加属性“图号”及更改创建文档页面文字
Windchill软件中页面上包含的中文字是通过对相应的.rbinfo文件进行编译生成对应的.class文件，进而将汉字编译成Unicode代码，在相关的html页面上通过windchill scrip语言调用相应的class，从而将中文字显示在网页上，实现Windchill二次开发。
（1）在
（2）在elipse中创建工程,将上面的docResource.java文件加入工程，点击Project—Properties将java文件中涉及到的类以jar包的形式导入工程，将docResource.java文件编译成class文件。并将该class文件放置在
（3）将Widchillcodebase emplatesdoc目录下的CreateWTDocumentGeneralTab_zh_CN
.html中头文件对docRB.class文件的引用更改为对docResource.class文件的引用。
（4）重新启动Windchill软件。
4 文档的拟制与提交
用文档拟制工具（Office,AutoCAD,Pro/ENGINEER等）拟制项目相关的电子文件。进入PDM系统，在个人文件柜下建立一个文档对象，填入上图中需要手工填写的属性。把上面产生的电子文件作为主要文件加入到该文档的主要内容的文件栏位中，然后提交，把新建的文档从个人文件柜中检入到项目共享文件柜的相应目录中，完成该电子文档的提交。
5 文档的审签过程
船舶设计建造过程中的文档需要经历设计、校对、审核、标检、审定五个阶段才能归档。
在审签工作流模板中，存在审阅批准和不批准两种情况，此时要在属性中加入路由条件，这里通过代码实现，其代码如下：
java.util.Vector vect=wt.lifecycle.LifeCycleHelper.service.getSignatures((wt.lifecycle.LifeCycleManaged)primaryBusinessObject);
java.util.Enumeration enum = vect.elements();
wt.lifecycle.LifeCycleSignature sig=null;
while (enum.hasMoreElements()){
sig = (wt.lifecycle.LifeCycleSignature) enum.nextElement();
}
if(sig.isVote())
result="批准";
else
result="不批准";
对于处于审核状态以下的文档，其修改过程如下：选择需要修改的文档属性页执行检出操作，系统会把该文档检出到修改者的个人文件柜的/Check Out子目录下，并显示是否要打开或下载内容文件提示供用户选择。选择下载文件，对该内容文件进行修改后保存。
进入个人文件柜的/Check Out子目录下，点击需要上面检出的文档，在其属性页中点击检入链接，系统提示正在检入文档并弹出需要附上内容文件对话框。把修改完成的内容文件加入到该对话框，选择OK按钮，显示修改完成的文档，版本信息从A.1变成A.2，修改过程完成。
对已经达到审定状态的文档进行修改，则需要履行设计变更过程，在PDM系统中需要记录设计变更请求、设计变更通知，记录设计变更活动是否执行，文档修改后还需要执行审核审批流程[4][5]。
6 结论
通过船舶文档管理系统的设计及实现，免去了一线人员拿着图纸到处跑的无效劳动，同时也可以很好的维护文档数据在传递过程中的一致性，从而显著提高船舶设计工作的效率。
参考文献：
[1]庞士宗，肖平阳，唐加福. 产品数据管理（PDM）—现代企业信息化管理与集成的理想平台. 北京：机械工业出版社，2001.20
[2]范文慧，李涛，熊光楞等. 产品数据管理的原理与实施. 北京：机械工业出版社，2004.6 [3] (美)John Zukowski著. Java 2(J2SE 1.4版)从入门到精通，邱仲潘译. 北京：电子工业出版社，2002
[3] (美)Herbert Schildt著. Java2参考大全，张玉清等译. 北京：清华大学出版社，2002
[4] PTC Corporation. Set up Lifecycles, Projects, Workflow Templates 8.0. PTC Ltd. [6] PTC Corporation. Workflow Tutorial 8.0.www.ptc.com
[5] Workflow Management Coalition. Workflow Management Coalition Reference Model. WFMC TC00-1003, 1994