Utilisez WebHooks pour suivre l'historique de votre serveur de rapports Telerik

Avec la version Telerik Report Server R2 2018 (4.1.18.516) nous avons introduit la prise en charge des WebHooks. Ce billet de blog décrit comment les utiliser pour suivre l'historique d'un serveur de rapports Telerik. L'approche est illustrée dans le projet référencé ici – appelé WebHooks .

Les principaux éléments constitutifs du projet sont:

• CustomWebHookHandler mis en œuvre conformément à l'article Recevoir des Webhooks . La fonctionnalité de cette classe met à jour le contenu des fichiers JSON (un pour chaque filtre WebHooks) suivant l'historique du serveur de rapports.

• NotificationsController le contrôleur WebApi qui définit les points finaux pour exposer les données des fichiers JSON avec le

• HomeController est un contrôleur MVC renvoyant une vue avec HTML5 ReportViewer qui affiche le rapport WebHooksReport.trdp avec l'historique Report Server.

• ReportsController définit le Telerik Reporting REST Service qui génère le rapport. Peut être supprimé si le rapport WebHooksReport.trdp sera hébergé sur le serveur de rapports.

• Le dossier Reports contient le rapport – WebHooksReport.trdp et les fichiers JSON avec les enregistrements d'historique. Le rapport affiche cinq tableaux, un pour chaque filtre WebHooks. Chaque table est liée à un WebServiceDataSource lié au point de terminaison correspondant du NotificationsController. Le rapport contient trois paramètres de rapport visibles que l'utilisateur final peut utiliser pour filtrer le rapport. Deux d'entre eux sont DateTime (ReceivedAfter et ReceivedBefore) et filtrent les WebHooks en fonction de la date / heure de leur réception. Le troisième paramètre qui peut être contrôlé par l'utilisateur est NotificationType et permet le filtrage par les actions qui ont appelé la notification. Les types d'actions disponibles sont répertoriés dans un CsvDataSource incorporé. Il existe également un paramètre masqué, dont la valeur est transmise par la visionneuse et spécifie l'URL du service Web alimentant le rapport avec des données. Notez que les données sont filtrées au niveau de la source de données via JSONPath . Voici la page de configuration WebServiceDataSource appropriée (cliquez sur l'image pour l'agrandir):

L'idée de base est une modification du contenu du serveur de rapports (par exemple, télécharger un rapport, créer une tâche planifiée, éditer un Alerte de données, etc. – vérifiez Gestion des webhooks pour les filtres pris en charge) pour déclencher la fonctionnalité dans une application Web d'abonné (le "listener") qui mettra à jour les enregistrements d'historique Report Server. L '"écouteur" attend que le serveur de rapports signale des modifications particulières et les enregistre dans des fichiers JSON.

Les données de ces fichiers sont exposées via un contrôleur WebApi (NotificationsController dans l'exemple). Ce dernier est utilisé par WebServiceDataSources pour alimenter les tables de rapport où les détails sur les modifications sont affichés. Le rapport (WebHooksReport.trdp dans l'exemple) lui-même peut être hébergé sur le serveur de rapports. Si tel est le cas, vous pouvez supprimer le ReportsController de l'exemple de projet et définir la propriété ReportServer du visualiseur HTML5 en fonction de vos paramètres Report Server.