组织人事
  1. 开放平台-组织人事接口
组织人事
  • 开放平台-组织人事接口
    • 开放平台认证步骤
    • 同步人员
      POST
    • 同步部门
      POST
    • 同步分部
      POST
    • 同步岗位
      POST
    • 同步条件矩阵数据
      POST
    • 同步兼职信息
      POST
    • 封存部门
      POST
    • 解封部门
      POST
    • 人员返聘
      POST
    • 基本信息自定义字段信息
      POST
    • 部门自定义字段信息
      POST
    • 分部自定义字段信息
      POST
    • 人员查询
      POST
    • 组织查询
      POST
    • 岗位查询
      POST
    • 条件矩阵-保存数据
      POST
    • 条件矩阵-删除数据
      POST
    • 条件矩阵-条件查询取值
      POST
    • 条件矩阵-生产视图创建语句(兼容E9)
      POST
    • 批量新增职务
      POST
    • 同步职称
      POST
    • 群组列表查询
      POST
    • 批量删除群组
      POST
    • 新增或修改群组
      POST
    • 批量封存/解封群组
      POST
    • 群组成员查询接口
      POST
    • 新增群组成员
      POST
    • 删除群组成员
      POST
    • 添加群组可见范围
      POST
    • 更新群组可见范围项
      POST
    • 删除群组可见范围项
      POST
    • 根据组织或者人员查询全路径数据
      POST
    • 同步人力共享权限数据
      POST
    • 同步职级
      POST
    • 同步外部联系人
      POST
    • 同步外部企业
      POST
    • 同步外部部门
      POST
    • 同步虚拟维度人员
      POST
    • 查询虚拟维度人员
      POST
  1. 开放平台-组织人事接口

条件矩阵-保存数据

将废弃
POST
/api/hrm/restful/editData
1.
接口支持版本: 0501基线版本
post json格式请求
注意:特殊说明(重要)
矩阵数据对接,其实是托管模式,报文给什么数据,最终存储的就是什么模式。这个接口也包含清除处理。
举个列子:
dataStr是下面的报文格式,第1条数据如下图所示,有4个取值字段,1个条件字段
image.png
那么下面所有的数据,只会处理这4个取值字段,这1个条件字段。
如果第二条和第三条数据如下图所示
image.png
第二条数据传递了3个取值字段,id分别为1、2、3,那么对第二条数据的处理,这三个id为1、2、3的取值字段会按照这个报文传递的参数来,id为4的就会按照清除处理(有些版本需要手动传递空数组,否则会报错),等同于报文传递了空数组。
第三条数据传递了3个取值字段,id分别为1、2、5,那么对第三条数据的处理,id为1、2的会按照报文来,配置id为3、4的会按照清除处理(有些版本需要手动传递空数组,否则会报错),等同于传递了空数组。id为5的会进行忽略,不做任何处理。
条件字段也同上。
所以如果报文存在多个数据需要同步,同时configid数量不一致,那么可以采用对需要更新的配置id分组(条件和取值需要同时组合一起分组),让相同批次(需要更新的条件配置id列表、取值配置id列表一样)的放在一个同步请求里。

请求参数

Body 参数text/plain
示例
参数
参数名必选类型说明
tenantKey是string租户key
employeeId是long创建人id
matrixId是long矩阵id
source是string来源,当前固定normal
dataStr是string数据json 字符串
dataStr参数属性
参数名必选类型说明
matrixId是long矩阵id
newRowDataUseParamId否Boolean新增的行数据是否使用参数的id,如果是false的话,不存在的数据,会重新生成id
rowDataList是array矩阵行数据
rowDataList参数属性
参数名必选类型说明
id是long矩阵行数据id,值不存在的话是新增行数据(newRowDataUseParamId为true的话,使用这个id,否则系统会新生成一个id),存在的话是更新
conditionDataList是array条件项 数据信息
valueDataList是array取值项 数据信息
conditionDataList,valueDataList参数属性
参数名必选类型说明
configId是long条件配置id或者取值配置id
relateIdList是array关联数据id(取值id) 集合
示例值: { "tenantKey": "t7uyc4bi20", "employeeId": 2225404757647817194, "matrixId": 3225334517627817135, "source": "normal", "dataStr": "{\"matrixId\":\"3225334517627817135\",\"rowDataList\":[{\"id\":\"22253349999627888838\",\"conditionDataList\":[{\"configId\":\"55553349999627238978\",\"relateIdList\":[\"4445334999962734752\"]}],\"valueDataList\":[{\"configId\":\"11153349999627238733\",\"relateIdList\":[]}]}]}" }

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/hrm/restful/editData' \
--header 'Content-Type: text/plain' \
--data-raw '{
    "tenantKey": "t7uyc4bi20",
    "employeeId": 2225404757647817194,
    "matrixId": 3225334517627817135,
    "source": "normal",
    "dataStr": "{\"matrixId\":\"3225334517627817135\",\"rowDataList\":[{\"id\":\"22253349999627888838\",\"conditionDataList\":[{\"configId\":\"55553349999627238978\",\"relateIdList\":[\"4445334999962734752\"]}],\"valueDataList\":[{\"configId\":\"11153349999627238733\",\"relateIdList\":[]}]}]}"
}'

返回响应

🟢200成功
application/json
Body
object {0}
示例
{
    "code": 200,
    "status": true,
    "message": "successful",
    "data": null
}
修改于 2025-04-22 11:00:54
上一页
岗位查询
下一页
条件矩阵-删除数据
Built with