Progress® Telerik® Reporting R3 2017

XML Report Definition

The Standalone Report Designer supports trdp, trbp, trdx file formats that contain report and report book definitions serialized in XML.

XML Reports Versions

A report definition file specifies the Telerik Reporting XML namespace for the version of the report definition schema that is used by the Telerik Reporting XML serializer (Standalone Report Designer) to identify the XML content.

Upgrade XML Reports

When you open a report container file created for a previous namespace in the Standalone Report Designer, if the report was created for a previous namespace, the report is upgraded to the current namespace. If you save the upgraded report definition, you have saved the converted report definition file. This is the only way to upgrade a XML report definition. The report definition itself is not upgraded when uploaded on the Report Server.

The previous statements are valid only for reports authored in Standalone Report Designer. The compiled type reports authored in Visual Studio are upgraded with Upgrade Wizard. For more information, see Upgrading Telerik Reporting Projects

Report Definition Containers

The report definitions can be in plain text format or compressed in zip archive:

  • Telerik Report Definiton XML (.trdx) is a plain text file with XML content. It's easier to review the reports definition with simple text editors but all embedded resources like images are encoded with Base64 encoding.

  • Telerik Report Definition Package (.trdp) are compressed in zip - XML report definition and its resources. It's smaller in size and optimized for resources handling.

  • Telerik Report Book Package (.trbp) is compressed in zip archive report book XML definition.

How to: Identify the report definition schema version

The schema version is used by the Standalone Report Designer to identify supported report definitions. The Standalone Report Designer supports the current XML schema version at the time of the designer release and all previous ones. 

  1. Open the report definition:

    • For trdx extension: use an application such as Notepad in which you can view the xml.

    • For trdp and trbp extensions:

      1. Make a backup of the report definition.

      2. Open the report definition with archiving program that supports zip.

        1. Right click the report.

        2. Select Open with... option.

        3. Choose a zip manager. For example you can use the free 7-Zip application.

      3. Use an application such as Notepad in which you can view the xml to open the definition.xml file.

  2. Check the xmlns attribute part of the Report element It should look like this: http://schemas.telerik.com/reporting/2017/3.1. The above xmlns attribute means that that this definition is introduced in 2017 R3 SP1. For more information see the following section

XML Schema Versioning

The XML schema versioning prior 2017 R3 is incremental. To check when specific XML schema version is introduced see the following table:

Schema

Introduced in release

v1

2012 Q1

http://schemas.telerik.com/reporting/2012/2

2012 Q2

http://schemas.telerik.com/reporting/2012/3

2013 Q1 (19 Feb 2013)

http://schemas.telerik.com/reporting/2012/3.1

2013 Q1 (18 Mar 2013)

http://schemas.telerik.com/reporting/2012/3.2

2013 Q1 (16 Apr 2013)

http://schemas.telerik.com/reporting/2012/3.3

2013 Q2

http://schemas.telerik.com/reporting/2012/3.4

2013 Q3

http://schemas.telerik.com/reporting/2012/3.5

2014 Q1

http://schemas.telerik.com/reporting/2012/3.6

2014 Q2

http://schemas.telerik.com/reporting/2012/3.7

2014 Q3

http://schemas.telerik.com/reporting/2012/3.8

2015 Q1

http://schemas.telerik.com/reporting/2012/3.9

2016 Q1

http://schemas.telerik.com/reporting/2012/4.0

2016 R2

http://schemas.telerik.com/reporting/2012/4.1

2016 R3

http://schemas.telerik.com/reporting/2012/4.2

2017 R1

From 2017 R3 we have introduced a new versioning that is coherent with the release cycles. http://schemas.telerik.com/reporting/[year]/[release].[sp]

For example:

  • 2017 R3 - http://schemas.telerik.com/reporting/2017/3.0

  • 2017 R3 SP1 - http://schemas.telerik.com/reporting/2017/3.1

  • 2018 R1 - http://schemas.telerik.com/reporting/2018/1.0

See Also