Protocols 要素 (ADF)

  • [アーティクル]

通知クラスが通知を配信するために使用する 1 つ以上の配信プロトコルを定義する要素が含まれます。

構文

<NotificationClasses>
    <NotificationClass>
        ...
        <Protocols>

要素の特性

特性 説明

データ型と長さ

なし。

既定値

なし。

個数

NotificationClass 要素につき 1 個 (省略可)。

更新

アプリケーションの更新時に追加および削除できます。

要素の関係

関係 要素

親要素

NotificationClass 要素 (ADF)

子要素

Protocol 要素 (ADF)

解説

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>&quot;html&quot;</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>

参照

関連項目

アプリケーション定義ファイルのリファレンス

その他の技術情報

配信プロトコルの構成
インスタンスとアプリケーションの更新

ヘルプおよび情報

SQL Server 2005 の参考資料の入手