组织人事

同步部门

POST

/api/hrm/restful/syncDepartment

ignoreOrgSaveOrgNameCheck 、ignoreOrgCanceledValidate 在 0701基线后支持

emptyCustomVaueClearable 在2024-1101基线支持后支持

请求参数

Body 参数application/json

data

array [object {11}]

必需

name

string

部门名称

必需

fullname

string

部门全称

可选

code

string

部门编号

可选

parent

string

上级组织

必需

可以是分部或者部门；与【数据规则-组织规则】相关；例如：规则是编号，内容提供编号

coadjutant

string

协办人

可选

与【数据规则-人员规则】相关；例如：规则是编号，内容提供编号

status

string

是否启用

可选

1:启用；0: 停用

string

主键

可选

当【数据规则-组织规则】为id的时候；修改部门需要提供，其他不需要
；
特别注意： id 是E10系统的id;不可以自定义

description

string

备注

可选

disporder

integer

显示顺序

可选

departmentExtend

object

部门自定义

可选

在2504版本后支持传入数据key（可以自定义表单设计器中看到字段的数据key内容）

multiObj

object

多语言

可选

ignoreOrgSaveOrgNameCheck

boolean

忽略同层级重名判断

可选

组织新增，修改会检查同层级是否存在重名，如果重名则不允许操作

如果给true，则忽略判断

ignoreOrgCanceledValidate

boolean

忽略封存部门标准判断

可选

在封存组织（分部、部门）标准会做以下验证：

是否有未封存的下级组织，如果存在则不允许封存

封存组织是否有未离职的任意，如果存在不允许封存

如果当前参数是true，则忽略上面判断

dataRule

object

数据规则

必需

字段校验规则；比如指定组织规则是名称，就按照名称规则检查唯一，如果查询到则更新；否则新增

department

string

组织（含分部、部门）规则

必需

name:按照组织名称来检查；code:按照组织编号来检查

employee

string

人员规则

可选

id: 按照人员id来检查;username：按照名称检查；job_num: 按照编号来检查；

apiTaskId

string

任务号

可选

任务号，相同任务号防止并发； 0701基线支持

emptyCustomVaueClearable

boolean

自定义字段内容清空标识

可选

自定义字段的内容是否允许清空

virtualId

string

维度

可选

虚拟维度id；同步多维使用

2504基线支持

示例

{
  "data": [
    {
      "parent": "矩阵同步优化团队",
      "name": "xy同步部门001",
      "multiObj": {
        "name": {
          "7": "中文",
          "8": "En"
        }
      },
      "departmentExtend": {
        "1106047120783269888": [
          "xy1001",
          "xy悠悠001"
        ],
        "1106047120783269889": [
          "xy1001"
        ]
      }
    },
    {
      "parent": "矩阵同步优化团队",
      "name": "xy同步部门002",
      "multiObj": {
        "name": {
          "7": "中文",
          "8": "En"
        }
      },
      "departmentExtend": {
        "1106047120783269888": [
          "xy1001",
          "xy悠悠001"
        ],
        "1106047120783269889": [
          "xy悠悠001"
        ]
      }
    }
  ],
  "dataRule": {
    "department": "name",
    "employee": "username"
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/hrm/restful/syncDepartment' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": [
        {
           "parent":"矩阵同步优化团队",
            "name":"xy同步部门001",
            "multiObj":{
                "name":{
                    "7":"中文",
                    "8":"En"
                }
            },
            "departmentExtend":{
                "1106047120783269888":["xy1001","xy悠悠001"],
                "1106047120783269889":["xy1001"]
            }
        },
                {
           "parent":"矩阵同步优化团队",
            "name":"xy同步部门002",
            "multiObj":{
                "name":{
                    "7":"中文",
                    "8":"En"
                }
            },
            "departmentExtend":{
                "1106047120783269888":["xy1001","xy悠悠001"],
                "1106047120783269889":["xy悠悠001"]
            }
        }
    ],
    "dataRule": {
        "department": "name",
        "employee":"username"
    }
}'

返回响应

🟢200成功

application/json

Body

code

integer

api状态

必需

200 成功

msg

string

描述

必需

status

boolean

状态

必需

false 失败；true 成功

data

array [object {5}]

必需

keyValue

string

数据唯一字段值

可选

operate

string

同步操作类型

可选

add 新增、update 修改

status

string

状态

可选

SUCCESS 成功；ERROR 失败

errcode

string

失败原因

可选

needRepush

boolean

可选

示例

{
  "message": {
    "errcode": "0",
    "errmsg": "success"
  },
  "data": [
    {
      "keyValue": "测试岗位名称",
      "id": 712788378760470500,
      "operate": "ADD",
      "status": "SUCCESS",
      "errcode": "SUCCESS",
      "needRepush": false
    }
  ]
}

修改于 2025-04-23 07:41:16

同步人员

同步分部