配置IPD自运营/云服务类项目的通知规则
- 通知设置分为站内信、邮件、钉钉、飞书和通用webhook。
- 针对站内信通知和邮件通知,在给项目成员设置消息通知后,与成员有关的操作会进行提醒。如将工作项指派给某个成员,该成员可以收到对应通知。
- 钉钉、飞书和通用webhook,如有事件触发通知,会发到对应钉钉、飞书和webhook聊天群。
前提条件
已新建IPD自运营/云服务类项目,并在项目中拥有工作配置的“通知设置”权限。
站内信通知、邮件通知和企业微信设置
- 访问CodeArts Req服务首页。
- 进入项目,单击
。图1 通知设置
- 根据项目实际情况选择需要设置通知的工作项。
- 勾选或取消勾选通知对象和通知类型。
设置完成后,当发生相应的事件(如修改RR)时,被勾选的对象会收到相应的通知。
- 站内信通知:登录首页后,页面右上角图标
处将显示数字,单击该图标即可看到通知。
- 邮件通知:若为项目成员创建IAM用户时配置了邮箱,且项目成员在 中开启了邮件通知,则将会收到服务发出的邮件。
- 企业微信:提供应用动态企业微信推送能力,填写URL地址,根据需要填写其他信息,并配置通知内容即可。
- 站内信通知:登录首页后,页面右上角图标
钉钉和飞书通知设置
提供应用动态钉钉推送能力。根据需要填写参数信息,并配置通知内容。
- 访问CodeArts Req服务首页。
- 进入项目中,单击 。
- 在通知页面选择 ,进入IPD自运营/云服务类项目的钉钉/飞书设置页面。
- 按照表1设置参数。
表1 钉钉/飞书通知参数表 参数
说明
URL
该参数项必填,表示钉钉群聊天机器人、飞书群聊天机器人通知的URL。
事件类型
该参数项必选,可多选。表示要通知的事件类型。
事件类型按照原始需求和工作项的具体操作设置。按需勾选需要通知的操作项。
通知内容
该参数项选填,表示推送消息的内容。
通知内容包括:
- 需求管理名称
- 操作人
- 操作时间
- 通知内容
- 链接
@user_id
该参数项选填,表示消息推送时,需要@的成员。
格式要求:
user_id只能由英文字母、数字和.-_@符号组成,且必须以英文字母和数字开头,单个user_id长度为1-64个字符。
多个user_id间使用英文逗号隔开,最大可输入的个数为50个,总字符长度为1000。
@手机号
该参数项选填,表示消息推送时,需要@的手机号。钉钉有此项,飞书没有此项。
格式要求:多个手机号使用“;”隔开,总字符长度为1000。
密钥
该参数选填,仅配置钉钉、飞书通知时涉及此项参数。
若钉钉机器人的安全设置开启加签、飞书机器人的安全设置开启签名校验,请填写加签/签名的密钥。
- 单击“确定”,保存设置的信息。
通用webhook通知设置
提供应用动态通用webhook推送能力。
- 访问CodeArts Req服务首页。
- 进入项目中,单击 。
- 在通知页面选择 ,进入IPD自运营/云服务类项目的webhook设置页面。
- 单击“新建Webhook订阅”,进入“新建 Webhook”页面。
- 按照表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" //消息文本内容 } }
- 单击“确定”,保存设置的信息。