Premiers pas avec les concepteurs de bureau dans .NET

Dans le dernier article de cette série, nous détaillons les concepteurs de rapports .NET de Telerik Reporting pour le bureau. Consultez les premiers et deuxièmes messages .

Présentation de la série

Telerik Reporting est un puissant moteur de rapports basé sur .NET avec de nombreux avantages. L'un de ces avantages est le Report Designers . Des développeurs aux concepteurs de rapports et aux parties prenantes, Telerik Reporting est l'outil de choix pour créer et concevoir de beaux rapports. En conséquence, j'ai créé cette série pour illustrer cela.

Cette série couvre un peu du passé, un peu du présent et, surtout, des opportunités futures. Les derniers messages sont plus techniques et risquent de se chevaucher. Pour continuer, utilisez les liens ci-dessous ou lisez à votre guise.

1. Concepteurs de rapports Web et de bureau pour tous – Telerik Reporting

2. Premiers pas avec le Concepteur de rapports Web dans .NET

3. Premiers pas avec les concepteurs de bureau dans .NET (This Post)

Introduction

Comme indiqué dans la deuxième partie de cet article, des rapports bien conçus sont comme n'importe quel autre média. Il y a un art à les créer et à les lire. Les rapports sont destinés à répondre à des questions, à communiquer des objectifs et à évoquer des sentiments positifs ou négatifs.

Cela soutient le concept de la conception de rapports comme une étape intégrale dans la remise des rapports aux parties prenantes. On pourrait soutenir que les capacités du concepteur sont les aspects les plus importants d'un cadre de reporting. Cette idée vaut également pour Telerik Reporting.

Les concepteurs de rapports s'attendent à ce qu'un cadre de reporting soit facile à utiliser et à comprendre. Ils s'attendent à ce qu'il soit suffisamment puissant pour présenter leurs idées comme prévu. Des entrées de données à l'activité de l'utilisateur final, une solution de création de rapports doit être capable de fonctionner dans le cadre de l'intention de conception.

Cependant, pour concevoir correctement un rapport dans Telerik Reporting, il est essentiel de comprendre le cycle de vie des rapports . . Cette compréhension habilitera le concepteur en lui fournissant un cadre de travail. Permettez-moi de passer brièvement en revue le cycle de vie du rapport.

Comprendre le cycle de vie du rapport

Le cycle de vie du rapport dans Telerik Reporting se compose de trois étapes. Il s'agit de définir le rapport, de traiter le rapport puis de le rendre. Les étapes sont séquentielles et se construisent les unes après les autres. Pour apporter des modifications à n'importe quelle étape, vous devez redémarrer le cycle de vie. Permettez-moi de vous donner un aperçu des étapes ci-dessous.

Fig. 1 – Le cycle de vie du rapport

1. Définition du rapport sont les définitions déclaratives qui sont créées avec l'un des outils de conception de Telerik Reporting.
2. Le traitement de la définition de rapport effectue des calculs de regroupement, de tri et de filtrage. Il évalue les expressions, lie les sources de données et déclenche des événements de liaison.
3. Rendu du rapport traité prend le rapport traité et le transmet à l'une des nombreuses extensions de rendu disponibles.

La conception d'un rapport est la première étape du processus. Chacun des concepteurs de rapports Telerik s'inscrit dans la première étape du cycle de vie. Avoir une compréhension de la Le cycle de vie fournit une base solide pour la conception de rapports dans Telerik Reporting.

Conception de rapports

Les concepteurs de bureau ont permis aux développeurs de fournir des rapports de manière productive en utilisant soit notre propr ietary Standalone Designer ou Visual Studio, avec le concepteur autonome étant l'outil recommandé. Cependant, quel que soit l'outil de conception utilisé, nos concepteurs de bureau sont stables, testés au combat et bien documentés.

Pour illustrer cela, nous examinerons les démos fournies à la fois dans le concepteur autonome et dans le concepteur Visual Studio. En examinant les démos, il détaillera les éléments de conception de rapports dans les concepteurs de bureau, comme la façon de travailler au sein des concepteurs, de les configurer et de les intégrer entre les concepteurs.

Méthodologies utilisées

