Définition de fournisseurs d'événements hébergés

Article
12/15/2008

Les fournisseurs d'événements hébergés sont hébergés par le moteur Notification Services. Lorsque le moteur démarre, il initialise et exécute tous les fournisseurs d'événements hébergés activés.

Les informations que vous fournissez dans la définition d'application donnent au moteur les informations nécessaires pour trouver, initialiser et exécuter les fournisseurs d'événements hébergés.

Types de fournisseurs d'événements hébergés

Un fournisseur d'événements hébergé peut être continu ou planifié :

Un fournisseur d'événements continu est démarré lorsque le moteur démarre et arrêté lorsque le moteur s'arrête. Il gère le mode d'envoi et l'heure d'envoi des événements.
Si vous développez un fournisseur d'événements continu personnalisé, vous devez implémenter l'interface IEventProvider.
Un fournisseur d'événements planifié est démarré lorsque le moteur démarre et déclenché à des intervalles prédéfinis pour vérifier les nouveaux événements.
Vous fournissez la planification dans la définition d'application.
Si vous développez un fournisseur d'événements planifié personnalisé, vous devez implémenter l'interface IScheduledEventProvider.

Définition d'un fournisseur d'événements hébergé

Chaque application peut contenir des fournisseurs d'événements hébergés. Lorsque vous définissez une application, vous définissez chaque fournisseur d'événements utilisé par l'application, notamment les propriétés telles que le nom du fournisseur d'événements, la classe qui implémente le fournisseur d'événements, l'assembly qui contient la classe et les éventuels arguments requis pour initialiser le fournisseur d'événements.

Pour définir un fournisseur d'événements hébergé

Si vous définissez une application le biais de XML, définissez les fournisseurs d'événements hébergés dans l'élément Providers du fichier de définition d'application (ADF). Si vous définissez une application en utilisant Notification Services Management Objects (NMO), vous définissez individuellement les objets HostedEventProvider et les entrez dans un HostedEventProviderCollection à l'aide de la propriété HostedEventProviders de l'application.

HostedProvider Element (ADF)
HostedEventProvider (NMO)

Nom du fournisseur d'événements

Le nom du fournisseur d'événements identifie le fournisseur d'événements qui a soumis chaque lot d'événements. Lorsque vous déboguez, dépannez et surveillez des applications, vous fournissez souvent le nom du fournisseur d'événements sous forme de paramètre.

Pour définir le nom du fournisseur d'événements

Name Element for HostedProvider/Arguments/Argument (ADF)
Propriété Name de l'objet HostedEventProvider (NMO)

Nom de la classe

Pour chaque fournisseur d'événements hébergé, vous devez fournir le nom de la classe qui implémente le fournisseur d'événements.

Pour les fournisseurs d'événements hébergés personnalisés, le nom de classe doit respecter la convention de nom Microsoft .NET Framework NamespaceClassName. Pour plus d'informations sur la convention d'affectation de nom des espaces de noms, consultez Namespace Naming Guidelines (en anglais) dans la bibliothèque Microsoft MSDN.
Pour les fournisseurs d'événements Notification Services standard, le nom de classe n'inclut pas l'espace de noms. Utilisez le nom de classe figurant dans la documentation du fournisseur d'événements. Pour plus d'informations, consultez Fournisseurs d'événements standard.

Pour définir le nom de classe

Nom d'assembly

Si vous définissez un fournisseur d'événements personnalisé, fournissez le nom de l'assembly qui contient la classe du fournisseur d'événements hébergé. Le nom doit contenir le chemin totalement défini ou le nom d'assembly complet.

Si vous définissez un fournisseur d'événements standard, ne définissez pas le nom d'assembly. Les classes qui définissent les fournisseurs d'événements standard sont dans l'assembly principal Notification Services.

Pour définir le nom d'assembly

Nom système

La propriété de nom système spécifie le nom du système qui exécute le fournisseur d'événements hébergé. Cette valeur est généralement le nom de l'ordinateur. Toutefois, si le fournisseur d'événements s'exécute sur un cluster avec basculement, cette valeur est le nom de serveur virtuel.

Les composants clients Notification Services doivent être installés sur l'ordinateur et l'instance doit y est inscrite.

Pour plus d'informations sur la montée en puissance parallèle d'une application, consultez Configurations distribuées horizontalement.

Pour définir le nom système

Planification

Si vous définissez un fournisseur d'événements continu qui contient tous les fournisseurs d'événements standard et les éventuels fournisseurs d'événements personnalisés qui implémentent l'interface IEventProvider, ne définissez pas de planification.

Si vous définissez un fournisseur d'événements planifié qui implémente l'interface IScheduledEventProvider, vous devez lui définir une planification.

Une planification présente les propriétés suivantes :

La propriété d'heure de début spécifie une heure du jour (période de 24 heures) en temps UTC, qui est utilisée par Notification Services pour calculer les heures d'appel au fournisseur d'événements planifié. Par exemple, si l'heure de début est 10:00 et si l'intervalle est de trois heures, les heures d'appel au fournisseur d'événements planifié sont 10:00, 13:00, 16:00, etc. Si l'application démarre à 12:32, le fournisseur d'événements s'exécutera pour la première fois à 13:00. Pour des exemples supplémentaires, consultez StartTime Element for HostedProvider/Schedule (ADF).
La propriété d'intervalle spécifie la fréquence d'exécution du fournisseur d'événements planifié.

Pour définir une planification à un fournisseur d'événements planifié

Schedule Element for HostedProvider (ADF)
StartTime (NMO)
Interval (NMO)

Délai d'attente

Chaque fournisseur d'événements hébergé doit terminer le traitement dans une période prédéterminée. Si le fournisseur d'événements hébergé ne termine pas le traitement pendant cette période, l'intervalle de traitement en cours est annulé.

Les fournisseurs d'événements hébergés possèdent une valeur de délai par défaut de cinq minutes. Vous pouvez configurer une valeur de délai différente.

Pour définir une valeur de délai à un fournisseur d'événements hébergé

ProviderTimeout Element (ADF) (ADF)

Propriété Timeout (NMO)

Arguments

Notification Services peut passer des arguments aux fournisseurs d'événements. Si votre fournisseur d'événements hébergé utilise des arguments, fournissez les noms et les valeurs des arguments dans la définition du fournisseur d'événements.

Si vous utilisez un fournisseur d'événements développé par une tierce partie, il doit être accompagné d'une documentation sur les arguments obligatoires et facultatifs. Pour les arguments de fournisseurs d'événements standard, consultez Fournisseurs d'événements standard.

Pour définir les arguments de fournisseur d'événements

Voir aussi

Partager via