Autodesk Model Checker Configurator for Revit®

Model Checker Configurator

Model Checker Configurator

The Model Checker Configurator is a stand alone Windows application that allows you to create and edit your own configuration files to use with the Model Checker.

Main Toolbar

The main toolbar has the following commands:

Open:  This will allow you to open an existing configuration file for editing.

New:  A new "empty" configuration file is created, allowing you to create your own checks.

Save:  This saves the current configuration to an xml file, allowing you to open it up at a later time for editing. If the current configuration has not been saved a dialog will appear allowing the user to specify the location at which to save the configuration file.

Save As:  Saves the current configuration to a new location. When Save As is completed successfully, you will now be working on the new file in the Configurator.

Preview:  In order to preview the current configuration as an end user would see it in Revit, the Preview button will open the configuration in a new dialog box that mimics the Model Checker in Revit. This is intended to allow the configuration to be viewed as the end user will see it in Revit in order to test settings, fields, etc.

Export:  Once the configuration is complete, this command should be run to compile the check; this allows you to share the complete check with other workstations or companies. While xml files directly from the configurator may work, this command runs several validation checks on the file and shows errors or warnings that provide feedback on missing or invalid values. It also packages the xml file with the necessary images into a single folder for ease of installation at the client site.

Summary:  This will open up a dialog which gives a summary view of the current settings in the configuration file.

Exit:  Exits the Configurator. If unsaved changes have been made to the configuration the user will be given the opportunity to save or discard changes prior to closing.

Help:  Opens the help file on the BIM Interoperability Tools website.

About:  General information about Model Checker Configurator.

Model Checker Configuration File

At the bottom of the Configurator window, you will find the path to the currently loaded configuration file. If no file has been loaded, this will say **Unsaved Configuration**

General Settings

This tab controls the general information and settings for the current configuration.

Configurator General Settings Tab

Configuration Name:  This is the name of the check that will be displayed to the user in dialog titles, summaries, and reports in the Model Checker when this configuration is used. This field is required.

Dialog Icon:  The icon will be used as the icon placed in the top left corner of all Model Checker windows. Recommended size is 16x16 pixels. This is optional.

Dialog Image:  This image will be placed on the right side of the ribbon in all relevant dialogs. Recommended height for this image is 50 pixels and no wider than 100 pixels. This is optional.

Sample Model:  For locally accessible files, you can enter the path to a sample Revit model to illustrate standards and functionality of the checks. This is optional.

Mandatory / Optional Option:  This section's value determines if checks are allowed to be specified as required or optional in this configuration.

Check Builder

The Check Builder tab is for the creation and modification of the current configuration structure and also creation and editing of individual checks that can be run by the user. There are two sections: Structure and Configuration.

Configurator Check Builder Tab

The structure section is the starting point and allows definition of headers, sections, and checks.

Headings are top level only. The Add Heading button will always add a heading at the top level. This will help organize your checks and the exported reports of the check results.
Sections can be added below headings or as sub-sections of other sections. The Add Section button will add a section below the selected heading or section.
Checks can be added under sections only. The 'Add Check' button will add a check below the selected section.
To reorder or move elements, simply drag and drop them to the new desired location; note that you need to hold down CTRL while dragging a sub-section to move relocate it to the same "level", otherwise it will become a sub-section of whatever section it is dragged onto. To remove items, select them and left-click the trash can button.
In order to view or edit details of a specific item select it in the tree and it's details will be shown in the detail pane.
Clicking the copy icon to the left of a check in the list will duplicate that check in the sun-section.


The detail section allows you to define specific details of a Heading, Section, or Check. For additional help on specific fields, simply mouse over the information popups on the right side of the detail pane.

Configurator Check Builder Tab


When you create a check, you will be prompted to select the ADVANCED INTERFACE or to use the WIZARD to create your check. The ADVANCED INTERFACE is the traditional method of creating checks, and is reommended for those who have created checks before, or if you simply want to modify an existing check. The WIZARD will prompt you with a series of simple questions that will guide you through the creation of a check, with the appropriate configuration and filters.

Check Start Screen

Using the Wizard:  The Wizard has a simple consistent interface, allowing you to go back through the creation process, or even start over from the beginning if necessary.
The first question is what kind of check you want to make, either a General Check or an Element Check (see below). Depending on your selection, you will be given a series of other questions. When the Wizard has enough information from you, you will be asked if you want to finish and name your check, or continue adding to it. Adding a filter, will continue to refine the criteria you have already created. Adding another filter group will create a separate collection of filters that is collected under the same check as before, but has its own criteria.
Once the check is complete and you finish, you can not return to the Wizard. All follow-up work and changes must be done through the Advanced Interface.

Advanced Interface:  This is the traditional interface for the Configurator, and allows you full manual control over every aspect of the creation and editing of your checks.

General Checks:  General Checks are intended as reports that simply report either total counts of elements or lists of elements in the model and show up as 'Reports' in the model checker shell.
There are several built in model checks that show data about a model that can not be retrieved through filters. In order to create a model check based on filters select the 'Custom' type.

Element Checks:  Element Checks look for individual elements that meet a set of "filters" defined in the "Element Filters" section below, and return a pass/fail result and a list of failing elements if appropriate
Setting the "Failure Condition" to "Report Matching Element" will return a list of elements matching the filters criteria.
A setting of "Report Failure When No Elements Are Found" in the "Failure Condition" dropdown causes the check to fail if the filters return nothing.

Filter Order:  To reorder filters, simply use the up and down arrows to the left of each filter row, left-clicking either up or down to organize them in the order you need.

Parameter Filters:  For filters with category set to 'Parameter', the 'Property' value should be the name of the parameter, exactly as it appears in the Revit interface.

User Defined Fields:  By expanding the 'Value' expander for a filter, you can make a field user defined. Filters with user defined values will be presented to the user as fields and the user will be allowed to input their own values and/or save different configurations with different values.

Units:  Expanding the 'Value' exapnder will give you access to the Units dialog boxes. There you can enter a value, select a unit type, and select a unit. Switching units will convert the value from the old unit to the new one.

Room and Space Phasing:  Because Revit rooms do not use Phase Created and Phase Demolished, phase filters will not work for these elements. In order to get the phase of a room you must use a parameter filter.