Issue: Unhandled Exception when Opening a Custom Report

Issue: Unhandled Exception when Opening a Custom Report

If you have been working on a custom report and after saving it you get an unhandled exception error when you try to reopen it, you probably want to know if there is a way to fix that error.

The answer to that question depends on whether you know the last few operations before saving the report. In other words, do you have a good idea of what broke the report? If you know the cause of the error, you can fix it. Otherwise, the report may be corrupted and unrecoverable.

If you know what operation broke the report, here is the procedure to get access to the report in the Report Designer.

Open the factory database using the Microvellum SQL CE Viewer. Double click on the ReportTemplates table to open it. In the Name field, find the report that throws the exception. In the field named ReportFile for that row, right-click on the cell containing the "ByteArray" data and click "Save File to Disk." In the Save As dialog box, navigate to where you want to save it, give it a name, and an .MRT file extension and click Save.

Open a known good report in the Report Designer (Toolbox or Production). Click the Open button, as shown in the attached screenshot. Navigate to the location you saved the MRT file, select it, and click Open.

This will open the report in the Designer without any dataset connection. What that means on a practical level is that you won't be able to Preview the results of your work after revising the report. You will need to know what action broke the report, undo that action by setting it back to what it was before, or fix it. Then save the report and continue with the procedure below.

Once the MRT file has been repaired, the next step is to import that file back into the factory database. If the Microvellum SQL CE Viewer is not already open, open it, and double click on the table ReportTemplates to open it. In the Name field, again, find the report that throws the exception. In the field named ReportFile for that report, right-click on the cell containing the "ByteArray" data and click "Import File from Disk." Navigate to the location of the MRT you exported above, select it, and click Open.

If the repair was successful, you will now be able to reopen Toolbox or Production and work with the report.

To prevent this from happening, always be sure to check a report for errors before saving it.
    • Related Articles

    • Understanding Custom Formatting in Report Designer

      The articles in this section of the Knowledge Base involve Text Formatting for display in your reports. To learn more about Text Formatting and how to access this section within the Report Designer, see Understanding Text Formatting in the Report ...
    • Issue: Report Unexpectedly Missing Data

      Some Users tell us that infrequently a report may be displayed that is missing data when previewed. There are various possible reasons for this issue, but one cause may be a defective report dataset definition. This article explains a pre-test to ...
    • Overview: Toolbox Report Designer Access

      Microvellum build 15.5.1415 or higher required.   The Microvellum report suite incorporates reports that are designed to be printed from Toolbox, and other reports that are designed to be printed from the operation modules (Production). All reports ...
    • Report Training Tutorial 1: Report Designer Basics

      This is the first of a series of five Reports Training Tutorial videos.  This video presents some basic concepts that will be useful for first-time users of Report Designer.  By the end of this video, you will have some familiarity with the user ...
    • Working in the Sub Reports Editor of Report Designer

      The articles in this section of the Knowledge Base involve working with Sub Reports for display in your reports. To learn more about Sub Reports, and how to access this section within the Report Designer, see Understanding Sub Reports in Report ...
    • Recent Articles

    • Microvellum Release Notes | Build 25.2.0317.641

      The following release notes apply to Microvellum build 25.2.0317.641 Product Prompts UI Overhaul The Microvellum Product Prompts interface has been redesigned to improve efficiency and usability, giving users greater control over multiple features of ...
    • Microvellum Processing Center System Requirements

      This document lists both the minimum and recommended system configuration for operating Microvellum's standalone Processing Center application. For more information about the standalone application, see the Microvellum Processsing Center Application ...
    • Microvellum Release Notes | Patch 25.2.0227.641

      The following release notes apply to Microvellum build 25.2.0227.641 Processing Center Fixes Multiple fixes and updates were applied to the standalone Processing Center application to improve usability. Add New Configuration An update has been ...
    • Microvellum Foundation Library Release Notes | Build 26.0220

      The following release notes apply to the Microvellum Foundation Library build 26.0220. Additions Added DTC Magic Pro and Magic Star Ultra drawer systems. Magic Pro Items added in hardware file 300 and 600 lengths for all drawer heights. Add 60kg ...
    • Microvellum Release Notes | Build 25.2.0223.641

      The following release notes apply to Microvellum build 25.2.0223.641. Add 2D Elevation Tokens to 3D Drawings Fig. 1: The new 2D Elevation setting. A popularly requested feature by the community has been added to the Microvellum software: the checkbox ...