Les éléments conceptuels des outils Telerik Report Designers permettent une conception simple et visuelle. Pour ce faire, les concepteurs de rapports peuvent utiliser le glisser-déposer, les commentaires contextuels, les assistants et les concepts Ce que vous voyez est ce que vous obtenez.

Le glisser-déposer est un concept courant utilisé dans la conception. dans de nombreux outils de conception. Il permet au concepteur de sélectionner l'outil ou l'élément de conception, de le faire glisser sur l'aire de conception et de modifier l'outil. Ceci est omniprésent avec d'autres concepts tels que l'alignement sur la grille.

Pour des commentaires contextuels, l'interface utilisateur se mettra à jour lors de la sélection d'un élément spécifique dans le concepteur. Par exemple, une zone de texte a des propriétés différentes de celles d'une source de données et la fenêtre des propriétés sera mise à jour pour tenir compte de ces différences.

Pour faciliter la création de rapports complexes, les outils de conception incluent des assistants. Les éléments de rapport les plus complexes tels que le graphique, les différentes sources de données et les tableaux / tableaux croisés peuvent être créés beaucoup plus simplement à l'aide des assistants. Les assistants sont couramment utilisés pour des tâches complexes.

Les concepts ci-dessus complètent le flux de travail du concepteur en affichant le composant exactement à quoi il ressemblera dans le rapport. Ceci est connu comme ce que vous voyez est ce que vous obtenez. Dans Telerik Reporting, il fournit un aperçu en direct des éléments basés sur des images tels que le graphique, la carte, le code-barres et la PictureBox. C'est très courant avec les concepteurs complexes.

Éléments d'interface utilisateur de Desktop Designer

Les concepteurs de bureau partagent des éléments d'interface utilisateur similaires. Ceux-ci sont légèrement différents car ils interagissent avec différents types de fichiers. Par exemple, le concepteur de rapports autonome utilise une définition XML propriétaire et le concepteur Visual Studio utilise des classes C # ou VB.NET.

Au cours de cette section, nous examinerons les éléments du concepteur dans chaque concepteur. Il est logique de les séparer en différentes sections. Les sections qui se chevauchent comprennent l'aire de conception, les composants disponibles et les explorateurs de rapports, de données, de groupes et de propriétés.

Éléments de l'interface utilisateur du concepteur de rapports autonome

Le concepteur de rapports autonome est une application distincte qui utilise le moteur de création de rapports pour empaqueter une définition XML. Il s'agit d'un simple fichier .EXE qui s'exécute sous Windows comme les autres applications de bureau. Commençons par examiner comment créer des rapports.

Création de rapports dans le Concepteur de rapports autonome

La création de nouveaux rapports est comme toute autre application Windows. Exécutez le Concepteur de rapports autonome à partir du menu Démarrer et sélectionnez nouveau comme la capture d'écran suivante.

Fig. 2 – La nouvelle interface utilisateur de rapport

Surface de conception du concepteur autonome UI

Après avoir sélectionné un rapport nouveau ou existant, cela ouvrira le rapport dans l'aire de conception. Voici une capture d'écran après l'ouverture de l'exemple de fichier Dashboard.trdp.

Fig. 3 – Interface de la surface de conception du concepteur autonome [19659040] Menus des composants du concepteur autonome

La barre d'outils contient un menu à onglets dans le ruban de l'application et les onglets sont contextuels par composant ou par vue. Ce sont les onglets Accueil, Insertion, Données et Affichage ainsi qu'un onglet Outils contextuels. Laissez-nous Passez-les ensuite en revue.

L'onglet Accueil comprend le mode d'affichage, le presse-papiers, le format, la mise en page et les contrôles de bordure, comme indiqué dans la capture d'écran suivante.

Fig. 4 – Onglet Accueil du concepteur autonome

L'onglet Insertion est l'endroit où les composants peuvent être insérés dans le rapport. L'onglet est divisé en groupes suivants et la capture d'écran qui l'accompagne.

• Tableaux
• Graphiques
• Cartes
• Rapport
• Eléments de rapport

Fig. 5 – Onglet Insertion du Concepteur autonome

L'onglet Données permet au concepteur d'insérer un composant de données. Les composants de données disponibles sont illustrés dans la capture d'écran suivante.

