更新职务序列

POST

/TenantBaseExternal/api/v5/JobSequence/Update

接口限制：100次/秒/企业 3000次/分钟/企业

适用场景：用于更新职务序列

警告信息：不适用场景：启用职务序列、停用职务序列

tips：-

错误码示例

{
"data": null,
"code": "417",
"message": "资源集合中已经有启用的名称为Test041601A的职务序列"
}

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://openapi.italent.cn/TenantBaseExternal/api/v5/JobSequence/Update' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": {
        "objectId":"ce8a543b-84a9-48a7-b35d-08b8bd89b8af",
        "name": "Test041601A",
        "startDate": "2021-04-01",
        "emptyFields":["order"],
        "customProperties":{
            "extNote":"职务序列备注"
        }
    }
}'

响应示例

{
    "data": {
        "name": "string",
        "oId": "string",
        "startDate": "2019-08-24T14:15:22Z",
        "stopDate": "2019-08-24T14:15:22Z",
        "status": 0,
        "oIdResourceSet": "string",
        "jobLevelType": "string",
        "pOId": "string",
        "level": 0,
        "businessModifiedBy": 0,
        "businessModifiedTime": "2019-08-24T14:15:22Z",
        "order": 0,
        "firstLevelJobSequence": "string",
        "secondLevelJobSequence": "string",
        "thirdLevelJobSequence": "string",
        "fourthLevelJobSequence": "string",
        "fifthLevelJobSequence": "string",
        "sixthLevelJobSequence": "string",
        "seventhLevelJobSequence": "string",
        "eighthLevelJobSequence": "string",
        "ninthLevelJobSequence": "string",
        "tenthLevelJobSequence": "string",
        "objectId": "string",
        "customProperties": {
            "property1": {},
            "property2": {}
        },
        "translateProperties": {
            "property1": "string",
            "property2": "string"
        },
        "createdBy": 0,
        "createdTime": "2019-08-24T14:15:22Z",
        "modifiedBy": 0,
        "modifiedTime": "2019-08-24T14:15:22Z",
        "stdIsDeleted": true
    },
    "code": "string",
    "message": "string"
}

请求参数

Body 参数application/json

data

object

必需

oIdResourceSet

string

可选

对应所属资源集合实体对象（实体编码：TenantBase.ResourceSet）业务OId（非主键），示例：a6a2c5a3-32d5-4b79-a7e9-a27238fdccdd

order

integer <int32> | null

可选

排序编码，示例：123

jobLevelType

string

可选

关联职级类别，职级类别实体对象（实体编码：TenantBase.JobLevelType）业务OId（非主键），示例：c1fd7ea5-ff77-4b0e-b058-98836e126c66

level

integer <int32> | null

层级，示例：3

可选

pOId

string

可选

上级序列，对应职务序列实体对象（实体编码：TenantBase.JobSequence）业务OId（非主键），示例："12"

name

string

可选

名称，示例：名称示例

startDate

string <date-time> | null

可选

生效日期，示例：2021-01-01

status

integer <int32> | null

可选

状态，示例：1（启用），查看可用选项

stopDate

string <date-time> | null

可选

失效日期，示例：9999-12-31

name_zh_TW

string

可选

名称_繁体，示例：名稱示例

name_en_US

string

可选

名称_英文，示例：NameTest

objectId

string

必需

业务对象实体主键GUID，示例：094ae643-2b5a-4e00-b99c-0e5aaf0e5c66

emptyFields

array[string]

可选

清空字段集合，示例：["Desc","Note"]。字段未传值或者null表示不更新该字段，如需清空，请添加对应字段名称(不区分大小写，且必填字段清空会自动忽略)的元素。注意：该列表优先级高，若同一个字段既赋值又清空，则优先清空。

optionalSysProperties

object

可选

非必填（可选）标准字段Key（字段编码）-Value（字段值）字典，暂不使用，仅预留方便后续扩展使用。(区分大小写，自动忽略自定义字段和不存在的字段)，若有同名属性，则优先使用属性值。示例：key=Remarks,value="可选标准字段"

customProperties

object

可选

租户级别自定义字段Key（字段编码）-Value（字段值）字典(区分大小写，自动忽略非自定义字段和不存在的字段)，示例：key=exthtxybeizhua_127666_1123139652,value="自定义字段"

示例

返回响应

