统一数字档案系统接口规范说明

中国移动通信IBM项目组2013年04月统一数字档案归档接口规范说明2版本控制版本修订时间修订人修订内容修订页码1.02013-3-28创建新版本1.52013-4-19将规范文件改为链接3增加归档文件数据类型5更新反馈接口名称，调整了接口的参数（具体见《02_CMCC_统一数字档案系统_接口规范_v1.4》）7，8新增接口机配置及文件格式要求12,131.62013-4-23将链接改为文件名3更新文件格式要求133统一数字档案接口规范文件构成统一数字档案接口规范文件由接口规范、档案元数据规范、电子文件封装规范以及元数据与档案分类数据映射表四个文件构成。1.概述了外围接口的归档内容、归档过程、概述了接口的实现方式；2.详细描述了提供的外围系统的接入接口，包括Webservice接口、中间表接口和FTP接口，内容包括输入参数，输出参数，字典表和注意事项；1.定义了档案文件中的138项元数据，包括名称、定义、约束、类型、可重复、缺省值等内容；2.定义了15大类共28小类档案的著录项的元数据构成；1.电子文件封装规范规定了对档案电子文件的封装格式，该格式既用于将著录项信息封装为XML文件，也用于系统内部的文件比对校验；2.外部系统需要将各类档案的著录项，映射为电子文件封装规范中规定的属性信息，并通过接口归档到统一数字档案系统中；1.本表格主要用于说明接口传递过程中，每类档案采用电子文件封装规范规定的著录项信息该如何组织和封装。用于定义著录项的元数据的详细属性信息请参照《档案元数据规范》。2.针对每一个元数据项，都定义了数据来源。对于上游系统而言，需要针对每一类档案提供数据来源中标明来自于上游系统的数据项。02_CMCC_统一数字档案系统_接口规范_v1.503_CMCC_统一数字档案系统_档案元数据规范_V1.204_CMCC_统一数字档案系统_电子文件封装规范_V1.405_CMCC_统一数字档案系统_元数据与档案分类数据映射表4档案归档接口过程OA系统接口机档案系统合同系统工程系统……山西业务系统OA系统合同系统工程系统……山东业务系统OA系统合同系统工程系统……内蒙业务系统……接口机接口机接口机接口机接口机档案的归档是由业务系统、接口机和档案系统三部分共同完成。业务系统负责将业务数据按照接口规范转换为接口机可以识别的数据；接口机负责为数据的预处理与传输；档案系统负责收集最终数据并执行相应的业务操作。预归档库归档库实时采集接口批量采集接口实时采集接口批量采集接口实时采集接口批量采集接口实时采集接口批量采集接口历史数据现有数据5业务系统档案归档过程中的数据类型通过将档案数据分为著录项信息、正文、附件、底稿和流转单五种类型，档案和业务系统之间完成了文书、招投标、合同、工程、会计、审计和特殊载体档案7个档案分类的同步。著录项信息档案著录项信息格式为XML正文正文的Word正文的PDF档案附件格式为rar/zip压缩包，包含：附件的原文附件的PDF，与原文同名底稿正文的Word流转单格式为:mht或html档案系统文书档案合同档案招投标档案工程档案会计档案特殊载体档案审计档案OA系统文书档案招投标系统招投标档案合同系统合同档案……系统……档案统一数字档案归档接口和历史数据迁移接口6序号服务名称服务功能描述服务类型提供方消费方读/写1.外围系统档案归档信息服务将可归档的文件进行归档生成档案或对已归档但又有内容变更的文件进行再次归档Webservice统一数字档案管理系统上游业务系统写入2.外围系统档案归档信息服务将可归档的文件进行归档生成档案或对已归档但又有内容变更的文件进行再次归档中间表统一数字档案管理系统上游业务系统写入3.原有档案系统数据迁移信息服务各省原有档案系统通过该接口完成系统中原有档案数据向统一数字档案管理系统迁移中间表统一数字档案管理系统原有档案系统写入上游业务系统上游业务系统中间逻辑数据库数据接口程序数字档案管理系统数字档案管理系统待归档档案信息提取写入（中间库方式接口总体架构图）待归档FTP服务器待归档档案正文、附件、著录项、底稿、流转单提取预归档库预归档库上游业务系统XML信息包WebService接收写入档案系统数据库Web服务方式接口总体架构图待归档FTP服务器待归档档案正文、附件、著录项、底稿、流转单读取档案信息7档案归档接口外围系统需开发程序说明接口前期设置：客户端FTP程序（档案文件同步接口）FTP服务器端客户端程序（档案信息同步接口），支持webservice及中间表省接口节架构①②Webservice服务③结果收集程序（档案校验结果反馈接口），支持webservice和中间表数据校验（准确性和完整性）④⑤FTP客户端程序成功FTP服务端打包/加密集团接口节架构解密/解包/校验数据归档各省档案外围系统的归档程序写日志统一数字档案平台档案文件同步模块：开发FTP客户端程序，负责调用接口机FTP服务。主要完成的功能是将前面所需的7类档案文件及著录项XML文件通过FTP协议的方式传送到部署在各省的接口机中。这个过程中需要记录接口调用的返回结果以备联调。档案信息同步模块：根据系统要求，选择采用WebService方式或中间表方式，开发客户端，负责调用接口机的服务端。主要完成的功能是将每个档案的属性信息（档案标识、档案名称、编写者、档案类型、档案附件数量、每个附件的大小、档案校验码等档案基本信息以及对应的调用接口的系统标识、系统名称等来源信息）传递给接口服务。这个过程中需要记录接口调用的返回结果以备联调。结果收集程序：开发服务端，接收接口机传过来的数据校验结果。外围系统程序说明8档案归档过程中的详细接口调用接口前期设置：客户端FTP程序（档案文件同步接口）FTP服务器端客户端程序（档案信息同步接口），支持webservice及中间表省接口节架构①②Webservice服务③结果收集程序（档案校验结果反馈接口），支持webservice和中间表数据校验（准确性和完整性）④⑤FTP客户端程序成功FTP服务端打包/加密集团接口节架构解密/解包/校验数据归档各省档案外围系统的归档程序写日志统一数字档案平台1.档案信息同步模块通过调用接口机提供的归档服务，同步需要传递的档案的信息。在接口调用失败的情况下，同步模块需要记录下失败的信息，并有重试的处理。2.档案文件同步模块通过调用接口机提供的FTP服务，同步需要传递的档案的档案内容。在接口调用失败的情况下需要相应的记录及重试的处理。3.（接口机完成过程）通过档案信息同步模块传递的档案信息，对档案文件同步接口传递的档案文件进行校验。针对每次档案信息同步接口调用所同步的档案信息进行校验，对失败的档案标识进行整理，调用档案校验结果反馈接口。4.结果收集程序通过接口机传递的数据校验结果，对错误的文件进行处理后，再通过档案信息同步模块进行归档处理。5.系统管理员可以通过接口界面查看归档的情况，以及出错信息。接口调用说明9统一数字档案接口使用前置准备工作---外围系统归档接口步骤工作项责任部门参考规范1按集团档案业务分类规范，确认各系统中文件在归档时，对应的档案分类档案室《七类档案管理规范》2按集团档案接口规范，确认各系统中文件在归档时，所需要填写的著录项，包括必填项、选填项和自定义项，以及这些项对应的值档案室《电子文件封装规范》《元数据与档案分类数据映射表》3按集团档案接口规范，确认各类档案提供的著录项信息在技术上能由各系统提供；信息管理部《元数据与档案分类数据映射表》4完成待归档系统的归档接口的开发信息管理部《CMCC_统一数字档案系统_接口规范》5根据待归档系统的类型和要求，配置归档数据归档到待归档库或归档库档案室6接口根据业务需要，支持业务系统采用按月、按天或实时的方式进行归档信息管理部10统一数字档案接口使用前置准备工作---历史数据归档接口步骤工作项责任部门参考规范1整理现有档案的历史数据的数据结构并提交信息管理部2整理现有档案历史数据的分类，与现有档案分类的对应关系档案室《七类档案管理规范》3整理现有档案历史数据的著录项，形成与现有档案历史数据的著录项的对应关系的描述文件并提交档案室《电子文件封装规范》《元数据与档案分类数据映射表》4完成待归档系统的归档接口的开发信息管理部《CMCC_统一数字档案系统_接口规范》接口机接入方式说明为保证数据传输的安全性及效率，采用接口机的方式，实现省公司本地系统与档案服务包一级平台的对接。建议针对全新支撑和迁移接管类采用方式一直接接入，针对规范互联类采用方式二间接接入档案数据接口机集团档案服务包一级平台省公司网络域山西移动网络域外围系统A外围系统B外围系统C档案数据接口机集团档案服务包一级平台省公司网络域山西移动网络域外围系统A外围系统B外围系统C原有档案系统方式一：直接接入外围待归档系统直接通过接口机完成到档案服务包一级平台的归档工作建议“河北、内蒙、宁夏、山东、山西、西藏”六省公司采用该方式方式二：间接接入外围待归档系统归档到旧有档案系统中，由旧有档案系统通过接口机完成到档案服务包一级平台的归档工作建议“上海、江苏、浙江”三省公司采用该方式11接口机配置要求•接口机硬件配置要求：性能约40万TPMC12项目参数数量备注CPU6核2C建议Intel5650内存32GB硬盘600GB2项目厂商版本备注操作系统RedhatLinux6.2省公司负责准备数据库软件MySQL省公司无需准备，接口机软件安装时将同时安装MySQL•接口机软件配置要求PDF文件格式要求13背景：•在接口讨论会上，集团综合部针对档案文件的导入提出了相应的格式要求，具体如下：•对于新接入的档案导入对象：正文和附件要求版本：原件、原件的PDF版•对于历史档案导入对象：前一年的档案正文和附件要求版本：原件、原件的PDF版PDF格式要求:对于文档型文件（TXT、WORD、PPT等），在转化为PDF文件后，需要能通过PDF的搜索框对PDF文件内容进行搜索。具体的PDF格式可以选用PDF1.4及以上。•接口规范联系人1415©2012IBMCorporation谢谢©2012中国移动版权所有保留一切权利