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.0206.641

      The following release notes apply to Microvellum build 25.2.0206.641. Item Number Fix An issue was reported regarding item numbers in composite drawings. Users who processed work orders with multiple products reported that the item numbers would ...
    • Microvellum Release Notes | Build 25.2.0204.641

      The following release notes apply to Microvellum build 25.2.0204.641. Toolbox Brand Retirement As part of Microvellum’s ongoing alignment with the values and catalog of INNERGY, and to improve user experience, clarity, and consistency, we have ...
    • MDF Door Profile Guide

      Door Wizard The Door Wizard is a Microvellum feature that enables users to interact with and control the specifics of door related variables, prompts, and available settings. The options available in the door wizard vary depending on the specific ...
    • Microvellum Foundation Library Release Notes | Build 26.0112

      Additions In accordance with Microvellum's new subscription changes, all Face Frame Expansion products and subassemblies, as well as the Range Hood Master product have been added to the full library install and library update zips (now included with ...
    • Toolbox Release Notes | Build 25.2.0114.641

      The following release notes apply to Toolbox build 25.2.0114.641 Processing Center Message Fix Fig. 1: An error message running in the background of the software. An issue was reported within the Processing Center. When processing an order, there ...