文档首页/ 需求管理 CodeArts Req/ API参考/ API/ IPD字段管理/ 更新租户层字段
更新时间：2025-09-11 GMT+08:00
在线调试
CLI示例
查看PDF
分享

更新租户层字段

功能介绍

更新租户级字段。支持更新字段名称、描述，以及对单选列表、多选列表、层级字段选项的增删改。

调用方法

请参见如何调用API。

URI

POST /v1/ipdprojectservice/tenant/fields/{field_id}

表1 路径参数

参数

是否必选

参数类型

描述

field_id

是

String

参数解释： 工作项字段id，可通过 查询IPD项目租户字段列表接口获取，响应消息体中的field_id字段的值就是工作项字段field_id。

约束限制： 最小长度：2，最大长度：32。

取值范围： 不涉及。

默认取值： 不涉及

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

id

否

String

参数解释：

字段id。

取值范围：

不涉及。

display_name

否

String

参数解释：

字段名称。

取值范围：

不涉及。

created_by

否

String

参数解释：

添加人。

取值范围：

不涉及。

field_type

否

String

参数解释：

字段类型。

取值范围：

不涉及。

show_on_card

否

Boolean

参数解释：

是否显示在新建页。

取值范围：

true：是；false：否。

optional

否

Boolean

参数解释：

是否必填。

取值范围：

true：必填；false：非必填。

all_options

否

Array of OptionEntity objects

参数解释：

字段选项。

取值范围：

不涉及。

default_value

否

String

参数解释：

默认值。

取值范围：

不涉及。
表3 OptionEntity

参数

是否必选

参数类型

描述

id

否

String

参数解释：

选项id

取值范围：

不涉及

code

否

String

参数解释：

选项code值

取值范围：

不涉及

display_value

否

String

参数解释：

选项名称

取值范围：

不涉及

value

否

String

参数解释：

选项唯一标识

取值范围：

不涉及

level

否

Integer

参数解释：

选项层级。用于区分层级字段的层级

取值范围：

层级字段最多4层

sequence

否

Integer

参数解释：

选项顺序

取值范围：

不涉及

parent_id

否

String

参数解释：

父选项id

取值范围：

不涉及

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

id

String

参数解释：

字段id。

取值范围：

不涉及。

display_name

String

参数解释：

字段名称。

取值范围：

不涉及。

created_by

String

参数解释：

添加人。

取值范围：

不涉及。

field_type

String

参数解释：

字段类型。

取值范围：

不涉及。

show_on_card

Boolean

参数解释：

是否显示在新建页。

取值范围：

true：是；false：否。

optional

Boolean

参数解释：

是否必填。

取值范围：

true：必填；false：非必填。

all_options

Array of OptionEntity objects

参数解释：

字段选项。

取值范围：

不涉及。

default_value

String

参数解释：

默认值。

取值范围：

不涉及。
表5 OptionEntity

参数

参数类型

描述

id

String

参数解释：

选项id

取值范围：

不涉及

code

String

参数解释：

选项code值

取值范围：

不涉及

display_value

String

参数解释：

选项名称

取值范围：

不涉及

value

String

参数解释：

选项唯一标识

取值范围：

不涉及

level

Integer

参数解释：

选项层级。用于区分层级字段的层级

取值范围：

层级字段最多4层

sequence

Integer

参数解释：

选项顺序

取值范围：

不涉及

parent_id

String

参数解释：

父选项id

取值范围：

不涉及

请求示例

  • 更新租户字段

    https://{endpoint}/v1/ipdprojectservice/tenant/fields/1162422376023437316

{
  "field_type_id" : "10001",
  "display_name" : "更新租户字段选项2",
  "option" : [ {
    "id" : "1162422376023437313",
    "display_value" : "A",
    "value" : "1162422376023437313",
    "code" : "1162422376023437313",
    "value_py" : "A",
    "sequence" : 0,
    "level" : 1,
    "domain_id" : "-1",
    "belong_definition_type" : "4",
    "disabled" : true
  }, {
    "id" : "1162422376023437314",
    "display_value" : "B",
    "value" : "1162422376023437314",
    "code" : "1162422376023437314",
    "value_py" : "B",
    "sequence" : 1,
    "level" : 1,
    "domain_id" : "-1",
    "belong_definition_type" : "4",
    "disabled" : true
  }, {
    "id" : "1162422376023437315",
    "display_value" : "C",
    "value" : "1162422376023437315",
    "code" : "1162422376023437315",
    "value_py" : "C",
    "sequence" : 2,
    "level" : 1,
    "domain_id" : "-1",
    "belong_definition_type" : "4",
    "disabled" : true
  } ],
  "id" : "1162422376023437316",
  "definition_type" : "4"
}

  • 修改层级字段

    https://{endpoint}/v1/ipdprojectservice/tenant/fields/1162425805358092292

