API di gestione delle sottoscrizioni

Articolo
12/15/2008

Quando si crea un'interfaccia di gestione delle sottoscrizioni vengono gestiti tre tipi di oggetti: sottoscrittori, dispositivi del sottoscrittore e sottoscrizioni. L'applicazione personalizzata utilizza l'API di gestione delle sottoscrizioni Notification Services per creare, modificare ed eliminare questi oggetti. Internamente, l'API memorizza e modifica le informazioni sul sottoscrittore e sulle sottoscrizioni nei database dell'istanza e dell'applicazione.

Notification Services include inoltre viste nel database dell'istanza e dell'applicazione che è possibile utilizzare per aggiungere un sottoscrittore, un dispositivo del sottoscrittore e sottoscrizioni standard direttamente ai database. Queste viste sono pensate essenzialmente per lo sviluppo e la verifica delle applicazioni.

Importante:
Utilizzare sempre l'API o le viste per gestire i dati relativi al sottoscrittore, al dispositivo del sottoscrittore e alle sottoscrizioni. Evitare di modificare direttamente le tabelle sottostanti.

API di gestione delle sottoscrizioni

Nella figura riportata di seguito è illustrato come utilizzare gli oggetti di gestione delle sottoscrizioni in un'interfaccia di gestione delle sottoscrizioni per comunicare con Notification Services.

Architettura della gestione delle sottoscrizioni

L'oggetto Subscriber rappresenta un sottoscrittore singolo. Un sottoscrittore è un soggetto o processo identificato da un ID sottoscrittore. I dati del sottoscrittore sono memorizzati nel database dell'istanza in modo che i sottoscrittori possano essere condivisi tra le applicazioni.
L'oggetto SubscriberDevice rappresenta un dispositivo del sottoscrittore singolo per un sottoscrittore. Un dispositivo del sottoscrittore è un endpoint di recapito della notifica, ad esempio un indirizzo di posta elettronica.
Ogni sottoscrittore deve includere almeno un dispositivo del sottoscrittore. I dati del dispositivo del sottoscrittore, come i dati del sottoscrittore, sono memorizzati nel database dell'istanza.
Ogni dispositivo del sottoscrittore dispone di un nome e di un indirizzo ed è associato a un canale di recapito. Il canale di recapito rappresenta un servizio di recapito specifico utilizzato per il recapito delle notifiche al dispositivo, ad esempio un gateway Mail Transfer Protocol (SMTP) specifico. I canali di recapito vengono configurati quando si configura un'istanza di Notification Services.
Un oggetto Subscription rappresenta una singola sottoscrizione per un sottoscrittore. Le sottoscrizioni definiscono quali notifiche il sottoscrittore desidera ricevere. Le sottoscrizioni sono relative a una classe di sottoscrizione specifica e possono essere basate su eventi o pianificate. Le sottoscrizioni definiscono i valori per i campi della classe di sottoscrizione.
Se la classe di sottoscrizione utilizza azioni condizionali, una sottoscrizione può inoltre specificare una condizione utilizzata per determinare se per la sottoscrizione dovrebbe essere generata una notifica. È necessario che l'applicazione utilizzi le classi nello spazio dei nomi Microsoft.SqlServer.NotificationServices.Rules per supportare lo sviluppo delle condizioni.
I dati della sottoscrizione vengono memorizzati nel database dell'applicazione.

Classi di gestione delle sottoscrizioni

Le classi seguenti nello spazio dei nomi Microsoft.SqlServer.NotificationServices sono utilizzate per sviluppare le interfacce di gestione delle sottoscrizioni.

Classe	Descrizione
Subscriber	Rappresenta un singolo sottoscrittore in una determinata istanza di Notification Services.
SubscriberEnumeration	Rappresenta l'insieme dei sottoscrittori in una determinata istanza di Notification Services.
SubscriberDevice	Rappresenta un dispositivo che può ricevere notifiche.
SubscriberDeviceEnumeration	Rappresenta un insieme di dispositivi del sottoscrittore.
Subscription	Rappresenta una sottoscrizione singola.
SubscriptionEnumeration	Rappresenta un insieme di sottoscrizioni.
SubscriberLocale	Rappresenta un'area geografica per la quale verrà formattata una notifica.
SubscriberLocaleEnumeration	Rappresenta l'insieme delle impostazioni internazionali dei sottoscrittori in una determinata istanza di Notification Services.
TimeZone	Rappresenta un fuso orario valido, utilizzato per le sottoscrizioni pianificate.
TimeZoneEnumeration	Rappresenta l'insieme dei fusi orari disponibili in una determinata istanza di Notification Services.
SubscriptionClass	Rappresenta una classe di sottoscrizione, come specificato per una determinata applicazione.
SubscriptionClassEnumeration	Rappresenta l'insieme delle classi di sottoscrizione in una determinata applicazione Notification Services.
NSApplication	Rappresenta un'applicazione Notification Services.
NSInstance	Rappresenta un'istanza di Notification Services.
NSException	Rappresenta le eccezioni generate quando si verifica un errore dell'applicazione Notification Services.

