2.7 KiB
2.7 KiB
创建迭代并关联交付
产品经理可将已交棒（或已有编号）的多条【交付】任务打进同一云效迭代。
口令
创建迭代：版本类型=副；交付任务=ONEOS-a,ONEOS-b,ONEOS-c；名称前缀=统一运营管理平台PC端
创建迭代：版本类型=子；交付任务=ONEOS-99；名称前缀=统一运营管理平台PC端
| 参数 | 规则 |
|---|---|
| 交付任务 | 1..N 个任务编号（逗号分隔）；禁止用标题凑数 |
| 版本类型 | 主 / 副 / 子；未点选则停下询问，禁止默认猜 |
| 名称前缀 | 可选；缺省 统一运营管理平台PC端。最终名={前缀}{版本号} |
版本号 V{主}.{副}.{子}
| 版本类型 | 含义 | 递增 |
|---|---|---|
| 主 | 功能重制 | 主+1，副→0，子→0（V1.3.2→V2.0.0） |
| 副 | 新功能上线 | 副+1，子→0（V1.3.2→V1.4.0） |
| 子 | bug/优化 | 子+1（V1.3.2→V1.3.3） |
取基线再递增
- 拉取当前项目云效迭代列表。
- 从迭代名称解析
V数字.数字.数字；旧名V数字.数字视为.0。 - 同名称前缀内取最大版本为基线（主→副→子比较）；避免 PC 与小程序串号。
- 按用户点选类型递增，写入新迭代名称。
- 无一可解析版本：基线
V0.0.0再递增（主→V1.0.0，副→V0.1.0，子→V0.0.1）；或口令显式给起始版本。
禁止：手填与规则冲突的版本号却声称自动生成；禁止用交付标题推断版本类型。
创建与关联
| 步骤 | 动作 |
|---|---|
| 1 | 算出新版本 → 拼迭代全名 |
| 2 | 创建迭代（起止日期口令未给则询问或用项目默认，禁止瞎填） |
| 3 | 只挂【交付】：N 个交付任务挂迭代；交付失败不得报完成 |
| 4 | 幂等：同名迭代已存在 → 不新建，补挂尚未关联的交付，回报「复用迭代」 |
| 5 | 回报：迭代名、版本号、identifier、已关联交付编号、失败编号 |
禁止把需求挂进迭代（需求侧「迭代」字段保持空）。不挂【分析】/【设计】除非口令显式点名。
不在本步创建【开发】/【测试】。仍须 Plan 门禁。
挂接 API（已通 · 校验走 /extra）
PATCH /projex/api/workitem/workitem/{交付id}?_input_charset=utf-8
{"workitemIdentifier":"{交付id}","propertyKey":"sprint","propertyValue":"{sprintId}","operateType":"COVER"}
校验（详情主接口不含 sprint，勿用其判空）：
GET /projex/api/workitem/workitem/{id}/extra?_input_charset=utf-8
→ result.sprint[].identifier
清空误挂的需求迭代：同上 PATCH，propertyValue:"" + operateType:"COVER"（或 CLEAR）。