Implémenter des gestionnaires d'alertes
Dernière modification : lundi 8 mars 2010
S’applique à : SharePoint Foundation 2010
Vous pouvez intercepter les événements de notification en implémentant la fonction OnNotification dans l’interface IAlertNotifyHandler.
Vous pouvez intercepter les événements de création et de modification d’alerte en implémentant les fonctions PreUpdate et PostUpdate dans IAlertUpdateHandler.
Important
Les gestionnaires d’alertes ne sont déclenchés que lorsque l’utilisateur s’est abonné aux alertes par courrier électronique. Ils ne le sont pas lorsque l’utilisateur a choisi les alertes SMS.
Implémenter un gestionnaire d'alertes
Vous pouvez utiliser la procédure suivante pour implémenter un gestionnaire d'alertes.
Pour implémenter un gestionnaire d'alertes
Créez des classes pour implémenter les interfaces IAlertNotifyHandler et IAlertUpdateHandler.
Inscrivez les assemblys dans le Global Assembly Cache.
Connectez le modèle d’alerte au gestionnaire en utilisant l’élément Properties du modèle d’alerte dans le format suivant :
<Properties> <NotificationHandlerAssembly> Handler assembly strong name </NotificationHandlerAssembly> <NotificationHandlerClassName> Fully qualified class name </NotificationHandlerClassName> <NotificationHandlerProperties> Other option properties you want to pass </NotificationHandlerProperties> <UpdateHandlerAssembly> Assembly </UpdateHandlerAssembly> <UpdateHandlerClassName> Class name </UpdateHandlerClassName> <UpdateHandlerProperties> Other properties </UpdateHandlerProperties> </Properties>
Les modèles d’alerte sont stockés dans les fichiers AlertTemplates.xml et AlertTemplates_SMS.xml. Ces modèles définissent le format, le contenu et les propriétés utilisés pour créer des messages d’alerte à partir de chaque type de liste. Les développeurs peuvent personnaliser les alertes en modifiant une copie de l’un des fichiers ou des deux, puis en chargeant les modèles d’alerte personnalisés à l’aide de la commande stsadm -o updatealerttemplates.
Notes
Ne modifiez pas les fichiers AlertTemplates.xml et AlertTemplates_SMS.xml. Ils peuvent être remplacés lors de l’installation d’un Service Pack. Pour apporter des modifications, effectuez une copie de l’un des fichiers ou des deux, modifiez la copie, puis effectuez un ou deux appels de la commande stsadm -o updatealerttemplates pour remplacer les modèles d’origine par vos modifications. Celles-ci sont stockées dans la base de données de configuration SharePoint Foundation. Pour plus d’informations, voir Vue d'ensemble des alertes et Schéma AlertTemplates.
Important
Si vous apportez une modification à un modèle SPAlertTemplateType.* donné en dehors de l’élément Format, vous devez apporter la même modification au modèle SPSmsAlertTemplateType.* correspondant.
Intercepter l'événement
Pour intercepter l’événement lorsqu’une alerte est déclenchée, implémentez IAlertNotifyHandler. IAlertNotifyHandler.OnNotification est appelé lorsque l’alerte est déclenchée. Un objet SPAlertHandlerParams est passé à la fonction. Envoyez ensuite le message avec une méthode d’envoi par courrier électronique, telle que SendEmail, ou une méthode d’envoi de message SMS comme SendMessage(String).
Pour intercepter l'événement lorsqu'une nouvelle alerte est créée ou mise à jour (afin que vous puissiez modifier ses propriétés ou définir de nouvelles propriétés), implémentez l'interface IAlertNotifyHandler. PreUpdateest appelé avant que les modifications apportées à l'alerte ne soient validées dans la base de données ; PostUpdate est appelé une fois les modifications validées.
Notes
Lors de l'implémentation de IAlertNotifyHandler, n'accédez pas à SPAlertCollection, ne modifiez pas l'objet SPAlert et vérifiez systématiquement si une propriété SPAlert a pour valeur null avant d'y accéder.