My report failed to run. What should I do next?

If you are directed to this page from an error message in Aconex, you can find the error below and find out what to do next.

 

Report execution failed. Unable to retrieve data from Module

This error is caused by a temporary issue in Aconex, or a special character in your chosen data.

 

Confirm if there's a temporary issue in Aconex

  1. If you ran a standard report (or a custom report that is shared with another project), try and run this same report from other projects
  2. If you ran a custom report, try and export it to XML.
  3. Try running other reports that use the same subject area.
  4. If the above tests fail, then there is a temporary issue with Aconex. This should resolve on its own. Please try again later and if the report still fails, contact us. If the above tests were successful then the issue could be due to unsupported special characters (see below).

 

Find and remove unsupported special characters

  1. Check your data for special characters such as %, #, ~.  You can apply different filters in the report to help you identify which record is causing the failure.
  2. If you ran a standard report or a custom report that is shared with another project, try and run this same report from another project. This will help you identify if the special character belongs to a particular project.
  3. Once you identify the special character, edit the record and remove it. You may need to repeat steps 1-3 to find and remove special characters across multiple records.
  4. If you are unable to edit the record please contact us.

 

Report execution failed. Unable to render the report using the layout selected

This error is caused by:

 

Confirm if there's a temporary issue in Aconex

  1. Try running other reports. You should try and run them in the current project and other projects to verify if the issue affects multiple projects.
  2. If all reports fail after trying the above, then there is a temporary issue with Aconex. This should resolve on its own. Please try again later and if the report still fails, contact us. 

 

Check the layout matches the data model (using the online editor)

  1. If you changed your data model (for example, you added or deleted attributes) then you need to make sure these changes are applied to your layout.
  2. Confirm if any of the charts used in the layout are causing the failure. For each chart, check if the report runs after removing:
    • any attribute incorrectly used as a series, label, or value.

    • the filters applied.

    • any grouping used on table or pivot charts.

  3. Make sure you haven't joined data from multiple main subject areas into an object. Only data from a main subject area and its supporting subject areas should be joined into any object in the layout editor.

 

Check the layout matches the data model (using the offline template builder)

Generate a preview when using the MS Word template.

 

Find and remove invalid characters

  1. Check your data for invalid characters. As an example, sometimes data copied from Excel contains invalid characters. You can apply different filters in the report to help you identify which record is causing the failure.
  2. If you ran a standard report (or a custom report that is shared with another project), try and run this same report from another project. This will help you identify if the character belongs to a particular project.
  3. Once you identify the invalid character, edit the record and remove it. You may need to repeat steps 1-3 to find and remove special characters across multiple records.
  4. If you are unable to edit the record please contact us.

 

Reduce the volume of data requested in the report

If there are no invalid characters, then the report may fail due to the amount of data being requested. Use filters to reduce the amount of data in the report and try again.

 

Help! My report still fails after completing these steps

If you are still unable to run your report, please raise a request with Oracle Support. Include a HAR file, along with screenshots of your data models, layouts, and filters used in the report.