用途:管理 DevOps Center 流水线阶段(stage)的各类测试套件分配,统一通过 Connect API 的 testSuiteStages 端点完成。
前置条件:需先加载 checking-devops-prerequisites,满足前置条件 1–4 及前置条件 5(阶段),并准备好 doce-org-alias、pipelineId、stageId;event 取值为 Pre-Promote、Post-Promote 或 Review。
主要能力(三种模式): A. 将单个套件分配到阶段,需提供 testSuiteId 与 testSuiteName,调用前必须经用户确认。 B. 将多个套件映射到阶段,输入为 {testSuiteId, action: "add"|"remove"} 列表,执行前必须展示完整映射预览并获明确确认。 C. 在套件内增删测试类,用于同步已评审测试或提升测试;被拒绝的测试必须从载荷中排除,测试若被修改需重新展示最终列表并再次确认。
系统调用(三种模式共用,执行前替换占位符): sf api request rest "/services/data/v67.0/connect/devopstesting/pipeline/<pipelineId>/testSuiteStages" --method POST --body '{"pipelineStageId":"<stageId>","event":"<event>","assignments":[{"testSuiteId":"<id>","action":"add|remove"}]}' --target-org <doce-org-alias>
错误处理:不得向用户暴露原始 API 错误,需按状态码映射为友好提示(400 请求无效、403 无权限、404 流水线或阶段未找到、500 服务器错误)。
相关技能:syncing-test-providers(套件未出现时重新同步)、recommending-devops-tests(需推荐套件时)、configuring-quality-gate(映射后配置质量门禁)、analyzing-test-failures(失败分析)。
限制:所有模式均需用户显式确认后方可调用 API;具体权限、配额与平台支持范围资料未提供。