Protocol Element (ADF)

  • Article

Contains elements that define a delivery protocol used by the notification class to deliver notifications.

Syntaxe

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

Element Characteristics

Characteristic Description

Data type

None.

Default value

None.

Occurrence

Required once or more per Protocols element.

Updates

Can be added and deleted when updating the application.

Element Relationships

Relationship Elements

Parent element

Protocols Element (ADF)

Child elements

ProtocolName Element (ADF)

Fields Element for Protocol (ADF)

ProtocolExecutionSettings Element (ADF)

Notes

The child elements of the Protocol element define a delivery protocol used by the notification class. Each notification class must define at least one delivery protocol to deliver notifications.

The delivery protocol must be associated with a delivery channel in the instance configuration file (ICF). For more information see Définition des canaux de remise.

Exemple

The following example shows how to define an SMTP delivery protocol, and provides values for the fields required to create an SMTP message. (Values surrounded by percent characters (%) are parameters defined either in the ParameterDefaults element or when creating the instance of Notification Services.)

If the initial delivery attempt is unsuccessful, notifications sent using this protocol attempt redelivery 15 minutes after the initial attempt, 30 minutes later, and then one hour later.

<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>

Voir aussi

Référence

Application Definition File Reference

Autres ressources

Spécification du nom et des champs du protocole de remise
Mise à jour des instances et des applications

Aide et Informations

Assistance sur SQL Server 2005