Definir proveedores de eventos alojados
Los proveedores de eventos alojados se alojan en el motor de Notification Services. Cuando se inicia el motor, se inicializan y ejecutan todos los proveedores de eventos alojados habilitados.
La información indicada en la definición de aplicación proporciona al motor la información necesaria para encontrar, inicializar y ejecutar proveedores de eventos alojados.
Tipos de proveedores de eventos alojados
Un proveedor de eventos alojado puede ser continuo o programado:
- Un proveedor de eventos continuo se inicia cuando se inicia el motor y se detiene cuando se detiene el motor. Administra cómo y cuándo se envían eventos.
Si desarrolla un proveedor de eventos personalizado continuo, debe implementar la interfaz IEventProvider. - Un proveedor de eventos programado se inicia cuando se inicia el motor y se desencadena para comprobar nuevos eventos en intervalos predefinidos.
La programación se proporciona en la definición de aplicación.
Si desarrolla un proveedor de eventos personalizado programado, debe implementar la interfaz IScheduledEventProvider.
Definir un proveedor de eventos alojado
Cada aplicación puede tener proveedores de eventos alojados. Al definir una aplicación, se define cada proveedor de eventos utilizado por la aplicación, incluidas propiedades como el nombre del proveedor de eventos, la clase que implementa el proveedor de eventos, el ensamblado que contiene la clase y los argumentos necesarios para inicializar el proveedor de eventos.
Para definir un proveedor de eventos alojado
Si está definiendo una aplicación a través de XML, defina los proveedores de eventos alojados en el elemento Proveedores del archivo de definición de aplicación (ADF). Si está definiendo una aplicación con Objetos de administración de Notification Services (NMO), defina individualmente objetos HostedEventProvider y agréguelos a un HostedEventProviderCollection con la propiedad HostedEventProviders de la aplicación.
- HostedProvider Element (ADF)
- HostedEventProvider (NMO)
Nombre del proveedor de eventos
El nombre de proveedor de eventos identifica el proveedor de eventos que envió cada lote de eventos. Cuando está depurando, solucionando problemas y supervisando aplicaciones, a menudo proporciona el nombre de proveedor de eventos como un parámetro.
Para definir el nombre de proveedor de eventos
- Name Element for HostedProvider/Arguments/Argument (ADF)
- Propiedad Name del objeto HostedEventProvider (NMO)
Nombre de clase
En cada proveedor de eventos alojado debe proporcionar el nombre de la clase que implementa el proveedor de eventos.
- En los proveedores de eventos alojados personalizados, el nombre de clase debe cumplir la convención de nomenclatura de Microsoft .NET Framework de espacioDeNombres.nombre DeClase. Para obtener más información acerca de las convenciones de nomenclatura del espacio de nombres, vea el artículo sobre instrucciones de nomenclatura del espacio de nombres en Microsoft MSDN Library.
- En proveedores de eventos estándar de Notification Services, el nombre de clase no incluye el espacio de nombres. Utilice el nombre de clase proporcionado en la documentación del proveedor de eventos. Para obtener más información, vea Proveedores de eventos estándar.
Para definir el nombre de clase
Nombre del ensamblado
Si está definiendo un proveedor de eventos personalizado, proporcione el nombre del ensamblado que contiene la clase de proveedor de eventos alojado. El nombre debe incluir la ruta de acceso completa o el nombre de ensamblado completo.
Si está definiendo un proveedor de eventos estándar, no defina el nombre del ensamblado. Las clases que definen los proveedores de eventos estándar se encuentran en el ensamblado principal de Notification Services.
Para definir el nombre del ensamblado
Nombre del sistema
La propiedad de nombre del sistema especifica el nombre del sistema que ejecuta el proveedor de eventos alojado. Normalmente, este valor es el nombre del equipo. Sin embargo, si el proveedor de eventos se ejecuta en un clúster de conmutación por error, este valor es el nombre del servidor virtual.
Los componentes de cliente de Notification Services deben estar instalados en el equipo y la instancia debe estar registrada en el equipo.
Para obtener más información acerca de cómo realizar una implementación escalada de una aplicación, vea Configuraciones escaladas.
Para definir el nombre del sistema
Programación
Si está definiendo un proveedor de eventos continuo que incluye todos los proveedores de eventos estándar y un proveedor de eventos personalizado que implementa la interfaz IEventProvider, no defina una programación.
Si está definiendo un proveedor de eventos programado que implementa la interfaz IScheduledEventProvider, debe definir una programación para el proveedor de eventos.
Una programación tiene las siguientes propiedades:
- La propiedad de hora de inicio especifica una hora (período de 24 horas) en UTC que Notification Services usa para calcular tiempos de invocación para el proveedor de eventos programado. Por ejemplo, si su hora de inicio es 10:00 y su intervalo es tres horas, las horas de invocación del proveedor de eventos programado son 10:00, 13:00, 16:00, etc. Si la aplicación se inicia a las 12:32, el proveedor de eventos primero se ejecutará a las 13:00. Para obtener más ejemplos, vea StartTime Element for HostedProvider/Schedule (ADF).
- La propiedad de intervalo especifica la frecuencia de ejecución del proveedor de eventos programado.
Para definir una programación para un proveedor de eventos programado
Tiempo de espera
Cada proveedor de eventos alojado debe completar el procesamiento en un período de tiempo predeterminado. Si el proveedor de eventos alojado no completa el proceso dentro de ese tiempo, el intervalo actual de procesamiento se cancela.
Los proveedores de eventos alojados tienen un valor de tiempo de espera predeterminado de cinco minutos. Puede configurar otro valor de tiempo de espera.
Para definir un valor de tiempo espera para un proveedor de eventos alojado
ProviderTimeout Element (ADF) (ADF)
Propiedad Timeout (NMO)
Argumentos
Notification Services puede pasar argumentos a proveedores de eventos. Si su proveedor de eventos alojado utiliza argumentos, proporcione los nombres de argumento y los valores en la definición del proveedor de eventos.
Si está utilizando un proveedor de eventos desarrollado por un tercero, el proveedor de eventos debe incluir documentación sobre los argumentos requeridos y opcionales. Para obtener los argumentos del proveedor de eventos estándar, vea Proveedores de eventos estándar.
Para definir los argumentos del proveedor de eventos
Vea también
Conceptos
Definir proveedores de eventos no alojados
Otros recursos
Definir aplicaciones de Notification Services
Desarrollar un proveedor de eventos personalizados
Definir proveedores de eventos
Definir clases de eventos
Proveedores de eventos estándar