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.

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.

• 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.
SubscriberEnumeration	Stellt die Auflistung von Abonnenten in einer bestimmten Notification Services-Instanz dar.
SubscriberDevice	Stellt ein Gerät dar, das Benachrichtigungen empfangen kann.
SubscriberDeviceEnumeration	Stellt eine Auflistung von Abonnentengeräten dar.
Subscription	Stellt ein einzelnes Abonnement dar.
SubscriptionEnumeration	Stellt eine Auflistung der Abonnements dar.
SubscriberLocale	Stellt einen geographischen Bereich dar, für den eine Benachrichtigung formatiert wird.
SubscriberLocaleEnumeration	Stellt die Auflistung der verfügbaren Abonnentengebietsschemas in einer bestimmten Notification Services-Instanz dar.
TimeZone	Stellt eine gültige Zeitzone dar, die für geplante Abonnements verwendet wird.
TimeZoneEnumeration	Stellt die Auflistung der verfügbaren Zeitzonen in einer bestimmten Notification Services-Instanz dar.
SubscriptionClass	Stellt eine für eine bestimmte Anwendung angegebene Abonnementklasse dar.
SubscriptionClassEnumeration	Stellt die Auflistung von Abonnementklassen in einer bestimmten Notification Services-Anwendung dar.
NSApplication	Stellt eine Notification Services-Anwendung dar.
NSInstance	Stellt eine Notification Services-Instanz dar.
NSException	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
AndCondition	Definiert eine Gruppe von Bedingungen, die mithilfe boolescher AND-Logik ausgewertet werden sollen.
BetweenLeafCondition	Ergibt true, wenn das Testargument zwischen einem minimalen und einem maximalen Wert liegt (inklusiv).
BooleanLeafCondition	Ergibt true, wenn das Argument vom Typ Boolean true ergibt.
ConstantValue	Stellt ein Argument mit einem vordefinierten Wert dar.
ExpressionOperator	Ausdrucksoperatoren
ExpressionValue	Stellt ein Argument dar, dessen Wert durch die Auswertung eines einfachen arithmetischen Ausdrucks ermittelt wird.
FieldValue	Stellt ein Bedingungsargument dar, das seinen Wert aus einem Eingabefeld abruft.
FilterAction	Filteraktionen
FilterRule	Definiert einen Filter für eine Eingabetabelle oder Sicht, die auf den Ergebnissen der Bedingungsauswertung basiert. Eine Filterregel besteht aus mindestens einer Filteranweisung.
FilterStatement	Beschreibt eine logische Anweisung im Format "IF Condition THEN Action".
FunctionValue	Stellt ein Argument dar, das seinen Wert aus einer benutzerdefinierten Transact-SQL-Funktion abruft.
IsNullLeafCondition	Ergibt true, wenn sein Argument NULL ist.
LinkLeafCondition	Wertet Operationen gegen die Ergebnisse einer verwandten Filterregel aus.
LinkLeafOperator	Operatoren für Verknüpfungsblattbedingungen.
NotCondition	Negiert das Ergebnis einer anderen Bedingung.
OrCondition	Definiert eine Gruppe von Bedingungen, die mithilfe boolescher OR-Logik ausgewertet werden sollen.
PropertyRule	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.
PropertyStatement	Beschreibt eine logische Anweisung im Format "IF Condition THEN Result", deren Ergebnis ein skalarer Wert ist.
RulesException	Stellt die Ausnahme dar, die von einem Objekt in diesem Namespace ausgelöst wird.
RuleValue	Stellt ein Argument dar, das seinen Wert aus der Auswertung anderer Regeln abruft.
SimpleLeafCondition	Vergleicht zwei Argumente mithilfe von relationalen Operatoren und gibt ein boolesches Ergebnis zurück.
SimpleOperator	Operatoren für einfache Blattbedingungen.
TableInputType	Beschreibt eine Tabelle, die als Eingabe für eine Regel verwendet werden kann.
ViewInputType	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
Instance	Stellt Methoden zum Aktivieren und Deaktivieren der Abonnentenverwaltung bereit.
Application	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:

• NSSubscriberView
• NSSubscriberDeviceView
• NS<SubscriptionClassName>View

Siehe auch

Konzepte

Starten eines Abonnementverwaltungsprojekts

Andere Ressourcen

Entwickeln von Abonnementverwaltungsschnittstellen
Verwalten von Abonnenten
Verwalten von Abonnentengeräten
Verwalten von Abonnementdaten

Hilfe und Informationen

Informationsquellen für SQL Server 2005