Spécification du nom et des champs du protocole de remise
Chaque classe de notification peut utiliser un ou plusieurs protocoles pour la remise des notifications. Dans la définition d'application, vous devez configurer chaque protocole de remise pris en charge par une classe de notification. Notification Services utilise ces informations pour déterminer les protocoles de remise qui sont valides pour un ensemble de notification. Cette rubrique explique comment définir les protocoles de remise.
Définition d'un protocole de remise
Lorsque vous définissez un protocole de remise, vous devez fournir son nom. Si le protocole de remise nécessite des informations supplémentaires, vous définissez également les champs qui fournissent ces informations.
En outre, Notification Services prend en charge plusieurs paramètres d'exécution pour les protocoles de remise, qui vous permettent de configurer la gestion des tentatives de remise, des échecs et des délais d'attente. Pour plus d'informations, consultez Spécification des paramètres d'exécution d'un protocole de remise.
Pour définir un protocole de remise
- Si vous définissez une application par le biais de XML, définissez les protocoles de remise individuels dans l'Protocol Element (ADF).
- Si vous définissez une application par programme, définissez les protocoles de remise individuels dans les objets NotificationClassProtocol et ajoutez-les à un objet NotificationClassProtocolCollection d'un objet NotificationClass à l'aide de la propriété NotificationClassProtocols.
Nom du protocole de remise
Chaque protocole de remise porte un nom prédéfini. Les protocoles de remise standard sont SMTP et File. Les noms des protocoles de remise personnalisés sont documentés dans la configuration d'instance. Le nom que vous entrez dans la classe de notification doit correspondre au nom donné au protocole de remise.
Pour définir le nom du protocole
- Si vous définissez une application par le biais de XML, définissez le nom du protocole dans l'ProtocolName Element (ADF).
- Si vous définissez une application par programme, utilisez la propriété Name de l'objet NotificationClassProtocol (NMO).
Champs du protocole
Certains protocoles de remise requièrent des données de configuration. Par exemple, un message envoyé à l'aide de SMTP doit fournir les données Subject, From et To. Vous définissez les noms et les valeurs de champ des données de configuration lorsque vous définissez des protocoles de remise pour une classe de notification.
- Le nom du champ est simplement le nom du champ de configuration. Par exemple, si le protocole nécessite une valeur Subject, Subject est le nom de champ.
- La valeur de champ est le nom ou un champ de notification qui contient la valeur requise, ou une expression Transact-SQL qui calcule la valeur. Vous pouvez utiliser toute expression Transact-SQL qui peut être évaluée dans une instruction SELECT. Comme toutes les chaînes Transact-SQL, placez une chaîne entre des guillemets simples. Si la chaîne est Unicode, ajoutez un N avant le premier guillemet, par exemple N'maChaine'.
Par exemple, si vous devez fournir les champs Subject, From et To, vous pouvez définir les champs suivants pour le protocole de remise :
Nom du champ | Expression Transact-SQL | Champ de notification |
---|---|---|
Subject |
|
Headline |
From |
'someone@example.com' |
|
To |
DeviceAddress |
|
Subject est la valeur d'un champ de notification nommé Headline. La valeur From est une expression Transact-SQL qui est une chaîne constante placée entre guillemets simples. La valeur To est une référence à un champ intégré qui contient l'adresse de messagerie de l'abonné.
Remarque : |
---|
Si vous définissez une application dans un fichier XML, vous devez remplacer les caractères XML réservés, tels que « < », par leurs références d'entité. Pour plus d'informations, consultez XML Reserved Characters. |
Lorsque le serveur de distribution transmet les données de notification au protocole de remise, il inclut les valeurs de tous les champs de protocole définis.
Pour définir les champs de protocole
- Si vous définissez une application par le biais de XML, définissez les champs d'en-tête de protocole individuels dans l'Field Element for Protocol/Fields (ADF).
- Si vous définissez une application par programme, définissez les champs d'en-tête individuels dans les objets ProtocolField et ajoutez-les à l'objet ProtocolFieldCollection d'un objet NotificationClassProtocol à l'aide de la propriété ProtocolFields.
Voir aussi
Concepts
Distribution des notifications
Spécification des paramètres d'exécution d'un protocole de remise
Autres ressources
Configuration des protocoles de remise
Définition des classes de notification
Définition des applications Notification Services