Condividi tramite


API di gestione delle sottoscrizioni

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.

ms166467.note(it-it,SQL.90).gifImportante:
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

Concetti

Avvio di un progetto di gestione delle sottoscrizioni

Altre risorse

Sviluppo di interfacce di gestione delle sottoscrizioni
Gestione dei sottoscrittori
Gestione dei dispositivi dei sottoscrittori
Gestione dei dati delle sottoscrizioni

Guida in linea e informazioni

Assistenza su SQL Server 2005