2.常德市电子公文归档数据交换接口要求（试行）
常德市电子公文归档数据交换接口要求
1 范围
本要求规定了常德市协同办公平台电子公文归档的数据交换接口内容。
本要求适用于开发人员、实施人员、接口系统开发商开发系统接口提供指导。
2 规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是标注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。
GB/T 33477-2016《党政机关电子公文标识规范》
GB/T 33480-2016《党政机关电子公文元数据规范》
GB/T 33482-2016《党政机关电子公文系统建设规范》
DA/T 22-2015《归档文件整理规则》
DA/T 46—2009《文书类电子文件元数据方案》
3 整体业务要求
3.1 对接范围
常德市委协同办公平台。
3.2 及归档元数据
序号 | 模块 | 是否归档 | 归档范围 | 归档元数据 | 说明 |
1 | 发文 | 是 | 附件、处理笺（发文稿纸）、正文、留痕稿（如有）、定稿（如有）、底稿（如有） | 3.3归档元数据 | 归档后，通过发文修改功能修改了公文，要重新归档，并对档案系统的数据做覆盖，需要OA确认一个唯一标识 |
发文台账、发文情况汇总表 | 公文标识:文件的唯一标识 标题：XXXX年发文台账、统计表 成文日期：XXXX年12月31日 | 按年为周期归档，每年归一次 | |||
2 | 收文 | 是 | 正文、附件、处理笺（包含发文处理笺） | 3.3归档元数据 | |
收文台账、收文情况统计表 | 公文标识:文件的唯一标识 标题：XXXX年收文台账、统计表 成文日期：XXXX年12月31日 | 按年为周期归档，每年归一次 | |||
3 | 通讯录 | 否 | \ | ||
4 | 领导干部外出请假 | 是 | 上报单位：正文（请假单)、处理笺； | 公文标识:文件的唯一标识 责任者：来文单位 标题：外出领导+外出事由 | |
5 | 紧急通知系统 | 否 | \ | ||
6 | 主要工作重要活动预安排 | 是 | 正文、附件、处理笺 | 公文标识:文件的唯一标识 标题：标题 责任者：拟稿部门 成文日期：会议通过或者发文机关负责人签发的日期 | |
7 | 智慧督查 | 是 | 立项：正文（督办函）、附件、处理笺 | 立项： 公文标识:文件的唯一标识 标题：标题 责任者：责任单位 成文日期：会议通过或者发文机关负责人签发的日期 摘要：工作内容 签收： 公文标识:文件的唯一标识 标题：标题 发文字号：来文字号 责任者：责任单位 成文日期：会议通过或者发文机关负责人签发的日期 摘要：工作内容 反馈： 表单信息对应字段说明： 公文标识:文件的唯一标识 标题：标题 发文字号：文号 责任者：拟稿单位 紧急程度：缓急 成文日期：会议通过或者发文机关负责人签发的日期 | 立项单位归：立项材料、反馈材料 |
督查事项总台账、各类督查事项台账 | 公文标识:文件的唯一标识 标题：XXXX年XX台账 成文日期：XXXX年12月31日 | 按年为周期归档，每年归一次 | |||
8 | 通知公告 | 否 | \ | 有内容、附件。内容通过富文本编辑器编辑，无电子签字及图形章 | |
9 | 内部发文 | 是 | 正文、附件、处理笺（发文稿纸）、留痕稿（如有）、定稿（如有）、底稿（如有） | 见3.3归档元数据 | |
内部发文台账、内部发文统计表 | 公文标识:文件的唯一标识 标题：XXXX年内部发文台账、统计表 成文日期：XXXX年12月31日 | 按年为周期归档，每年归一次 | |||
10 | 外部发文 | 是 | 正文、附件、处理笺（发文稿纸）、留痕稿（如有）、定稿（如有）、底稿（如有） | 见3.3归档元数据 | |
外部发文台账、外部发文统计表 | 公文标识:文件的唯一标识 标题：XXXX年外部发文台账、统计表 成文日期：XXXX年12月31日 | 按年为周期归档，每年归一次 | |||
11 | 工作请示 | 是 | 正文（请示单）、附件、处理笺（请示报告单） | 公文标识:文件的唯一标识 标题：标题 责任者：拟稿部门 成文日期：会议通过或者发文机关负责人签发的日期 摘要：说明 | |
12 | 经费请示 | 是 | 正文（经费请示单）、处理笺、附件 | 公文标识:文件的唯一标识 标题：标题 责任者：拟稿部门 成文日期：会议通过或者发文机关负责人签发的日期 | |
13 | 出差请假 | 是 | 处理签（审批单）、附件 | 公文标识:文件的唯一标识 标题：请假人姓名+事由说明 成文日期：会议通过或者发文机关负责人签发的日期 | |
14 | 开会其他 | 是 | 处理签（审批单）、附件 | 公文标识:文件的唯一标识 标题：请假人姓名+事由说明 成文日期：会议通过或者发文机关负责人签发的日期 | |
15 | 租车申请 | 是 | 处理签（申请单） | 公文标识:文件的唯一标识 标题：申请人+租车事由 责任者：申请科室 成文日期：会议通过或者发文机关负责人签发的日期 | |
16 | 公务用车 | 是 | 处理签（申请单） | 公文标识:文件的唯一标识 标题：事由 责任者：申请人所在部门 成文日期：会议通过或者发文机关负责人签发的日期 | |
17 | 公务接待 | 是 | 附件、处理笺（审批单） | 公文标识:文件的唯一标识 标题：标题 责任者：申报科室 成文日期：会议通过或者发文机关负责人签发的日期 | |
公务接待统计表 | 公文标识:文件的唯一标识 标题：XXXX年公务接待统计表 成文日期：XXXX年12月31日 | 按年为周期归档，每年归一次 | |||
18 | 加班用餐 | 是 | 处理签（审批单） | 公文标识:文件的唯一标识 标题：加班内容 责任者：申报科室 成文日期：会议通过或者发文机关负责人签发的日期 | |
19 | 资产购置 | 是 | 正文(采购调剂申请单)、附件、处理笺（购置处理单） | 公文标识:文件的唯一标识 标题：标题 责任者：拟稿部门 成文日期：会议通过或者发文机关负责人签发的日期 | |
20 | 资产处置 | 是 | 正文（处置请示单）、附件、处理笺（处置处理单） | 公文标识:文件的唯一标识 标题：标题 责任者：拟稿部门 成文日期：会议通过或者发文机关负责人签发的日期 | |
21 | 资产异动 | 是 | 正文（异动请示单）、附件、处理笺（异动处理单） | 公文标识:文件的唯一标识 标题：标题 责任者：拟稿部门 成文日期：会议通过或者发文机关负责人签发的日期 摘要：异动原因 | |
22 | 党组会议（行政办公会议） | 是 | 议题申报：正文、处理笺（议题申报审批单） | 公文标识:文件的唯一标识 标题：标题 发文字号：文号 责任者：拟稿单位 成文日期：会议通过或者发文机关负责人签发的日期 紧急程度：缓急 | 以会议为单位归档 |
23 | 常委会会议（政府常务会议） | 是 | 议题申报：正文、处理笺（议题申报审批单） | 公文标识:文件的唯一标识 标题：标题 发文字号：编号 责任者：拟稿单位 成文日期：会议通过或者发文机关负责人签发的日期 紧急程度：缓急 | 以会议为单位归档 |
24 | 会务管理 | 是 | 会议签到表 | 公文标识:文件的唯一标识 标题：XXXX会议签到表 成文日期：XXXX年XX月XX日（会议日期） | 以会议为单位归档 |
25 | 内参（政研内参） | 是 | 正文（原始版本）、处理笺（发文稿纸）、领导批示意见（领导批示版本）、附件 | 内参： 公文标识:文件的唯一标识 标题：标题+刊发期数 责任者：拟稿单位 成文日期：会议通过或者发文机关负责人签发的日期 紧急程度：紧急程度 附注：备注 政研内参： 公文标识:文件的唯一标识 标题：标题+刊发期数 责任者：拟稿单位 签发人：签发人 成文日期：会议通过或者发文机关负责人签发的日期 紧急程度：紧急程度 摘要：政研要目 | |
26 | 涉常舆情 | 是 | 正文（原始版本）、处理笺（发文稿纸）、领导批示意见（领导批示版本）、附件 | 公文标识:文件的唯一标识 标题：标题+刊发期数 责任者：拟稿单位 签发人：签发人 成文日期：会议通过或者发文机关负责人签发的日期 紧急程度：紧急程度 摘要：舆情要目 | |
27 | 常德要情（信息快报） | 是 | 正文（原始版本）、处理笺（发文稿纸）、领导批示意见（领导批示版本）、附件 | 公文标识:文件的唯一标识 标题：标题+刊发期数 责任者：拟稿单位 签发人：签发人 成文日期：会议通过或者发文机关负责人签发的日期 紧急程度：紧急程度 摘要：政研要目 | |
28 | 督查通报 | 是 | 正文（原始版本）、处理笺（督察室文件处理笺）、领导批示意见（领导批示版本）、附件 | 公文标识:文件的唯一标识 标题：标题+督办期数 责任者：拟稿部门 成文日期：会议通过或者发文机关负责人签发的日期 | |
29 | 防汛抗旱 | 是 | 正文（原始版本）、处理笺（收文处理笺）、领导批示意见（领导批示版本）、附件 | 公文标识:文件的唯一标识 标题：标题 责任者：拟稿单位 成文日期：会议通过或者发文机关负责人签发的日期 | |
30 | 省政府政务要情与交流 | 是 | 正文 | 公文标识:文件的唯一标识 标题：标题 责任者：拟稿单位 成文日期：会议通过或者发文机关负责人签发的日期 | |
31 | 日程安排（公文包） | 否 | \ | ||
32 | 大事记 | 是 | 正文、处理笺（值班室文件处理笺） | 公文标识:文件的唯一标识 标题：标题 发文字号：文号 责任者：拟稿单位 成文日期：会议通过或者发文机关负责人签发的日期 紧急程度：缓急 | |
33 | 报刊征订 | 否 | \ | ||
34 | 即时通讯 | 否 | \ | ||
35 | 领导工作日志 | 是 | 以周为单位形成工作日志 | 公文标识:文件的唯一标识 标题：XXXX年XX月XX日领导工作日志 成文日期：XXXX年XX月XX日 | |
36 | 考勤管理 | 否 | \ | ||
37 | 干部信息管理 | 是 | 在职干部信息：干部信息一览表、花名册 | 公文标识:文件的唯一标识 标题：XXXX年XX单位干部信息一览表 成文日期：XXXX年12月31日 | 以年为周期进行归档 |
38 | 我的传阅 | 否 | \ | ||
39 | 共享云盘 | 否 | \ | ||
40 | 生日提醒 | 否 | \ | ||
41 | 在线人数 | 否 | \ | ||
42 | 方案管理 | 是 | 考察调研方案：正文(XX活动调研方案)、附件、处理笺（值班室文件处理笺） | 考察调研方案： 公文标识:文件的唯一标识 标题：标题 成文日期：会议通过或者发文机关负责人签发的日期 公文标识:文件的唯一标识 标题：标题 成文日期：会议通过或者发文机关负责人签发的日期 附注：备注 公文标识:文件的唯一标识 标题：标题 成文日期：会议通过或者发文机关负责人签发的日期 摘要：主要内容 | |
方案管理台账 | 公文标识:文件的唯一标识 标题：XXXX年XX台账 成文日期：XXXX年12月31日 | ||||
43 | 道闸管理 | 否 | \ | ||
44 | 订餐管理 | 否 | \ | ||
45 | 全市功能运行情况统计报表 | 否 | \ | ||
46 | 会议室申报 | 否 | \ | ||
47 | 档案单套制 | 否 | \ | ||
48 | 领导干部来常报告 | 是 | 正文、处理笺（值班室文件处理笺）、附件 | 公文标识:文件的唯一标识 标题：具体内容 责任者：报告单位 成文日期：会议通过或者发文机关负责人签发的日期 |
3.3 归档格式
电子文件应以通用格式形成、收集并归档。其归档格式不应绑定特定软硬件，且具备开放、可转换、易与利用等特性。其中，文书类电子文件正本、集中记录修改过程的彩色留痕稿以及确有必要保存的重要修改稿、文件处理签应以OFD格式归档；附件-文本类应以OFD格式归档，附件-图像类应以JPG、TIF格式归档，附件-音频类应以WAV、MP3格式归档，附件-图形类应以SVG、STEP格式归档，附件-视频类应以AVI、MP51、MPG格式归档，附件-社交媒体类应以HTML、MHT格式归档。
3.4 归档流程
协同办公平台把流转结束需要归档的数据封装成预归档信息包推送到档案归档处理系统，由归档处理系统先进行数据包的真实性校验，校验成功后，再进行数据包的解析。流程如下:
4 预归档信息包描述
4.1 预归档信息包结构示意图
每份电子公文封装一个包，包含：元数据、内容数据。包结构参考如下:
4.1 预归档信息包结构详解
4.2.1 电子公文元数据.xml
文件名称 | 电子公文元数据.xml |
文件内容 | 电子公文的元数据信息，包括：目录元数据、过程信息元数据、电子文件元数据 |
是否必须 | 必须 |
举例 | <?xml version="1.0" encoding="GB18030"?> <元数据> <文件信息> <文件> <公文标识> </公文标识> <发文字号> </发文字号> <发文机关> </发文机关> <标题> </标题> <成文日期> </成文日期> <文种> </文种> <附注> </附注> … </文件> <全文> <全文信息> <文件名称> </文件名称> <文件格式> </文件格式> <文件大小> </文件大小> ... </全文信息> <全文信息> <文件名称> </文件名称> <文件格式> </文件格式> <文件大小> </文件大小> ... </全文信息> <全文信息> .... </全文信息> </全文> <过程> <过程信息> <记录流水号> </记录流水号> <处理类型> </处理类型> <处理者> </处理者> <处理部门> </处理部门> <处理时间> </处理时间> <处理结果> </处理结果> … </过程信息> <过程信息> <记录流水号> </记录流水号> <处理类型> </处理类型> <处理者> </处理者> <处理部门> </处理部门> <处理时间> </处理时间> <处理结果> </处理结果> … </过程信息> <过程信息> ... </过程信息> <过程> </文件信息> </元数据> |
注释 | 无 |
层次结构 | 无 |
4.2.2 电子公文文件夹
名称 | 电子公文文件夹 |
目的 | 存放电子公文内容及其元数据 |
命名规则 | 以公文标识能够唯一标识电子公文的编号命名，便于区别不同的文件 |
是否必须 | 是 |
说明 | 电子公文内容数据包括文件处理笺、正文、底稿、留痕稿、正稿、附件等；其中电子签章转换为图形化章。 |
注释 | 无 |
层次结构 |
|
4.2 元数据
4.2.1 目录元数据
数据元 | 数据类型 | 值域 | 是否必填 | 备注 |
发文单位机构代码 | VARCHAR2(200) | 必填 | 发文单位机构代码 | |
公文标识 | VARCHAR2(100) | 参 考 《 党 政 机 关 电 子 公 文 元 数 据 规 范 》 GB/T 33480 - 2016 | 必填 | 电子公文的唯一标识，用以区别其他公文。做重复数据判断标识 |
文种 | VARCHAR2(50) | 可选 | 公文的种类 | |
份号 | VARCHAR2(50) | 可选 | 公文印刷份数的顺序号 | |
密级 | VARCHAR2(10) | 必填 | 公文的秘密登记 | |
保密期限 | VARCHAR2(50) | 必填 | 公文的保密期限 | |
紧急程度 | VARCHAR2(50) | 可选 | 对公文送达和办理的时限要求 | |
发文机关标志 | VARCHAR2(50) | 可选 | 发文机关全称或者规范化简称,其后添加特定标志 | |
发文字号 | VARCHAR2(500) | 可选 | 由发文机关代字、年份、发文顺序号组成 | |
签发人 | VARCHAR2(200) | 可选 | 签发公文人员的姓名 | |
题名 | VARCHAR2(500) | 必填 | 公文题名 | |
主送机关 | VARCHAR2(500) | 可选 | 公文的主要受理机关 | |
附件说明 | VARCHAR2(500) | 可选 | 公文附件的顺序号和名称 | |
发文机关或签发人署名 | VARCHAR2(100) | 可选 | 发文机关的全称或者规范化简称 | |
成文日期 | DATE | 必填 | 会议通过或发文机关负责人签发的日期YYYY-MM-DD | |
附注 | VARCHAR2(200) | 可选 | 公文印发传达范围等需要说明的事项 | |
抄送机关 | VARCHAR2(500) | 可选 | 除主送机关外需要执行或知晓公文内容的其他机关 | |
印发机关 | VARCHAR2(500) | 可选 | 公文的印送机关 | |
印发日期 | DATE | 可选 | 公文的送印日期 | |
发布层次 | VARCHAR2(50) | 可选 | 公文允许传达的范围 | |
年度 | NUMBER | 必填 | 电子文件按年度分类后标记的行成处理年度,成文日期所在年度 | |
页数 | NUMBER | 可选 | 电子全文的页数和 | |
责任者 | VARCHAR2(500) | 必填 | 对电子文件内容进行创造、负有责任的团体或个人 发文：发文起草单位或部门；外部收文：来文单位 | |
公文模块 | VARCHAR2(50) | 必填 | OA对应的模块 | |
收文编号 | VARCHAR2(50) | 收文模块必填，其它模块选填 | 收文流水号 | |
VARCHAR2(500) | 必填 | 归档部门编码 | ||
摘要 | VARCHAR2(200) | 可选 | ||
环境信息 | VARCHAR2(500) | 可选 | 信息系统的名称、版本、功能、开发商名称 | |
软件环境 | VARCHAR2(250) | 可选 | 形成和处理文档的程序名称和版本 | |
硬件环境 | VARCHAR2(250) | 可选 | 信息系统运行的硬件环境 | |
4.2.2 过程信息元数据
数据类型 | 是否必填 | 备注 | |
处理者 | VARCHAR2(50) | 必填 | |
处理时间 | DATE | 必填 | |
处理类型 | VARCHAR2(50) | 必填 | |
处理结果 | VARCHAR2(1000) | 必填 | |
处理部门 | VARCHAR2(50) | 必填 | |
OA过程信息Id | VARCHAR2(20) | 必填 | OA的过程信息主键 |
4.2.3 电子全文元数据
数据元 | 数据类型 | 是否必填 | 备注 |
序号 | NUMBER | 必填 | 文件顺序号，按照正本-定稿-公文处理单-附件-底稿排序 |
电子文件类别 | VARCHAR2(50) | 必填 | 正本、定稿、公文处理单、附件、底稿 |
页数 | NUMBER | 可选 | 单个文件的页数 |
文件名称 | VARCHAR2(100) | 必填 | 文件名称 |
OA全文id | VARCHAR2(20) | 必填 | OA的全文主键 |
文件大小 | VARCHAR2(10) | 必填 | 单位kb |
文件格式 | VARCHAR2(50) | 必填 | 文件格式 |
文件摘要码 | VARCHAR2(100) | 必填 | 每个文件的sm3摘要码 |
5 接口方案
5.1 地址
归档流程采用webservice接口，完成实时归档。
接口路径 | http://IP:8080/context/services/soap/EdaDataPkgTransfer?wsdl |
请求方式 | post |
请求参数 | String strIdentifierCode，String pkgPath，String token，String fileName，String orgCode |
接口说明 | 业务系统推送数据包给档案系统 |
5.2 接口参数
服务名 | 服务 描述 | 传入参数 | 返回结果 | ||||
参数名 | 参数类型 | 说明 | 变量名 | 类型 | 说明 | ||
putArchivingDocuments | 推送归档电子公文 | strIdentifierCode | String | 归档信息包唯一标识 | returnMessage | String | 成功与否的代码与信息，返回“0”：文件接收成功；返回“1：失败信息！”： 文件接收失败； |
pkgPath | String | FTP服务器上的文件路径。例：/data/0001/202110/YJ-J0086-2018-201808020136.zip | |||||
token | String | 对整个信息包进行加密（sm3）生成的摘要码 | |||||
fileName | String | 归档信息包名（ZIP文件名）。例： YJ-J0086-2018-201808020136.zip | |||||
orgCode | String | 单位机构代码 | |||||
5.3 接口调用示例
Java语言：
java.rmi.RemoteException;
import javax.xml.namespace.QName;
import javax.xml.rpc.ParameterMode;
import javax.xml.rpc.ServiceException;
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.axis.encoding.XMLType;
public class TestEdaDataPkgTransferService {
public static void main(String[] args) {
//webService访问地址
String url = "http://127.0.0.1:8080/jzsdas3.8.2/services/soap/EdaDataPkgTransfer";
//创建服务
Service service = new Service();
//创建调用句柄
Call call;
try {
call = (Call) service.createCall();
//设置请求地址
call.setTargetEndpointAddress(url);
call.setOperationName(new QName("http://service.webservice.archive.component.ces.com/","putArchivingDocuments"));
call.addParameter(new QName("http://service.webservice.archive.component.ces.com/","strIdentifierCode"), XMLType.XSD_STRING, ParameterMode.IN);
call.addParameter(new QName("http://service.webservice.archive.component.ces.com/","pkgPath"), XMLType.XSD_STRING, ParameterMode.IN);
call.addParameter(new QName("http://service.webservice.archive.component.ces.com/","token"), XMLType.XSD_STRING, ParameterMode.IN);
call.addParameter(new QName("http://service.webservice.archive.component.ces.com/","fileName"), XMLType.XSD_STRING, ParameterMode.IN);
call.addParameter(new QName("http://service.webservice.archive.component.ces.com/","orgCode"), XMLType.XSD_STRING, ParameterMode.IN);
call.setReturnType(XMLType.XSD_STRING);
String result = (String) call.invoke(new Object[] {"YJ-J0086-2018-201808020136","/data/0001/202110/YJ-J0086-2018-201808020136.zip","bf24a0d2a5b9c3375514f0a0acef93613cc7c7d9ebc32c58a9dfe7c699af09a6","YJ-J0086-2018-201808020136.zip","0002"});
System.out.println(result);
} catch (ServiceException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (RemoteException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
}
5.4 预归档信息包上传接口
考虑到预归档信息包包含的全文较大，因此使用FTP上传，用于上传预归档信息包到指定服务器的指定位置。
FTP服务器的基本信息为，
IP：
端口：
用户名：
密码：
Java语言可以使用commons-net-3.0.1.jar中的FTPClient进行FTP上传。
示例：
myFtp.connect("192.168.1.106", 21, "user1", "passWord");
String remote = "YJ-J0086-2018-201808020136.zip";
String local = "G:/YJ-J0086-2018-201808020136.zip";
myFtp.upload(local, "/J0086/2018/" + remote);
myFtp.disconnect();
参数说明：
第一个参数：FTP服务器ip 例：192.168.1.106
第二个参数：FTP端口 例：21
第三个参数：用户名 例：user1
第四个参数：密码 例：passWord
第五个参数：本地文件路径 例：G:/ YJ-J0086-2018-201808020136.zip
第六个参数：FTP服务器上的文件路径，按单位，时间创建目录。
例：/data/0001/202110/YJ-J0086-2018-201808020136.zip
5.5 字段样例
Ø 文件
数据元 | 实例 |
公文标识 | |
发文字号 | 档办发﹝2015﹞309号 |
机关代字 | 档办发 |
文号年度 | 2015 |
序号 | 1号 |
标题 | 关于五一放假的通知 |
发文机关 | |
成文日期 | YYYYMMDD |
页数 | 5 |
文种 | |
附注 |
Ø 电子全文
数据元 | 实例 |
序号 | |
文件名称 | xxx.pdf |
文件格式 | |
文件大小 | 200K |
Ø 过程信息
数据元 | 实例 |
处理类型 | 拟稿 |
处理人 | 张三 |
处理部门 | 办公室 |
处理时间 | 2015-5-1 12:25 |
处理意见 | 同意 |
