Skip to content

Convert your Snap report templates (.SNX) to DevExpress Reports (.REPX).

License

Notifications You must be signed in to change notification settings

DevExpress-Examples/snap-convert-snx-to-repx

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Snap – Convert Your SNX Reports to REPX Files

As you may already know, the WinForms Snap control and Snap Report API are now in maintenance support mode. No new features or capabilities are incorporated into these products. We recommend that you use DevExpress Reporting tool to generate, edit, print, and export your business reports/documents.

To help you migrate to DevExpress Reports, we created an application that allows you to convert your SNX report templates to REPX files.

How to Convert Snap Reports to REPX Files

Download and run this application. Select an SNX file you need to convert to REPX and click Convert. The generated report will be displayed within the WinForms End-User Report Designer.

Snap - SNX to REPX Converter

Handle the ConfigureDataConnection event to update connection settings for your data source (if necessary). Refer to the following help topic for details: SqlDataSource.ConfigureDataConnection.

Limitations

Since Snap and DevExpress Reports use different formats and have incompatible feature sets, the conversion process has the following limitations:

  • A Snap document can contain auxiliary controls (such as checkboxes) within formatted text. Since a DevExpress Report does not support this functionality, the converter uses textual representation for Snap content controls. This means that the generated report contains "True" and "False" strings instead of checkboxes.
  • A Snap document can contain multiple sections with different page settings. A DevExpress Report cannot use different page settings in the same report, so only the first section's settings are applied during conversion.
  • In Snap, different data sources can contain calculated fields that have the same name. To avoid potential conflicts in DevExpress Reports, we disabled the ability to add fields with the same name.
  • Snap allows you to create documents with a multi-column layout. DevExpress Report does not support this layout, so the converter creates a single-column report.
  • XRTableCell and XRLabel use expressions and HTML-style markup to build and format content. If these objects have nested controls, markup and expressions are ignored and only nested controls are visible. Snap allows you to place any content within a table cell (including multiple nested table levels). There is no generic solution to automatically convert this content to DevExpress Reports.
  • Detail Snap lists do not have a DataSource property specified. Instead, they use the parent's data source. DevExpress Reports require the DataSource property to be set. Moreover, the DataMember property should contain a full path to the data member (for example, DevExpress Reports use "Products.ProductOrders", while Snap uses "ProductOrders" in this case). You need to correct the DataSource and DataMember properties for each DetailReportBand object after conversion.
  • DevExpress Reports do not differentiate between first/primary/odd/even headers and footers. So, the converter processes only the primary header and footer of a Snap report.
  • Snap allows you to place page fields at any position within formatted text. A DevExpress Report does not support this functionality, so all fields in headers and footers are converted to static values.
  • Static text in a Snap report is converted to markup. Markup with different format settings starts with a new line.

If you encounter an issue while using our converter app, please submit a ticket to our DevExpress Support Center.

About

Convert your Snap report templates (.SNX) to DevExpress Reports (.REPX).

Topics

Resources

License

Stars

Watchers

Forks