消息服务

1. 概况

消息途径分为邮件、短信、站内信3大类别。它包含了激发系统与用户交互的触发点类型,不同触发点在触发之后给用户反馈的消息模板,发送邮箱和短信的服务器配置信息。

消息服务用来选择某一个触发点对应选择的邮件模板、短信模板、站内信模板以及发送模式。用户可以根据需要,通过此功能,可以在忘记密码、添加/导入新用户、系统添加新功能、修改密码等过程中向不同成员发送邮件提醒。同时可以设置不同的邮件通知模式。

2. 消息服务列表

列表字段:

  • 消息类型:由接收方的某些行为触发邮件发送的触发点类型。比如忘记密码、添加/导入新用户、项目停用、修改密码等。
  • 说明:对触发类型的触发情景、适用场景的描述。
  • 层级:发送设置生效的层级,包括平台层,组织层,项目层三个层级。
  • 状态:消息类型的状态,分为启用,停用两种。启用状态下的消息类型会根据发送消息。
  • 是否允许配置接收:设置是否允许用户自定义是否接收此类型的消息。

3. 设置邮件内容

  • 进入平台管理,点击菜单“设置>通知>消息服务”,进入消息服务页面。
  • 点击您要进行设置的消息类型所在列的三点按钮,选择设置邮件内容,进入该消息类型的设置邮件内容页。
  • 在设置邮件内容页,您可以看到邮件的发送配置项和可使用邮件模板。

发送设置:

  • 重发次数:自动重发的次数,默认重发次数为3次。
  • 是否即时发送:选择触发该消息类型是否立刻发送。
  • 是否允许手动重发:邮件发送失败后,是否允许用户在消息日志面点击重发。选择模板:
  • 模板列表展示了当前消息类型下的全部模板。点击模板名称查看模板。您可以点击三点,选择设为默认模板,设置默认发送的邮件模板。
    • 点击操作栏的修改配置→修改配置按钮,打开修改设置页面:

可修改项:

  • 重发次数:设置自动重发的次数,默认重发次数为3次。
  • 是否即时发送:选择触发该消息类型是否立刻发送。
  • 是否允许手动重发:设置邮件发送失败后,是否允许用户在消息日志面点击重发
  • 设置默认模板:选择触发该消息类型后使用的邮件模板。
    • 点击保存,保存您对该消息类型发送配置项的更改。
  • 点击点击操作栏的创建模板→创建模板按钮,打开新建邮件模板页面。

必填字段:

  • 模板名称:邮件模板的名称。
  • 邮件主题:发送时邮件的主题。
  • 邮件内容:邮件的内容。填写模板所需的文字和参数。模板中的参数变量通过${}进行替换,在发送时,将${}替换成对应的实际变量。例如:模板:${username}您好。发送参数:username=张三。发送信息:张三您好。更多的变量信息,请查看变量说明
    • 点击保存,完成新建模板。

3.1 修改模板

  • 点击您要修改的邮件模板所在列的三点按钮,选择修改,进入修改模板页。
  • 您可以在修改模板页,对邮件的主题、内容进行修改。
  • (可选)你可以设置当前模板是否为默认使用模板。
  • 点击保存,保存对模板的修改。

3.2 删除模板

点击您要删除的邮件模板所在列的三点按钮,选择删除,即可删除模板。

只能够删除自定义模板,不能删除预置模板。

4. 设置站内信内容

  • 进入平台管理,点击菜单“设置>通知>消息服务”,进入消息服务页面。
  • 点击您要进行设置的消息类型所在列的三点按钮,选择设置站内信内容,进入该消息类型的设置站内信内容页。
  • 在设置站内信内容页,您可以看到站内信的发送配置项和可使用站内信模板。

发送设置:

  • 站内信类型:分为消息通知两种,如果是消息类型,则显示在消息通知的消息页。如果是通知类型,则显示在通知页。选择模板:
  • 模板列表展示了当前消息类型下的全部模板。点击模板名称查看模板。您可以点击三点,选择设为默认模板,设置默认发送的站内信模板。
    • 点击操作栏的修改配置→修改配置按钮,打开修改设置页面:

可修改项:

  • 站内信类型:可以选择消息通知两种。
  • 设置默认模板:选择触发该消息类型后使用的邮件模板。
    • 点击保存,保存您对该消息类型发送配置项的更改。
  • 点击点击操作栏的创建模板→创建模板按钮,打开新建站内信模板页面。

必填字段:

  • 模板名称:站内信模板的名称。
  • 站内信主题:发送时站内信的标题。
  • 站内信内容:站内信的内容。填写模板所需的文字和参数。模板中的参数变量通过${}进行替换,在发送时,将${}替换成对应的实际变量。
  1. 例如:
  2. 模板:`${username}`您好。
  3. 发送参数:`username=张三`
  4. 发送信息:张三您好。
  • 更多的变量信息,请查看变量说明
    • 点击保存,完成新建模板。

