Please note : This help page is not for the latest version of Enterprise Architect. The latest help can be found here.
Element Filters
As you specify the output of your report, you might want to include only elements that have specific properties or features, rather than every element encountered. Using the Element Filters tab, you can define which element properties to report on, and which fields and field values. You can also delete the element filters if you no longer want to apply them.
The Element Filters tab is provided in two different ways, as a tab of:
| • | The Generate Documentation dialog, to set filters for a specific instance of a report; the filters are reset when you exit the dialog or select a different template |
| • | The Document Options dialog, to set filters in a template as the default settings to be applied to every report generated using that template; these settings can be overridden by the 'specific instance' settings on the Generate Documentation dialog |
The options and behavior are the same for both dialogs, except that the Document Options dialog provides a facility for importing a previously-defined set of Model Search filters from within your model or from an external file (created by exporting a Model Search from another model).
Access Project Browser package: ( F8 ) > Element Filters, or
Project | Documentation | Document Template Designer: <template> > Content | File | Document Options > Element Filters
Manage Element Filters
Column/Button |
Action |
See also |
||||
|---|---|---|---|---|---|---|
Search In |
Shows the type and name of each element property field to search on. Select the checkbox against a property field to include it in the current search.
|
|
||||
Condition |
Displays the condition of the search parameter. The possible values are Contains, Equal To, Not Equals and One Of.
|
|
||||
Look For |
Displays the search term to perform the conditional search on. This value is specific to the selected field; for example, the value could be a date for DateCreated or a text or numerical value for other fields. The search term can contain multiple values, separated by commas.
|
|||||
Required |
Indicates that the search results must include elements with the search term in that field; these checkboxes are set on the Add Filters dialog. When no Required checkboxes are selected, the fields listed as filters have an OR relationship; that is, if the search term is found in any one of those fields, then the element is displayed. Any field having the Required checkbox ticked overrides fields where the Required checkbox is not ticked.
|
|||||
Element Features - Optional - Required |
Specify whether element features are optional or required; these appear as a new branch underneath the root element term in the Search In column. If you scroll down the Search In column, you might see sub-branches such as Attribute, Change and Custom Property; these are the element features. You can add these features using the Add Filters dialog. Select the:
|
|||||
Add Filter |
Add a new set of parameters to filter the search on.
|
|||||
Edit Filter |
Open the Edit Filters dialog, to change the search parameters.
|
|||||
Remove Filter |
Remove the selected filter from the search.
|
|
Notes
| • | Check that the values you provide in the Look for fields are exactly what is contained in the element data fields to be searched; for example, the test Classes Unit, Integration, System, Acceptance and Scenario are represented by attribute values 1 - 5, not by their respective tab names |
Learn more
Learning Center topics
| • | (Alt+F1) | Reporting | RTF Templates | Filter Elements |
