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

资源描述

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

《02CMCC统一数字档案系统接口规范v15Word格式.docx》由会员分享，可在线阅读，更多相关《02CMCC统一数字档案系统接口规范v15Word格式.docx（23页珍藏版）》请在冰豆网上搜索。

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

中文名称

WSFL

WebServiceFlowLanguage

叙述网络服务流程的语言

SOAP

SimpleObjectAccessProtocol

简单对象访问协议

UDDI

UniversalDescription,Discovery,andIntegration

统一描述、发现和集成。

UDDI允许动态发现相关的Web服务并将其集成到聚合的业务过程中。

WSDL

WebServicesDescriptionLanguageWEB

服务描述语言

XML

ExtensibleMarkupLanguage

可扩展标记语言

HTTP

HypertextTransferProtocol

超文本传输协议

FTP

FileTransferProtocol

文件传输协议

W3C

WorldWideWebConsortium

互联网联合组织

SGML

StandardGeneralizedMarkupLanguage

标准通用置标语言

6　系统接口概述

中国移动总部、各省分公司及直属单位的统一数字档案管理系统建设过程中，根据各自的具体情况，选择接口服务的类型。

根据相应的服务接口的规范，开发相应的服务接口调用程序及FTP服务调用程序，分别处理档案正文（含Word和PDF）、附件（压缩包，含Word和PDF）、底稿、流转单、著录项的元数据。

本规范制定的接口包括档案归档接口和历史数据迁移接口两类，其中档案归档接口用于指导档案外围系统将统一数字档案一期系统支持的七类档案归档到档案系统中，历史数据迁移接口用于各省将已有档案系统的历史数据（七类档案的历史数据）迁移到统一数字档案一期系统中。

6.1　归档内容

本规范规定的采集归档的档案类型包括文书、招投标、合同、工程、会计、审计和特殊载体档案7个档案分类，其中归档档案的数据内容按不同档案分类将包括档案著录项以及正文、附件、底稿和流转单,档案数据包括档案新增数据和档案历史数据，其中正文包括PDF和Word形式的两份、附件归档文件类型为压缩包（zip格式或RAR格式，含附件的Word形式和PDF形式），底稿归档文件类型为word文件，流转单归档文件类型为MHT文件（推荐）或HTML文件。

档案著录项格式为XML文件，格式要求见电子文件封装规范及元数据规范，其中针对不同的档案类型的元数据要求，对应的XML文件封装要求也有区别，具体参见元数据规范。

6.2　归档过程描述

接口前期设置：

统一数字档案归档接口过程

6.2.1　接口使用前配置

统一数字档案外围系统归档接口：

1.接口在使用前，需要按集团档案业务分类规范，确认各系统对应的档案分类，以及其中各必填项字段的输入数据；

2.接口在使用前，根据待归档系统的类型和要求，配置归档数据归档到待归档库或归档库；

3.接口根据业务需要，支持业务系统采用按月、按天或实时的方式进行归档；

统一数字档案历史数据归档接口：

1.接口在使用前，需要提供历史档案数据的数据结构，以及数据与现有档案分类元数据的映射关系；

6.2.2　接口归档过程

上图中红色区域中为各省需要将新增数据导入到统一数字档案系统而需要开发的程序，总共包括一个三个模块。

✓档案文件同步模块：

开发FTP客户端程序，负责调用接口机FTP服务。

主要完成的功能是将前面所需的7类档案文件及著录项XML文件通过FTP协议的方式传送到部署在各省的接口机中。

这个过程中需要记录接口调用的返回结果以备联调。

✓档案信息同步模块：

根据系统要求，选择采用WebService方式或中间表方式，开发客户端，负责调用接口机的服务端。

主要完成的功能是将每个档案的属性信息（档案标识、档案名称、编写者、档案类型、档案附件数量、每个附件的大小、档案校验码等档案基本信息以及对应的调用接口的系统标识、系统名称等来源信息）传递给接口服务。

（步骤③）

✓错误档案退回模块：

开发服务端，接收接口机传过来的数据校验结果。

程序调用过程：

1.档案信息同步模块通过调用接口机提供的归档服务，同步需要传递的档案的信息。

在接口调用失败的情况下，同步模块需要记录下失败的信息，并有重试的处理。

2.档案文件同步模块通过调用接口机提供的FTP服务，同步需要传递的档案的档案内容。

在接口调用失败的情况下需要相应的记录及重试的处理。