4.1 修改模板

  • 点击您要修改的站内信模板所在列的三点按钮,选择修改,进入修改模板页。
  • 您可以在修改模板页,对站内信的主题、内容进行修改。
  • (可选)你可以设置当前模板是否为默认使用模板。
  • 点击保存,保存对模板的修改。

4.2 删除模板

点击您要删除的站内信模板所在列的三点按钮,选择删除,即可删除模板。

只能够删除自定义模板,不能删除预置模板。

5. 设置短信内容

  • 进入平台管理,点击菜单“设置>通知>消息服务”,进入消息服务页面。
  • 点击您要进行设置的消息类型所在列的三点按钮,选择设置短信内容,进入该消息类型的设置短信内容页。
  • 在设置短信内容页,您可以看到可使用短信模板(短信没有发送设置)。

选择模板:

  • 模板列表展示了当前消息类型下的全部模板。点击模板名称查看模板。您可以点击三点,选择设为默认模板,设置默认发送的短信模板。
    • 点击点击操作栏的创建模板→创建模板按钮,打开新建短信模板页面。

必填字段:

  • 模板名称:短信模板的名称。
  • 短信内容:短信的内容。
    • 点击保存,完成新建模板。

5.1 修改模板

  • 点击您要修改的短信模板所在列的三点按钮,选择修改,进入修改模板页。
  • 您可以在修改模板页,对短信的内容进行修改。
  • (可选)你可以设置当前模板是否为默认使用模板。
  • 点击保存,保存对模板的修改。

5.2 删除模板

点击您要删除的短信模板所在列的三点按钮,选择删除,即可删除模板。

只能够删除自定义模板,不能删除预置模板。

6. 变量声明

以下是邮件、短信、站内信模板中可以使用的变量参数。

