Intégration de première classe du concepteur et de la visionneuse de rapports Web

Telerik Reporting a bénéficié d’un bon coup de pouce dans la version précédente : les utilisateurs peuvent basculer entre l’affichage et la conception de leurs rapports dans le navigateur. Découvrez comment faire fonctionner cela pour une création de rapports soignée.

Commencer par le progrès Rapport Telerik 2024 T1 (18.0.24.130) libération, le Concepteur de rapports Web le composant peut être démarré en standard Visionneuse de rapports Web et offre des capacités de personnalisation améliorées du visualiseur lui-même. Cela étend les scénarios d’intégration couverts par le composant.

Mode de démarrage du concepteur de rapports Web

Telerik Reporting Web Designer, qui fait partie de Reportage Telerik, est un composant Web puissant qui permet aux utilisateurs de créer et de gérer facilement des définitions de rapports. Le mode aperçu du concepteur intègre le contrôle Telerik HTML 5 Report Viewer et permet aux utilisateurs de prévisualiser les rapports qu’ils ont conçus d’un simple clic. À partir du mode aperçu, l’utilisateur peut revenir au mode conception, modifier le rapport en toute transparence et prévisualiser à nouveau le rapport mis à jour.

La nouvelle option d’initialisation du Web Report Designer permet au développeur de démarrer le concepteur en mode conception (le mode par défaut en cas d’omission) ou en mode aperçu.

$(document).ready(function () {
  $("#webReportDesigner").telerik_WebReportDesigner({
    serviceUrl: "api/reportdesigner/",
    report: "Dashboard.trdp",
    
    startMode: "preview"
  }).data("telerik_WebReportDesigner");
}); 

Refonte du mode aperçu de Web Report Designer

Nous avons peaufiné le mode aperçu de Web Report Designer en supprimant les composants redondants. Désormais, l’aperçu récemment repensé de Web Report Designer contient uniquement la visionneuse de rapports et un bouton dans le coin supérieur droit pour contrôler le changement de mode. Cela modifie efficacement l’expérience de l’utilisateur final en travaillant avec le célèbre Report Viewer, mais avec des fonctionnalités de conception supplémentaires.

En mode conception, un bouton d’aperçu situé à la même position peut ramener l’utilisateur en mode aperçu.

En savoir plus sur le mode aperçu dans la documentation.

Passage des paramètres du concepteur au visualiseur

Paramètres du rapport sont une fonctionnalité couramment utilisée du rapport qui peut contrôler le contenu du rapport ou peut être utilisée pour filtrer les données du rapport. Avec les versions précédentes de Telerik Reporting, il n’était pas possible de transmettre les valeurs initiales des paramètres du rapport lors de la prévisualisation d’un rapport dans Web Report Designer.

C’est pourquoi nous avons ajouté le reportSourceParameters option d’initialisation qui donne au développeur la possibilité de définir les paramètres à transmettre à la visionneuse de rapports.

$(document).ready(function () {  
  $("#webReportDesigner").telerik_WebReportDesigner({  
    serviceUrl: "api/reportdesigner/",  
    report: "Dashboard.trdp",  
    reportViewerOptions: {  
      reportSourceParameters: {  
        ReportYear: 2002 
      }  
    }  
  }).data("telerik_WebReportDesigner");  
});

Pour éviter les effets secondaires, le reportSourceParameters La valeur de l’option est appliquée uniquement lorsque le rapport initialement défini dans l’option d’initialisation du rapport est prévisualisé. Si l’utilisateur ouvre un autre rapport, ces valeurs de paramètres initiales n’interféreront pas. Dans l’exemple ci-dessus, le ReportYear Le paramètre ne sera défini que si l’utilisateur prévisualise le rapport « Dashboard.trdp ».

Personnalisation de la visionneuse de rapports dans le contrôle du concepteur de rapports

Le contrôle de la visionneuse de rapports est intégré au concepteur de rapports avec ses options de comportement par défaut. Il y a quelques options d’initialisation qui peut être personnalisé par l’utilisateur comme scaleMode, scale, viewMode et pageMode.

$(document).ready(function () {  
  $("#webReportDesigner").telerik_WebReportDesigner({  
    serviceUrl: "api/reportdesigner/",  
    report: "Dashboard.trdp",  
    reportViewerOptions: {  
      scaleMode: "SPECIFIC",  
      scale: 1.5,  
      viewMode: "INTERACTIVE",  
      pageMode: "CONTINUOUS_SCROLL"  
    }  
  }).data("telerik_WebReportDesigner");  
});

Les autres options d’initialisation de la visionneuse de rapports peuvent être définies via les événements du concepteur de rapports nouvellement introduits ciblant l’initialisation et le chargement de la visionneuse.

