档案管理软件与公文系统不兼容？5步实操方案快速解决适配问题

本文适用于政务、企业内部档案管理软件与公文系统出现的格式不识别、接口调用失败、运行环境冲突三类常见兼容问题，无技术背景的行政、运维人员均可按照步骤操作落地。

前置准备：先定位不兼容的具体类型

1.1 排查3类常见不兼容场景

• 数据格式不兼容：公文办结后导出的归档包上传档案系统提示格式错误、字段不匹配
• 接口不兼容：两套系统打通后数据自动同步失败，返回400/500/签名校验失败错误码
• 运行环境不兼容：两套系统要求的浏览器版本、插件冲突，无法同时正常操作

1.2 工具与资料准备

• 公文系统导出的原始归档包1份（不要修改文件后缀）
• 档案系统官方格式规范文档：可在系统「帮助中心-归档接口说明」直接下载，找不到可向供应商索要符合GB/T 39362-2020标准的适配模板
• 谷歌浏览器114及以上版本：https://www.google.cn/chrome/index.html
• 开源格式转换工具Pandoc 3.1.9版本：https://github.com/jgm/pandoc/releases/tag/3.1.9，根据操作系统选择对应安装包

实操步骤：分场景解决不兼容问题

2.1 数据格式不兼容解决步骤

第一步：提取公文系统原始元数据，打开公文系统已办结发文列表，找到需归档的公文，点击「导出归档包」，选择「导出原始元数据（含XML标识）」，不要选择「导出为PDF/docx」，导出后解压到本地文件夹，找到后缀为.xml的元数据文件。

第二步：配置字段映射规则，打开档案系统格式规范中的「归档元数据字段映射表」，将导出的XML字段与规范字段一一对应，例如公文系统的「发文号」对应档案系统的「文件字号」、「拟稿人」对应「责任者」，将以下映射配置保存为「公文转档案映射.xslt」，和XML文件放在同一文件夹：

```xslt <档案元数据> <责任者> <文件字号> <成文日期> <标题> <保管期限> <密级> ```

第三步：批量转换格式，Windows按Win+R输入cmd回车打开命令行，进入XML文件所在文件夹，执行以下命令转换格式：

``` pandoc -s 原始公文元数据.xml --xsl 公文转档案映射.xslt -o 符合档案规范的元数据.xml ```

将转换后的XML文件和原公文正文PDF打包，上传档案系统即可，不会出现格式报错。

2.2 接口不兼容解决步骤

第一步：定位错误原因，打开公文系统「系统设置-接口管理-归档接口日志」，查看报错请求的返回信息：如果是「字段缺失/格式错误」，直接用2.1的字段映射规则补全调整；如果是「签名校验失败」走第二步；如果是「跨域请求被拦截」走第三步。

第二步：统一国密SM3签名算法，目前政务系统统一要求使用SM3签名，先执行命令安装国密依赖：pip install gmssl，再使用以下代码生成符合要求的签名：

```python from gmssl import sm3, func def sm3_sign(key, data): key_bytes = key.encode('utf-8') data_bytes = data.encode('utf-8') sign_data = key_bytes + data_bytes signature = sm3.sm3_hash(func.bytes_to_list(sign_data)) return signature 调用示例 if __name__ == '__main__': 签名密钥向档案系统供应商索要 sign_key = "档案系统分配的专属签名密钥" data为要传输的归档元数据JSON字符串 post_data = '{"责任者":"张三","文件字号":"XX发〔2024〕1号","成文日期":"2024-01-01"}' print(sm3_sign(sign_key, post_data)) ```

将生成的签名放在接口请求头的sign字段中，重新调用接口即可。

第三步：解决跨域问题，如果是浏览器调用接口报跨域错误，在公文系统的Nginx配置中添加以下规则，重启Nginx即可：

```nginx location /archive-api/ { 替换为档案系统的内网IP和端口 proxy_pass http://192.168.1.100:8080/; add_header Access-Control-Allow-Origin ; add_header Access-Control-Allow-Methods "GET, POST, OPTIONS"; add_header Access-Control-Allow-Headers "sign, Content-Type"; if ($request_method = OPTIONS) { return 204; } } ```

2.3 运行环境不兼容解决步骤

第一步：创建浏览器独立配置文件，打开谷歌浏览器，点击右上角头像，选择「添加」，创建两个独立的配置文件，分别命名为「公文系统」和「档案系统」。

第二步：单独配置兼容规则，打开「公文系统」配置文件，地址栏输入chrome://flags/unsafely-treat-insecure-origin-as-secure，将公文系统内网地址填入后启用该配置，再安装公文系统要求的专属插件；同理打开「档案系统」配置文件单独配置对应的兼容规则，两个配置文件互不干扰，不会出现插件冲突问题。

验证与长期适配方案

3.1 功能验证

配置完成后依次完成三类测试：1. 单份公文手动归档测试；2. 100份公文批量归档测试；3. 涉密公文跨系统流转测试，所有测试通过即可正式投入使用。

3.2 长期适配建议

如果需要彻底解决兼容问题，可要求两套系统供应商按照GB/T 39362-2020《政务服务事项归档规范》统一元数据字段、接口规范、签名算法，无需自行做中间转换即可实现数据自动流转。