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