更新时间:2025-07-24 GMT+08:00

E2E设置

什么是E2E设置

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

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

约束与限制

表1 E2E设置的约束与限制

限制类别

具体限制

功能限制

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

权限限制

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

可集成系统

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

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

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

项目类型

可关联工作项

Scrum

Epic,Feature,Story,Task,Bug

IPD-系统设备类

IR,SR,AR,Bug

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. 选择源分支为“Dev”,目标分支为“master”。其中,专业版和企业版涉及“模板”

      此时,工作项被自动提取至该合并请求。