如何通过Autodesk Construction Cloud API更新带可见性控制的冲突问题

前置条件 #

• 已获取冲突构件的URN/唯一标识符列表
• 已拿到目标Issue的ID
• 已完成ACC API身份认证，持有包含data:write、modelcoordination:write、bim360:issues:write权限的有效访问令牌

1. 程序化隔离冲突构件 #

通过ACC的Model Coordination API执行构件隔离操作：

POST https://developer.api.autodesk.com/modelcoordination/v1/projects/{projectId}/clashes/{clashId}/isolate-components

请求体（替换占位符为实际项目/构件值）：

{
  "componentUrnList": [
    "urn:adsk.wipprod:fs.file:vf.xxx?version=1",
    "urn:adsk.wipprod:fs.file:vf.yyy?version=1"
  ],
  "isolate": true
}

• projectId：目标ACC项目的ID
• clashId：对应冲突检测结果的ID
• componentUrnList：填入已获取的两个冲突构件URN

2. 更新目标冲突Issue #

调用BIM 360 Issues API更新Issue的状态、描述等信息，匹配预期效果：

PATCH https://developer.api.autodesk.com/bim360/issues/v1/projects/{projectId}/issues/{issueId}

请求体示例（按需调整字段内容）：

{
  "status": "resolved",
  "description": "已完成两个冲突构件的隔离操作，冲突问题已处理",
  "customAttributes": [
    {
      "attributeDefinitionId": "项目自定义属性ID",
      "value": "已隔离"
    }
  ]
}

• status：设置符合项目流程的状态（如resolved、closed等）
• description：补充隔离操作说明，让相关人员清晰了解处理动作
• customAttributes：若项目有自定义字段，可添加隔离状态标记

注意事项 #

• 确保访问令牌权限覆盖所有操作所需范围，否则会返回权限错误
• 构件URN必须是ACC中有效的模型构件标识符，可通过冲突检测详情API获取
• 若需将隔离视图关联到Issue，可在更新请求中添加linkedDocuments字段，关联隔离后的视图资源URN

内容的提问来源于stack exchange，提问作者Taiheon Choi