Overview of the Report Manager
The Report Manager allows users to create, modify, import, export, and print reports at a project level.
Tool Palette buttons
- Run Report - used to preview and print reports.
- Export - used to export a report configuration file.
- Import - used to import a report configuration file.
- Create New Report - used to generate a report file.
- Open Report Designer - used to layout/format a new report and/or modify an existing report.
- Name - used to apply a unique label to a report configuration.
- Group - used to assign a report configuration to a category/type.
- Sub Group - used to assign a report configuration to a subset of a group/category.
- Description - used to provide additional information about the report configuration.
- Primary Profile - defines the main collection of parameters used to create the report configuration.
- Report File Path - defines the location of the .repx file.
- Additional Profiles - defines other collection(s) of parameters used to create the report configuration.
- Data Tables - defines Data Tables used to create the report configuration.
- Prompt for Parameters - when checked, a preview of the report is not generated until required parameters, if specified, are supplied.
Record Navigator buttons
- Add - used to add a new row to the grid.
- Delete - used to delete selected row(s).
- Duplicate - used to duplicate selected rows.
- Export Grid - exports the grid as currently displayed to Excel.
- Settings - opens Data Profiles.
- From the Report Manager window, select the desired report(s) and click the Run Reports button.
NOTE: If multiple reports are selected, press the SHIFT key while closing a report to break the Run Report loop.
- From the Preview window, click the Print button.
TIP: clicking the Quick Print button, sends one copy of the report to the default printer.
- From the Print window, select your desired printing preferences, like printer, number of copies, etc, then click the Print button.
The Export feature allows selected reports to be saved to a file.
NOTE: currently, when exporting reports any associated data profiles and/or data tables are not included and must be exported separately.
The Import feature allows exported reports to be saved to a project.
NOTE: currently, when importing reports any associated data profiles and/or data tables are not included and must be imported separately. As a best practice, if a report has additional components like a Data Table, import the additional components first.
- If applicable, from Utilities/Data Tables, import the associated data table.
- From Utilities/Data Profiles, click Import Profile.
- From the Import Profile window, navigate to the required profile(s) for the desired report and click Open.
NOTE: a report may contain multiple profiles, however, each profile must be imported separately.
- If the report contains multiple profiles, repeat step 3, until all required profiles have been imported.
- From Utilities/Report Manager, click Import.
- From the Import window, navigate to the exported Report file (.eVReport) and click Open.
IMPORTANT: Verify the Report File Path is pointing to the current/correct location of the .repx file.
- After the report has been imported, click Apply or OK.
Creating a New Report
Specifying a default report folder
Before creating a new report, a default report folder must be specified.
- From the Report Manager window, click the Browse button in the Default Folder for Reports panel.
- From the Default Folder for Reports window, browse to the desired folder and click OK. The selected folder appears in the Default Folder for Reports panel and a .repx file is created in the specified location.
Creating a report file
Before creating a report, a report file must be created.
- From the Report Manager window, click the Create New Report button.
- From the Create New Report window, select the primary Data Profile for the report from the menu and click OK.
- From the Create New Report window, in the File Name field, specify a name for the report file, and click Save. The Report Designer window opens.
Note: the default name is the same as the select primary profile if not changed.
Creating a report
- From the Report Manager window, in the grid, select a cell from the Click here to add a new row and specify the following:
- Primary Profile
- Report File Path
- Sub Group
- Additional Profiles
- Prompt for Parameters
- Once the row is created and the required and if desired, the optional fields are specified, click Apply or OK.
- From the Report Manager window, in the grid, select the desired report and click Open Report Designer from the tool palette.
IMPORTANT: For more information on the Report Designer window, click the following link.
Miscellaneous Reporting Items
All parameter values sent from Data Profiles are string values regardless of the original type in Revit. From Data Profiles, users may elect to send the display value by checking the Use Display Value checkbox or the internal Revit value by leaving this option unchecked. However, this value is still a string and may pose issues when performing calculations within the report. To help alleviate this issue, a string may be converted to Revit values from the Expression Editor.
Each unit conversion has a "To_Display" and a "To_Value" option and is dependent on how the value is sent from Data Profiles. The To_Display converts the numeric internal Revit value string into the displayed measurement value honoring the project units set for the respective Revit project. The To_Value converts the formatted display value string into the numeric internal Revit value.
After a field is placed on the Design Surface, from the Expression Editor window, go to Functions and click Revit.
Some reports may open and/or run slower than others, there are many causes like the number of fields in the Data Source, parameters running PowerShell scripts, size of the Revit project, etc. However, there are some good practices to keep in mind when initially creating the reports.
The Data Source(Data Profile)
- Only send relevant data. Remove irrelevant categories and parameters from the Data Profile.
- Are PowerShell scripts running? Keep in mind, that each PowerShell script is running on every element that meets the criteria defined in the data profile's element filter. If the report is taking a long time to open, consider splitting up the profile and including the parameters with PowerShell scripts in an additional profile.