# 设置钉钉订阅
 #### 操作场景
当以下事件发生时，CodeArts支持以订阅的方式，将事件以HTTP协议发送到钉钉群。
- [需求管理]
- [代码托管]
- [流水线]
- [代码检查]
- [编译构建]
- [部署]
- [测试计划]
表1事件类型 
| 分类   | 事件类型      |
|:---|:---|
| 原始需求 | 新建/提交     |
| 原始需求 | 编辑        |
| 原始需求 | 删除        |
| 原始需求 | 变更        |
| 原始需求 | 状态更新      |
| 原始需求 | 催单        |
| 原始需求 | 评论        |
| 系统特性 | 新建        |
| 系统特性 | 编辑        |
| 系统特性 | 删除        |
| 系统特性 | 变更        |
| 系统特性 | 基线/取消基线   |
| 系统特性 | 状态更新      |
| 系统特性 | 催单        |
| 系统特性 | 评论        |
| 研发需求 | 新建        |
| 研发需求 | 编辑        |
| 研发需求 | 删除        |
| 研发需求 | 变更        |
| 研发需求 | 基线/取消基线   |
| 研发需求 | 迁移        |
| 研发需求 | 评论        |
| 研发需求 | 催单        |
| 研发需求 | 状态更新      |
| 任务   | 新建        |
| 任务   | 编辑        |
| 任务   | 删除任务      |
| 任务   | 评论        |
| 任务   | 催单        |
| 任务   | 状态更新      |
| 缺陷   | 新建/提交     |
| 缺陷   | 编辑        |
| 缺陷   | 删除        |
| 缺陷   | 迁移        |
| 缺陷   | 状态更新      |
| 缺陷   | 催单        |
| 缺陷   | 评论        |
| 评审单  | 提交        |
| 评审单  | 转他人处理     |
| 评审单  | 撤销/驳回     |
| 评审单  | 变更对象评审完成  |
| 评审单  | 变更对象决策完成  |
| 评审单  | 评审/决策阶段完成 |
| 评审单  | 删除        |
| 评审单  | 评论        |
   
表2事件类型 
| 分类   | 事件类型   |
|:---|:---|
| 仓库   | 容量预警   |
| 仓库   | 删除仓库   |
| 合并请求 | 开启合并请求 |
| 合并请求 | 更新合并请求 |
| 合并请求 | 合并合并请求 |
| 合并请求 | 检视合并请求 |
| 合并请求 | 审核合并请求 |
| 合并请求 | 新建评审意见 |
| 合并请求 | 解决评审意见 |
   
表3事件类型 
| 事件类型     || 通知内容                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|---|:---|
| 流水线 | 已完成 | - 流水线名称  - 流水线执行描述  - 执行人  - 触发信息  - 项目名称  - 执行时间  - 运行状态   |
| 流水线 | 失败  | - 流水线名称  - 流水线执行描述  - 执行人  - 触发信息  - 项目名称  - 执行时间  - 运行状态   |
| 流水线 | 暂停  | - 流水线名称  - 流水线执行描述  - 执行人  - 触发信息  - 项目名称  - 执行时间  - 运行状态   |
| 流水线 | 挂起  | - 流水线名称  - 流水线执行描述  - 执行人  - 触发信息  - 项目名称  - 执行时间  - 运行状态   |
| 流水线 | 忽略  | - 流水线名称  - 流水线执行描述  - 执行人  - 触发信息  - 项目名称  - 执行时间  - 运行状态   |
   
表4事件类型 
| 事件类型                                                                                                                                                                                                                                                                                                                          || 通知内容                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|---|:---|
| 代码检查任务 | 检查完成 - 全部  - 门禁通过  - 门禁不通过   | - 检查结果  - 门禁结果  - 问题数  - 跳转链接  - 执行人  - 完成时间   |
   
表5事件类型 
| 事件类型            || 通知内容                                                                                                                                                                                                                                                                            |
|:---|---|:---|
| 编译构建任务 | 任务构建成功  | - 任务名称  - 执行人  - 执行时间   |
| 编译构建任务 | 任务构建失败  | - 任务名称  - 执行人  - 执行时间   |
| 编译构建任务 | 任务被禁用   | - 任务名称  - 执行人  - 执行时间   |
| 编译构建任务 | 任务被删除   | - 任务名称  - 执行人  - 执行时间   |
| 编译构建任务 | 任务配置被更新 | - 任务名称  - 执行人  - 执行时间   |
   
表6事件类型 
| 事件类型       || 通知内容                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|---|:---|
| 应用 | 应用部署成功 | - 应用名称  - 执行结果  - 执行序号  - 执行人  - 执行时间  - 项目名称   |
| 应用 | 应用部署失败 | - 应用名称  - 执行结果  - 执行序号  - 执行人  - 执行时间  - 项目名称   |
| 应用 | 应用部署中止 | - 应用名称  - 执行结果  - 执行序号  - 执行人  - 执行时间  - 项目名称   |
   
