Abonnementverwaltungs-API
Wenn Sie eine Abonnementverwaltungsschnittstelle erstellen, verwalten Sie drei Typen von Objekten: Abonnenten, Abonnentengeräte und Abonnements. Die Abonnementverwaltungs-API von Notification Services wird von der benutzerdefinierten Anwendung verwendet, um diese Objekte zu erstellen, zu ändern und zu löschen. Abonnenten- und Abonnementinformationen werden von der API intern in den Instanz- und Anwendungsdatenbanken gespeichert und geändert.
Von Notification Services werden zudem Sichten in der Instanz- und Anwendungsdatenbank bereitgestellt, die Sie verwenden können, um grundlegende Informationen zu Abonnenten, Abonnentengeräten und Abonnements direkt den Datenbanken hinzuzufügen. Diese Sichten sind hauptsächlich für die Anwendungsentwicklung und für Tests vorgesehen.
.gif "ms166467.note(de-de,SQL.90).gif") Wichtig: |
|---|
| Verwenden Sie immer die API oder Sichten, um Daten zu Abonnenten, Abonnentengeräten und Abonnements zu verwalten. Bearbeiten Sie nie die zugrunde liegenden Tabellen. |
Abonnementverwaltungs-API
In der folgenden Abbildung wird gezeigt, wie Abonnementverwaltungsobjekte von einer Abonnementverwaltungsschnittstelle für die Kommunikation mit Notification Services verwendet werden.
.gif "Architektur der Abonnementverwaltung")
- Das Subscriber-Objekt stellt einen einzelnen Abonnenten dar. Ein Abonnent ist eine Person oder ein Prozess, die bzw. der durch eine Abonnenten-ID identifiziert wird. In der Instanzdatenbank werden Abonnentendaten gespeichert, sodass Abonnenten von mehreren Anwendungen gemeinsam verwendet werden können.
- Das SubscriberDevice-Objekt stellt ein einzelnes Abonnentengerät für einen Abonnenten dar. Ein Abonnentengerät ist ein Übermittlungsendpunkt für die Benachrichtigungsübermittlung, z. B. eine E-Mail-Adresse.
Jeder Abonnent muss mindestens ein Abonnentengerät besitzen. Abonnentengerätdaten werden wie Abonnentendaten in der Instanzdatenbank gespeichert.
Jedes Abonnentengerät besitzt einen Namen und eine Adresse und ist einem Übermittlungskanal zugeordnet. Der Übermittlungskanal stellt einen bestimmten Übermittlungsdienst dar, der zum Übermitteln von Benachrichtigungen an das Gerät, z. B. an ein bestimmtes SMTP-Gateway, verwendet wird. Übermittlungskanäle werden beim Konfigurieren einer Notification Services-Instanz konfiguriert. - Ein Subscription-Objekt stellt ein einzelnes Abonnement für einen Abonnenten dar. In Abonnements wird definiert, welche Benachrichtigungen der Abonnent empfangen möchte. Abonnements gelten für eine bestimmte Abonnementklasse und können für ereignisgesteuerte oder geplante Abonnements verwendet werden. In Abonnements sind Werte für Abonnementklassenfelder definiert.
Falls von der Abonnementklasse Bedingungsaktionen verwendet werden, kann von einem Abonnement außerdem eine Bedingung angegeben werden, mit der bestimmt wird, ob eine Benachrichtigung für das Abonnement generiert werden soll. Zur Unterstützung der Bedingungsentwicklung muss die Anwendung Klassen im Microsoft.SqlServer.NotificationServices.Rules-Namespace verwenden.
Abonnementdaten werden in der Anwendungsdatenbank gespeichert.
Abonnementverwaltungsklassen
Die folgenden Klassen im Microsoft.SqlServer.NotificationServices-Namespace werden zum Entwickeln von Abonnementverwaltungsschnittstellen verwendet.
| Klasse | Beschreibung |
|---|---|
Subscriber |
Stellt einen einzelnen Abonnenten in einer bestimmten Notification Services-Instanz dar. |
Stellt die Auflistung von Abonnenten in einer bestimmten Notification Services-Instanz dar. |
|
SubscriberDevice |
Stellt ein Gerät dar, das Benachrichtigungen empfangen kann. |
Stellt eine Auflistung von Abonnentengeräten dar. |
|
Subscription |
Stellt ein einzelnes Abonnement dar. |
Stellt eine Auflistung der Abonnements dar. |
|
Stellt einen geographischen Bereich dar, für den eine Benachrichtigung formatiert wird. |
|
Stellt die Auflistung der verfügbaren Abonnentengebietsschemas in einer bestimmten Notification Services-Instanz dar. |
|
Stellt eine gültige Zeitzone dar, die für geplante Abonnements verwendet wird. |
|
Stellt die Auflistung der verfügbaren Zeitzonen in einer bestimmten Notification Services-Instanz dar. |
|
Stellt eine für eine bestimmte Anwendung angegebene Abonnementklasse dar. |
|
Stellt die Auflistung von Abonnementklassen in einer bestimmten Notification Services-Anwendung dar. |
|
Stellt eine Notification Services-Anwendung dar. |
|
Stellt eine Notification Services-Instanz dar. |
|
Stellt Ausnahmen dar, die ausgelöst werden, wenn ein Notification Services-Anwendungsfehler auftritt. |
Abonnementbedingungsklassen
Falls eine Abonnementklasse Regeln enthält, in denen Bedingungsaktionen verwendet werden, verwenden Sie Klassen im Microsoft.SqlServer.NotificationServices.Rules-Namespace, um Benutzern das Definieren von Bedingungen zu ermöglichen.
| Klasse | Beschreibung |
|---|---|
Definiert eine Gruppe von Bedingungen, die mithilfe boolescher AND-Logik ausgewertet werden sollen. |
|
Ergibt true, wenn das Testargument zwischen einem minimalen und einem maximalen Wert liegt (inklusiv). |
|
Ergibt true, wenn das Argument vom Typ Boolean true ergibt. |
|
Stellt ein Argument mit einem vordefinierten Wert dar. |
|
Ausdrucksoperatoren |
|
Stellt ein Argument dar, dessen Wert durch die Auswertung eines einfachen arithmetischen Ausdrucks ermittelt wird. |
|
Stellt ein Bedingungsargument dar, das seinen Wert aus einem Eingabefeld abruft. |
|
Filteraktionen |
|
Definiert einen Filter für eine Eingabetabelle oder Sicht, die auf den Ergebnissen der Bedingungsauswertung basiert. Eine Filterregel besteht aus mindestens einer Filteranweisung. |
|
Beschreibt eine logische Anweisung im Format "IF Condition THEN Action". |
|
Stellt ein Argument dar, das seinen Wert aus einer benutzerdefinierten Transact-SQL-Funktion abruft. |
|
Ergibt true, wenn sein Argument NULL ist. |
|
Wertet Operationen gegen die Ergebnisse einer verwandten Filterregel aus. |
|
Operatoren für Verknüpfungsblattbedingungen. |
|
Negiert das Ergebnis einer anderen Bedingung. |
|
Definiert eine Gruppe von Bedingungen, die mithilfe boolescher OR-Logik ausgewertet werden sollen. |
|
Definiert eine Logik, die für alle Zeilen in einer Eingabetabelle oder Sicht zu einem skalaren Wert ausgewertet wird. Eine Eigenschaftsregel besteht aus mindestens einer Eigenschaftsanweisung. |
|
Beschreibt eine logische Anweisung im Format "IF Condition THEN Result", deren Ergebnis ein skalarer Wert ist. |
|
Stellt die Ausnahme dar, die von einem Objekt in diesem Namespace ausgelöst wird. |
|
Stellt ein Argument dar, das seinen Wert aus der Auswertung anderer Regeln abruft. |
|
Vergleicht zwei Argumente mithilfe von relationalen Operatoren und gibt ein boolesches Ergebnis zurück. |
|
Operatoren für einfache Blattbedingungen. |
|
Beschreibt eine Tabelle, die als Eingabe für eine Regel verwendet werden kann. |
|
Beschreibt eine Sicht, die als Eingabe für eine Regel verwendet werden kann. |
Abonnementverwaltungsklassen
Die oben aufgeführten Klassen werden zum Verwalten von Daten für Abonnenten, Abonnentengeräte und Abonnements verwendet. Wenn Sie eine Anwendung zum Verwalten von Notification Services-Instanzen erstellen, verwenden Sie die folgenden Klassen im Microsoft.SqlServer.Management.Nmo-Namespace, um Abonnenten und Abonnements zu aktivieren oder zu deaktivieren.
| Klasse | Beschreibung |
|---|---|
Stellt Methoden zum Aktivieren und Deaktivieren der Abonnentenverwaltung bereit. |
|
Stellt Methoden zum Aktivieren und Deaktivieren der Abonnementverwaltung bereit. |
Abonnementverwaltungssichten
Von Notification Services werden Sichten zum Verwalten von Abonnentendaten hauptsächlich zum Testen von Anwendungen bereitgestellt. Weitere Informationen finden Sie in den folgenden Hilfethemen:
Siehe auch
Konzepte
Starten eines Abonnementverwaltungsprojekts
Andere Ressourcen
Entwickeln von Abonnementverwaltungsschnittstellen
Verwalten von Abonnenten
Verwalten von Abonnentengeräten
Verwalten von Abonnementdaten