02CMCC统一数字档案系统接口规范v15Word格式.docx

1、中文名称WSFLWeb Service Flow Language叙述网络服务流程的语言SOAPSimple Object Access Protocol 简单对象访问协议UDDIUniversal Description, Discovery, and Integration 统一描述、发现和集成。UDDI 允许动态发现相关的 Web 服务并将其集成到聚合的业务过程中。WSDLWeb Services Description Language WEB 服务描述语言XMLExtensible Markup Language 可扩展标记语言HTTPHypertext Transfer Proto

2、col 超文本传输协议FTPFile Transfer Protocol 文件传输协议W3CWorld Wide Web Consortium 互联网联合组织SGMLStandard Generalized Markup Language标准通用置标语言6系统接口概述中国移动总部、各省分公司及直属单位的统一数字档案管理系统建设过程中，根据各自的具体情况，选择接口服务的类型。根据相应的服务接口的规范，开发相应的服务接口调用程序及FTP服务调用程序，分别处理档案正文（含Word和PDF）、附件（压缩包，含Word和PDF）、底稿、流转单、著录项的元数据。本规范制定的接口包括档案归档接口和历史数据迁

3、移接口两类，其中档案归档接口用于指导档案外围系统将统一数字档案一期系统支持的七类档案归档到档案系统中，历史数据迁移接口用于各省将已有档案系统的历史数据（七类档案的历史数据）迁移到统一数字档案一期系统中。6.1归档内容本规范规定的采集归档的档案类型包括文书、招投标、合同、工程、会计、审计和特殊载体档案7个档案分类，其中归档档案的数据内容按不同档案分类将包括档案著录项以及正文、附件、底稿和流转单,档案数据包括档案新增数据和档案历史数据，其中正文包括PDF和Word形式的两份、附件归档文件类型为压缩包（zip格式或RAR格式，含附件的Word形式和PDF形式），底稿归档文件类型为word文件，流转单

4、归档文件类型为MHT文件（推荐）或HTML文件。档案著录项格式为XML文件，格式要求见电子文件封装规范及元数据规范，其中针对不同的档案类型的元数据要求，对应的XML文件封装要求也有区别，具体参见元数据规范。6.2归档过程描述 接口前期设置：统一数字档案归档接口过程6.2.1接口使用前配置统一数字档案外围系统归档接口：1.接口在使用前，需要按集团档案业务分类规范，确认各系统对应的档案分类，以及其中各必填项字段的输入数据；2.接口在使用前，根据待归档系统的类型和要求，配置归档数据归档到待归档库或归档库；3.接口根据业务需要，支持业务系统采用按月、按天或实时的方式进行归档；统一数字档案历史数据归档接

5、口：1.接口在使用前，需要提供历史档案数据的数据结构，以及数据与现有档案分类元数据的映射关系；6.2.2接口归档过程上图中红色区域中为各省需要将新增数据导入到统一数字档案系统而需要开发的程序，总共包括一个三个模块。 档案文件同步模块：开发FTP客户端程序，负责调用接口机FTP服务。主要完成的功能是将前面所需的7类档案文件及著录项XML文件通过FTP协议的方式传送到部署在各省的接口机中。这个过程中需要记录接口调用的返回结果以备联调。 档案信息同步模块：根据系统要求，选择采用WebService方式或中间表方式，开发客户端，负责调用接口机的服务端。主要完成的功能是将每个档案的属性信息（档案标识、档

6、案名称、编写者、档案类型、档案附件数量、每个附件的大小、档案校验码等档案基本信息以及对应的调用接口的系统标识、系统名称等来源信息）传递给接口服务。（步骤） 错误档案退回模块：开发服务端，接收接口机传过来的数据校验结果。程序调用过程：1. 档案信息同步模块通过调用接口机提供的归档服务，同步需要传递的档案的信息。在接口调用失败的情况下，同步模块需要记录下失败的信息，并有重试的处理。2. 档案文件同步模块通过调用接口机提供的FTP服务，同步需要传递的档案的档案内容。在接口调用失败的情况下需要相应的记录及重试的处理。3. （接口机完成过程）通过档案信息同步模块传递的档案信息，对档案文件同步接口传递的档

