接收状态报告通知
通过上一节配置,业务应用向终端用户发送5G消息后,5G消息云服务平台会向业务应用推送消息发送的结果状态报告。实现业务应用收到结果状态报告,您需要做以下配置。
操作步骤
- 参考1新建事件“命名空间__MessageNotification__e”,该事件的自定义参数必须与5G消息云服务平台向业务应用推送的结果状态报告中字段保持一致。
该事件自定义参数如下图所示。
表1 自定义参数说明 标签
名称
字段类型
是否必填
描述
address
address
文本
是
发送回执消息的发送方地址(原消息的目的方地址)。
deliveryStatus
deliveryStatus
文本
是
消息发送状态,取值说明如下:
- MessageSent:消息已发送到5G消息云服务平台
- DeliveredToTerminal:消息已达到终端用户
- DeliveryImpossible:发送失败
- DeliveredToNetwork:已转短消息发送
- MessageDisplayed:消息已阅
description
description
文本
否
描述。
href
href
文本
否
可选字段,对应源消息deliveryInfoNotification_link_href。
messageId
messageId
文本
否
源消息ID。
rel
rel
文本
否
可选字段,对应源消息deliveryInfoNotification_link_ref。
- 参考2,新建并配置数据接入“命名空间__MessageNotification”,用于接收5G消息云服务平台向业务应用推送的结果状态报告,并转化成上一步定义的事件输入到AppCube平台的Kafka中。与2配置不同的是,输入源“5G消息”的“元数据定义”页签“元数据类型”配置为“状态报告通知消息”;且输出源“Kafka”配置中,事件选择“命名空间__MessageNotification__e”,配置事件属性映射。图1 数据接入图2 5G消息“元数据定义”配置图3 Kafka配置
- 新建并编排Flow,该Flow的启动类型为事件驱动。
当结果状态报告通过数据接入转化成事件后,订阅该事件的Flow会运行起来。应用开发者可根据自身业务需求自定义开发Flow的逻辑编排。例如业务应用收到用户返回的结果状态报告后,发送邮件。
- 鼠标放在应用下的Logic文件夹,文件夹后会出现加号,单击加号,选择“服务编排”。
- 系统弹出“添加服务编排”的对话框,请参见表2配置参数。然后单击“添加”。图4 创建服务编排
表2 创建服务编排参数说明 参数名
参数说明
如何配置
创建一个新的服务编排
创建一个新的服务编排流程。
选中单选按钮。
选择“创建一个新的服务编排”。
使用已有的服务编排
基于同一租户或基线里已有的服务编排创建。
方便用户快速继承已有服务编排的配置,增加效率。
标签
该服务编排标签名,命名体现其提供的功能。
长度不超过64个字节。
直接填写。
例如:MessageNotification
名称
该服务编排的名称,唯一标识。系统自动生成。
单击该参数配置处系统可自动生成。
类型
服务编排的类型。
- Autolaunched Flow:自启动Flow,在接口调用后会立即执行服务编排模型定义的逻辑。
- Event Trigger:事件触发的服务编排,则会在事件触发时才会开始执行服务编排模型定义的逻辑。当选择该类型时,您需要配置具体的事件以及条件规则。
在下拉框里选择“Event Trigger”。
事件
触发执行该Flow的事件。
选择1定义的事件“MessageNotification”。
规则
触发执行该Flow的规则。
不用配置。
- 拖拽“基本”下“发送邮件”图元至画布中,松开鼠标左键。
- 选中“发送邮件”图元,单击
,设置发送邮件参数。
图5 配置邮件发送参数表3 邮件发送参数说明 参数名称
参数说明
如何配置
直接编辑
手动设置邮件信息。
选中单选按钮。
“直接编辑”和“基于模板”两者择一。
例如选中“直接编辑”。
基于模板
基于同一租户或基线里已有的邮件模板设置邮件主题和内容。
方便用户增加效率。
主题
邮件标题。
当选中“直接编辑”时,您需要直接输入邮件标题。
例如:MessageNotification
内容
邮件内容。
当选中“直接编辑”时,您需要直接输入邮件内容。
例如从全局上下文中拖入事件对象。
地址
接收人的邮箱地址。
有以下两种方式设置地址:
- 字符串:表示直接输入分号分隔的字符串或者从全局上下文拖拽变量。
- 集合:表示可以从全局上下文拖拽集合变量。
请在字符串后直接输入接收人邮箱地址。
抄送
抄送人员的邮箱地址。
直接输入分号分隔的字符串或者从全局上下文拖拽变量。
密送
秘密发送人员的邮箱地址。
直接输入分号分隔的字符串或者从全局上下文拖拽变量。
- 连接图元。
- 单击
,保存Flow。
- 单击
,运行Flow。
- 单击编辑器页面上方
图标,启用服务编排。
当5G消息云服务平台会向业务应用推送消息发送的结果状态报告后,Flow“发送邮件”图元配置的邮箱会收到邮件。
