API de gestion d'abonnement
Lorsque vous créez une interface de gestion d'abonnement, vous gérez trois types d'objets : les abonnés, les périphériques d'abonnés et les abonnements. Votre application personnalisée utilise l'API de gestion d'abonnement Notification Services pour créer, modifier et supprimer ces objets. L'API stocke et manipule en interne les informations d'abonné et d'abonnement dans les bases de données d'instance et d'application.
Notification Services fournit également dans les bases de données d'instance et d'application des vues utilisables pour ajouter directement l'abonné de base, le périphérique d'abonné et les abonnements aux bases de données. Ces vues sont principalement destinées au développement et au test d'applications.
Important : |
---|
Utilisez toujours l'API ou les vues pour gérer les données d'abonné, de périphérique d'abonné et d'abonnement ; ne manipulez jamais directement les tables sous-jacentes. |
API de gestion d'abonnement
L'illustration ci-dessous montre comment des objets de gestion d'abonnement sont utilisés par une interface de gestion d'abonnement pour communiquer avec Notification Services.
- L'objet Subscriber représente un abonné unique. Un abonné est une personne ou un processus identifié par un ID d'abonné. Les données d'abonné sont stockées dans la base de données d'instance afin que des abonnés puissent être partagés entre des applications.
- L'objet SubscriberDevice représente un périphérique d'abonné unique pour un abonné. Un périphérique d'abonné est un point de terminaison pour la remise des notifications, tel qu'une adresse de messagerie.
Chaque abonné doit disposer au moins d'un périphérique d'abonné. Les données de périphérique d'abonné, à l'instar des données d'abonné, sont stockées dans la base de données d'instance.
Chaque périphérique d'abonné a un nom et une adresse et il est associé à un canal de remise. Le canal de remise représente un service de remise spécifique utilisé pour remettre des notifications au périphérique, tel qu'une passerelle SMTP (Simple Mail Transfer Protocol) particulière. Vous configurez les canaux de remise lorsque vous configurez une instance de Notification Services. - Un objet Subscription représente un abonnement unique pour un abonné. Les abonnements définissent les notifications que l'abonné souhaite recevoir. Les abonnements concernent une classe d'abonnement spécifique et ils peuvent être gérés par événements ou planifiés. Les abonnements définissent des valeurs pour les champs de classe d'abonnement.
Si la classe d'abonnement utilise des actions de condition, un abonnement peut également spécifier une condition utilisée pour déterminer si une notification doit être générée pour l'abonnement. Votre application doit utiliser des classes de l'espace de noms Microsoft.SqlServer.NotificationServices.Rules pour pouvoir prendre en charge le développement de conditions.
Les données d'abonnement sont stockées dans la base de données d'application.
Classes de gestion d'abonnement
Les classes suivantes de l'espace de noms Microsoft.SqlServer.NotificationServices sont utilisées pour développer des interfaces de gestion d'abonnement.
Classe | Description |
---|---|
Subscriber |
Représente un abonné individuel dans une instance Notification Services donnée. |
Représente la collection d'abonnés dans une instance Notification Services donnée. |
|
SubscriberDevice |
Représente un périphérique pouvant recevoir des notifications. |
Représente une collection de périphériques d'abonnés. |
|
Subscription |
Représente un abonnement unique. |
Représente une collection d'abonnements. |
|
Représente une région géographique pour laquelle une notification est formatée. |
|
Représente la collection de paramètres régionaux d'abonnés disponible dans une instance Notification Services donnée. |
|
Représente un fuseau horaire valide, utilisé pour les abonnements planifiés. |
|
Représente la collection de fuseaux horaires disponible dans une instance Notification Services donnée. |
|
Représente une classe d'abonnement telle que spécifiée pour une application donnée. |
|
Représente la collection de classes d'abonnement dans une application Notification Services donnée. |
|
Représente une application Notification Services. |
|
Représente une instance de Notification Services. |
|
Représente les exceptions levées lorsqu'une erreur d'application Notification Services se produit. |
Classes de condition d'abonnement
Si une classe d'abonnement contient des règles qui utilisent des actions de condition, vous utiliserez des classes de l'espace de noms Microsoft.SqlServer.NotificationServices.Rules afin de permettre aux utilisateurs de définir des conditions.
Classe | Description |
---|---|
Définit un ensemble de conditions à évaluer à l'aide de la logique booléenne AND. |
|
Prend la valeur true si l'argument de test est compris entre une valeur minimale et maximale incluse. |
|
Prend la valeur true si son argument booléen est vrai. |
|
Représente un argument avec une valeur prédéterminée. |
|
Opérateurs d'expressions. |
|
Représente un argument dont la valeur est déterminée par l'évaluation d'une expression arithmétique simple. |
|
Représente un argument de condition qui récupère sa valeur d'un champ d'entrée. |
|
Actions de filtre. |
|
Définit un filtre au-dessus d'une table d'entrée ou d'une vue en fonction des résultats d'évaluation de condition. Une règle de filtre se compose d'une ou de plusieurs instructions de filtre. |
|
Décrit une instruction logique sous la forme « IF Condition THEN Action ». |
|
Représente un argument qui récupère sa valeur d'une fonction définie par l'utilisateur Transact-SQL. |
|
Prend la valeur true si son argument a la valeur NULL. |
|
Évalue les opérations par rapport aux résultats d'une règle de filtre associée. |
|
Opérateurs pour des conditions de feuille de liens. |
|
Inverse le résultat d'une autre condition. |
|
Définit un ensemble de conditions à évaluer à l'aide de la logique booléenne OR. |
|
Définit la logique qui prend une valeur scalaire pour n'importe quelle ligne d'une table d'entrée ou d'une vue. Une règle de propriété se compose d'une ou plusieurs instructions de propriété. |
|
Décrit une instruction logique sous la forme « IF Condition THEN Result », dans laquelle le résultat est une valeur scalaire. |
|
Représente l'exception levée par un objet de cet espace de noms. |
|
Représente un argument qui récupère sa valeur de l'évaluation d'autres règles. |
|
Compare deux arguments en utilisant des opérateurs relationnels et retourne un résultat booléen. |
|
Opérateurs pour des conditions de feuille simples. |
|
Décrit une table pouvant être utilisée comme une entrée à une règle. |
|
Décrit une vue pouvant être utilisée comme une entrée à une règle. |
Classes d'administration d'abonnement
Les classes ci-dessus sont destinées à la gestion des données d'abonné, de périphérique d'abonné et d'abonnement. Si vous créez une application pour administrer ou gérer des instances de Notification Services, utilisez les classes suivantes de l'espace de noms Microsoft.SqlServer.Management.Nmo pour activer et désactiver des abonnés et des abonnements.
Classe | Description |
---|---|
Fournit des méthodes pour activer et désactiver la gestion d'abonné. |
|
Fournit des méthodes pour activer et désactiver la gestion d'abonnement. |
Vues de gestion d'abonnement
Notification Services expose des vues pour gérer des données d'abonné, principalement pour le test d'applications. Pour plus d'informations, consultez les rubriques suivantes :
Voir aussi
Concepts
Démarrage d'un projet de gestion d'abonnement
Autres ressources
Développement d'interfaces de gestion d'abonnement
Gestion des abonnés
Gestion des périphériques d'abonné
Gestion des données d'abonnement