7、案文件进行校验。针对每次档案信息同步接口调用所同步的档案信息进行校验，对失败的档案标识进行整理，调用错误档案退回接口。4.错误档案退回模块收集接口机传递的数据校验结果，对错误的文件进行处理后，再通过档案信息同步模块进行归档处理。5.系统管理员可以通过接口界面查看归档的情况，以及出错信息。对于历史数据而言，各省同样需要提供相应的程序处理历史数据的导入，与上面的处理过程类似，包含的主要模块为： 历史档案文件导入模块：主要完成的功能是将历史档案文件及其著录项XML文件通过FTP协议的方式传送到部署在各省的接口机中。 历史档案信息导入模块：开发WebService客户端，负责调用接口机的WebServ

8、ice服务端。主要完成的功能是将每个档案的属性信息（档案标识、档案名称、编写者、档案类型、档案附件数量、每个附件的大小、档案校验码等档案基本信息以及对应的调用接口的系统标识、系统名称等来源信息）传递给接口机WebService服务。 历史错误档案退回模块：开发WebService服务端，接收接口机传过来的数据校验结果。对于历史数据而言，由于历史数据的档案类型、数据结构等与现有的档案类型、数据结构之间存在差异，需要整理历史档案类型与现有的档案类型的映射，同时针对每一类的档案类型映射，还需要整理具体的数据结构上的映射关系，并将整理后的映射关系导入到统一数字档案系统。1. 档案历史信息导入模块通过调

9、用接口机提供的WebService服务，导入需要传递的历史档案的信息。2. 档案文件导入模块通过调用接口机提供的FTP服务，导入需要传递的档案的档案内容。3. （接口机完成过程）通过档案信息导入模块传递的档案信息，对档案文件导入模块传递的档案文件进行校验。针对档案信息导入模块调用所导入的档案信息进行校验，对失败的档案标识进行整理，调用错误档案退回接口。4.错误档案退回模块收集接口机传递的数据校验结果。6.3接口实现方式所建设的接口实现方式考虑到外部系统的复杂性，接口平台提供了两种实现方式：一是 “中间库”，二是“Web服务”模式。接下来将简单介绍两种方式实现。（一） 中间库方式由于domino

10、 6.5以下版本不支持Web Service,所以引入了中间库接口方式。根据电子文件归档与管理规范 GB/T 18894-2002的要求，在各上游业务系统与统一数字档案管理系统之间建立一个中间逻辑数据库，该库包含一系列数据表及视图，在上游业务系统中提交归档的数据信息都存放在此中间逻辑数据库中，同时将档案正文（含Word和PDF）、附件（压缩包含Word和PDF）、著录项、底稿、流转单等相关文件放置到待归档的FTP服务器上，在此中间逻辑数据库和统一数字档案管理系统之间开发应用程序，该应用程序可以将此中间逻辑数据库中和FTP服务器中的信息转换到统一数字档案管理系统的数据库中。存放在统一数字档案管理

11、系统的数据暂存库中，以便进行数据接收入库及文件归档工作。如下图：（二） WEB服务模式统一数字档案管理系统中提供档案归档和查询数据接口，在归档时，上游业务系统将原文上传至指定FTP服务器 ，然后接口系统提交XML信息至统一数字档案的WEB服务，将归档数据写入统一数字档案管理系统实现供后期文件检索利用的目的。各上游业务系统可以通过这个WEB服务向档案系统导入数据。由于原文一般都比较大，为了系统的稳定性WEB服务不直接接收原文信息，各上游业务系统先将原文信息导至中间介质，由档案系统根据条件对应至中间介质中取出原文信息。中间介质，一般采用FTP方式。各接口系统，首先将原文信息导入至中间FTP服务器，

