在项目中添加「云效代码库」和「云效流水线」应用,开启后项目的任务详情页中会出现代码模块,可进行代码与任务的关联,让开发管理过程可视化。

任务中的代码区块记录了软件开发过程,所有变更都可追溯变更的详细信息记录,包括分支、提交、合并请求。

配置好对应的代码库和流水线后,可直接在任务的代码中向上追溯变更的原始需求、流转过程等所有关联信息,包括变更过程、变更追溯和变更回滚。

一、代码提交时关联任务

在代码提交时可以使用 #ID 语法建立代码和任务的关联,如 git commit -m "#id"

#ID 支持长 ID 和短 ID 。

任务短 ID 即在项目设置 - 任务设置 中开启「任务 ID 」后,在每个任务卡片上显示的数字。开启任务ID后,项目中的任务均带有一个唯一的编号。可以通过查看任务详情页右上角以及看板视图下任务卡片上获得。

例如, #TOY-60 将链接到 ID 为 TOY-60 的任务。

任务长 ID 可以点击任务详情页右上角的「复制任务链接」获得,如果是在浏览器中打开则可以打开任务后,从当前浏览器地址栏中获得。如 url 中 「task/」后的部分,如:task/5ddb6d2cf856a50018da2f65,这里的任务 ID 为 5ddb6d2cf856a50018da2f65

例如, #5ddb6d2cf856a50018da2f65 将链接到 ID 为 5ddb6d2cf856a50018da2f65 的任务。

除建立关联外,系统还将识别任务状态并流转到对应的流程下:

1. 当任务/需求状态处于「待处理」,关联后任务会流转状态到「开发中」

2. 当缺陷状态处于「待处理」,关联后会流转状态到「修复中」

3. 当格式是 fix #ID,流转缺陷状态从「待处理」或「修复中」到「已解决」

4. 若没有对应的状态,则不处理状态变更

二、合并请求关联任务

在合并请求标题中可以使用「 #ID 」语法建立合并请求和任务的关联,如 在标题中输入 #TOY-60 将关联对应的合并请求到 ID 为 TOY-60 的任务下。输入:#5ddb6d2cf856a50018da2f65 将关联对应的合并请求到 ID 为 5ddb6d2cf856a50018da2f65 的任务下;

标题和描述均可使用该语法。

三、在任务中关联代码变更

在任务中可以关联分支、提交、合并请求:

在代码区块中点击「+ 从资源添加」

在关联窗口中选择对应的记录,然后点击「确定」,即可完成关联

四、在任务中取消关联代码变更

在代码区块中选择要取消关联的记录,点击「取消关联」

取消关联不会删除记录,确认后点击「取消关联」即可解除任务和代码变更的关联关系