关联工作项

配置代码提交流转状态（可选）

默认状态下您可以在提交备注中使用fix关键字将目标状态流转为已解决状态。

本节主要帮助用户理解工作项关联代码提交记录的工作原理与进阶设置，如果您只需要使用默认设置，请跳过此节。

在项目设置中，可以对不同的工作项类型（Epic、Feature、Story、Task、Bug）分别设置三个预设的提交信息关键字（fix、close、resolve），对于每个关键字可绑定目标状态（如：已解决、已关闭等，工作项状态也是可以自定义的）。

代码提交流转状态的默认设置如下：

• fix关键字绑定在“已解决”目标状态（默认开启使用）。
• close关键字绑定在“已关闭”目标状态（默认不开启使用）。
• resolve关键字绑定在“已解决”目标状态（默认开启使用）。

只有项目经理或其它拥有项目设置权限的角色可以修改此配置内容。

下面以将Task工作项类型中的close关键字绑定在“已拒绝”为例，进行一次操作演示。

1. 进入项目。
2. 参照下图，在“设置 > 项目设置”中找到Task工作项类型所对应的代码提交流转状态。

   

3. 单击close的“目标状态”，将其设定为“已拒绝”，并将其的“是否使用”设置为。

   此时将自动保存设置状态。

设置完成后，当提交代码时可以在提交备注中用close关键字去改变Task类工作项的状态为“已拒绝”。

示例如下：

git commit -m "close #Task的编号 本次提交的信息"

新建工作项

为了分别体验在本地提交代码并关联工作项和在代码托管控制台提交代码并关联工作项，重复以下步骤，分别创建两个task。

1. 进入项目。
2. 按照 “工作 > 工作项”路径“进入工作项管理页面”。
3. 单击“新建”按钮，在弹出的下拉框中选择“Task”，即进入新建工作项页面。
4. 填写一个标题即可单击“保存”按钮进行保存。

此时系统会自动跳转回“工作项管理页面”，可以查看到工作项的ID（编号），且状态都是“新建”。

本示例中：

• task01的编号是7370149。
• task02的编号是7370151。

获取工作项目编号的方式为项目“工作 > 工作项”。

在本地提交代码并关联工作项

首先您需要在本地具备Git环境，详细请参考Git客户端安装与配置，在可以访问仓库时（已经关联到了对应的远程仓库），可以开始进行以下操作。

在本地的master分支上新建一个文件，将其推送到远程仓库，在推送时-m里使用“fix”关键字去关联工作项task01。

• 本示例直接修改master分支，是为了缩短流程减少杂音让开发者更快的了解本地提交关联工作项的操作和原理。
• 在实际代码开发中，尽量不要直接修改master分支，推荐新建一个分支进行文件操作，操作完后再合并到master分支并将master推送到远程仓库。（这是一种默认规则和良好习惯）

1. 在本地仓库文件夹下右键，打开Git Bash。
2. 确认远程仓库地址绑定是否成功。

   git remote -v          #该命令可以查看目前本地仓库所绑定的远程仓库地址。

   如下图返回内容中，红线部分是本地仓所关联的远程仓库地址，地址之前是远程仓库在本地的别名。

   

   如果发现绑定的仓库并非需要关联的仓库，或者没有绑定仓库，推荐直接将想绑定的仓库Clone到本地。

   Clone成功以后再次执行“git remote -v”查看确认绑定正确即可。

3. （上步骤已Clone的仓库可跨过此步）用status命令查看下目前仓库的状态，切换到master分支。

   git status             #查看当前仓库状态，可以看到目前处于哪个分支、该分支有没有未暂存、未提交、未推送远端的修改
   git checkout master    #切换到master分支，如果当前没有处于master分支时使用

4. 在本地仓库文件夹下新建一个文件，本示例中将其命名为“fileFor7370149”。
5. 在Git Bash中将新建的文件添加到暂存区。

   git add fileFor7370149

6. 在Git Bash中将本次操作提交。

   git commit -m "fix #7370149 Task01"    #/本次提交用fix关键字关联了编号为7370149的task01

   

   61081924是tesk-01的编号。

7. 在Git Bash将提交的内容推送到关联的代码托管仓库。

   git push

   如推送成功，不同仓库结构返回会略有不同，只要看到所有步骤都100%、done就是推送成功了，如果推送失败一般是您的密钥问题。

8. 验证关联结果。

   上述操作完成后，进入工作项列表，找到编号为7370149的工作项，进入查看详情，如下图所示：

   • 其状态已经置于“已解决”。
   • 增加了一条关联得代码提交记录，单击提交编号可以前往查看提交详情。
   • 增加了一条自动生成得评论以说明本次工作项关联。

     

在代码托管控制台提交代码并关联工作项

1. 进入仓库详情页。
2. 新建一个文件，如下图所示，在填写“备注”时以fix #7370151开头，其他信息任意即可。

   

   

   7370151是task02的编号。

3. 单击“确定”按钮，此时系统相当于在代码托管仓库上执行了以下操作：

   新建文件写入内容
   git add .
   git commit -m "fix #7370151 Task02"

   也就是将一个新建的文件进行了一次commit，并通过-m参数中的“fix”关键字关联到了task02工作项。

4. 验证。

   此时您再去查看task02工作项时，如下图所示：

   • 其状态已经置于“已解决”。
   • 增加了一条关联得代码提交记录，单击提交编号可以前往查看提交详情。
   • 增加了一条自动生成的评论以说明本次工作项关联。

     

如何查看代码提交与工作项的关联关系

代码提交记录与工作项之间的关联关系，可以通过如下表所示方法查看。