Classi condizionali di sottoscrizione

Se una classe di sottoscrizione include regole che utilizzano azioni condizionali, le classi nello spazio dei nomi Microsoft.SqlServer.NotificationServices.Rules verranno utilizzate per consentire agli utenti di definire le condizioni.

Classe	Descrizione
AndCondition	Definisce un set di condizioni da valutare utilizzando la logica booleana AND.
BetweenLeafCondition	Restituisce true se il l'argomento di test è compreso tra un valore minimo e massimo, inclusi.
BooleanLeafCondition	Restituisce true se il relativo argomento valutato a livello Booleano è true.
ConstantValue	Rappresenta un argomento con un valore predeterminato.
ExpressionOperator	Operatori di espressione.
ExpressionValue	Rappresenta un argomento il cui valore è determinato tramite valutazione di una semplice espressione matematica.
FieldValue	Rappresenta un argomento condizionale che ottiene il proprio valore da un campo di input.
FilterAction	Operazioni filtro.
FilterRule	Definisce un filtro su una tabella di input o vista in base ai risultati della valutazione della condizione. Una regola di filtro è composta da una o più istruzioni per il filtro.
FilterStatement	Descrive un'istruzione logica nel formato "IF condizione THEN operazione."
FunctionValue	Rappresenta un argomento che ottiene il valore da una funzione definita dall'utente Transact-SQL.
IsNullLeafCondition	Restituisce true se l'argomento è NULL.
LinkLeafCondition	Valuta le operazioni rispetto ai risultati di una regola filtro correlata.
LinkLeafOperator	Operatori LinkLeafConditions.
NotCondition	Nega il risultato di un'altra condizione.
OrCondition	Definisce un set di condizioni da valutare logicamente utilizzando la logica booleana OR.
PropertyRule	Definisce la logica che restituisce un valore scalare per qualsiasi riga in una tabella di input o vista. Una regola di proprietà è composta da una o più istruzioni per la proprietà.
PropertyStatement	Descrive un'istruzione logica nel formato "IF condizione THEN risultato", dove il risultato è un valore scalare.
RulesException	Rappresenta l'eccezione generata da un oggetto nello spazio dei nomi.
RuleValue	Rappresenta un argomento che ottiene il proprio valore dalla valutazione di altre regole.
SimpleLeafCondition	Confronta due argomenti utilizzando gli operatori relazionali e restituisce un risultato booleano.
SimpleOperator	Operatori per SimpleLeafConditions.
TableInputType	Descrive una tabella utilizzabile come input per una regola.
ViewInputType	Descrive una vista utilizzabile come input per una regola.

Classi di amministrazione di sottoscrizioni

Le classi precedenti sono pensate per la gestione dei dati relativi ai dati del sottoscrittore, del dispositivo del sottoscrittore e delle sottoscrizioni. Se si sta creando un'applicazione per la gestione o l'amministrazione di istanze di Notification Services, utilizzare le classi seguenti nello spazio dei nomi Microsoft.SqlServer.Management.Nmo per attivare e disattivare i sottoscrittori e le sottoscrizioni.

Classe	Descrizione
Instance	Specifica metodi per attivare e disattivare la gestione dei sottoscrittori.
Application	Specifica metodi per attivare e disattivare la gestione delle sottoscrizioni.

Viste di gestione delle sottoscrizioni

Notification Services indica le viste per la gestione dei dati del sottoscrittore essenzialmente per il test delle applicazioni. Per ulteriori informazioni, vedere gli argomenti seguenti:

Vedere anche

API di gestione delle sottoscrizioni

API di gestione delle sottoscrizioni

Classi di gestione delle sottoscrizioni

Classi condizionali di sottoscrizione

Classi di amministrazione di sottoscrizioni

Viste di gestione delle sottoscrizioni

Vedere anche

Concetti

Altre risorse

Guida in linea e informazioni

Risorse aggiuntive