3.（接口机完成过程）通过档案信息同步模块传递的档案信息，对档案文件同步接口传递的档案文件进行校验。

针对每次档案信息同步接口调用所同步的档案信息进行校验，对失败的档案标识进行整理，调用错误档案退回接口。

4.错误档案退回模块收集接口机传递的数据校验结果，对错误的文件进行处理后，再通过档案信息同步模块进行归档处理。

5.系统管理员可以通过接口界面查看归档的情况，以及出错信息。

对于历史数据而言，各省同样需要提供相应的程序处理历史数据的导入，与上面的处理过程类似，包含的主要模块为：

历史档案文件导入模块：

主要完成的功能是将历史档案文件及其著录项XML文件通过FTP协议的方式传送到部署在各省的接口机中。

历史档案信息导入模块：

开发WebService客户端，负责调用接口机的WebService服务端。

主要完成的功能是将每个档案的属性信息（档案标识、档案名称、编写者、档案类型、档案附件数量、每个附件的大小、档案校验码等档案基本信息以及对应的调用接口的系统标识、系统名称等来源信息）传递给接口机WebService服务。

历史错误档案退回模块：

开发WebService服务端，接收接口机传过来的数据校验结果。

对于历史数据而言，由于历史数据的档案类型、数据结构等与现有的档案类型、数据结构之间存在差异，需要整理历史档案类型与现有的档案类型的映射，同时针对每一类的档案类型映射，还需要整理具体的数据结构上的映射关系，并将整理后的映射关系导入到统一数字档案系统。

1.档案历史信息导入模块通过调用接口机提供的WebService服务，导入需要传递的历史档案的信息。

2.档案文件导入模块通过调用接口机提供的FTP服务，导入需要传递的档案的档案内容。

3.（接口机完成过程）通过档案信息导入模块传递的档案信息，对档案文件导入模块传递的档案文件进行校验。

针对档案信息导入模块调用所导入的档案信息进行校验，对失败的档案标识进行整理，调用错误档案退回接口。

4.错误档案退回模块收集接口机传递的数据校验结果。

6.3　接口实现方式

所建设的接口实现方式考虑到外部系统的复杂性，接口平台提供了两种实现方式：

一是“中间库”，二是“Web服务”模式。

接下来将简单介绍两种方式实现。

（一）中间库方式

由于domino6.5以下版本不支持WebService,所以引入了中间库接口方式。

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

存放在统一数字档案管理系统的数据暂存库中，以便进行数据接收入库及文件归档工作。

如下图：

（二）WEB服务模式

统一数字档案管理系统中提供档案归档和查询数据接口，在归档时，上游业务系统将原文上传至指定FTP服务器，然后接口系统提交XML信息至统一数字档案的WEB服务，将归档数据写入统一数字档案管理系统实现供后期文件检索利用的目的。

各上游业务系统可以通过这个WEB服务向档案系统导入数据。

由于原文一般都比较大，为了系统的稳定性WEB服务不直接接收原文信息，各上游业务系统先将原文信息导至中间介质，由档案系统根据条件对应至中间介质中取出原文信息。

中间介质，一般采用FTP方式。

各接口系统，首先将原文信息导入至中间FTP服务器，确认成功后再调用相应的接口WEB服务。

6.4　接口概述

统一数字档案系统提供的服务接口概述：

序号

服务名称

服务功能描述

服务类型

提供方

消费方

读/写

外围系统档案归档信息服务

将可归档的文件进行归档生成档案或对已归档但又有内容变更的文件进行再次归档

WebService

上游业务系统

写入

中间表

原有档案系统数据迁移信息服务

各省原有档案系统通过该接口完成系统中原有档案数据向统一数字档案管理系统迁移

原有档案系统

7　Web服务接口描述

7.1　数据归档接口

7.1.1　服务名称

英文名称：

ImportArchiveInfo

中文名称：

数据归档接口

7.1.2　服务描述

将需要归档的文件信息导入统一数字档案管理系统生成归档档案。

服务提供方：

服务消费方：

上游业务系统。

7.1.3　接口类型

读出

写入

读出写入

7.1.4　输入参数

参数信息：

是否必填

字段名称

字段描述

数据类型

字段约束

ARCHIVE_ID

档案标识

VARCHAR2（64）

系统简称_档案唯一标示

COMPANY_ID

公司代码

见《代码体系编制规则v1.5》2.2.1公司代码的编制方法