Fig. 6 – Onglet de données du concepteur autonome [19659007] L'onglet Affichage permet au concepteur de basculer entre les volets d'affichage de l'application. La capture d'écran suivante s'affiche chacun comme étant activé.

Fig. 7 – Onglet Vue du concepteur autonome [19659007] L'onglet Outils apparaît en fonction de la sélection actuelle et fournit les outils les plus utilisés pour l'élément de rapport sélectionné. Il peut être vu sur la capture d'écran ci-dessous lorsque le graphique est sélectionné et un nouvel onglet vert intitulé " Outils graphiques »apparaît à la fin du menu de l'onglet.

Fig. 8 – Onglet Outils contextuels du concepteur autonome

Le processus principal d'ajout de composants dans le Concepteur de rapports autonome consiste à utiliser chaque onglet décrit ci-dessus, à sélectionner un élément et à le placer directement dans l'aire de conception. Le concepteur peut ensuite faire glisser et déposer le composant et utiliser le Explorateur de rapports pour modifier ses propriétés.

Interface utilisateur de l'explorateur de rapports du concepteur autonome

L'explorateur de rapports fournit une vue hiérarchique de chaque composant du rapport. Notez l'arborescence dans la capture d'écran suivante.

Fig. 9 – L'interface utilisateur de l'explorateur de rapports de Standalone Designer [19659007] L'explorateur de rapports est un excellent outil pour sélectionner des composants dans de grands rapports complexes. En outre, l'interface utilisateur se met à jour de manière contextuelle. Par exemple, lors de la sélection d'un élément dans l'aire de conception, l'élément sera mis en surbrillance dans l'explorateur de rapports et l'explorateur de propriétés se mettra à jour en conséquence. .

Interface utilisateur de l'explorateur de propriétés du concepteur autonome

L'explorateur de propriétés est l'élément le plus contextuel du concepteur. Comme indiqué précédemment et indiqué dans la figure suivante, lorsque les éléments sont sélectionnés via l'aire de conception ou via l'explorateur de rapports, l'explorateur de propriétés s'adapte également. Cependant, ceci est également utilisé pour créer des liaisons d'expression, des filtres et / ou des règles de style, entre autres, si le composant le prend en charge. De plus, lors de la sélection des composants qui fournissent un aperçu en direct mettront également à jour leur représentation au moment de la conception lorsque leurs propriétés sont modifiées via la grille de propriétés.

Fig. 10 – L'interface utilisateur de l'explorateur de propriétés du concepteur autonome

Interface utilisateur de l'explorateur de données du concepteur autonome

L'explorateur de données décrit la source de données sélectionnée. Il s'agit plutôt de la source de données disponible pour le composant. Cela signifie la source de données du rapport ou la source de données sélectionnée. Pour ajouter un champ de données dans un élément de données de rapport, le champ peut être sélectionné dans l'explorateur de données, glissé puis déposé sur l'élément de rapport.

Fig. 11 – L'interface de l'explorateur de données de Standalone Designer

Interface utilisateur de l'explorateur de groupes du concepteur autonome

Chaque composant d'élément de données, rapport, tableau / tableau croisé / liste, graphique et mappage du rapport peut utiliser des groupes. Ceux-ci sont affichés dans l'explorateur de groupes. Les groupes sont des ensembles de données nommés qui sont liés à un élément de données. La capture d'écran suivante illustre l'emplacement de l'explorateur de groupes par rapport à l'ensemble de l'interface utilisateur.

Fig. 12 – L'interface utilisateur de l'explorateur de groupe

Aperçu de la section précédente l'interface utilisateur avec le Concepteur de rapports autonome. L'autre concepteur de bureau est le Concepteur Visual Studio. Passons en revue ensuite.

L'interface utilisateur du Concepteur Visual Studio

Les éléments de l'interface utilisateur du concepteur Visual Studio et du Concepteur de rapports autonome partagent les mêmes éléments de l'interface utilisateur. Par exemple, chacun possède l'explorateur de groupes, l'explorateur de données, etc. La différence réside dans le processus d'accès et d'ajout de composants à l'aire de conception. Dans la section suivante, nous examinerons l'accès aux mêmes sections et l'ajout de composants à l'aire de conception. Commençons par créer des rapports.

Création de rapports dans Visual Studio Designer

