区县/企事业单位自建档案标准接入金华数字档案馆系统实操

前置准备：配齐基础硬件与前置条件

硬件/网络配置（自建档案服务器最低要求）

• CPU：Intel Xeon E3-1270 v6 或同等性能及以上
• 内存：16GB DDR4 ECC 或以上
• 存储：系统盘256GB SSD，数据盘至少预留2TB（非SSD/普通机械需做RAID5冗余）
• 网络：申请接入金华市电子政务外网（内网带宽≥100Mbps，固定IP地址1个）

前置软件与材料

• 前置软件：CentOS 7.9 或 Windows Server 2019（推荐CentOS更稳定）、JDK 1.8.0_341、MySQL 8.0.32、Redis 6.2.7
• 材料：提前联系金华市档案馆信息技术科（电话：0579-82469872）获取接入申请表、元数据映射模板V3.2、API接入文档V4.0
• 账号：提交接入申请表后3个工作日内，获取API对接的app_id、app_secret、测试库地址

步骤一：配置自建档案基础环境

CentOS 7.9下一键配置依赖环境（复制粘贴即用）

执行前需先用root权限登录服务器，或每步前加sudo。

```bash 1. 安装JDK 1.8.0_341 yum install -y java-1.8.0-openjdk-devel 验证安装：输出openjdk version "1.8.0_xxx"即成功 java -version 2. 安装MySQL 8.0.32 wget https://repo.mysql.com/mysql80-community-release-el7-7.noarch.rpm rpm -ivh mysql80-community-release-el7-7.noarch.rpm yum install -y mysql-community-server 启动MySQL并设置开机自启 systemctl start mysqld systemctl enable mysqld 获取初始root密码 grep 'temporary password' /var/log/mysqld.log 登录MySQL修改密码（替换temp_pwd为获取的初始密码，new_root_pwd为自定义8位以上含大小写字母+数字+符号的密码） mysql -uroot -p'temp_pwd' ALTER USER 'root'@'localhost' IDENTIFIED BY 'new_root_pwd'; FLUSH PRIVILEGES; EXIT; 3. 安装Redis 6.2.7 yum install -y epel-release yum install -y redis6 启动Redis并设置开机自启 systemctl start redis6 systemctl enable redis6 验证Redis连接 redis6-cli ping 输出PONG即成功 ```

步骤二：完成元数据映射与本地数据准备

元数据映射规则（按V3.2模板严格执行）

下载模板后，找到“金华市档案馆元数据标准字段”sheet，自建档案的字段需与该sheet中必填字段（标注）完全对齐：

• 全宗号：必须从申请表获批的专属全宗号获取，格式为JHDXXXXX（JH固定，D代表电子政务/自建全宗）
• 年度：4位阿拉伯数字，如2024
• 保管期限：永久、30年、10年三选一，必须用全称
• 档案分类号：按申请时提交的分类方案填写，如文书类W01
• 件号：年度内同分类号同保管期限下的连续流水号，4位补零，如0001

本地数据格式转换（只接受两种标准格式包）

两种格式二选一，推荐用DA/T 48-2009 OFD+XML格式包（DA/T 48是档案行业标准，不可篡改）：

• OFD+XML包：每个归档文件件生成独立文件夹，命名为<全宗号>-<年度>-<保管期限代码>-<分类号>-<件号>（如JHD00123-2024-Y-W01-0001，永久代码Y、30年C、10年D），文件夹内放：
  • OFD格式的正文文件（扫描件需用DA/T 48扫描参数生成OFD，分辨率≥300dpi，黑白）
  • XML格式的元数据文件（命名同文件夹名，内容按V3.2模板转换后的XML格式）
• ZIP压缩包：将所有OFD+XML独立文件夹压缩成单个ZIP，压缩级别选择存储或标准，密码留空

步骤三：本地对接测试（调用API上传验证）

获取API访问令牌（access_token）

使用Postman或curl调用获取令牌接口，有效期2小时，过期需重新获取：

```bash curl命令示例（替换下方app_id、app_secret、测试库地址） curl -X POST "https://test-jhda.jinhua.gov.cn/api/v1/auth/token" \ -H "Content-Type: application/json" \ -d '{ "app_id": "your_app_id", "app_secret": "your_app_secret" }' 返回结果示例（提取access_token字段备用） { "code": 200, "msg": "success", "data": { "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", "expires_in": 7200 } } ```

测试上传单个OFD+XML文件夹压缩的ZIP包

继续用curl或Postman调用上传接口，测试库地址必须用提供的：

```bash curl命令示例（替换access_token、测试库地址、ZIP包本地路径） curl -X POST "https://test-jhda.jinhua.gov.cn/api/v1/archive/upload" \ -H "Authorization: Bearer your_access_token" \ -F "file=@/home/archive/test_archive.zip" 返回结果示例（返回archive_id说明上传成功，保存该ID用于后续查询） { "code": 200, "msg": "success", "data": { "archive_id": "JHD00123-2024-Y-W01-0001_20240520123456" } } ```

查询上传验证结果

上传后5分钟内调用查询接口：

```bash curl命令示例（替换archive_id、access_token、测试库地址） curl -X GET "https://test-jhda.jinhua.gov.cn/api/v1/archive/query?archive_id=your_archive_id" \ -H "Authorization: Bearer your_access_token" 验证通过返回："status": "verified"；验证失败返回："status": "failed" + "error_msg"（按提示修改元数据或文件格式） ```

步骤四：正式上线与数据上传

切换正式库环境

测试通过3个批次（每批次至少100件）后，联系金华市档案馆信息技术科申请切换正式库，获取正式app_id、正式app_secret、正式库地址，替换步骤三的对应参数。

批量上传正式数据的注意事项

• 单个ZIP包大小不超过500MB，建议每批次100-500件归档文件
• 正式库上传后10分钟内会完成归档审核，审核通过后数据不可修改、删除
• 审核失败的批次会返回详细的错误列表，需按要求重新整理后上传

定期同步全宗数据（可选，建议每月1次）

使用同步接口可以确认本地已上传的数据与正式库一致：

```bash curl命令示例（替换全宗号、起始年度、结束年度、access_token、正式库地址） curl -X GET "https://jhda.jinhua.gov.cn/api/v1/archive/sync?fonds_code=JHD00123&start_year=2024&end_year=2024" \ -H "Authorization: Bearer your_access_token" ```