更新时间:2025-11-27 GMT+08:00
分享

E2E设置

CodeArts Repo支持通过“E2E设置”帮助记录每次代码合入的原因,包括开发需求、修复问题单,或者完成工作项,Repo系统将记录关联信息方便日后追溯。

在进行E2E设置前,用户请先查看约束与限制,满足E2E设置权限的用户请根据可集成系统集成策略自动提取单号规则进行配置,用户也可以参考E2E设置示例进行配置。

约束与限制

表1 E2E设置的约束与限制

限制类别

具体限制

功能限制

看板项目下的代码托管仓库不支持E2E设置。

权限限制

当用户角色为“项目经理”或者“项目管理员”,可以设置项目级E2E设置,请参考配置项目级的Repo权限进行配置。

可集成系统

与CodeArts Req系统集成,使用CodeArts Req的工作项关联对应代码提交,包括代码提交、代码分支和合并请求场景。Repo系统默认设置了关联。

Repo可关联的工作项类别请参考下表。

表2 Repo可关联工作项参数说明

项目类型

可关联工作项

Scrum

Epic,Feature,Story,Task,Bug

IPD-系统设备类

IR,SR,AR,Bug,DR

IPD-独立软件类

IR,US,Bug,Task

IPD-自运营软件/云服务类

Epic,FE,US,Task,Bug

集成策略

可选枚举值,用于限定用户在关联工作项时的选择条件。

排除状态:选中状态的工作项不可关联合并请求。

例如,当前图片展示是“Scrum”项目可关联的工作项,选择“新建”,表示新建状态的工作项不可关联合并请求。

可关联类别:选中类型的工作项可以被关联。

例如,选择Epic表示“Epic”类型的工作项可以关联合并请求,不同类型项目可关联的工作项请参考表2

当前支持跨项目关联工作项。

应用分支:选中的分支将受,其他分支无限制。

例如,如果正则表达式为“Branch_*”,表示所有以“Branch_”开头的分支的合并请求将遵循上述的“排除状态”“可关联类别”设置,正则表达式规则请参考常见的正则表达式示例

自动提取单号规则

约束与限制

  • 前缀、后缀、分隔符不能互相包含,否则提取效果不符合预期。
  • 分隔符为空时,前缀和后缀不建议为“;”,否则提取效果不符合预期。
  • 后缀为空时,前缀和分隔符不能为“\n”,否则提取效果不符合预期。
  • 前缀、分隔符、后缀为全字符匹配,不支持正则表达式。

配置步骤

自动提取单号规则表示可以根据代码提交信息自动提取单号,请参考下表进行配置。

表3 自动提取单号规则参数说明

参数

说明

单号前缀

非必填。支持多个前缀,最多10个,每个最多200字符。

分隔符

非必填。默认为“;”

单号后缀

非必填。默认为使用换行。

E2E设置示例

此示例以Scrum类型项目为例。

  1. 进入要配置的项目,上方导航栏依次选择“设置 > 服务集成 > E2E设置”,切换到“E2E设置”页面。

  2. 排除状态选择“新建”,可关联类别选择“Story”,应用分支为“Branch_*”,单号前缀为“合入需求”,分隔符为“;”,单号后缀为“\n”

  3. 创建工作项。

    1. 单击目标项目名称,进入项目。
    2. 在当前“工作项”页面,单击“新建”,在弹出的下拉框中选择“Task”,进入新建工作项页面。

    3. 填写标题,例如:迭代一。

      其他参数默认即可,单击“保存”按钮进行保存。

  4. 新建文件。

    1. 进入代码托管仓库列表页,单击目标仓库名称,进入仓库。
    2. “代码”页签下,单击“新建”,在弹出的下拉框中选择“新建文件”,进入新建文件页面。

    3. 填写以下信息,其余参数默认即可,单击“确定”完成文件的新建。

      文件名:自定义文件名称,例如:示例代码。

      文件内容:自定义文件内容。

      提交信息:填写E2E设置中的前缀及工作项的单号,例如:合入需求:708635317。

  5. 新建合并请求时提取单号。

    1. 切换为“合并请求”页签,单击“新建”
    2. 选择源分支为“Test”,目标分支为“master”
    3. 设置变更主题为“test”。单击,可复制当前的变更主题名称,单击,可取消当前的变更主题关联。
      使用变更主题时,需要注意以下事项:
      • 变更主题不支持半角引号和全角引号,字符长度不超过50。
      • 一个变更主题可管理多个合并请求。例如,当用户希望为其他合并请求关联变更主题“test”时,可以在创建新的合并请求时,右侧填写变更主题为“test”。

  • 如果用户的仓库是“所有访客只读”,当用户新建或者修改合并请求“标题”时,且标题内容包含违规词汇,新建或者修改合并请求标题将失败,并在右上角报错提示“合并请求标题存在违反法律法规的内容,请修改后重新提交。”
  • 如果用户的仓库是“所有访客只读”,当用户的“描述”包含违规词汇或者图片,会审核不通过,在合并请求标题右侧将显示“标题或描述内容审核不通过,请及时修改,否则合并请求仅项目内成员可见。”并且此合并请求将不对其他成员展示,修改并合规后,将正常展示此合并请求信息。
  • 如果用户的仓库是“所有访客只读”,当用户的“合并请求评价”包含敏感词汇或者图片,将会在评价所在行显示“审核不通过”

相关文档