API de administración de suscripciones
Cuando se genera una interfaz de administración de suscripciones, se administran tres tipos de objetos: suscriptores, dispositivos de suscriptor y suscripciones. Su aplicación personalizada utiliza la API de administración de suscripciones de Notification Services para crear, modificar y eliminar estos objetos. Internamente, la API almacena y manipula información de suscriptor y suscripción en las bases de datos de instancia y aplicación.
Notification Services también proporciona vistas en la base de datos de instancia y aplicación que puede utilizar para agregar suscriptores, dispositivos de suscriptor y suscripciones básicos directamente a las bases de datos. Estas vistas están destinadas principalmente para desarrollar y probar aplicaciones.
.gif "ms166467.note(es-es,SQL.90).gif") Importante: |
|---|
| Utilice siempre la API o las vistas para administrar datos de suscriptor, dispositivo de suscriptor y suscripción; no manipule nunca directamente las tablas subyacentes. |
API de administración de suscripciones
En la ilustración siguiente se muestra el modo en que una interfaz de administración de suscripciones utiliza los objetos de administración de suscripciones para comunicarse con Notification Services.
.gif "Arquitectura de administración de suscripciones")
- El objeto Subscriber representa un suscriptor único. Un suscriptor es una persona o un proceso identificado por un Id. de suscriptor. Los datos de suscriptor se almacenan en la base de datos de instancia de manera que se pueden compartir suscriptores entre aplicaciones.
- El objeto SubscriberDevice representa un dispositivo de suscriptor único para un suscriptor. Un dispositivo de suscriptor es un extremo para la entrega de notificaciones, como, por ejemplo, una dirección de correo electrónico.
Cada suscriptor debe tener al menos un dispositivo de suscriptor. Los datos de dispositivo de suscriptor, igual que los datos de suscriptor, se almacenan en la base de datos de instancia.
Cada dispositivo de suscriptor tiene un nombre y una dirección, y se asocia con un canal de entrega. El canal de entrega representa un servicio de entrega específico utilizado para entregar notificaciones al dispositivo, como una puerta de enlace SMTP (Protocolo simple de transferencia de correo) determinada. Los canales de entrega se configuran al mismo tiempo que la instancia de Notification Services. - Un objeto Subscription representa una suscripción única para un suscriptor. Las suscripciones definen qué notificaciones desea recibir el suscriptor. Las suscripciones son de una clase de suscripción específica y pueden ser para suscripciones controladas por eventos o programadas. Las suscripciones definen valores de campos de clase de suscripción.
Si la clase de suscripción utiliza acciones de condición, una suscripción también puede especificar una condición que se utilice para determinar si se debe generar una notificación para la suscripción. La aplicación debe utilizar clases en el espacio de nombres Microsoft.SqlServer.NotificationServices.Rules para admitir el desarrollo de condiciones.
Los datos de suscripción se almacenan en la base de datos de aplicación.
Clases de administración de suscripciones
Las clases siguientes del espacio de nombres Microsoft.SqlServer.NotificationServices se utilizan para desarrollar interfaces de administración de suscripciones.
| Clase | Descripción |
|---|---|
Subscriber |
Representa un suscriptor individual en una instancia de Notification Services determinada. |
Representa la colección de suscriptores en una instancia de Notification Services determinada. |
|
SubscriberDevice |
Representa un dispositivo que puede recibir notificaciones. |
Representa una colección de dispositivos de suscriptor. |
|
Subscription |
Representa una suscripción única. |
Representa una colección de suscripciones. |
|
Representa una región geográfica para la que se aplicará formato a una notificación. |
|
Representa la colección de configuraciones regionales de suscriptor disponibles en una instancia de Notification Services determinada. |
|
Representa una zona horaria válida, utilizada para suscripciones programadas. |
|
Representa la colección de zonas horarias disponibles en una instancia de Notification Services determinada. |
|
Representa una clase de suscripción, tal como se especifica para una aplicación determinada. |
|
Representa la colección de clases de suscripción en una aplicación de Notification Services determinada. |
|
Representa una aplicación de Notification Services. |
|
Representa una instancia de Notification Services. |
|
Representa excepciones iniciadas cuando se produce un error de aplicación de Notification Services. |
Clases de condición de suscripción
Si una clase de suscripción contiene reglas que utilizan acciones de condición, se utilizarán clases en el espacio de nombres Microsoft.SqlServer.NotificationServices.Rules para permitir a los usuarios que definan condiciones.
| Clase | Descripción |
|---|---|
Define un conjunto de condiciones que se deben evaluar mediante la lógica del booleano AND. |
|
Se evalúa como true si el argumento de prueba está entre un valor mínimo y un valor máximo, ambos incluidos. |
|
Se evalúa como true si su argumento de valor booleano es true. |
|
Representa un argumento con un valor predeterminado. |
|
Operadores de expresión. |
|
Representa un argumento cuyo valor se determina al evaluar una expresión aritmética simple. |
|
Representa un argumento de condición que obtiene su valor de un campo de entrada. |
|
Acciones de filtro. |
|
Define un filtro sobre una tabla o vista de entrada basado en los resultados de la evaluación de condiciones. Una regla de filtro está compuesta por una o varias instrucciones de filtro. |
|
Describe una instrucción lógica en la forma "IF Condición THEN Acción". |
|
Representa un argumento que obtiene su valor a partir de una función Transact-SQL definida por el usuario. |
|
Se evalúa como true si su argumento tiene un valor NULL. |
|
Evalúa operaciones con los resultados de una regla de filtro relacionada. |
|
Operadores para condiciones de hoja de vínculo. |
|
Niega el resultado de otra condición. |
|
Define un conjunto de condiciones que se deben evaluar de forma lógica mediante la lógica del booleano OR. |
|
Define la lógica que se evalúa como un valor escalar para cualquier fila de una tabla o vista de entrada. Una regla de propiedad está compuesta por una o varias instrucciones de propiedad. |
|
Describe una instrucción lógica en la forma "IF Condición THEN Resultado", donde el resultado es un valor escalar. |
|
Representa la excepción iniciada por un objeto en este espacio de nombres. |
|
Representa un argumento que obtiene su valor de la evaluación de otras reglas. |
|
Compara dos argumentos con operadores relacionales y devuelve un resultado booleano. |
|
Operadores para condiciones de hoja simples. |
|
Describe una tabla que se puede usar como entrada en una regla. |
|
Describe una vista que se puede usar como entrada en una regla. |
Clases de administración de suscripciones
Las clases anteriores están destinadas a la administración de datos de suscriptor, dispositivo de suscriptor y suscripción. Si está generando una aplicación para administrar instancias de Notification Services, utilice las clases siguientes en el espacio de nombres Microsoft.SqlServer.Management.Nmo para habilitar y deshabilitar suscriptores y suscripciones.
| Clase | Descripción |
|---|---|
Proporciona métodos para habilitar y deshabilitar la administración de suscriptores. |
|
Proporciona métodos para habilitar y deshabilitar la administración de suscripciones. |
Vistas de administración de suscripciones
Notification Services expone vistas para administrar datos de suscriptores principalmente para probar las aplicaciones. Para obtener más información, vea los siguientes temas:
Vea también
Conceptos
Iniciar un proyecto de administración de suscripciones
Otros recursos
Desarrollar interfaces de administración de suscripciones
Administrar suscriptores
Administrar dispositivos de suscriptor
Administrar datos de suscripción