如何向工作项布局添加字段？API添加后UI未显示问题咨询

当你通过API成功添加字段但UI不显示时，核心原因是字段仅被添加到流程中，未关联到工作项的具体布局组。以下是具体解决步骤：

• 验证字段关联状态
  先确认字段已绑定到目标工作项类型（如用户故事、任务），可调用以下API检查：

  GET https://dev.azure.com/{organization}/{project}/_apis/work/processes/{processId}/workItemTypes/{witId}/fields?api-version=7.1
  

  响应中能找到你的字段，说明关联成功。

• 将字段添加到布局组
  使用布局更新API把字段加入指定的UI组（比如"详情"组）：

  POST https://dev.azure.com/{organization}/_apis/work/processes/{processId}/workItemTypes/{witId}/layout/groups/{groupId}/fields?api-version=7.1
  

  请求体示例（替换为你的字段引用名）：

  {
    "id": "Custom.MyNewField",
    "visible": true,
    "width": 100
  }
  

  若不知道目标组的groupId，先调用布局查询API获取结构：

  GET https://dev.azure.com/{organization}/_apis/work/processes/{processId}/workItemTypes/{witId}/layout?api-version=7.1
  

• 刷新UI验证
  完成API调用后，刷新工作项页面或重新打开工作项，字段就会出现在指定的布局区域。如果仍不显示，检查请求体中visible是否设为true，且布局API返回成功响应。

• 备选：UI手动添加
  若API操作繁琐，可直接在Azure DevOps中操作：进入组织设置→流程→选择目标流程→对应工作项类型→布局→点击"添加字段"，选择你创建的字段并放置到合适位置，保存后即可在UI中看到。

内容的提问来源于stack exchange，提问作者Takadox et compagnie