变量名说明试用范围示例
${loginName}登录名所有触发类型模板:您的登录名为${loginName}。发送参数:loginName=张三发送信息:您的登录名为张三。
${userName}用户名所有触发类型模板:${userName},您好。发送参数:userName=张三发送信息:张三,您好。
${defaultPassword}初始密码组织重置用户密码模板:您的初始密码为${defaultPassword}。发送参数:defaultPassword=abc123发送信息:您的初始密码为abc123。
${verifyCode}验证码忘记密码模板:您的验证码为${verifyCode}。发送参数:verifyCode=123456发送信息:您的验证码为123456。
${addCount}添加的用户数量添加用户模板:您已成功添加${addCount}名用户。发送参数:addCount=1发送信息:你已成功添加1名用户。
${assigneeName}issue的操作者(创建者、被分配者)问题创建、问题分配、问题已创建模板:issue${summary}已由${assigneeName}解决。发送参数:summary=No-1 编写变量说明文档${assigneeName}=张三发送信息:No-1 编写变量说明文档已由张三解决。
${summary}敏捷管理的issue编码名称问题创建、问题分配、问题已解决模板:${summary}已解决。发送参数:summary=No-1 编写变量说明文档发送信息:No-1 编写变量说明文档已解决。
${organizationName}组织名称组织启用、组织停用模板:${organizationName}组织已启用。发送参数:organizationName=Choerodon发送信息:Choerodon组织已启用。
${projectName}项目名称项目启用、项目停用模板:${projectName}项目已启用。发送参数:organizationName=Choerodon发送信息:Choerodon项目已启用。
${title}您在系统公告页填写公告时编写的系统公告标题系统公告模板:${title}发送参数:${title}=版本更新发送信息:版本更新(发送后标题为版本更新)
${content}您在系统公告页编写的公告内容系统公告模板:${content} 发送参数:${content}= 请在此输入系统公告内容发送信息:请在此输入系统公告内容(发送后系统公告为此内容)
${jobName}任务名称平台任务状态通知、组织任务状态通知、项目任务状态通知模板:${jobName} 任务已结束。发送参数:${jobName}=定时执行任务发送信息:定时执行任务已结束。
${jobStatus}任务执行状态(可渲染的状态有启用、停用、结束)平台任务状态通知、组织任务状态通知、项目任务状态通知模板:定时执行任务已${jobStatus}。 发送参数:${jobStatus}= 启用 发送信息:定时执行任务已启用。
${sagaInstanceId}事务实例的ID事务实例失败通知模板:编号为${sagaInstanceId}的事务实例运行失败。发送参数:${sagaInstanceId}= 1000 发送信息:编号为1000的事务实例运行失败。
${sagaCode}事务定义的编码事务实例失败通知模板:编号为1000的${sagaCode}事务实例运行失败。发送参数:${sagaCode}=iam-disable-project 发送信息:编号为1000的iam-disable-project事务实例运行失败。
${level}触发事务实例的层级(平台、组织、项目)事务实例失败通知模板:编号为1000的${level}层事务实例运行失败。发送参数:${level}=平台 发送信息:编号为1000的平台层事务实例运行失败。
${pipelineName}流水线名称流水线失败、流水线成功、流水线任务待审核、流水线被终止通知、流水线或签任务通过通知模板:流水线${pipelineName}执行成功。发送参数:${pipelineName}=test 发送信息:流水线test执行成功。
${pipelineId}流水线Id流水线失败、流水线成功、流水线任务待审核、流水线被终止通知、流水线或签任务通过通知模板:ID为${pipelineId}的流水线执行成功。发送参数:${pipelineId}=1 发送信息:ID为1的流水线执行成功。
${pipelineName},${pipelineId},${pipelineRecordId},${projectId},${projectName},${organizationId}流水线名称,流水线Id,流水线记录Id,项目Id,项目名称,组织Id流水线失败、流水线成功模板:流水线“${pipelineName}”执行失败。查看详情(查看详情的链接为:#/devops/pipeline-record/detail/${pipelineId}/${pipelineRecordId}?type=project&id=${projectId}&name=${projectName}&category=undefined&organizationId=${organizationId})发送参数:pipelineName=通知测试002pipelineId=197pipelineRecordId=672projectId=490projectName=testpro0110organizationId=803发送信息:流水线“通知测试002”执行失败。 查看详情
${pipelineName},${stageName},${pipelineId},${pipelineRecordId},${projectId},${projectName},${organizationId}流水线名称,阶段名称,流水线Id,流水线记录Id,项目Id,项目名称,组织Id流水线任务待审核模板:流水线“${pipelineName}”目前暂停于【${stageName}】阶段,需要您进行审核。查看详情(查看详情的链接为:#/devops/pipeline-record/detail/${pipelineId}/${pipelineRecordId}?type=project&id=${projectId}&name=${projectName}&category=undefined&organizationId=${organizationId})发送参数:pipelineName=通知测试002stageName=阶段一pipelineId=200pipelineRecordId=677projectId=875projectName=project0517organizationId=1027发送信息:流水线“通知测试001”目前暂停于【阶段一】需要您进行审核。查看详情
${pipelineName},${stageName},${auditName},${realName},${pipelineId},${pipelineRecordId},${projectId},${projectName},${organizationId}流水线名称,阶段名称,终止人员工号,终止人员名称,流水线Id,流水线记录Id,项目Id,项目名称,组织Id流水线被终止模板:流水线“${pipelineName}”在【${stageName}】阶段被${auditName}:${realName}终止。查看详情(查看详情的链接为:#/devops/pipeline-record/detail/${pipelineId}/${pipelineRecordId}?type=project&id=${projectId}&name=${projectName}&category=undefined&organizationId=${organizationId}
${pipelineName},${stageName},${auditName},${realName},${pipelineId},${pipelineRecordId},${projectId},${projectName},${organizationId}流水线名称,阶段名称,或签审核人员工号,或签审核人员名称,流水线Id,流水线记录Id,项目Id,项目名称,组织Id流水线或签任务通过通知模板:流水线“${pipelineName}”在【${stageName}】阶段中的或签任务已被${auditName}:${realName}审核。查看详情(查看详情的链接为:#/devops/pipeline-record/detail/${pipelineId}/${pipelineRecordId}?type=project&id=${projectId}&name=${projectName}&category=undefined&organizationId=${organizationId})发送参数:pipelineName=通知测试002stageName=阶段二auditName=m1realName=m1pipelineId=197pipelineRecordId=672projectId=490projectName=testpro0110organizationId=803发送信息:流水线“通知测试002”在【阶段二】被m1:m1终止。查看详情”
${user},${env},${object},${objectName},${captcha}操作者名称,环境名称,删除对象类型,删除对象名称,验证码删除资源对象(网络、域名、实例、证书、配置映射、密文)模板:您好,${user}正在${env}环境下执行删除${object}“”${objectName}“的操作,验证码为:${captcha};确认后,需将此验证码提供给操作者${user}完成删除操作。验证码10分钟内有效。参数:user=m1env=testshellobject=证书objectName=cert-0604-7captcha=215694发送信息:您好,m1正在testshell环境下执行删除证书”“cert-0604-7”“的操作,验证码为:215694;确认后,需将此验证码提供给操作者m1完成删除操作。验证码10分钟内有效。

模板中的参数变量通过${}进行替换,在发送时,将${}替换成对应的实际变量。

例如:

  1. 邮件标题:验证邮件
  2. 邮件内容:
  3. ${userName},您好!您正在进行邮箱验证,您本次请求的验证码为:${verifyCode}。
  4. 此验证码用于重置密码,XXX内有效。

7. 更多操作