Protocols 要素 (ADF)
通知クラスが通知を配信するために使用する 1 つ以上の配信プロトコルを定義する要素が含まれます。
構文
<NotificationClasses>
<NotificationClass>
...
<Protocols>
要素の特性
特性 | 説明 |
---|---|
データ型と長さ |
なし。 |
既定値 |
なし。 |
個数 |
NotificationClass 要素につき 1 個 (省略可)。 |
更新 |
アプリケーションの更新時に追加および削除できます。 |
要素の関係
関係 | 要素 |
---|---|
親要素 |
|
子要素 |
解説
Protocols 要素の子要素は、通知クラスが使用する 1 つ以上の配信プロトコルを定義します。各通知クラスには、通知の配信に使用する配信プロトコルが少なくとも 1 つ必要です。
Protocols 要素を追加または削除した後、アプリケーションを更新すると、対応する通知クラスがいったん削除され、再作成されます。同時に、この通知クラスが使用していた SQL Server テーブルも削除され、再作成されます。元の SQL Server テーブルに存在していたすべてのデータは、完全に削除されます。
使用例
次の例は、通知クラスの 2 つの配信プロトコルの定義方法を示しています。1 つは組み込みの SMTP で、もう 1 つはカスタム HTTPLogger です。
<Protocols>
<Protocol>
<ProtocolName>SMTP</ProtocolName>
<Fields>
<Field>
<FieldName>Subject</FieldName>
<SqlExpression>%SubjectLine%</SqlExpression>
</Field>
<Field>
<FieldName>From</FieldName>
<SqlExpression>%fromAddress%</SqlExpression>
</Field>
<Field>
<FieldName>To</FieldName>
<FieldReference>DeviceAddress</FieldReference>
</Field>
<Field>
<FieldName>Priority</FieldName>
<SqlExpression>%mailPriority%</SqlExpression>
</Field>
<Field>
<FieldName>BodyFormat</FieldName>
<SqlExpression>"html"</SqlExpression>
</Field>
</Fields>
<ProtocolExecutionSettings>
<RetrySchedule>
<RetryDelay>P0DT00H15M00S</RetryDelay>
<RetryDelay>P0DT00H30M00S</RetryDelay>
<RetryDelay>P0DT01H00M00S</RetryDelay>
</RetrySchedule>
</ProtocolExecutionSettings>
</Protocol>
<Protocol>
<ProtocolName>HttpLogger</ProtocolName>
<Fields>
<Field>
<FieldName>escaping</FieldName>
<SqlExpression>'yes'</SqlExpression>
</Field>
<Field>
<FieldName>Subject</FieldName>
<SqlExpression>
'Stock notification: '
+CONVERT (NVARCHAR(30), GETDATE())
</SqlExpression>
</Field>
<Field>
<FieldName>SubscriberId</FieldName>
<SqlExpression>DeviceAddress</SqlExpression>
</Field>
</Fields>
</Protocol>
</Protocols>