云效接口现在能直接获取支撑项，子项和依赖项这些吗？

云效接口目前支持通过特定的API获取工作项之间的关联关系，包括支撑项、子项和依赖项等信息。以下是详细的解答：

1. 获取工作项关联项

云效提供了 GetWorkitemRelations 接口，用于获取指定工作项的关联项。通过该接口，您可以查询工作项之间的关系，例如： - BLOCKING：表示当前工作项阻塞了其他工作项。 - BLOCKED：表示当前工作项被其他工作项阻塞。 - ASSOCIATED：表示工作项之间存在关联关系。 - DUPLICATED：表示工作项是重复的。 - SUB：表示当前工作项是另一个工作项的子项。 - PARENT：表示当前工作项是另一个工作项的父项。

请求语法

GET /organization/{organizationId}/workitems/{workitemId}/getRelations

请求参数

返回结果

返回结果中包含一个 relationList 字段，列出了与当前工作项相关的所有关联项信息。每个关联项的信息包括： - identifier：工作项 ID。 - subject：工作项标题。 - assignedTo：负责人。 - spaceIdentifier：所属项目 ID。 - categoryIdentifier：工作项类型 ID。 - gmtCreate 和 gmtModified：创建时间和修改时间。

示例

以下是一个正常返回的示例：

{
  "requestId": "ASSDS-ASSASX-XSAXSA-XSAXSAXS",
  "errorMsg": "",
  "errorCode": "",
  "success": true,
  "relationList": [
    {
      "identifier": "deafe5f33xxxxx6a259d8dafd",
      "subject": "标题内容",
      "assignedTo": "aliyun_1384605",
      "spaceIdentifier": "2b856dxxxxxxb61d93676255ba",
      "categoryIdentifier": "Req",
      "workitemTypeIdentifier": "9uy29901re573f561d69jn40",
      "gmtCreate": "1667205617061",
      "gmtModified": "1667205617089"
    }
  ]
}

2. 支撑项、子项和依赖项的获取方式

根据上述接口说明，支撑项、子项 和 依赖项 可以通过设置不同的 relationType 参数来获取： - 支撑项：使用 BLOCKING 类型，表示当前工作项支撑了其他工作项。 - 子项：使用 SUB 类型，表示当前工作项是某个父工作项的子项。 - 依赖项：使用 BLOCKED 类型，表示当前工作项依赖于其他工作项。

3. 注意事项

• 权限要求：调用该接口需要具备相应的权限，否则可能会返回 403 错误码（无权限）。
• 分页处理：如果关联项较多，可能需要结合分页参数进行处理（尽管当前接口未明确提到分页，但建议关注返回数据量较大的情况）。
• 错误处理：接口返回的 errorCode 和 errorMsg 字段可以帮助定位问题，请务必检查这些字段以确保请求成功。

总结

云效接口 GetWorkitemRelations 可以直接获取工作项的支撑项、子项和依赖项等关联信息。通过设置不同的 relationType 参数，您可以灵活查询不同类型的工作项关系。