🟢200核心人力操作结果

application/json

Body

data

object

可选

name

string

可选

名称，示例：名称示例

oId

string

可选

业务OId（非主键），示例："123"

startDate

string <date-time> | null

可选

生效日期，示例：2021-01-01

stopDate

string <date-time> | null

可选

失效日期，示例：9999-12-31

status

integer <int32> | null

可选

状态，示例：1（启用），查看可用选项

oIdResourceSet

string

可选

对应所属资源集合实体对象（实体编码：TenantBase.ResourceSet）业务OId（非主键），示例：a6a2c5a3-32d5-4b79-a7e9-a27238fdccdd

jobLevelType

string

可选

关联职级类别，职级类别实体对象（实体编码：TenantBase.JobLevelType）业务OId（非主键），示例：c1fd7ea5-ff77-4b0e-b058-98836e126c66

pOId

string

可选

上级序列，对应职务序列实体对象（实体编码：TenantBase.JobSequence）业务OId（非主键），示例："12"

level

integer <int32> | null

层级，示例：3

可选

businessModifiedBy

integer <int32>

可选

业务修改人：只查询。系统更新数据时，该字段值不会修改。

businessModifiedTime

string <date-time>

可选

业务修改时间：只查询。系统更新数据时，该字段值不会修改。

order

integer <int32> | null

可选

排序编码，示例：123

firstLevelJobSequence

string

可选

一级序列，对应职务序列实体对象（实体编码：TenantBase.JobSequence）业务OId（非主键），示例："12"

secondLevelJobSequence

string

可选

二级序列，对应职务序列实体对象（实体编码：TenantBase.JobSequence）业务OId（非主键），示例："12"

thirdLevelJobSequence

string

可选

三级序列，对应职务序列实体对象（实体编码：TenantBase.JobSequence）业务OId（非主键），示例："12"

fourthLevelJobSequence

string

可选

四级序列，对应职务序列实体对象（实体编码：TenantBase.JobSequence）业务OId（非主键），示例："12"

fifthLevelJobSequence

string

可选

五级序列，对应职务序列实体对象（实体编码：TenantBase.JobSequence）业务OId（非主键），示例："12"

sixthLevelJobSequence

string

可选

六级序列，对应职务序列实体对象（实体编码：TenantBase.JobSequence）业务OId（非主键），示例："12"

seventhLevelJobSequence

string

可选

七级序列，对应职务序列实体对象（实体编码：TenantBase.JobSequence）业务OId（非主键），示例："12"

eighthLevelJobSequence

string

可选

八级序列，对应职务序列实体对象（实体编码：TenantBase.JobSequence）业务OId（非主键），示例："12"

ninthLevelJobSequence

string

可选

九级序列，对应职务序列实体对象（实体编码：TenantBase.JobSequence）业务OId（非主键），示例："12"

tenthLevelJobSequence

string

可选

十级序列，对应职务序列实体对象（实体编码：TenantBase.JobSequence）业务OId（非主键），示例："12"

objectId

string

可选

业务对象实体主键GUID

customProperties

object

可选

租户级别自定义字段Key（字段编码）-Value（字段值）字典，示例：key=exthtxybeizhua_127666_1123139652,value="自定义字段"

translateProperties

object

可选

动态翻译字段集合，用于数据源字段翻译功能，省去调用方调用翻译接口。翻译后字段名默认为翻译前字段名追加后缀Text，示例：[{"OIdJobPositionText","示例职位"}]

createdBy

integer <int32>

可选

创建人员工UserID，示例：115515434

createdTime

string <date-time>

可选

创建时间，示例：2021-01-01 14:00:00

modifiedBy

integer <int32>

可选

修改人员工UserID，示例：115515434。系统更新数据时，该字段值会修改。

modifiedTime

string <date-time>

可选

修改时间，示例：2021-01-01 14:00:00。系统更新数据时，该字段值会修改。

stdIsDeleted

boolean

可选

是否删除，示例：false

code

string

可选

响应码（正常情况必须200）或异常错误编码（异常情况）：200-OK，417-参数异常、业务不合法，500-内部服务器异常。示例："200"

message

string

结果消息

可选

修改于 2021-10-13 10:54:25

根据时间窗滚动查询变动的职务序列信息

新建职务序列

更新职务序列

错误码示例#

请求参数

返回响应

错误码示例