《档案管理系统与企业HR系统集成全流程实操技术指南》

一、集成前置准备（10分钟完成）

完成3项权限配置与环境准备，无需代码基础即可启动：

• 步骤1：HR系统API权限开启：登录HR系统后台→「系统设置→第三方集成」，开启API接口访问，生成固定Bearer Token并复制备用。
• 步骤2：档案系统接收权限开启：登录档案系统后台→「数据接口→外部数据导入」，开启外部API数据接收，生成对应Token并复制备用。
• 步骤3：执行环境搭建：
  • 安装Python 3.8+：Linux执行sudo apt install python3 python3-pip；Windows官网下载安装，勾选「Add Python to PATH」
  • 安装依赖库：执行pip install requests

二、核心集成脚本编写（15分钟完成）

脚本实现「拉取HR员工数据→转换字段→推送档案系统」全流程，替换配置项即可使用：

2.1 完整脚本代码

打开记事本粘贴以下内容，替换【】内的自定义信息，保存为hr_archive_sync.py：

```python import requests 【配置项：替换为你的实际信息】 HR_API_URL = "https://你的HR系统域名/api/v1/employees" HR系统员工数据API地址 HR_TOKEN = "你的HR系统Bearer Token" ARCHIVE_API_URL = "https://你的档案系统域名/api/v1/records" 档案系统数据接收API地址 ARCHIVE_TOKEN = "你的档案系统Bearer Token" 请求头：固定格式，勿修改 HR_HEADERS = {"Authorization": f"Bearer {HR_TOKEN}", "Content-Type": "application/json"} ARCHIVE_HEADERS = {"Authorization": f"Bearer {ARCHIVE_TOKEN}", "Content-Type": "application/json"} def sync_data(): try: 1. 从HR系统拉取员工数据 hr_resp = requests.get(HR_API_URL, headers=HR_HEADERS, timeout=10) hr_resp.raise_for_status() 自动检测请求是否成功 emp_list = hr_resp.json() print(f"拉取到{len(emp_list)}条员工数据") 2. 逐条转换字段（根据两个系统实际字段调整） for emp in emp_list: 示例映射：HR字段名→档案字段名，如HR的"join_time"对应档案的"entry_date" archive_data = { "emp_id": emp["id"], "name": emp["name"], "dept": emp["department"], "entry_date": emp["join_time"], "status": "在职" if emp["is_active"] else "离职" } 3. 推送数据到档案系统 archive_resp = requests.post(ARCHIVE_API_URL, headers=ARCHIVE_HEADERS, json=archive_data, timeout=10) archive_resp.raise_for_status() print(f"同步员工{emp['name']}成功") except requests.exceptions.SSLError: print("SSL证书错误：测试环境可加verify=False（生产环境勿用）") except Exception as e: print(f"同步失败：{str(e)}") if __name__ == "__main__": sync_data() ```

2.2 脚本调试操作

终端进入脚本目录，执行python hr_archive_sync.py：若打印「同步成功」则正常；若提示字段缺失，修改代码中emp["字段名"]为HR系统实际返回的字段名；若提示权限错误，核对Token是否过期或复制正确。

三、定时自动同步配置（5分钟完成）

避免手动执行，配置每2小时自动同步（生产环境最低间隔1小时）：

3.1 Linux系统（Cron）

执行crontab -e，文末添加以下内容（替换脚本绝对路径）：

0 /2 /usr/bin/python3 /home/你的用户名/hr_archive_sync.py >> /var/log/hr_sync.log 2>&1

保存退出后生效，日志输出同步状态至指定文件。

3.2 Windows系统（任务计划）

1. 打开「任务计划程序→创建基本任务」，名称设为「HR档案同步」
2. 触发器：每天，起始时间设为当前时间后1分钟，重复频率每2小时
3. 操作：启动程序，程序路径选Python.exe（如C:\Python310\python.exe），添加参数为脚本完整路径（如D:\scripts\hr_archive_sync.py）

四、集成后验证与常见排查

确保数据准确，完成3项检查：

• 数据字段校验：对比两个系统中3条随机员工的姓名、部门、入职时间，必须完全一致
• 异常排查：
  • 权限错误：重新在系统后台生成Token，替换脚本中对应项
  • 网络错误：执行ping 对方系统域名，确保网络连通
  • 字段错误：修改脚本中字段映射代码，匹配两个系统的实际字段名
• 增量同步优化：数据量较大时，在HR API后添加时间参数，仅同步新增员工（示例：HR_API_URL = "https://你的HR地址/api/v1/employees?after=上次同步时间"）