Dans Visual Studio, les rapports sont créés à l'aide des modèles de projet et d'élément de rapport de la bibliothèque de classes de rapports. Le projet est un bibliothèque de classes et le rapport est une définition de type de classe par opposition à une définition XML dans le Concepteur de rapports autonome.

Commencez par créer un projet Report Library via l'assistant d'ajout de nouveau projet dans Visual Studio. [19659007]

Fig. 14 – The Visual Studio Designer Ajouter un nouveau projet

Ensuite, ajoutez une nouvelle définition de rapport via l'assistant d'ajout d'un nouvel élément dans Visual Studio.

Fig. 15 – Le concepteur Visual Studio Ajouter un nouvel élément de rapport

Interface utilisateur de la surface de conception de Visual Studio Designer

Le concepteur de Visual Studio a une surface de conception comme les autres concepteurs. Il comprend un mode d'affichage permettant de prévisualiser le rapport de différentes manières.

Fig. 16 – La surface de conception de Visual Studio Designer [19659040] Boîte à outils de Visual Studio Designer

La boîte à outils de Visual Studio permet au concepteur de sélectionner les composants du rapport. Cela inclut tous les composants de rapport disponibles.

Fig. 17 – La boîte à outils Visual Studio Designer

Visuel Éditeurs de vue Studio Designer

Les éditeurs de vue incluent l'Explorateur de rapports, l'Explorateur de propriétés, l'Explorateur de données et l'Explorateur de groupes. Ils offrent les mêmes fonctionnalités que le Concepteur de rapports autonome, sauf que leur ouverture est légèrement différente.

Pour afficher eux, cliquez avec le bouton droit n'importe où dans l'aire de conception, sélectionnez la vue, puis sélectionnez l'éditeur approprié. Ceci est décrit dans la capture d'écran suivante.

Fig. 18 – Les éditeurs de vues Visual Studio Designer [19659040] Explorateur de propriétés de Visual Studio

L'explorateur de propriétés de Visual Studio fonctionne de manière contextuelle comme avec les autres concepteurs. Il s'agit de la fenêtre Propriétés de Visual Studio et lorsque certains composants sont sélectionnés, il s'adapte à la sélection.

Fig. 19 – Explorateur de propriétés de Visual Studio Designer

Ceci conclut les éléments qui composent les concepteurs de bureau. Il devrait afficher les différents éléments et ce qu'ils font. De plus, il devrait articuler les différences mineures entre les deux interfaces. La section suivante passera en revue les outils disponibles.

Outils disponibles dans les concepteurs de bureau

Pour vous aider à concevoir des rapports, plusieurs outils sont inclus qui simplifient et simplifient la conception de rapports. Il s'agit de nos Assistants de rapport, Assistants de source de données et Modes d'affichage. Passons en revue les suivants.

Les Assistants de rapport [19659039] Nos assistants de rapport permettent aux concepteurs de créer rapidement des rapports communs avec facilité. La plupart des rapports courants sont le rapport de bande, le rapport d'étiquette, le rapport de facture et le catalogue de produits. Voyons comment y accéder b ci-dessous pour chaque concepteur de bureau.

Assistants de rapport du Concepteur de rapports autonomes

Dans le Concepteur de rapports autonome, sélectionnez le menu Fichier, puis l'onglet Nouveau comme illustré dans la capture d'écran suivante.

Fig. 20 – Assistants de rapports du Concepteur de rapports autonomes

] Assistants de rapport de Visual Studio Designer

Dans Visual Studio Designer, utilisez la boîte de dialogue Ajouter un nouvel élément et sélectionnez le nouveau modèle d'Assistant de rapport comme indiqué dans les captures d'écran ci-dessous.

Fig. 21 – Assistants Ajout de nouveau rapport de Visual Studio Designer

Fig. 21 – Assistants d'ajout de nouveau rapport de Visual Studio Designer

Les assistants DataSource

Pour certains, la connexion aux données est une tâche ardue. Les assistants de source de données guideront le concepteur dans la création d'une source de données pour les sources de données les plus courantes. Il existe de nombreuses sources de données courantes. Ensuite, nous examinera comment démarrer les assistants pour chaque concepteur de bureau.

Assistants DataSource du concepteur de rapports autonomes