Nouveaux événements pour la visionneuse de rapports dans le contrôle Report Designer

Auparavant, les options de personnalisation de la Visionneuse de rapports dans le contrôle Web Report Designer étaient assez limitées. Avec l’introduction des nouveaux événements viewerInitializing et viewerLoading dans notre version du premier trimestre 2024, nous sommes fiers de dire que le développeur peut définir toutes les options d’initialisation de la visionneuse.

Cela permet à l’utilisateur de contrôler entièrement l’apparence et les fonctionnalités de la visionneuse de rapports. De plus, le développeur peut désormais s’abonner à la liste complète des événements de la visionneuse de rapports et implémenter le scénario personnalisé nécessaire.

viewerInitializing Événement

Cet événement est déclenché la première fois lorsque l’utilisateur passe en mode aperçu du concepteur, une seule fois pour le cycle de vie du concepteur de rapports. Ce sera l’endroit idéal où le développeur pourra définir les options d’initialisation de la visionneuse de rapports. Ils seront ensuite appliqués à tous les rapports prévisualisés. En outre, il existe la possibilité de s’abonner à tous les événements possibles du visualiseur via ses options d’initialisation du Report Viewer.

Événement viewerLoading

Cet événement est déclenché chaque fois que l’utilisateur entre dans le mode aperçu du concepteur. Il convient à la configuration de certains paramètres de la visionneuse spécifiques au rapport actuellement prévisualisé. Par exemple, transmettre les valeurs des paramètres applicables au rapport actuellement prévisualisé.

Montrons les nouveaux événements avec un exemple.

$(document).ready(function () { 
  $("#webReportDesigner").telerik_WebReportDesigner({ 
    serviceUrl: "api/reportdesigner/", 
    report: "Dashboard.trdp", 
    viewerInitializing: onViewerInitializing, 
    viewerLoading: onViewerLoading 
  }).data("telerik_WebReportDesigner");  
}); 
 
function onViewerInitializing(e, args) { 
  
  
  
  args.reportViewerOptions.parameters = { 
    editors: { 
      singleSelect: telerikReportViewer.ParameterEditorTypes.COMBO_BOX, 
      multiSelect: telerikReportViewer.ParameterEditorTypes.COMBO_BOX 
    } 
  }; 
  args.reportViewerOptions.renderingBegin = onViewerRenderingBegin; 
} 
 
function onViewerLoading(e, args) { 
  
  
  
  
  
  
  var reportViewerOptions = args.reportViewerOptions;
  var report = reportViewerOptions.reportSource.report;
  if (report === "Dashboard.trdp") { 
    reportViewerOptions.reportSource.parameters = { ReportYear: 2003 };
    reportViewerOptions.viewMode = telerikReportViewer.ViewModes.PRINT_PREVIEW; 
  } else if (report === "Product Catalog.trdp") { 
    reportViewerOptions.pageMode = telerikReportViewer.PageModes.SINGLE_PAGE; 
    reportViewerOptions.viewMode = telerikReportViewer.ViewModes.INTERACTIVE; 
  }  
} 
 
function onViewerRenderingBegin(e) { 
  console.log('TRV rendering begin.'); 
}

Dans cet exemple, dans onViewerInitializing nous avons modifié le type d’éditeur par défaut pour les éditeurs de paramètres à sélection unique et à sélection multiple en une zone de liste déroulante au lieu d’une vue de liste. De plus, nous fournirons un gestionnaire au ViewerRenderingBegin événement, qui enregistrera une ligne dans la console.

Et en onViewerLoading nous avons défini les paramètres du rapport « Dashboard.tdp » et nous avons modifié le pageMode et viewMode pour le rapport « Product Catalog.trdp ».

Conclure

Nous sommes ravis que Telerik Reporting offre désormais une expérience client encore meilleure, en offrant à nos utilisateurs une visionneuse de rapports et des composants Web de conception de rapports entièrement intégrés et pouvant être personnalisés pour les besoins spécifiques de chaque client.

Donnez-nous vos impressions

Aidez-nous à créer la meilleure expérience de reporting pour vous ! Partagez vos commentaires et suggestions en visitant notre Portail de commentaires et Forum de reportage Telerik. Nous sommes impatients de savoir ce que vous pensez.

Veulent en savoir plus?

Reportage Telerik est un puissant outil de reporting .NET qui permet aux utilisateurs de concevoir, générer et intégrer facilement des rapports dans leurs applications Web ou de bureau.

Essayez-le gratuitement ou consultez notre démos en ligne pour commencer votre voyage dans le reporting !