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.

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.

• 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.
SubscriberEnumeration	Representa la colección de suscriptores en una instancia de Notification Services determinada.
SubscriberDevice	Representa un dispositivo que puede recibir notificaciones.
SubscriberDeviceEnumeration	Representa una colección de dispositivos de suscriptor.
Subscription	Representa una suscripción única.
SubscriptionEnumeration	Representa una colección de suscripciones.
SubscriberLocale	Representa una región geográfica para la que se aplicará formato a una notificación.
SubscriberLocaleEnumeration	Representa la colección de configuraciones regionales de suscriptor disponibles en una instancia de Notification Services determinada.
TimeZone	Representa una zona horaria válida, utilizada para suscripciones programadas.
TimeZoneEnumeration	Representa la colección de zonas horarias disponibles en una instancia de Notification Services determinada.
SubscriptionClass	Representa una clase de suscripción, tal como se especifica para una aplicación determinada.
SubscriptionClassEnumeration	Representa la colección de clases de suscripción en una aplicación de Notification Services determinada.
NSApplication	Representa una aplicación de Notification Services.
NSInstance	Representa una instancia de Notification Services.
NSException	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
AndCondition	Define un conjunto de condiciones que se deben evaluar mediante la lógica del booleano AND.
BetweenLeafCondition	Se evalúa como true si el argumento de prueba está entre un valor mínimo y un valor máximo, ambos incluidos.
BooleanLeafCondition	Se evalúa como true si su argumento de valor booleano es true.
ConstantValue	Representa un argumento con un valor predeterminado.
ExpressionOperator	Operadores de expresión.
ExpressionValue	Representa un argumento cuyo valor se determina al evaluar una expresión aritmética simple.
FieldValue	Representa un argumento de condición que obtiene su valor de un campo de entrada.
FilterAction	Acciones de filtro.
FilterRule	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.
FilterStatement	Describe una instrucción lógica en la forma "IF Condición THEN Acción".
FunctionValue	Representa un argumento que obtiene su valor a partir de una función Transact-SQL definida por el usuario.
IsNullLeafCondition	Se evalúa como true si su argumento tiene un valor NULL.
LinkLeafCondition	Evalúa operaciones con los resultados de una regla de filtro relacionada.
LinkLeafOperator	Operadores para condiciones de hoja de vínculo.
NotCondition	Niega el resultado de otra condición.
OrCondition	Define un conjunto de condiciones que se deben evaluar de forma lógica mediante la lógica del booleano OR.
PropertyRule	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.
PropertyStatement	Describe una instrucción lógica en la forma "IF Condición THEN Resultado", donde el resultado es un valor escalar.
RulesException	Representa la excepción iniciada por un objeto en este espacio de nombres.
RuleValue	Representa un argumento que obtiene su valor de la evaluación de otras reglas.
SimpleLeafCondition	Compara dos argumentos con operadores relacionales y devuelve un resultado booleano.
SimpleOperator	Operadores para condiciones de hoja simples.
TableInputType	Describe una tabla que se puede usar como entrada en una regla.
ViewInputType	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
Instance	Proporciona métodos para habilitar y deshabilitar la administración de suscriptores.
Application	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:

• NSSubscriberView
• NSSubscriberDeviceView
• NS<nombreDeClaseDeSuscripción>View (vista)

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

Ayuda e información

Obtener ayuda sobre SQL Server 2005