Protocole de remise SMTP

Mis à jour : 14 avril 2006

Le protocole de remise SMTP (Simple Mail Transfer Protocol) crée et achemine des messages de notification à remettre par un service SMTP, comme celui qui est fourni par les services Microsoft Exchange ou les services Internet (IIS). Si vous souhaitez utiliser ce protocole pour remettre les notifications à partir d'une classe de notification particulière, vous devez le définir comme faisant partie de cette classe de notification dans la définition de l'application.

Important :
Le service SMTP est requis pour utiliser le protocole de remise SMTP, mais il n'est pas installé avec Windows Vista. Pour utiliser le protocole de remise SMTP dans Windows Vista, vous devez installer séparément un service SMTP.

Définition d'un protocole de remise SMTP

La définition d'un protocole se compose d'un nom et de valeurs pour tous les champs personnalisés. Le protocole de remise SMTP utilise les valeurs et les champs suivants :

• La valeur ProtocolName doit être SMTP (obligatoire).
• Définissez les champs suivants, dans l'ordre ci-dessous, pour le protocole de remise :
  • Subject(obligatoire) spécifie l'expression qui représente la ligne d'objet à afficher dans le message électronique.
  • From (obligatoire) spécifie l'adresse de messagerie d'envoi à afficher dans le message électronique.
  • To (obligatoire) doit spécifier l'adresse du périphérique cible. Ce champ doit être vide pour une classe de notification qui fournit des notifications de multidiffusion.
  • Priority(facultatif) spécifie la priorité du message électronique. Pour Microsoft Exchange, les valeurs disponibles sont Basse, Normale ou Haute. La priorité de notification par défaut est Normale si aucune autre valeur n'est spécifiée.
  • BodyFormat(facultatif) prend la valeur « text » ou « html », selon le format prévu pour les données de notification fournies par le module de formatage de contenu. La valeur par défaut du format de notification est text, si aucune valeur n'est spécifiée.

Dans la syntaxe Transact-SQL, les constantes de chaîne doivent être placées entre guillemets. Si vous utilisez une chaîne dans un champ de protocole de remise, vous devez par conséquent l'entourer de guillemets simples, comme par exemple 'maChaîne'. Si la chaîne est au format Unicode, vous devez également la faire précéder d'un N, par exemple N'maChaîne'.

Exemple de définition de protocole de remise SMTP

L'exemple suivant montre comment définir un protocole de remise SMTP pour une classe de notification :

<Protocols>
    <Protocol>
        <ProtocolName>SMTP</ProtocolName>
        <Fields>
            <Field>
                <FieldName>Subject</FieldName>
                <SqlExpression>
                'The price of ' + StockSymbol
                + ' is now ' + StockPrice
                </SqlExpression>
            </Field>
            <Field>
                <FieldName>From</FieldName>
                <SqlExpression>
                N'stockquotes@microsoft.com'
                </SqlExpression>
            </Field>
            <Field>
                <FieldName>To</FieldName>
                <SqlExpression>DeviceAddress</SqlExpression>
            </Field>
            <Field>
                <FieldName>Priority</FieldName>
                <SqlExpression>N'Normal'</SqlExpression>
            </Field>
            <Field>
                <FieldName>BodyFormat</FieldName>
                <SqlExpression>N'html'</SqlExpression>
            </Field>
            <Field>
        </Fields>
        <ProtocolExecutionSettings>
            ...
        </ProtocolExecutionSettings>
    </Protocol>
</Protocols>

Dans cet exemple, toutes les valeurs de champs sont représentées sous la forme d'expressions Transact-SQL  :

• Le champ Subject se compose de chaînes et de références de champ de notification (StockSymbol et StockPrice) pour personnaliser la ligne d'objet de chaque notification.
• La valeur du champ To tire son origine du champ DeviceAddress pour le périphérique de l'abonné. Pour obtenir la liste des champs disponibles, consultez SqlExpression Element for Protocol/Fields/Field (ADF).
• Les champs From, Priority et BodyFormat se composent de chaînes qui sont les mêmes pour toutes les notifications envoyées via le protocole de remise.

La valeur des champs peut également provenir directement des champs de notification. Pour plus d'informations, consultez FieldReference Element (ADF).

Définition d'un canal de remise pour le protocole de remise SMTP

Pour utiliser le protocole de remise SMTP dans la distribution des notifications, vous devez également définir un canal de remise qui utilise le protocole de remise SMTP. Plusieurs classes de notification à partir de plusieurs applications peuvent utiliser le même canal de remise SMTP.

Important :
En raison de l'implémentation SMTP utilisée par Microsoft .NET Framework, vous ne pouvez définir qu'un seul canal de remise qui utilise le protocole de remise SMTP par instance. Si vous en définissez deux, les notifications risquent d'arriver sur le serveur SMTP incorrect.

Pour plus d'informations, consultez Définition d'un canal de remise SMTP.

Voir aussi

Concepts

protocole de remise File
Developpement d'un protocole de remise personnalisé

Autres ressources

Configuration des protocoles de remise
Définition des classes de notification
Protocol Element (ADF)

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications

Version	Historique
14 avril 2006	Nouveau contenu : Ajout d'une remarque spécifiant que le service SMTP n'est pas installé avec Windows Vista. Ajout de la description d'un exemple de code.