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

配置IPD自运营/云服务类项目的通知规则

  • 通知设置分为站内信、邮件、钉钉、飞书和通用webhook。
  • 针对站内信通知和邮件通知,在给项目成员设置消息通知后,与成员有关的操作会进行提醒。如将工作项指派给某个成员,该成员可以收到对应通知。
  • 钉钉、飞书和通用webhook,如有事件触发通知,会发到对应钉钉、飞书和webhook聊天群。

前提条件

已新建IPD自运营/云服务类项目,并在项目中拥有工作配置的“通知设置”权限。

站内信通知、邮件通知和企业微信设置

  1. 访问CodeArts Req服务首页
  2. 进入项目,单击设置 > 工作项设置 > 通知设置

    图1 通知设置

  3. 根据项目实际情况选择需要设置通知的工作项。
  4. 勾选或取消勾选通知对象和通知类型。

    设置完成后,当发生相应的事件(如修改RR)时,被勾选的对象会收到相应的通知。
    • 站内信通知:登录首页后,页面右上角图标处将显示数字,单击该图标即可看到通知。
    • 邮件通知:若为项目成员创建IAM用户时配置了邮箱,且项目成员在个人设置 > 消息通知中开启了邮件通知,则将会收到服务发出的邮件。
    • 企业微信:提供应用动态企业微信推送能力,填写URL地址,根据需要填写其他信息,并配置通知内容即可。

钉钉和飞书通知设置

提供应用动态钉钉推送能力。根据需要填写参数信息,并配置通知内容。

  1. 访问CodeArts Req服务首页
  2. 进入项目中,单击设置 > 通用配置 > 通知设置
  3. 在通知页面选择钉钉/飞书 > 需求管理,进入IPD自运营/云服务类项目的钉钉/飞书设置页面。
  4. 按照表1设置参数。

    表1 钉钉/飞书通知参数表

    参数

    说明

    URL

    该参数项必填,表示钉钉群聊天机器人、飞书群聊天机器人通知的URL。

    事件类型

    该参数项必选,可多选。表示要通知的事件类型。

    事件类型按照原始需求和工作项的具体操作设置。按需勾选需要通知的操作项。

    通知内容

    该参数项选填,表示推送消息的内容。

    通知内容包括:

    • 需求管理名称
    • 操作人
    • 操作时间
    • 通知内容
    • 链接

    @user_id

    该参数项选填,表示消息推送时,需要@的成员。

    格式要求:

    user_id只能由英文字母、数字和.-_@符号组成,且必须以英文字母和数字开头,单个user_id长度为1-64个字符。

    多个user_id间使用英文逗号隔开,最大可输入的个数为50个,总字符长度为1000

    @手机号

    该参数项选填,表示消息推送时,需要@的手机号。钉钉有此项,飞书没有此项。

    格式要求:多个手机号使用“;”隔开,总字符长度为1000

    密钥

    该参数选填,仅配置钉钉、飞书通知时涉及此项参数。

    若钉钉机器人的安全设置开启加签、飞书机器人的安全设置开启签名校验,请填写加签/签名的密钥。

  5. 单击“确定”,保存设置的信息。

通用webhook通知设置

提供应用动态通用webhook推送能力。

  1. 访问CodeArts Req服务首页
  2. 进入项目中,单击设置 > 通用配置 > 通知设置
  3. 在通知页面选择通用 webhook > 需求管理,进入IPD自运营/云服务类项目的webhook设置页面。
  4. 单击“新建Webhook订阅”,进入“新建 Webhook”页面。
  5. 按照表2设置参数。

    表2 webhook通知参数表

    参数

    说明

    订阅事件名称

    该参数项必填,表示订阅事件的名称,自定义名称,至多200个字符。

    URL

    该参数项必填,表示webhook通知的URL。必须以https://或http://开头。

    事件类型

    该参数项必选,可多选。表示要通知的事件类型。

    事件类型按照原始需求和工作项的具体操作设置。按需勾选需要通知的操作项。

    HTTP 请求头

    该参数项选填,表示消息推送时,需要用到的请求头。

    HTTP请求头,JSON数组; 单个请求头最大长度100,最多输入20个请求头; 一个请求头的格式为key:值,例如 Content-Type:application/json。

    自定义模板

    该参数必填,表示通用webhook通知消息自定义的模板。

    支持配置变量,可通过${}方式获取变量对应的值,支持的变量见表3字符总长度为1000。

    钉钉的参数示例:
    {
        "msgtype" : "text"  //消息类型为文本
        "text" : {
            "content" : "xxx"   //消息文本内容
        }
    }
    表3 通用webhook自定义模板支持配置的变量

    变量

    说明

    project.id

    项目ID。

    project.url

    项目URL。

    issue.id

    工作项id

    issue.url

    工作项URL。

    issue.title

    工作项标题。

    operator.username

    操作员用户名。

    operator.id

    操作员的id。

    operation

    操作。

  6. 单击“确定”,保存设置的信息。

相关文档