Partage via


Utiliser une classe Notification pour une extension de remise

La classe Notification se trouve dans l'espace de noms Microsoft.ReportingServices.Interfaces et représente les informations d'abonnement utilisées par les extensions de remise pour la remise de rapports. La Notification classe fournit de nombreuses propriétés qui peuvent être utilisées pour afficher les rapports de remise, déterminer l’état de la notification et définir les données utilisateur.

Screenshot of the Report notification process.

La notification est l’objet central de toute remise.

Lorsqu'un événement associé à un abonnement qui utilise votre extension de remise personnalisée est déclenché, une notification contenant un objet Report est créée. L'objet Report regroupe les fonctionnalités nécessaires pour effectuer le rendu d'un rapport donné dans un format de rendu pris en charge, et contient des propriétés spécifiques au rapport, telles que l'URL d'accès au rapport sur le serveur et le nom du rapport. Pour plus d’informations sur la Report classe, consultez Utiliser la classe Report pour une extension de remise.

L'objet Notification est passé à la méthode Deliver de votre extension de remise. Votre méthode Deliver doit contenir du code spécifique pour traiter la notification et remettre le rapport.

Pour un exemple d’utilisation de la classe Notification, consultez SQL Server Reporting Services Product Samples (Exemples Reporting Services pour le produit SQL Server).

Fonctionnalité de nouvelle tentative

Reporting Services vous permet de créer une file d’attente de nouvelles tentatives pour les notifications qui ne peuvent pas être remises immédiatement. Une fois que le serveur de rapports a appelé la méthode Deliver d'une extension de remise, cette extension peut demander que le serveur de rapports effectue une nouvelle tentative de remise à un moment ultérieur. Si cet événement se produit, le serveur de rapports place la notification dans une file d’attente interne et réessaye la remise après un certain temps écoulé. Les administrateurs peuvent configurer le nombre maximal de nouvelles tentatives effectuées par le serveur de rapports, de même que le délai entre les nouvelles tentatives, dans la section relative à l’extension de remise du fichier RSReportServer.config, à l’aide des éléments XML MaxNumberOfRetries et PeriodBetweenRetries. Les notifications sont supprimées de la file d'attente des nouvelles tentatives si la remise réussit ultérieurement ou si le nombre maximal de nouvelles tentatives est atteint. Si la remise échoue après le nombre maximal de nouvelles tentatives, la notification est ignorée.