{
  "field_type_id" : "10011",
  "display_name" : "更新租户层级字段",
  "option" : [ {
    "parent_node_id" : null,
    "node_id" : "745aff525721e70a2b5ebd341aa4ca1",
    "id" : "1162425805358092289",
    "display_value" : "A",
    "value" : "1162425805358092289",
    "code" : "1162425805358092289",
    "value_py" : "A",
    "sequence" : 0,
    "level" : 1,
    "domain_id" : "-1",
    "belong_definition_type" : "4",
    "label" : "A"
  }, {
    "parent_node_id" : "745aff525721e70a2b5ebd341aa4ca1",
    "node_id" : "02599ef5cd454dca63e3e91bcef100d",
    "parent_id" : "1162425805358092289",
    "id" : "1162425805358092290",
    "display_value" : "AAa1",
    "value" : "1162425805358092290",
    "code" : "1162425805358092290",
    "value_py" : "AA1",
    "sequence" : 0,
    "level" : 2,
    "domain_id" : "-1",
    "belong_definition_type" : "4",
    "label" : "AAa1",
    "isFocused" : false
  }, {
    "parent_node_id" : "02599ef5cd454dca63e3e91bcef100d",
    "node_id" : "098ed9566865dafa6cac4a8862aeff2",
    "parent_id" : "1162425805358092290",
    "id" : "1162425805358092291",
    "display_value" : "AAA1",
    "value" : "1162425805358092291",
    "code" : "1162425805358092291",
    "value_py" : "AAA1",
    "sequence" : 0,
    "level" : 3,
    "domain_id" : "-1",
    "belong_definition_type" : "4",
    "label" : "AAA1",
    "isLeaf" : true
  }, {
    "parent_node_id" : "745aff525721e70a2b5ebd341aa4ca1",
    "node_id" : "a4f6e6374b1f19291015cbcf070b278",
    "parent_id" : "1162425805358092289",
    "sequence" : 1,
    "display_value" : "AA2",
    "level" : 2,
    "isFocused" : false,
    "label" : "AA2",
    "value" : "a4f6e6374b1f19291015cbcf070b278"
  }, {
    "parent_node_id" : "a4f6e6374b1f19291015cbcf070b278",
    "node_id" : "b1133b7f570622c8a5934dfd11db85b",
    "display_value" : "AAA2",
    "sequence" : 0,
    "level" : 3,
    "isFocused" : false,
    "label" : "AAA2",
    "isLeaf" : true,
    "value" : "b1133b7f570622c8a5934dfd11db85b"
  } ],
  "id" : "1162425805358092292",
  "definition_type" : "4"
}

响应示例

状态码：200

ok

{
  "display_name" : "更新租户字段选项2",
  "code" : "c7354343193790545920",
  "name" : "c7354343193790545920",
  "id" : "1162422376023437316",
  "show" : false,
  "description" : "",
  "default_value" : "",
  "field_id" : "1162422376023437316",
  "created_by" : "c2d89e38a64a466f8f945f595df4402d",
  "created_date" : "1755072691000",
  "modified_by" : "c2d89e38a64a466f8f945f595df4402d",
  "modified_date" : "1755072755000",
  "definition_type" : "4",
  "field_type_id" : "10001",
  "alm_field_type_id" : "10001",
  "field_type_name" : "单选列表",
  "using_status" : true,
  "controlled" : false,
  "immutable" : false,
  "optional" : true,
  "show_on_split" : false,
  "show_on_filter" : true,
  "show_on_edit" : false,
  "show_on_table" : true,
  "sort_on_table" : true,
  "no" : 9999,
  "option" : [ {
    "id" : "1162422376023437313",
    "display_value" : "A",
    "value" : "1162422376023437313",
    "code" : "1162422376023437313",
    "value_py" : "A",
    "sequence" : 0,
    "level" : 1,
    "domain_id" : "-1",
    "belong_definition_type" : "4"
  }, {
    "id" : "1162422376023437314",
    "display_value" : "B",
    "value" : "1162422376023437314",
    "code" : "1162422376023437314",
    "value_py" : "B",
    "sequence" : 1,
    "level" : 1,
    "domain_id" : "-1",
    "belong_definition_type" : "4"
  }, {
    "id" : "1162422376023437315",
    "display_value" : "C",
    "value" : "1162422376023437315",
    "code" : "1162422376023437315",
    "value_py" : "C",
    "sequence" : 2,
    "level" : 1,
    "domain_id" : "-1",
    "belong_definition_type" : "4"
  } ],
  "user_visibility" : true,
  "has_update_privilege" : false,
  "has_same_display_name" : false
}

状态码

状态码

描述

200

ok

错误码

请参见错误码。

父主题： IPD字段管理

相关文档