Creating Element Filters

Creating an Element Filter

1. From the record navigator, click the Add new button. The Element Filter window is displayed.
2. From the Element Filter window, in the Filter Name panel, enter a filter name.
   1. Optionally, specify a Group and Sub Group to sort and categorize your filters.
3. From the Categories panel, select the category or categories to apply the filter.
4. From the Rules panel, based on the selected categories, define the AND/OR condition(s) for the available parameters.
   1. Click Add Condition, a new row appears in the grid.
   2. From the new row, click the Parameter menu and select the desired parameter.
   3. From the new row, click the Operator menu and select the desired comparative action.
   4. From the new row, click the Input Type menu and select the desired method.
   5. From the new row, depending on the selected Input Type, enter text in the Value cell.
   6. Optional - You may continue to add more conditions to the AND/OR statement(s) to further refine the results of the Element Filter.
5. From the Options panel, select any necessary options.
   1. The Options tab allows users to define the default action to the rule. If this is set to anything other than "Select Action" then the action defined will be automatically applied after a double click on the rule within the palette.
6. Click OK.

TIP: You may find yourself creating the same type of element filters with slight differences, use the Copy from Existing feature to quickly add the elections in Categories, Rules, and Options panels from an existing element filter, then modify the categories and conditions to suit the needs of the new element filter.

Overview of the Element Filter window

1. Copy from Existing: duplicates an available Element Filter from the network or on your local computer as the current input. Use this to create similar rules or as a template from an (Embedded Filter).
2. Export Filter: saves the current input into a .EVFilter file.
3. Import Filter: Opens a .EVFilter file.
4. Filter Name panel: Contains the Filter Name, Group, and Sub Group fields used to sort and organize the filters in the dockable Element Filter palette.
5. Categories panel: Used to specify the category or categories the rule sets will run against. When creating the conditions, the available parameters are dependent on the selected categories.
6. Rules panel: Used to create the AND/OR rule sets.
   1. Add And button: Creates a logical AND condition. All AND conditions must be true in order for the ruleset to be considered a match.
   2. Add Or button: Creates a logical OR condition. At least one OR condition must be true in order for the ruleset to be considered a match.
   3. Add Condition button: Creates constraints/rulesets for the Add And/Add Or conditions.
   4. Duplicate button: Copies the selected row in the grid.
   5. Delete button: Removes the selected row in the grid.
   6. Parameter cell: Lists the most common parameters based on the selected Categories. Parameter names not listed, which are unique to selected Categories, may be manually entered.
      1. If only a few parameters, or none, appear in the drop-down, it may be due to multiple categories being selected and the desired parameter may not exist in all categories. To correct this, go back and reduce the number of categories for the rule.  The other categories may be added later. A missing parameter name can be entered manually, but it must be exact. Parameter names are case-sensitive.
      2. If the parameter you are looking for is not available then you might need to create a shared parameter. In some cases, you may need to use the Parameter Sync tool.
   7. Operator cell: Lists comparative actions that may be performed on the condition.
   8. Input Type cell: Lists available methods used to compare the parameter value to that of the Input Type.
   • Constant Value: The criteria is typed in the Value field. For example, if searching for RMC Fittings, consider the "contains" operator, "constant value" input type, and RMC in the value field
   • Prompt for Value: When the Element Filter runs, this option displays a dialog allowing the specified value to be used in the query. Text typed in the Value field is used in the dialog's prompt or in the Revit status bar, depending on the Input Type option
   • Compare to Parameter: Used to match parameter values.
   • Single Element Selection: When the rule is activated, only one element in the model can be selected, then the rule acts on that object. For example, a user may want to select all objects that match the same service type or service abbreviation, therefore the rule would ask the user to select one object and find all matches in the model
   • Multiple Element Selection: To duplicate the old Hide button functionality, the rule must allow the selection of multiple elements. This setting allows users to pick objects on different services and will apply a Hide action on all elements with the same service abbreviation as the objects selected
   1. Value cell: User-defined value dependent on the Input Type.
7. Options panel: contains various options that can be applied when the filter is invoked.
   1. Default Filter Action: When enabled, a standard behavior make be selected and applied when the filter is invoked.
      • Select Action: This is the default action that forces the user to select what action to apply at the time the rule is activated. If Default Filter Action is not selected this will be the action used.
      • Select: Select the elements to run any eVolve or Revit command on the selected objects
      • Isolate: Isolates the elements in the current view
      • Isolate (Temporary): Creates a new temporary view and isolates the elements
      • Show: Shows elements that were previously hidden in the current view
      • Hide: Hides the elements from the current view
      • Make Halftone: Applies halftone to the selected elements
      • Make Transparent: Applies transparency to the selected elements
   2. Tolerance on decimal values: Defines the precision used when working with Revit INTERNAL decimal values (higher value means less tolerance).
   3. Case sensitive conditions: When enabled text searches are case sensitive. Performance Note: This can negatively impact query speed. Only enable if necessary.
   4. Use internal filtering: When enabled, native Revit filtering is bypassed in favor of internal logic. This processing can be much slower and should only be enabled in particular circumstances where Revit filtering does not give intended results which are verifiably correct.
   5. Expansion Options:
      1. Select Contained elements within Assemblies, Model Groups: When enabled, elements within the containers are included within the selection. If not enabled, only the container element itself is selected.
      2. Include part insulation: When enabled, part insulation on matching elements is included within the selection.
      3. Include nested elements: When enabled, nested elements on matching elements is included within the selection.

Relevant Articles

Overview of the eVolve Element Filter

Using Element Filters