OA资产绑定数据同步HR系统程序开发文档

# 1.   文档说明

本文档作为乐的文化管理系统的员工资产使用数据同步程序，对全国所有门店员工名下资产概况信息做自动同步更新程序的开发文档，对项目中使用的技术标准和技术开发方案进行描述。

# 2.   项目目标

由于员工离职手续办理时，在员工离职确认环节中，需要对该员工的名下资产进行统计查看，确保员工当名下无登记资产后方可确认其离职。但是离职确认是在HR系统中进行操作，而资产信息却在OA系统中记录，此时需要将OA系统中员工资产情况同步到HR系统中，由HR系统中的流程节点中来自动读取，并自动判断是否可以确认离职。

通过以上目标的实现，最终可以达到员工离职时可以快速查看资产情况，并快速判断是否可以确认离职的需求，以达到整个数据即时性、完整性、统一性、安全性、可追溯性机制，从而满足工作需要，提高工作效率。

# 3.数据表设计

| 表 名       | EmployeeAssetsCount   |             |         |          |       |
| ----------- | --------------------- | ----------- | ------- | -------- | ----- |
| 中文描述    | HR系统-员工资产统计表 |             |         |          |       |
| 建立日期    | 2023-03-14            |             |         | 修改日期 |       |
| 列 名       | 中文描述              | 数据类型    | 空/非空 | 是否主键 | 备 注 |
| Work_no     | 员工号                | varchar(10) | 否      | 是       |       |
| Work_name   | 员工姓名              | varchar(30) | 否      | 否       |       |
| Asset_count | 资产计数              | int         | 否      | 否       |       |
| 补充说明    | 业务需要，新增表      |             |         |          |       |

| 表 名    | per_dimission_order       |             |         |          |       |
| -------- | ------------------------- | ----------- | ------- | -------- | ----- |
| 中文描述 | HR系统-人力资产基本信息表 |             |         |          |       |
| 建立日期 |                           |             |         | 修改日期 |       |
| 列 名    | 中文描述                  | 数据类型    | 空/非空 | 是否主键 | 备 注 |
| emp_no   | 员工号                    | varchar(10) | 否      | 是       |       |
| 补充说明 |                           |             |         |          |       |

| 表 名    | hrmresource               |             |         |          |       |
| -------- | ------------------------- | ----------- | ------- | -------- | ----- |
| 中文描述 | OA系统-人力资产基本信息表 |             |         |          |       |
| 建立日期 |                           |             |         | 修改日期 |       |
| 列 名    | 中文描述                  | 数据类型    | 空/非空 | 是否主键 | 备 注 |
| id       | 资源ID                    | Int         | 否      | 是       |       |
| Workcode | 员工号                    | varchar(10) | 否      | 否       |       |
| 补充说明 |                           |             |         |          |       |

| 表 名      | Cptcapital                  |          |         |          |                   |
| ---------- | --------------------------- | -------- | ------- | -------- | ----------------- |
| 中文描述   | OA系统-资产和资产资料主信息 |          |         |          |                   |
| 建立日期   |                             |          |         |          |                   |
| 列 名      | 中文描述                    |          |         |          |                   |
| resourceid | 使用人(资料管理员)          | 数据类型 | 空/非空 | 是否主键 | 备  注            |
| stateid    | 状态                        |          |         |          | 取值：2（使用中） |
| 补充说明   |                             |          |         |          |                   |

# 4.数据字典/全局变量

## 4.1 数据字典

| **字典名称** | **类   型** | **键** | **值** |
| ------------------ | ----------------- | ------------ | ------------ |
|                    |                   |              |              |

## 4.2 全局变量

| **变量名称** | **访问路径** | **值** | **说  明** |
| ------------------ | ----------------- | ------------ | ------------ |
|                    |                   |              |              |

# 5.接口设计

## 5.1 xxxxxxxx

调用：

| **调用URL** |  |
| ----------------- | - |

入参：

| **参 数 名** | **类  型** | **说  明** | **备  注** |
| ------------------ | ---------------- | ---------------- | ---------------- |
|                    |                  |                  |                  |

出参：

| **参 数 名** | **类  型** | **说  明** |
| ------------------ | ---------------- | ---------------- |
|                    |                  |                  |

# 6.实施内容

## 6.1概况描述

将OA系统中记录的员工资产使用情况信息，统计每位员工当前名下所记录的资产计数汇总信息同步到HR系统数据库新增数据表中（EmployeeAssetsCount）；然后在HR系统即可对已同步完成的这部分员工资产使用情况数据进行读取使用。

## 6.2程序初始化

### （1）模块名称：程序初始化

### （2）模块路径：员工资产数据同步程序 > 程序初始化

### （3）逻辑描述：

1：在程序执行数据同步任务前，需要对执行任务中的参数（任务执行间隔时长，默认5分钟）进行配置；

2：将手动点击开始按钮，以新建定时任务，定时（配置定时间隔时间）执行数据同步任务；

3：同步数据规则：
A、  首先从HR系统中提取（per_dimission_order表的数据记录）当前所有员工的员工号数据；
B、  其次通过HR系统（hrmresource表，ID，关联查询Cptcapital表resourceid列，条件以stateid列值为2(使用中)的数据记录）提取OA系统中查询该所有员工的所有的“使用中”的资产绑定数据；
C、  然后依次遍历所有HR系统的员工号，以员工号为关键信息，统计员工当前名下的所有资产进行计数统计，生成使用情况数据，添加到同步数据列表中；
D、  最后以批量插入方式或更新方式保存到HR系统数据库表（EmployeeAssetsCount）中保存，至此就完整的完成一次数据同步；
E、  一次任务完成，重复执行A-D步骤，持续同步资产统计数据。