Please note : This help page is not for the latest version of Enterprise Architect. The latest help can be found here.

Work With Diagram Filters

You can modify the display of diagram components using diagram filters, which you create and use through the Diagram Filters window. This window is dockable, so you can move it around or 'fix' it next to the Diagram View while you activate, deactivate and edit the filters.

Access Diagram | Diagram Filters

Create a filter to be applied to your diagrams

Step

Action

See also

1

Perform one of these actions:

  • On the Diagram Filter toolbar, click on the 'New Filter' icon - the first on the left
  • Right-click on the list panel and select the 'New Filter' option

The 'Create New Diagram Filter' dialog displays.

2

In the 'Enter Filter Name' field, type a name for the filter, then click on the OK button.

The 'Diagram Filter' dialog displays.

3

In the 'Search On' field, either:

  • Use the default value of 'Element' or
  • Click on the drop-down arrow and select 'Connector'

If you select 'Connector', the dialog changes to offer a smaller set of properties. The 'Visible' option enables you to filter out hidden or visible connectors that meet other filter conditions that you set.

4

Scroll through the properties to filter on, and select the checkbox against each property you require.

5

For each property, click on the 'Condition' field and select, from the drop-down list, the comparison condition to be applied.

Consider how the combination of 'Condition - Equal To / Not Equal To' and 'Filter Effect' might affect the results on the diagram.

Diagram Filters

6

For each property, double-click on the 'Value' field and type or select any specific value to filter on.

7

Click on the OK button to save the filter and return to the Diagram Filters window.

Other Operations

Operation

Detail

See also

Edit a Filter

To edit an existing filter on the Diagram Filters window, either:

  • Double-click on the filter name
  • Click on the filter name and select the 'Properties' icon from the toolbar (the second icon from the left), or
  • Right-click on the name and select the 'Properties' option

The 'Diagram Filter' dialog displays; adjust the filtered fields as described above.

Change the Name of the Filter

Right-click on the name and select the 'Change Name' option.

The 'Create New Diagram Filter' dialog displays.

Type over the existing name with the new name, and click on the OK button.

Set Effect of Filters

To set how your filters identify selected items on your diagrams, click on the drop-down arrow of the toolbar 'Filter Effect' field, and select one of these options:

  • Fade - display all items that do not match the filter criteria in a pale version of the diagram background color
  • Gray Scale - display all items that do not match the filter criteria in pale gray
  • Hide - conceal all items that do not match the filter criteria
  • Select - select and highlight (with a hashed line) all those items that do match the filter criteria

If the filter is for elements in the Package Browser or Diagram List, note that the 'Select' filter effect cannot show up in this context.

Enable Filters

To enable a filter so that it takes immediate effect on your diagrams, select the check box against the filter name.

You can select more than one filter at a time, to combine their effects.

Disable/Clear Filters

To disable a filter and clear the effect of the filter on the diagram so that it displays in full, clear the checkbox.

To disable all filters, either:

  • Click on the 'Reload Filters' icon in the toolbar (third option from the left), or
  • Right-click on the list panel and select the 'Reload Filters' option

Toggle between Diagram Filters and Context Filtering

To disable the filters you have defined and simply highlight a selected element and its immediate relatives, right-click on the Diagram Filters window background or the diagram background itself and select the 'Context Filtering' option.

To re-enable the Diagram Filter effects, display the Diagram Filters window or diagram context menus again and deselect the 'Context Filtering' option.

Context Filter a Diagram

Delete a Filter

To remove a filter from the Diagram Filters window, either:

  • Click on the filter name and click on the Delete icon in the toolbar, or
  • Right-click on the filter name and select the 'Delete Filter' option