表7事件类型 
| 分类   | 事件类型                   |
|:---|:---|
| 测试用例 | 分配用例处理者                |
| 测试用例 | 修改用例                   |
| 测试用例 | 执行手工用例                 |
| 测试用例 | 接口测试用例执行完成             |
| 测试用例 | 删除用例                   |
| 测试套  | 新建测试套                  |
| 测试套  | 更新测试套                  |
| 测试套  | 删除测试套                  |
| 测试套  | 测试套件执行完成               |
| 测试报表 | 新建报表                   |
| 测试报表 | 更新报表                   |
| 测试报表 | 删除报表                   |
| 分支计划 | 新建计划                   |
| 分支计划 | 更新计划                   |
| 分支计划 | 编辑风险信息（在测试质量看板中编辑风险信息） |
| 分支计划 | 删除计划                   |
| 分支计划 | 删除分支                   |
| 分支计划 | 测试计划完成后发送质量报告          |
| 目录   | 删除目录                   |
| 评论通知 | 评论通知（在手工测试用例下变更评论）     |
   
#### 约束与限制
- 仅IPD类项目支持需求管理服务配置。
 
#### 前提条件
已新建CodeArts项目，在项目中的角色为"项目管理员"或"项目经理"。
#### 设置钉钉订阅
1. 进入CodeArts首页。 
   1. 登录[CodeArts控制台](https://console.huaweicloud.com/devcloud)，单击![](https://support.huaweicloud.com/usermanual-devcloud/zh-cn_image_0000001917408514.png)，根据需要选择已开通CodeArts的区域。
   
   2. 单击"前往工作台"。 如果当前账号采用的是历史计费模式（详情请参考[历史计费模式说明](https://support.huaweicloud.com/price-devcloud/codearts_29_0031.html)），则单击"立即使用"。
      
   
   
   
   
2. 单击目标项目名称，进入项目。
3. 在导航中依次单击"设置 \> 通用设置 \> 通知设置"，进入通知设置页面。
4. 选择"钉钉"页签。
5. 根据实际需要完成参数配置。 
   图1钉钉配置（以流水线服务为例）   
   ![](https://support.huaweicloud.com/usermanual-devcloud/zh-cn_image_0000002504251799.png "点击放大")
   表8配置钉钉通知 
   | 参数       | 说明                                                                                                                                                            |
   |:---|:---|
   | URL      | 钉钉机器人Webhook地址，http://或https://开头，长度不超过256个字符。 获取钉钉机器人Webhook地址的方式，请参考钉钉开放平台帮助中心"获取自定义机器人 Webhook 地址"章节（以钉钉开放平台帮助中心实际结构为准）。 |
   | 事件类型     | 触发钉钉通知的事件类型，支持的事件类型参考[操作场景]。                                                                                           |
   | 通知内容     | 钉钉通知中所包含的内容，可配置的内容请参考[操作场景]。 该参数为可选参数，当需要通知特定内容时配置。                                |
   | @user_id | 钉钉通知中被@成员的钉钉user_id，多个user_id之间使用";"隔开。支持输入数字、英文、";"、"."、"-"、"_"、"@"，长度不超过1000个字符。 该参数为可选参数，当需要通知特定成员时配置。                   |
   | @手机号     | 该参数为可选参数，输入被@成员的手机号，多个手机号之间使用";"隔开。支持输入数字、";"，长度不超过1000个字符。                                                                                                   |
   | 密钥       | 该参数为可选参数，如果钉钉机器人的安全设置中开启了加签，需输入加签密钥，长度不超过2000个字符。 获取钉钉机器人加签密钥的方式，请参考钉钉开放平台帮助中心"获取自定义机器人 Webhook 地址"章节（以钉钉开放平台帮助中心实际结构为准）。  |
      
   
   
6. 完成配置后，可以选择以下操作。 
   - 单击"保存"，保存本次配置。
     - 当对应开关的状态为![](https://support.huaweicloud.com/usermanual-devcloud/zh-cn_image_0000002594114272.png)时，本次钉钉订阅配置仅保存但未生效，需打开开关后生效。
     
     - 当对应开关的状态为![](https://support.huaweicloud.com/usermanual-devcloud/zh-cn_image_0000002594274190.png)时，本次钉钉订阅配置立即生效。
     
     
     图2配置生效   
     ![](https://support.huaweicloud.com/usermanual-devcloud/zh-cn_image_0000002624673657.png "点击放大") 
   
   - 单击"保存并开启"，本次钉钉订阅配置立即生效。
   
   - 单击"取消"，撤销本次配置，页面中的各参数的值恢复为上一次保存的配置。如果本次为首次配置，则清空页面中的全部参数值。