指定传递协议名称和字段
每个通知类均可使用一个或多个传递协议进行通知传递。在应用程序定义中,必须配置通知类支持的每个传递协议。Notification Services 使用此信息来确定哪些传递协议对于一组通知有效。此主题解释如何定义传递协议。
定义传递协议
定义传递协议时,必须提供协议名称。如果传递协议需要其他信息,还应该定义提供此信息的字段。
此外,Notification Services 支持传递协议的几个执行设置,这些设置允许配置传递重试、失败和超时处理。有关详细信息,请参阅指定传递协议执行设置。
定义传递协议
- 如果通过 XML 定义应用程序,则在Protocol Element (ADF) 中定义各个传递协议。
- 如果以编程方式定义应用程序,则在 NotificationClassProtocol 对象中定义各个传递协议,使用 NotificationClassProtocols 属性将它们添加到 NotificationClass 对象中的 NotificationClassProtocolCollection 对象。
传递协议名称
每个传递协议有一个预定义的名称。标准传递协议的名称为 SMTP 和 File。自定义传递协议的名称记录在实例配置中。在通知类中提供的名称必须与为传递协议指定的名称相匹配。
定义协议名称
- 如果通过 XML 定义应用程序,则在 ProtocolName Element (ADF) 中定义协议名称。
- 如果以编程方式定义应用程序,则使用 NotificationClassProtocol 对象 (NMO) 的 Name 属性。
协议字段
某些传递协议需要配置数据。例如,使用 SMTP 发送的邮件必须提供 Subject、From 和 To 数据。在定义通知类传递协议时,定义配置数据的字段名称和字段值。
- 字段名称只是配置字段的名称。例如,如果协议需要 Subject 值,则字段名称为 Subject。
- 字段值或者是包含必需值的通知字段的名称,或者是计算值的 Transact-SQL 表达式。您可以使用任何可作为 SELECT 语句的一部分求值的 Transact-SQL 表达式。与所有 Transact-SQL 字符串一样,用单引号将字符串括起来。如果字符串为 Unicode,请在第一个引号前加 N,例如,N'myString'。
例如,如果需要提供 Subject、From 和 To 字段,可定义以下传递协议字段:
字段名称 | Transact-SQL 表达式 | 通知字段 |
---|---|---|
Subject |
|
Headline |
From |
'someone@example.com' |
|
To |
DeviceAddress |
|
Subject 是名称为 Headline 的通知字段的值。From 值是一个 Transact-SQL 表达式,是用单引号括起来的字符串常量。To 值是对包含订阅方的电子邮件地址的内置字段的引用。
![]() |
---|
如果在 XML 文件中定义应用程序,必须用实体引用替换保留的 XML 字符,例如 '<'。有关详细信息,请参阅 XML Reserved Characters。 |
分发服务器将通知数据传递到传递协议时,它包括所有已定义的协议字段的值。
定义协议字段
- 如果通过 XML 定义应用程序,则在Field Element for Protocol/Fields (ADF) 中定义各个协议头字段。
- 如果以编程方式定义应用程序,则在 ProtocolField 对象中定义各个头字段,使用 ProtocolFields 属性将它们添加到 NotificationClassProtocol 对象中的 ProtocolFieldCollection 对象。
请参阅
概念
其他资源
配置传递协议
定义通知类
定义 Notification Services 应用程序