061301-201206-商发IDEAL平台CHS集成

SystemSystem DesignDesign DocumentDocument-CHS-CHS集成集成 系统设计文档系统设计文档CHSCHS集成集成 COMACCOMAC REALIZED VALUE PLATFORM - CONFIDENTIAL - PTC PROPRIETARY 8e65a5dc156e6fdcb6907da6d31bd5d2.pdf Last printed 10月/05/2010 | Page 2 of 24 文档属性文档属性 文件名称状态 系统设计文档CHS集成.docDraft 变更历史变更历史 日期日期作者作者版本版本修改说明修改说明 10/27/2011董琦0.1 审批历史审批历史 审批人审批人审批时间审批时间备注备注 REALIZED VALUE PLATFORM - CONFIDENTIAL - PTC PROPRIETARY 8e65a5dc156e6fdcb6907da6d31bd5d2.pdf Last printed 10月/05/2010 | Page 3 of 24 目录目录 1概述概述 -5 1.1目的目的 -5 1.2范围界定范围界定-6 1.3定义和术语定义和术语-6 1.4遵从标准遵从标准-6 2主要问题和需求描述主要问题和需求描述 -6 3技术环境技术环境 -7 3.1支持的平台支持的平台-7 3.2安全性安全性 -7 3.3性能性能 -7 3.4可靠性可靠性 -8 3.5交互性交互性 -8 3.5.1与外部系统的关系 -8 3.5.2支持的数据格式-8 3.6国际化和本地化国际化和本地化 -8 3.7设计约束设计约束-8 3.8域模型域模型 -8 4架构架构 -9 4.1软件列表软件列表-10 4.2集成用例集成用例-10 4.3集成主要用户界面集成主要用户界面 -11 4.4组件划分组件划分-11 4.4.1C_01_01_01 Check In Service -14 4.4.2C_01_01_02 CHS Data Parser-15 4.4.3C_01_01_03 Data Existing Validator -15 4.4.4C_01_01_04 Data Check In Validator -16 4.4.5C_01_01_05 - Data Check In Handler-16 4.4.6C_01_01_06 Data Check In Error Handler -16 4.4.7C_01_01_07 Update CHS Data State Service-18 4.4.8C_01_01_08 Retrieve Latest CHS Data Service-18 4.4.9C_01_01_09 Dirty Data Handler -19 REALIZED VALUE PLATFORM - CONFIDENTIAL - PTC PROPRIETARY 8e65a5dc156e6fdcb6907da6d31bd5d2.pdf Last printed 10月/05/2010 | Page 4 of 24 4.4.10 C_01_01_10 Censor Sign Workflow Starter-19 4.4.11 C_01_01_11 - Web Service Requestor-19 4.4.12 C_01_01_12 - Web Service Failed Logger-20 4.4.13 C_01_01_13 Email Service -20 4.4.14 C_01_01_14 Assign Workflow Activity Service -20 4.4.15 C_01_01_15 Web Service Failed Handler-21 5风险风险-22 5.1技术风险技术风险-22 5.2不确定因素不确定因素 -23 5.3遗留问题遗留问题-23 参考文档参考文档-24 REALIZED VALUE PLATFORM - CONFIDENTIAL - PTC PROPRIETARY 8e65a5dc156e6fdcb6907da6d31bd5d2.pdf Last printed 10月/05/2010 | Page 5 of 24 1 1概述概述 1.11.1目的目的 本系统设计文档定义IDEAL平台与CHS系统集成模块的系统架构。 本文对系统架构中的各主要组成部分以系统组件（Component）的方式进行标识和定义。同时给出各组件的以下 设计内容： 功能概述 系统组件接口描述 系统组件之间的相互关系 系统组件设计要求（功能性要求，如功能特性。非功能性要求，如性能、可配置性和可靠性等） 本系统设计文档的设计输入如下： IDEAL平台建设Phase III-业务流程描述文档（Process Description Document） IDEAL平台建设Phase III-业务流程应用实践文档（Practice Design Document） IDEAL平台建设 Phase III-业务配置文档(Function Description Document) IDEAL平台建设 Phase III-需求跟踪矩阵(Requirement Matrix) 通过本文描述的架构设计和系统组件规划，确保未来IDEAL平台可以支撑以下两个关键业务流程的正常运行： “IDEAL平台电气系统级别图样设计、签审及更改业务流程（IDEAL_Process_01_01）” 本文还将描述与CHS集成模块相关的如下内容： IDEAL平台关于CHS集成模块的主要需求描述 CHS集成模块的平台支持要求 对安全性需求的考虑和解决方案 对可靠性要求的考虑和解决方案 对性能要求的考虑和解决方案 对国际化和本地化 架构设计的设计约束 本文是描述IDEAL平台CHS集成模块未来特性的重要设计文件，是后续各组件设计文档（Component Design document）的主要设计输入。本文将与组件设计文档一起共同作为后续系统组件开发和单元测试（UT）/系统 集成测试（SIT）/用户接受测试（UAT）的设计依据。 REALIZED VALUE PLATFORM - CONFIDENTIAL - PTC PROPRIETARY 8e65a5dc156e6fdcb6907da6d31bd5d2.pdf Last printed 10月/05/2010 | Page 6 of 24 本文的目标读者包括：客户项目经理，PTC项目经理，PTC业务流程顾问，PTC系统架构顾问，PTC 开发人员，客户开发人员,测试开发和执行者，客户系统管理员，客户业务管理员。 1.21.2范围范围界定界定 本文用于描述IDEAL平台PhaseIII项目中对CHS集成模块的，任何未在本文档中描述的系统能力将认为使用Windc hill PDMLink 标准功能（OOTB），或者已经在IDEAL平台的前期项目中实施完毕可以直接使用。 1.31.3定义和术语定义和术语 1.41.4遵从标准遵从标准 名称名称目的目的 Realized Value Platform5.0（RVP） System Design Element 确保系统设计过程完备、考虑周全、对系统组件定义清晰明确。 确保系统设计覆盖项目范围内的全部相关需求和设计约束 确保系统设计的交付质量 此处增加COMAC的相关业务标准 2 2主要问题主要问题和需求描述和需求描述 问题问题问题描述问题描述需求编号需求编号 CHS各类文件检入ID EAL平台 1. CHS端需实现Web service客户端，用于检入文件至IDEAL平台 2. IDEAL平台需实现Web service服务，用于接口CHS发送过来的请求并将CHS提供的文件内容存储至正 确的IDEAL平台文档对象中 3. 检入时由CHS提供IDEAL平台：pdf作为主内容，XML等其他文件作为附件，并 且提供能够准确的在CHS中标识检入对象的对象标识（CHS数据编号/CHS数据 版本/URL） 4. 检入时根据图样是否已经在IDEAL平台存在决定是创建图样文档还是更新图样 文档 5. 检入时应检查：文件编号、版本号、生命周期状态 6. 检入时应明确设定IDEAL平台中的文件对象中的数据来源标识为“CHS”，以 便后续系统功能判断该文件的来源为 CHS 7. CHS提交图样时，除了图样的编号、版本外，还将提供CHS中该图样的唯一标 识，后续IDEAL通过集成接口传递信息时，都需提供此唯一标识 8. 在检入时的错误信息应明确和易于理解 R1.1.2 CHS各数据状态与ID EAL平台同步 1.CHS端需实现Web service服务器，用于接受IDEAL平台发送的状态同步请求并正确的设定状态 R1.1.3 IDEAL平台签审流程1. 本功能需要的进入标准是：文件的数据来源标识为“CHS”R1.1.4 REALIZED VALUE PLATFORM - CONFIDENTIAL - PTC PROPRIETARY 8e65a5dc156e6fdcb6907da6d31bd5d2.pdf Last printed 10月/05/2010 | Page 7 of 24 中，设置状态并与C HS同步 2. 在IDEAL平台提交签审时（IDEAL生命周期状态“签审中”），通过集成接口 ，在CHS中设置状态为pending 3. 在IDEAL平台驳回进行修改时（IDEAL生命周期状态“修改中”），通过集成 接口，在CHS中设置状态为draft 4. 在IDEAL平台发布时（IDEAL生命周期状态“已发布”），通过集成接口，在C HS中设置状态为Released 5. 在IDEAL平台经过作废流程，生命周期状态到达“已作废”时，通过基础接口 ，在CHS中设置状态为Obsolete 6. 为了保证签审流程中的图样文件在CHS和IDEAL保持一致，图样文件在IDEAL 平台中提交签审时，将通过集成接口查询IDEAL记录的CHS图样更新时间是否 是CHS中的最后更新时间； 如果不是最新时间，则予以报错，设计师需再次检入；如果是最新时间，则启 动签审流程，并通过集成接口通知CHS中设置图样的状态为“pending”，在 此状态下，设计师不能在CHS中编辑图样 6. 只有CHS中图样的状态为“released”，才可以进行换版的操作。这样就保证 了IDEAL与CHS图样的版本同步 7. 此项需求需要借助CHS集成接口实现，本需求仅描述在流程中的调用 集成接口错误处理IDEAL通过接口通知CHS设置相关对象状态的可能失败原因有： 网络连接 CHS端反馈失败错误码或者错误信息 系统代码错误 此功能出现连接故障或者意外情况时，系统应： 流程应坚固可靠，任何情况下不能因为此功能处于失控状态; 如果是连接问题，系统应能至少重复尝试3次再进行人工干预处理。但每次失败尝 试必须记录系统Log 如果系统重复尝试失败，应立即发送通知邮件给系统管理员，同时系统将流程Ro ute到管理员手工处理之工作任务 系统管理员解决相关失败原因后，能够通过“手工处理”任务使得流程继续进行 R1.1.5 IDEAL平台中文件数 据的数据来源标识 在WTDocument上增加标识，以记录数据来源，凡由CHS集成进入IDEAL平台的 文件，此标识的值一律设为“CHS”，此标识将作为IDEAL平台判断是否调用We b service来同步CHS中文件状态的依据 R1.1.6 3 3技术环境技术环境 3.13.1支持的平台支持的平台 CHS集成子系统运行于稳定的IDEAL平台之上，并且继承业界标准的Web Service的方式进行通信。 3.23.2安全性安全性 服务器安全性请参考XX文档。 REALIZED VALUE PLATFORM - CONFIDENTIAL - PTC PROPRIETARY 8e65a5dc156e6fdcb6907da6d31bd5d2.pdf Last printed 10月/05/2010 | Page 8 of 24 遵循IDEAL平台的安全性要求，包括对文档的各类操作权限。 3.33.3性能性能 为提高IDEAL平台CHS集成子系统的性能，本系统设计将从以下几个方面考虑以优化CHS集成子系统性能以及给 出子系统运行过程中性能设置的有关建议。 IDEAL平台解析CHS设计系统数据的性能 Web服务的性能瓶颈主要在数据传输上，CHS的数据传递可能会涉及到比较大的PDF等类型的文件。之前类似问 题的解决方案额外开放了FTP端口用于传送大文件，这不但会涉及到安全性问题，而且额外增加了系统管理员的维 护成本，因此这次给出的解决方案采用异步HTTP下载来处理大文件。 CHS调用WEB服务时，在参数中给定传递文件的URL，IDEAL平台接收到请求后，先处理同步执行的步骤，比如 设置属性等，同时将下载文件的任务放到队列中，完成后，根据要求挂接在图样文档的主内容或者附件之上。 3.43.4可靠性可靠性 CHS设计系统与IDEAL平台交互的过程中，本子系统的接口调用无论发生何种情况，都需要保证IDEAL平台的流 程不被意外终止，使IDEAL平台的使用者能够继续其工作。 而在子系统本身运行的过程中，如果出现错误，能够记录足够的信息，给予系统管理员充分的提示，迅速定位问 题且给出解决方案。 3.53.5交互性交互性 3.5.1 与外部系统的关系 外部系统外部系统目的目的 CHS设计系统通过Web服务请求CHS设计系统中图样文档的最新信息。 3.5.2 支持的数据格式 格式名称格式名称方向方向目的目的 xml输出/输入Web服务调用数据参数的格式，容纳足够多的信息， 也方便扩展，而不用修改web服务部署的方法签名； 另外，可能存在其他数据附件内容以xml格式的形式 传递。 pdf输入约定的传递图样文档的主内容格式；同样可能存在其 他数据附件内容以pdf形式传递。 3.63.6国际化和本地化国际化和本地化 虽然本子系统没有具体的用户界面，因此也没有直观的需要去国际化和本地化的地方；但是，考虑到跨系统之间 的交互同样需要消息通信，因此，在某些具体的消息环节中，还是需要处理好国际化的问题。 3.73.7设计约束设计约束 N/A REALIZED VALUE PLATFORM - CONFIDENTIAL - PTC PROPRIETARY 8e65a5dc156e6fdcb6907da6d31bd5d2.pdf Last printed 10月/05/2010 | Page 9 of 24 3.83.8域模型域模型 N/A 4 4架构架构 本子系统是跨系统的交互，且涉及到数据交换，因此IDEAL平台与CHS设计系统之间的通信方式采用Web Service。下列图示给出了CHS集成系统的总体架构， I ID DE EA AL L服服务务接接口口 W We eb b服服务务- -客客户户端端 W We eb b服服务务- -服服务务端端 C CH HS S集集成成接接口口 W We eb b服服务务- -客客户户端端 W We eb b服服务务- -服服务务端端 C CH HS S设设计计系系统统平平台台 I ID DE EA AL L数数据据管管理理平平台台 Web服务调用 本地服务调用 图 1 CHS集成总体系统架构图 如图1所示，CHS设计系统平台与IDEAL数据管理平台本身互不相关，而CHS集成接口和IDEAL服务接口作为两者 交互的桥梁。 IDEAL服务接口 本子系统的核心部分，需要根据CHS集成接口以及IDEAL数据管理平台的请求，实现一系列数据格式的解析 、转换等工作，为WEB服务调用和本地服务调用做准备工作；其中，又可细分为Web服务- 客户端和Web服务-服务端， Web服务-客户端 客户端在接收IDEAL数据管理平台的请求之后，进行某些处理并调用CHS集成接口的Web服务-服务端； Web服务-服务端 REALIZED VALUE PLATFORM - CONFIDENTIAL - PTC PROPRIETARY 8e65a5dc156e6fdcb6907da6d31bd5d2.pdf Last printed 10月/05/2010 | Page 10 of 24 服务端接收CHS集成接口的请求后，进行某些处理并调用IDEAL数据管理平台的服务； IDEAL数据管理平台 IDEAL服务接口运行于IDEAL数据管理平台之上，该平台提供文档检入等服务供IDEAL服务接口调用；同时 ，该平台也会向IDEAL服务接口发出设置状态等请求； CHS集成接口 CHS集成接口是IDEAL平台与CHS设计系统交互的门面，提供了设置状态、获取最新状态等的服务；也会根 据CHS设计系统的请求，向IDEAL服务接口发送信息；其中，又可细分为Web服务-客户端和Web服务- 服务端， Web服务-客户端 客户端在接收CHS设计系统的请求之后，进行某些处理并调用IDEAL服务接口的Web服务-服务端； Web服务-服务端 服务端接收IDEAL服务接口的请求之后，进行某些处理并调用CHS设计系统平台的服务； CHS设计系统平台 CHS集成接口同样运行于CHS设计系统平台之上，该平台提供设置图样文档状态、获取最新文档对象等的服 务。 4.14.1软件列表软件列表 N/A 4.24.2集成用例集成用例 REALIZED VALUE PLATFORM - CONFIDENTIAL - PTC PROPRIETARY 8e65a5dc156e6fdcb6907da6d31bd5d2.pdf Last printed 10月/05/2010 | Page 11 of 24 CHS设计师 检入文件至IDEAL平台 再次检入文件至IDEAL平台 IDEAL系统管理员 恢复流程，手工处理 IDEAL平台设计师 图样文档提交签审 图 2 CHS集成总体系统用例图 如图2所示，CHS集成系统的用例图可以分为三部分， CHS设计师 CHS主要有两个用例， 检入文件至IDEAL平台 由CHS设计师在CHS系统中完成一系列图样的设计之后，通过IDEAL集成接口初次检入IDEAL平台。 再次检入文件至IDEAL平台 初次检入至IDEAL平台提交签审时，经验证IDEAL平台中的图样并非最新时间，需要通知CHS设计师重 新检入最新版本的图样进IDEAL平台。 IDEAL系统管理员 IDEAL系统管理员只有一个用例， 恢复流程，手工处理 REALIZED VALUE PLATFORM - CONFIDENTIAL - PTC PROPRIETARY 8e65a5dc156e6fdcb6907da6d31bd5d2.pdf Last printed 10月/05/2010 | Page 12 of 24 图样签审流程中，当调用WEB服务失败时，系统会发邮件通知系统管理员并且将流程的活动指配到手 工处理，由系统管理恢复流程。 IDEAL平台设计师 IDEAL平台设计师只有一个用例， 提交图样文档签审 IDEAL平台中，设计师想要发布或归档某图样文档，则必须提交签审给相关人员，启动签审流程。 4.34.3集成主要用户界面集成主要用户界面 N/A 4.44.4组件划分组件划分 W We eb b S Se er rv vi ic ce e R Re eq qu ue es st to or r C Ce en ns so or r S Si ig gn n W Wo or rk kf fl lo ow w S St ta ar rt te er r U Up pd da at te e C CH HS S D Da at ta a S St ta at te e S Se er rv vi ic ce e C Ch he ec ck k I In n S Se er rv vi ic ce e C CH HS S集集成成系系统统I ID DE EA AL L平平台台 图 3 CHS集成的总体组件图 图3描述了CHS集成子系统的总体架构，主要可以分为以下几个组件， Check In Service 接收CHS集成系统的请求，检入一个或多个文档。 Censor Sign Workflow Starter 启动签审流程的组件，包括获取流程主对象的最新状态等。 Update CHS Data State Service 处理从IDEAL平台发起更新CHS数据的请求。 Web Service Requestor 处理整个IDEAL平台的Web服务的请求，包括错误处理、重发的尝试已经EMAIL的发送等。 REALIZED VALUE PLATFORM - CONFIDENTIAL - PTC PROPRIETARY 8e65a5dc156e6fdcb6907da6d31bd5d2.pdf Last printed 10月/05/2010 | Page 13 of 24 W We eb b S Se er rv vi ic ce e R Re eq qu ue es st to or r W We eb b S Se er rv vi ic ce e F Fa ai il le ed d H Ha an nd dl le er r E EM Ma ai il l S Se er rv vi ic ce e W We eb b S Se er rv vi ic ce e F Fa ai il le ed d L Lo og gg ge er r C Ce en ns so or r S Si ig gn n W Wo or rk kf fl lo ow w S St ta ar rt te er r D Di ir rt ty y D Da at ta a H Ha an nd dl le er r U Up pd da at te e C CH HS S D Da at ta a S St ta at te e S Se er rv vi ic ce e D Da at ta aC Ch he ec ck kI In nE Er rr ro or rH Ha an nd dl le er r D Da at ta aC Ch he ec ck kI In nH Ha an nd dl le er r D Da at ta aC Ch he ec ck kI In nV Va al li id da at to or r D Da at ta aE Ex xi is st ti in ng gV Va al li id da at to or r C CH HS SD Da at ta aP Pa ar rs se er r C Ch he ec ck kI In nS Se er rv vi ic ce e C CH HS S集集成成系系统统I ID DE EA AL L平平台台 R Re et tr ri ie ev ve e L La at te es st t C CH HS S D Da at ta a S Se er rv vi ic ce e A As ss si ig gn n W Wo or rk kf fl lo ow w A Ac ct ti iv vi it ty y S Se er rv vi ic ce e 图 4 CHS集成子系统的细分组件图 图4描述了CHS集成子系统的细分组件，各个组件的详细描述如下所述： 组件组件IDID组件名称组件名称描述描述 C_01_01_01Check In Service C_01_01_02CHS Data Parser C_01_01_03Data Existing Validator C_01_01_04Data Check In Validator C_01_01_05Data Check In Handler C_01_01_06Data Check In Error Handler REALIZED VALUE PLATFORM - CONFIDENTIAL - PTC PROPRIETARY 8e65a5dc156e6fdcb6907da6d31bd5d2.pdf Last printed 10月/05/2010 | Page 14 of 24 C_01_01_07Update CHS Data State Service C_01_01_08Retrieve Latest CHS Data Service C_01_01_09Dirty Data Handler C_01_01_10Censor Sign Workflow Starter C_01_01_11Web Service Requestor C_01_01_12Web Service Failed Logger C_01_01_13Email Service C_01_01_14Assign Workflow Activity Service C_01_01_15Web Service Failed Handler 4.4.1 C_01_01_01 Check In Service 组件IDC_01_01_01 组件名称Check In Service 负责人 组件描述根据CHS 需求编号R1.1.2，R1.1.6 用例 接口 方法名：checkInDocument 该方法提供了检入图样文档的web服务； 参数： request.xml，内容举例如下： 标签attr表示一个属性的开始，属性name表示图样文档的属性名称，无论是IBA还是M BA，CHSDataParser都会将其解析成一个MAP，由DataCheckInHandler具体去处理，名 REALIZED VALUE PLATFORM - CONFIDENTIAL - PTC PROPRIETARY 8e65a5dc156e6fdcb6907da6d31bd5d2.pdf Last printed 10月/05/2010 | Page 15 of 24 称、编号、IBA、主附内容等。 上述例子只描述了个别属性，CHS会去处理的属性名称需要一一给出，方便IDEAL平 台进行处理。 返回值： 成功 OK. 失败 失败的信息。 详细描述输入： Web Service调用，取得的XML文件 输出： 成功或失败的信息 4.4.2 C_01_01_02 CHS Data Parser 组件IDC_01_01_02 组件名称CHS Data Parser 负责人 组件描述根据CHS通过WEB服务传输过来的XML流对象，根据约定的格式进行解析，以List的对象形式返回调用者XML文件的内容 需求编号R1.1.2 用例 接口方法名： public List parseData(InputStream xmlStream) throws WTException; 详细描述参数 xmlStream, XML参数流的对象 返回 List 解析完的属性集合 异常 WTException，IDEAL平台的异常父类，由DataCheckInErrorHandler统一处理。 4.4.3 C_01_01_03 Data Existing Validator 组件IDC_01_01_03 组件名称Data Existing Validator 负责人 组件描述检查CHS需要检入的对象在IDEAL平台中是否存在。 需求编号R1.1.2 用例 接口public boolean isDataExist(WTDocument doc) throws WTException; REALIZED VALUE PLATFORM - CONFIDENTIAL - PTC PROPRIETARY 8e65a5dc156e6fdcb6907da6d31bd5d2.pdf Last printed 10月/05/2010 | Page 16 of 24 详细描述参数 doc，图样文档对象； 返回 是否存在的布尔值； 异常 WTException，IDEAL平台的异常父类，由DataCheckInErrorHandler统一处理。 4.4.4 C_01_01_04 Data Check In Validator 组件IDC_01_01_04 组件名称Data Check In Validator 负责人 组件描述检查CHS需要检入的对象的属性，包括编号、版本及状态等信息是否符合IDEAL平台的规范及检 入要求。如符合，则检入系统；否则予以报错。 需求编号R1.1.2 用例 接口public boolean isAllowToCheckIn(WTDocument doc) throws WTException; 详细描述参数 doc，图样文档对象； 返回 是否能够检入的布尔值； 异常 WTException，IDEAL平台的异常父类，由DataCheckInErrorHandler统一处理。 4.4.5 C_01_01_05 - Data Check In Handler 组件IDC_01_01_05 组件名称Data Check In Handler 负责人 组件描述根据CheckInService获取的XML参数流，先调用CHSDataParser解析XML流，输出解析完的参 数，然后调用Data Check In Validator检查其是否符合检入要求；接着调用Data Existing Validator验证其是否存在，如存在则操作标示符记录为更新否则为创建；最后调用IDEAL平台的 服务创建或更新数据。 需求编号R1.1.2 用例 接口public String checkInData(InputStream xmlStream) throws WTException; 详细描述参数 xmlStream，XML流对象； 返回 String, 检入结果 异常 WTException，IDEAL平台的异常父类，由DataCheckInErrorHandler统一处理。 4.4.6 C_01_01_06 Data Check In Error Handler 组件IDC_01_01_06 组件名称Data Check In Error Handler REALIZED VALUE PLATFORM - CONFIDENTIAL - PTC PROPRIETARY 8e65a5dc156e6fdcb6907da6d31bd5d2.pdf Last printed 10月/05/2010 | Page 17 of 24 负责人 组件描述获取检入对象错误的异常后，解析并生成明确且关键的错误信息 需求编号R1.1.2 用例 接口public void handleError(Throwable error, Object obj); 详细描述参数 error，异常对象； obj，异常相关对象 返回 N/A 异常 N/A DataCheckInHandlerCheckInServiceCHSDataParserDataCheckInValidatorDataExistingValidatorDataCheckInErrorHandler 能够检入 存在与否 检入 检入失败 处理错误 检入错误信息 检入成功 检入成功 检入成功 解析完的数据 文档属性 文档属性 XML流 XML流 图 5 从CHS检入图样至IDEAL平台的时序图 图5中列出了从CHS集成接口发送过来检入一个图样文档的调用序列， 1)Check In Service接收CHS接口调用 Web Service 请求后，获取输入参数的XML流对象，该XML中包含了待检入文档的一切信息；（Check In Service是一个以Web Service形式部署、暴露在IDEAL平台外部的一个接口，详见4.5.1） 2)Data Check In Handler拿到图样得到XML流对象之后， 先调用CHS Data Parser解析XML文件； 3)CHS Data Parser得到XML流对象后，解析成为List对象并返回，Map表示一个图样文档的一组属性；而List则是多个图样文档的列表； REALIZED VALUE PLATFORM - CONFIDENTIAL - PTC PROPRIETARY 8e65a5dc156e6fdcb6907da6d31bd5d2.pdf Last printed 10月/05/2010 | Page 18 of 24 4)Data Check In Handler获得解析完的List对象后，先调用Data Check In Validator验证是否能够检入；如果能，再调用Data Existing Validator验证是否已经存在，如存在，则更新现有的文档；否则创建新的文档； 5)检入过程中，如果有失败，则将错误信息发送给Data Check In Error Handler处理； 6)返回检入结果 4.4.7 C_01_01_07 Update CHS Data State Service 组件IDC_01_01_07 组件名称Update CHS Data State Service 负责人 组件描述接收IDEAL平台更新CHS数据状态的请求后，先从需要更新的对象上获取CHS端需要的信息、 更新后的状态，且将需要调用的Web服务方法名及方法参数一齐作为调用Web Service Requestor的参数，完成Web服务的调用。 需求编号R1.1.3, R1.1.4 用例 接口public String updateState(List docList, String state) throws WTException; 详细描述参数 docList，需要改变状态的图样文档列表 返回 String, 更新结果 异常 WTException，IDEAL平台的异常父类，由WebServiceErrorHandler统一处理。 4.4.8 C_01_01_08 Retrieve Latest CHS Data Service 组件IDC_01_01_08 组件名称Retrieve Latest CHS Data Service 负责人 组件描述接收IDEAL平台获取最新CHS数据信息的请求后，先从需要获取最新信息的对象上得到CHS端 需要的信息，且将需要调用的Web服务方法名及方法参数一齐作为调用Web Service Requestor的参数，完成Web服务的调用。 需求编号R1.1.4 用例 接口public List retrieveLatestDocs(List docList) throws WTException; 详细描述参数 docList，需要获取最新状态的图样文档列表 返回 List, 最新状态的图样文档列表 异常 WTException，IDEAL平台的异常父类，由WebServiceErrorHandler统一处理。 REALIZED VALUE PLATFORM - CONFIDENTIAL - PTC PROPRIETARY 8e65a5dc156e6fdcb6907da6d31bd5d2.pdf Last printed 10月/05/2010 | Page 19 of 24 4.4.9 C_01_01_09 Dirty Data Handler 组件IDC_01_01_09 组件名称Dirty Data Handler 负责人 组件描述抛出IDEAL平台准备启动签审流程的当前对象不是最新时间的异常 需求编号R1.1.4 用例 接口public void handleDirtyData(WTDocument doc) throws WTException; 详细描述参数 doc，非最新时间的图样文档对象 返回 N/A 异常 WTException，IDEAL平台的异常父类，由WebServiceErrorHandler统一处理。 4.4.10C_01_01_10 Censor Sign Workflow Starter 组件IDC_01_01_10 组件名称Censor Sig