同步分部 - 组织人事

请求参数

Body 参数application/json

data

array [object {11}]

必需

name

string

分部名称

必需

fullname

string

分部全称

可选

code

string

分部编号

可选

parent

string

上级分部

必需

只能是分部；与【数据规则-组织规则】相关；例如：规则是编号，内容提供编号 ; 新增必填、修改非必填

disporder

integer

显示顺序

可选

description

string

备注

可选

status

string

是否启用

可选

1:启用；0: 停用

coadjutant

string

协办人

可选

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

id

string

可选

当【数据规则-组织规则】为id的时候；修改分部需要提供，其他不需要

subcompanyExtend

object

分部自定义

可选

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

multiObj

object

可选

ignoreOrgSaveOrgNameCheck

string

忽略同层级重名判断

可选

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

ignoreOrgCanceledValidate

string

忽略封存部门标准判断

可选

在封存组织（分部、部门）标准会做以下验证：1. 是否有未封存的下级组织，如果存在则不允许封存2. 封存组织是否有未离职的任意，如果存在不允许封存如果当前参数是true，则忽略上面判断

dataRule

object

数据规则

必需

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

subcompany

string

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

必需

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

employee

string

人员规则

必需

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

apiTaskId

string

任务号

必需

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

emptyCustomVaueClearable

boolean

自定义字段内容清空标识

可选

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

extKey

string

指定需要额外返回内容的key

可选

virtualId

string

维度

可选

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

2504基线支持

示例

{
  "data": [
    {
      "parent": "上海泛微",
      "name": "测试分部"
    }
  ],
  "dataRule": {
    "subcompany": "name"
  }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/api/hrm/restful/syncSubcompany' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": [
        {
           "parent":"上海泛微",
            "name":"测试分部"
        }
    ],
    "dataRule": {
        "subcompany": "name"
    }
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

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