Skip to content

Commit

Permalink
Added new kb article convert-cs-reports-to-trdp-telerik-reporting (#1535
Browse files Browse the repository at this point in the history
)

* Added new kb article convert-cs-reports-to-trdp-telerik-reporting

* Converting .cs Reports to .trdp Format in Telerik Reporting

* version

* Update convert-cs-reports-to-trdp-telerik-reporting.md

---------

Co-authored-by: KB Bot <[email protected]>
Co-authored-by: Desislava Yordanova <[email protected]>
Co-authored-by: Todor Arabadzhiev <[email protected]>
  • Loading branch information
4 people authored Nov 13, 2024
1 parent 54b0b4d commit 42741c6
Show file tree
Hide file tree
Showing 10 changed files with 69 additions and 0 deletions.
69 changes: 69 additions & 0 deletions knowledge-base/convert-cs-reports-to-trdp-telerik-reporting.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
---
title: Converting .cs Reports to .trdp Format in Telerik Reporting
description: Learn how to transition from .cs report files to the .trdp format in Telerik Reporting, enabling easier report management and distribution.
type: how-to
page_title: How to Convert CSharp Report Files to TRDP Format in Telerik Reporting
slug: convert-cs-reports-to-trdp-telerik-reporting
tags: reporting, convert, import, trdp, conversion
res_type: kb
ticketid: 1669949
---

## Environment

| Version | Product | Author |
| --- | --- | ---- |
| 18.3.24.1112+| Telerik Reporting|[Desislava Yordanova](https://www.telerik.com/blogs/author/desislava-yordanova)|

## Description

This tutorial shows how to convert types inheriting the base class [Telerik.Reporting.Report](/api/telerik.reporting.report) created with the Visual Studio Report Designer to `.trdp` format for various reasons, such as ease of use or distribution. This KB article also answers the following questions:
- How can I manage .cs reports in the Standalone Report Designer?
- Is it possible to convert code-based reports to the TRDP format?
- What steps should I follow to transition from .cs report files to .trdp in Telerik Reporting?

## Solution

Let's start with a Class library project that contains the reports:

![Class Library with Reports](images/reports-class-library.png)

The project targets .NET Framework 4.6.2 or higher:

![Target Framework](images/target-framework.png)

>note For projects targeting .NET, use the Standalone Report Designer for .NET.
To convert a `.cs` report to a `.trdp` report, use the [Standalone Report Designer]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/standalone-report-designer/overview%}). This tool allows for importing `.dll` files produced from projects containing types inheriting `Telerik.Reporting.Report`, facilitating the conversion process.

### Steps for Conversion

1. **Compile the Project**: Ensure your project containing the `.cs` report files is compiled successfully, generating a `.dll` file that includes the Report types.
1. Copy the produced dll (e.g. ProductCatalogLibrary.dll) and paste it next to the `exe` of the appropriate report designer considering the Target framework of the project:

![Same Folder](images/same-folder.png)

1. **Open Standalone Report Designer**: Launch the Telerik [Standalone Report Designer]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/standalone-report-designer/overview%}).
1. **Add an Assembly Reference** to the Standalone Report Designer: [Extending Report Designer to Recognize Custom Assemblies]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/standalone-report-designer/configuration/extending-report-designer%}).

![Assembly Reference](images/assembly-reference.png)

1. **Import the DLL**: From the Report Designer, select to import reports, and navigate to the `.dll` file produced by your project from the first step above. The Standalone Report Designer will launch the [Import Report Wizard]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/tools/report-wizards/import-report-wizard%}) and will list all reports available in the `.dll` for import. Follow the wizard:

![Start Import Report Wizard](images/select-dll.png)

![Select Reports to Convert](images/select-reports-to-convert.png)

![Output Settings](images/output-settings.png)

![Import Summary](images/import-summary.png)

1. **Save as TRDP**: After successfully importing the `.cs` reports, save them in the `.trdp` format using the Standalone Report Designer's save functionality.

![Converted Report](images/converted-trdp-report.png)

## See Also

- [Standalone Report Designer Overview]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/standalone-report-designer/overview%})
- [How to Import Reports Created with the VS Report Designer]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/standalone-report-designer/how-to-import-reports-created-with-the-vs-report-designer%})
- [Extending Report Designer at a Glance]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/standalone-report-designer/configuration/extending-report-designer%})
Binary file added knowledge-base/images/assembly-reference.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added knowledge-base/images/converted-trdp-report.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added knowledge-base/images/import-summary.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added knowledge-base/images/output-settings.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added knowledge-base/images/reports-class-library.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added knowledge-base/images/same-folder.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added knowledge-base/images/select-dll.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added knowledge-base/images/target-framework.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 42741c6

Please sign in to comment.