Dans le concepteur de rapports autonome, l'onglet de données affiche chaque source de données. Sélectionnez-en une et cliquez dans le concepteur de rapports pour démarrer l'assistant.

Fig. 22 – Assistants de sources de données de Report Designer autonomes

Assistants de sources de données de Visual Studio Designer

Visual Studio Designer utilise une approche similaire pour accéder aux sources de données. Sélectionnez-les dans la boîte à outils, puis sélectionnez-les dans le Concepteur de rapports. Une fonctionnalité intéressante avec les assistants est que le processus est enchaîné. Par exemple, si vous démarrez un Assistant de création de rapports qui créerait un graphique ou une table, il commencerait initialement par l'Assistant DataSource afin que vous vous connectiez aux données, puis que vous continuiez avec l'Assistant Graphique / Table qui utilisera les données que vous venez de configurer .

Fig. 23 – Assistants de source de données Visual Studio Designer

Modes d'affichage

Les modes d'affichage sont différentes façons de visualiser la conception du rapport. Il peut s'agir de la vue Concepteur et de la vue Aperçu. La vue Concepteur fournit un aperçu de ce que vous voyez est ce que vous obtenez et l'aperçu fournit une vue du rapport rendu.

Modes d'affichage du Concepteur de rapports autonome

Le Concepteur de rapports autonome utilise un bouton bascule pour activer l'aperçu ou la conception. De plus, il peut afficher un aperçu des rapports à l'aide de l'aperçu HTML5 lorsqu'il est connecté à un serveur de rapports. Cela permet

Fig. 24 – Bouton d'affichage du concepteur de rapports autonome

Onglets d'affichage du Concepteur de rapports Visual Studio

Le Concepteur de rapports Visual Studio utilise des onglets et ils se trouvent dans l'aire de conception. Les modes d'affichage de Visual Studio Designer ajoutent également la vue HTML.

Nous avons passé en revue les méthodologies utilisées, les éléments de l'interface utilisateur et les différents outils disponibles pour aider les concepteurs dans leur flux de travail. Ce sont les fonctionnalités de base des concepteurs, cependant, il y a des fonctionnalités plus avancées qui devraient également être revues.

Concepts avancés dans les concepteurs de bureau

Jusqu'à présent, nous avons discuté de l'utilisation de base dans nos concepteurs de bureau. Comme pour tout logiciel, il existe des fonctionnalités plus avancées. Cela inclut des concepts tels que les modèles, la configuration, les extensions et un ajout plus récent. Prise en charge de .NET Core. Commençons par les modèles du concepteur de rapports autonome.

Standalone Report Designer Te mplates

Les modèles de rapport sont un outil puissant qui peut être utilisé pour créer une série de rapports standardisés. Les éléments tels que les en-têtes, les pieds de page et les logos peuvent être identiques dans les rapports. Pour créer un modèle de rapport, utilisez le menu Fichier et sélectionnez Exporter le modèle comme indiqué dans la capture d'écran suivante.

Fig. 26 – Modèle d'exportation du concepteur de rapports autonome

Configuration du concepteur de rapports autonome

Il existe deux zones de configuration dans le concepteur de rapports autonome. Il s'agit du niveau utilisateur , mieux connu sous le nom d'options, et au niveau de l'application. Accéder aux options est très simple.

Options

Les options sont disponibles dans le menu Fichier sous forme d'onglet séparé. Il comprend une langue par défaut, un répertoire de travail par défaut et des données connexions. Les options sont explicites, à l'exception de la liste déroulante des langues par défaut. Les langues disponibles dans la liste déroulante de la langue dépendent des fichiers de ressources disponibles. Cette option force le concepteur à charger la langue souhaitée R ressources eport Designer. La capture d'écran suivante illustre les options.

Fig. 27 – Concepteur de rapports autonome Options

Configuration de l'application

La ​​configuration de l'application est disponible dans le dossier d'installation par défaut adjacent à l'exécutable de l'application. Ceci est illustré dans la capture d'écran suivante.

Fig. 28 – Dossier d'installation par défaut du Concepteur de rapports autonome