12、确认成功后再调用相应的接口WEB服务。6.4接口概述统一数字档案系统提供的服务接口概述：序号服务名称服务功能描述服务类型提供方消费方读/写1. 外围系统档案归档信息服务将可归档的文件进行归档生成档案或对已归档但又有内容变更的文件进行再次归档Web Service上游业务系统写入2. 中间表3. 原有档案系统数据迁移信息服务各省原有档案系统通过该接口完成系统中原有档案数据向统一数字档案管理系统迁移原有档案系统7Web服务接口描述7.1数据归档接口7.1.1服务名称英文名称： ImportArchiveInfo中文名称：数据归档接口7.1.2服务描述将需要归档的文件信息导入统一数字档案管理系统生成

13、归档档案。服务提供方：服务消费方：上游业务系统。7.1.3接口类型 读出 写入 读出写入7.1.4输入参数参数信息：是否必填字段名称字段描述数据类型字段约束YARCHIVE_ID档案标识VARCHAR2（64）系统简称_档案唯一标示COMPANY_ID公司代码见代码体系编制规则v1.52.2.1公司代码的编制方法CATEGORY档案分类见5.2.5字典项4. FILE原始正文VARCHAR2（200）该文件在FTP上的地址，地址存放格式见9.2节5. Nfile_PDF转换后正文6. ATTACHMENT档案附件该文件在FTP上的地址, 地址存放格式见9.2节，压缩包包含原始文件和转换后的文件

14、7. LlbCollection著录项（包括权限）该文件在FTP上的地址，地址存放格式见9.2节。XML格式文件。该文件须遵循电子文件封装规范, 8. WORKFLOW流程单该文件在FTP上的地址。地址存放格式见9.2节。MHT格式文件。9. DRAFT底稿10. FILE_MD5原始正文校验码该文件的校验码，使用MD5方式生成。11. file_PDF_MD5转换后正文校验码12. ATTACHMENT_MD5档案附件校验码13. LlbCollection_MD5著录项校验码（包括权限）14. WORKFLOW_MD5流程单校验码15. DRAFT_MD5底稿校验码16. OP_LOGIN

15、操作员使用接口的用户7.1.5接口数据字典档案分类（CATEGORY） 字典项：档案分类编码档案分类名称WS文书档案GC工程档案ZT招投标档案HT合同档案SJ审计档案TS特殊载体档案KJ会计档案CP产品档案QYZL专利档案QYBZ标准化档案JX教学档案KY科研档案SW实物档案QZ权证档案专题档案7.1.6接口接入注意事项如果上游系统的用户信息与集团SMAP系统一致,著录项中的授权对象值需要与集团SMAP系统中用户全名保持一致；如果上游系统的用户信息与集团SMAP系统不一致，著录项中的授权对象为空。7.1.7输出参数备注RETURN_VALUE服务执行结果0001：服务返回操作成功0002：服务

16、返回操作失败RETURN_INFO返回结果内容VARCHAR2（4000）7.2档案校验结果反馈7.2.1服务名称 ArchiveVerificationResult档案校验结果反馈7.2.2服务描述接受档案的校验结果7.2.3接口类型7.2.4输入ARCHIVE_CODESTATUS_ID校验结果代码RECEIVE_TIME档案接收时间7.2.5输出8中间库接口描述8.1数据归档接口8.1.1接口名称ImportArchiveInfo8.1.2接口描述业务系统根据统一数字档案管理系统档案归档范围将系统中待归档数据，以中国移动电子文件封装规范的规范进行封装后，推送到中间库，推送到中间库的数据通

17、过中间接口系统展现给档案员，有档案员选择数据并归档。8.1.3接口类型8.1.4中间表结构S_INFO：8.1.5接口接入注意事项8.2数据迁移接口8.2.1接口名称 ArchiveMigration数据迁移接口8.2.2接口描述数据迁移接口供各省原有档案系统根据统一数字档案管理系统档案归档范围将系统中已归档数据，在对历史数据进行归档之前，需要将历史已归档数据的映射关系整理并提交统一档案管理系统中。然后按照中国移动电子文件封装规范要求完成封装后，推送到中间库，推送到中间库的数据根据数据映射的要求，通过数据迁移程序迁移到统一数字档案系统中，数据迁移不涉及权限数据的迁移，依照现有统一数字档案系统权限规则处理。8.2.3接口类型8.2.4中间表结构该文件的校验码，使用MD5方式