dx-devops-test-suite-assignments-configure

配置 DevOps Center 套件分配

针对变更推荐应运行的现有测试套件，并管理套件如何分配到流水线阶段及如何映射。这些操作共用相同的套件-阶段元数据：推荐会显示相关套件并标出缺口，而这些缺口可直接用于后续分配。

API 版本： 所有 DevOps 测试系统调用均针对 Salesforce API v67.0（最低要求）。

重要： 所有 DevOps Center 数据都存储在 Salesforce 组织中，而非本地仓库中。切勿在文件系统中搜索套件配置。始终使用 sf data query 或 sf api request rest 查询组织。

---

步骤 1 — 始终先运行前置检查

在执行任何查询或系统调用之前，先运行 references/prerequisite-checks.md 中的前置检查。如果任何检查失败，请显示通俗易懂的消息并停止。

• 模式 A（推荐）： 前置条件 1–4（组织登录、插件、DevOps Center 组织身份验证、已识别流水线）。无需阶段——推荐会读取流水线级别的 Review 触发器。
• 模式 B–D（分配/映射/类）： 前置条件 1–4 以及前置条件 5（阶段）。你需要 doce-org-alias、pipelineId 和 stageId。

---

步骤 2 — 选择模式

如果用户想要……	模式	遵循
了解某次提交/差异应运行哪些套件，或哪些套件覆盖其变更	A — 推荐套件	references/recommendation-logic.md
将一个套件作为一次性操作分配到某个阶段	B — 分配单个套件	references/suite-assignment-modes.md
将多个套件批量映射到某个阶段，作为测试策略	C — 映射多个套件	references/suite-assignment-modes.md
在套件分配中添加/移除单个测试类	D — 添加/移除类	references/suite-assignment-modes.md

模式 A 仅进行推理（不写入）。模式 B–D 通过同一个 testSuiteStages 端点修改组织状态（references/api-endpoint.md）。

模式 A 如何衔接模式 B–D： 如果推荐标出了相关套件，但该套件尚未分配到相应阶段，这一缺口就是模式 B/C 的输入。如果推荐标出了没有套件覆盖的新方法，请引导开发者手动编写测试（v1 限制——切勿在此建议生成测试）。

---

步骤 3 — 治理与确认（模式 B–D）

模式 B–D 必须在任何写入前取得确认：

• 模式 B — 通过单个确认提示列明套件、阶段和事件。
• 模式 C — 在确认环节前，必须提供影响预览表（套件 / 阶段 / 事件 / 操作）。
• 模式 D — 确认前重新展示最终测试列表。**必须从请求负载中排除被拒绝的测试。**如果审核期间修改了测试，请在请求确认前重新展示最终列表。未经明确批准，切勿调用。

在用户明确同意之前，不要调用 API。如果用户拒绝，请停止且不要写入。每个确认环节的完整措辞见 references/suite-assignment-modes.md。

模式 A（推荐）不会进行任何写入，因此无需确认。

---

步骤 4 — 执行并汇报

遵循所选参考文件：

• references/recommendation-logic.md — 模式 A：差异分类、提供方匹配、排序、缺口标记、输出格式。
• references/suite-assignment-modes.md — 模式 B–D：输入、确认措辞、成功消息。
• references/api-endpoint.md — 共用的 testSuiteStages POST 请求负载架构（模式 B–D）。
• references/error-handling.md — 状态码到通俗易懂消息的对照表。

切勿向用户暴露原始 API 错误、堆栈跟踪或 JSON。

---

相关技能

• dx-devops-test-pipeline-configure — 如果要分配的测试套件尚未显示，请配置或重新同步提供方；映射后还可以配置阶段的质量门禁。
• dx-devops-test-suite-run — 在阶段上执行推荐或已分配的测试套件。
• dx-devops-test-failures-analyze — 分析测试套件中测试的失败情况并提供改进建议。