Voici un exemple de configuration comprenant plusieurs sections importantes. Il s'agit de la chaîne de connexion, du répertoire de travail par défaut, des références d'assembly, d'un écouteur de trace et d'un DbProvider supplémentaire.

 <?  xml   version   =  "1.0" ?>   
   < configuration >   
    < configSections >    
    < section   name  =  "Telerik.Reporting"   type  =  "Telerik.Reporting.Configuration.ReportingConfigurationSection, Telerik.Reporting"   allowLocation  =  "true"   allowDefinition  =  "Partout" /    
    < section   nom  =  "Telerik.ReportDesigner"   type  = [19659180] "Telerik.ReportDesigner.Configuration.Rep ortDesignerConfigurationSection, Telerik.ReportDesigner.Configuration "  allowLocation  = " true "  allowDefinition  = " Everywhere " />   
    </  configSections >    
   
   [19659186] < démarrage >    
    < supportedRuntime   version  =  "v4 .0 "  sku  = ". NETFramework, Version = v4.0 " />    
    </  démarrage >    
   
    < runtime >    
    < assemblyBinding   xmlns [19659181] =  "urn: schemas-microsoft-com: asm.v1" >    
    <! -    
        
    ->    
    < dependAssembly >    
          
    < assemblyIdentity   name  =  "Telerik.Reporting" [19659178] culture  =  "neutre"   publicKeyToken  =  "a9d7983dfcc261be"  />    
   [19659267] < bindingRedirect   oldVersion  =  "0.0.0.0-14.2.20.1021"   newVersio n  =  "14.2.20.1021"  />    
    </  dependAssembly >    
    </  assemblyBinding >    
   [19659186] </  runtime >    
   
    < connectionStrings >    
    < add   name  =  "Telerik.Reporting.Examples.CSharp.Properties.Settings. TelerikConnectionString "  connectionString  = " Data Source = (localdb)  mssqllocaldb; Initial Catalog = AdventureWorks; Integrated Security = SSPI "  providerName  = " System.Data.SqlClient "  />    
    </  connectionStrings >    
   
    < Telerik.Reigner.Reigner   DefaultWorkingDir  =  "Exemples" >    
    </  Telerik.ReportDesigner  >    
   
          [19659007]    < Telerik.Reporting >    
    < AssemblyReferences [1965118] ]>    
    < add   name  =  "DataLibrary"   />    
    </  AssemblyReferences >    
    </  Telerik.Reporting >    
   
          
    <! -    
    < system.diagnostics >    
    <  trace   autoflush  =  "true"   indentsize  =  "4" >    
    < auditeurs >    
    < add   name  =  "myListener"   type  =  "System.Diagnostics.TextWriterTraceListener"   initializeData  = "C:TempTelerik.ReportDesigner.log" />
                <remove name="Default" />
            </listeners>
        </trace>
    </system.diagnostics>
    -->
 
  <system.data>
    <DbProviderFactories>
      <remove invariant[19659181]="System.Data.SQLite" />
      <add name="SQLite Data Provider" invariant="System.Data.SQLite" description=".NET Framework Data Provider for SQLite" type="System.Data.SQLite.SQLiteFactory, System.Data.SQLite, Version=1.0.112.0, Culture=neutral, PublicKeyToken=db937bc2d44ff139" />
    </DbProviderFactories>
  </system.data>
</configuration>

The Standalone Designer Connection String Section

The connection string section lists data connections available to the application. These will be shown when using the data wizards.

The Standalone Designer Default Working Directory Section

The default working directory is the location that is opened when an end user selects open from the file menu.

The Standalone Designer Assembly References Section

The assembly references section is used to extend the designer. More specifically, when using the ObjectDataSource the class library that it is bound to is referenced here. Additionally, if a class library contains many custom functions it would be referenced here as well.

The Standalone Designer Trace Listener Section

At times, there will be a need to debug custom assemblies used in the application and a Trace Listener is a .NET capability that is also available in the Standalone Report Designer.

The Standalone Designer DbProvider Section

When adding new database providers to the Standalone Report Designer, the DbProvider section is used. The previous example shows SQLite.

The above configuration sections enable the Standalone Report Designer to have the same capabilities as the Visual Studio Designer. Because of the designer application the designers require different configuration. Let us review the Visual Studio Designer configuration next.

Visual Studio Designer Configuration

