添加自定义通知处理程序
ThingWorx Apps 提供两种通知发送方式:电子邮件和短信发送。这些发送方式可在 > 中启用和配置。默认情况下,必须先在 > 中配置每个用户的“通知首选项”,才能将其添加为警告通知的接收人。
要使用不同的通知发送方式,可创建一个新的通知处理程序,并在 PTC.Factory.C_LaunchPointConfigurationThing_[发布版本] 的“配置”页面上将其设置为 AdditionalAlertNotificationHandler。随后,可将任何用户添加为警报接收人。
要创建新通知处理程序:
1. 创建新数据形状 (例如 MyNotificationHandlerContent),然后单击“保存”。该数据形状用于定义通知的内容 (如需要)。有关示例,请参阅 SMSContent 和 EmailContent。
2. 使用 NotificationHandler 的“基本事物模板”创建新事物模板 (例如 MyNotificationHandlerTemplate)。
3. 在 MyNotificationHandlerTemplate 上,单击“服务”,然后在“我的服务”表中单击“添加”以添加一个“服务名称”为 Notify 的新服务。在“输入”的下面,添加以下输入参数:
名称
|
基本类型
|
数据形状
|
信息表类型
|
定义
|
NOTIFICATIONDEFINITIONNAME
|
—
|
—
|
事件
|
信息表
|
事件
|
仅信息表
|
配置
|
信息表
|
选择在步骤 1 中创建的数据形状,例如 MyNotificationHandlerContent
|
仅信息表
|
a. 单击“输入”下面的“添加”。
b. 在“新输入”窗口中,输入“输入参数”属性,如上表所示。
c. 单击“完成”。
d. 对每个输入参数重复步骤 3a 到 3c。
单击“完成”以创建新服务。
4. 单击“保存”。
5. 创建新事物 (例如 MyNotificationHandler),并将“事物模板”设置为在步骤 2 中创建的事物模板。单击“保存”。
6. 为通知处理程序事物 (
notificationHandlers.MyNotificationHandler) 创建本地化标记。有关详细信息,请参阅
ThingWorx 帮助中心的
“本地化表”。
7. 从事物右上角的“更多”菜单中选择“源控制的导出”。
8. 在文本编辑器中打开导出的文件。
9. 查找 ConfigurationTable 标记。在 ConfigurationTable 标记中查找空 Rows 标记。
10. 将以下内容添加到 Rows 标记中:
<Row>
<configuration><![CDATA[<数据类型>]]></configuration>
<handlerID><![CDATA[<UUID>]]></handlerID>
<localizedName><![CDATA[[[<标记名称>]]]]></localizedName>
<serviceName><![CDATA[<服务>]]></serviceName>
</Row>
将这些变量替换为以下内容:
◦ <数据形状> - 在步骤 1 中创建的数据形状的名称。
◦ <标记名称> - 在步骤 6 中创建的本地化标记。
◦ <服务> - 在步骤 3 中创建的服务。
例如:
<Row>
<configuration><![CDATA[MyNotificationHandlerContent]]></configuration>
<handlerID><![CDATA[90ded6fc-7fd7-4141-80ee-34aea5e6fb71]]></handlerID>
<localizedName><![CDATA[[[notificationHandlers.MyNotificationHandler]]]]></localizedName>
<serviceName><![CDATA[Notify]]></serviceName>
</Row>
11. 保存文件。
12. 在 ThingWorx Composer 中,选择 > > 。
13. 单击“选择文件”,然后导航至更新后的导出文件。
14. 确保选中“实体”,然后单击“导入”。
15. 单击“关闭”。
16. 打开 PTC.Factory.C_LaunchPointConfigurationThing_[发布版本],然后单击“配置”。
17. 对于 AdditionalAlertNotificationHandler,搜索并选择在步骤 7 中创建的事物,例如 MyNotificationHandler。单击“保存”。
现在创建警报时,可选择任何用户作为警报接收人,而非仅限已配置了
“通知首选项”的用户。有关详细信息,请参阅
配置警报。