The Visual Studio Designer requires less configuration because it is closer to the framework than the Standalone Report Designer. When using the Visual Studio Designer, it is a class library which uses an app.config for configuration settings and the Visual Studio environment which has a separate configuration, the devenv.exe.config. Let us review configuration for each section next.

The Visual Studio Designer Connection String Section

This is done in the app.config when using shared connections. It will also cover adding a new DbFactory since Visual Studio includes many different connection capabilities.

The Visual Studio Designer Assembly References Section

Since the report is in a class library accessing other class libraries is as simple as adding a project reference. An example of this could be a shared configuration class library that is used between the Reporting Class Library and the hosting application.

The Visual Studio Designer Trace Listener Section

For adding the TraceListener to troubleshoot the reporting engine, use the Visual Studio environment configuration. It is important to understand that for the hosting application, the TraceListener would be in the app.config. The location of the 2019 Visual Studio Environment Configuration is illustrated in the following screenshot.

Fig. 29 – Visual Studio Designer devenv Configruation Folder

The above sections are relevant to both designers and handled differently as described. The other sections missing in the Visual Studio Designer are not necessary and do not require additional configuration. The next advanced concept is .NET Core Support.

.NET Core Support

It is important to understand which report designers support .NET Core. The main issue is reports built in the Visual Studio designer.

Using Reports Designed in the Visual Studio Designer

At this time, the best approach for using reports that were built in the Visual Studio designer is to convert them to .trdx/.trdp definition files. However, we do have a temporary workaround for achieving design-time support. if the goal is to programmatically generate reports and there is no need for design-time support, then the class report could be used.

This wraps up some important information about advanced topics in the desktop designers. We reviewed the various configuration options in both the Standalone Report Designer and the Visual Studio Designer as well as which designer supports .NET Core. Next is a brief overview of using reports across the designers.

Using Reports Across Designers

Since we have several designers it may be confusing which report designer should be used and with what designer. Currently, we are focusing on the declarative (.trdp/.trdx) definition because it is the most flexible across our report viewer hosting applications. However, we still support and find acceptable uses of the Report Class definition. Quickly, let us review which designer supports each.

The declarative definition is built in the Standalone Report Designer and the Web Report Designer. This provides the most flexibility for a report designer. It enables designing reports on the desktop and the web.

The C#/VB.NET Report Class definitions can only be used with Visual Studio. Additionally, at the current time, design-time support is only supported with the .NET Framework as .NET Core support is coming. With these different design definitions, it is possible to use them across the different designers through import.

Importing Reports Created with the Standalone Report Designer

For the case of importing reports designed using the declarative designers into the Visual Studio Designer, the Visual Studio Designer includes an import report wizard which can be used to convert declarative definitions into a Report Class definition. For details on this see the documentation article, How to import reports created with the Standalone Report Designer.

Importing Reports Created with Visual Studio

In the case of importing reports designed using the Visual Studio Report Designer into the Standalone Report Designer or the Web Report Designer, the steps are straightforward with the exception of when using an external assembly for an ObjectDataSource.

For a thorough article that describes How to Import Reports Created with the Visual Studio Report Designer refer to the documentation. However, in the case of external assemblies, add the assemblies to the Standalone Report Configuration like in the Extending the Standalone Report Designer section.

Conclusion

This concludes the Report Designer series. In this post we reviewed designing reports by discussing methodologies used, UI elements and available tools. Next, we review the advanced concepts through configurations in the desktop designers. Finally, we review working across the various designers.

I hope that you enjoyed a more detailed review our desktop designers. For simplicity, I tried to keep the format of the last two posts similar. Overall, I hope that everyone gains a greater understanding of all our designer tooling. If you ever have any questions, I’m always happy to help.

Want to Try Telerik Reporting?

Telerik Reporting is a complete, easy-to-use, and powerful .NET embedded reporting tool for web and desktop applications that support: ASP.NET Core, Blazor, ASP.NET MVC, ASP.NET AJAX, HTML5/JS, Angular, React,Vue, WPF, WinForms. Also available as a part of our Telerik DevCraft Complete bundleReporting allows you to create, style, view, and export rich, interactive, and reusable reports to attractively present analytical and any business data. Add reports to any business application through report viewer controls. Export the ready reports in more than 15 formats. Download a FREE trial today.

Try Telerik Reporting