Skip to end of metadata
Go to start of metadata

The filtering described in this section is available with all diagrams and lists. Via the dialog you can add a new filter or edit the current one.

UI reference

  1. The header shows the element type to be filtered.
  2. In the next block, you are asked to choose an attribute to filter by. As shown in the image, you can add several filters with the OR- and AND-connector buttons on the right side.
  3. In addition to that, different attributes can be filtered with individual operators. Therefore, you have the possibility to choose a given value or a (numeric) scope.
  4. For the Information System building block the option "Include Information Systems connected over an Information Flow" is available.
  5. You can also add clauses to filter by attributes of related elements.
  6. In case you want to delete any filter option, click on the "x" button.
  7. "Ok/Apply" will apply the filtering while "Cancel" will undo the current changes and revert to state before the dialog was opened.

Filter by elements

Depending on the diagram type there are one or more element types for which filters can be applied to.

For example:

When filtering in the Information Flow Diagram, the element type to be filtered is always Information System. The Landscape diagram will offer three filtering options, for both axes elements and the content element. The Nested Cluster Diagram offers filters for the outer as well as the inner elements.

Filter by attributes

Depending on the element you have chosen in (1), the field "Choose an attribute" will list specific attributes. These attributes can have specific operations which are described in the following paragraph.

Based on the selected operation, you can enter values, select from options, choose calendar dates or set a numeric range via a silder element.

To remove filtering completely, click the "x" in the top right corner and click "Close".

Operators

According to the type of attribute, different operators are offered. A few are listed below.

  • Enumeration attributes: 
    • "is": After applying this operation, the field "Choose a value" will come up. You can select a value which the current element should have.
    • "starts with"/"contains not"After applying this operation, an additional input field will be shown. The filter is applied after confirmation of your input via pressing Enter.
  • Numeric attributes:
    • "between"/"not between": If you want your elements to have an attribute which only has values in a certain range, you can choose a start and an end value in the value slider. Start and/or end value can also be left empty, if you do not want to set border open.
  • Date attributes: 
    • "between": This operation differs from the operation of the numeric attribute. The range of the attribute is date based. The start and end date can be selected by a calendar which will be shown by clicking on the required field.

Multiple value enumeration attributes support all offered operators. To be in result set, at least one value of the attribute must fulfill the criterion. The filtering logic follows the rule "there exists one, which ..." NOT "all must fulfill ...".

All attribute types have two operators: "arbitrary value", which shows all elements having any value assigned, while "no value" shows all elements without a value assigned.

OR and AND connectors

The combination of multiple filters is possible. Each filter can be deleted by clicking on the "x" right beside of it (5). 

Logically OR-combined attribute filters have a dark gray background while logically AND-combined attributes are combined within a light grayed background.

Include Information Systems connected over an Information Flow

For the Information System building block type the option "Include Information Systems connected over an Information Flow" is available. For an already filtered set of Information Systems (e.g. with help of filtering by attributes or with manual selection) this option adds Information Systems that are connected by an Information Flow to the ones in the result (filtered) set. By default this option is deactivated.

Filter by related elements

Besides filtering by attributes, you can filter by attributes of related elements via choosing one option in the field "Choose a relation". Depending on the element you have chosen in (1), specific related elements will be listed.

After an element has been picked, the option "No Associations" will come up together with the filter block. If you select this option, you will filter the current element (1) by having a no relation to the chosen element type (4).

If you do not select this option, you can specify additional filter clauses. The filtering logic between the original element and the related elements/its attributes is as follows: "There exists one related element, which ...", NOT "all related elements must fulfill ...".

Pitfall

Assume you have an information system that is connected to two information system domains with the names "A" and "B". If you filter "Assigned Information System Domains" where "name is not A", the information system will be in the result set. The reason is, that the information system domain "B" fullfills the criterion, as its name is not "A", and it is connected to the information system.

Filter by Business Mappings

When filtering for related elements, you can choose to filter by Business Mappings if the building block type is part of a Business Mapping. In this case the dialog box will feature some additional options:

By adding the filter for Business Mappings only elements with at least one Business Mapping assigned will be in the result set. You can further refine / change your filtering.

  • (1) "No Associations" on top of the dialog: If checked, only elements with no Business Mapping at all will be in the result set. This is the opposite of the unchecked (default) state immediataly after adding the Business Mapping filter.
  • (2) "Choose an attribute": Attributes directly assigned to the Business Mapping are available for filtering. See above for details how to build your filter clauses.
  • (3) "Connected...": Available for the three 'other' endpoints of the Business Mapping
    "Any": Do not consider this endpoint in any way.
    "No associations": Elements will be in the result set, if they have at least one Business Mapping which has not no association for this endpoint configured.
    "According to attributes": Elements will be in the result set, if they have at least one Business Mapping which has at least one association for this endpoint configured.
    -> (4) "Choose an attribute": Filter elements according to the attribute clauses of this endpoint of the Business Mapping.

As always, the filter logic is as follows: "There exists one business Mapping, which ...", NOT "all Business Mappings of the element must fulfill ...".

Manual selection of items

In addition to filtering by using clauses, you can manually select the items, which should be used as a result set. This selection can be made on "Manual selection" tab of a filter dialog.

  1. "Manual selection" tab
  2. Buttons for quick selection of All/None
  3. Quick search input
  4. List of selectable items

The list of items contains the names of items and checkboxes, which allow to include or exclude the item from the result set. This list contains all items, which fulfill the filter clauses on the Filter tab.

The Quick search allows to filter the items, which are visible in the selection list, but does not affect the current selection. If some item is hidden by the quick search it will still be present in the result set if it has the selection check box checked.

Whenever the filter clauses on the tab Filter are changed, the manual selection of items is reset. This means that all items in the - then changed - list will be selected.

Attribute filtering

Attribute filtering (unlike the usual filtering for element) uses actual attribute values to filter by. It is used in diagrams where we can set attributes separately (e.g. Cluster diagram with attribute set as header or row).

UI reference


  1. The header shows the attribute which values are to be filtered.
  2. In the next block, you are asked to choose an operation to filter and filtering value.
  3. In case you want to delete any filter option, click on the "x" button.
  4. "Close/Apply" will apply the filtering while "Undo" will undo the current changes and revert to state before the dialog was opened.

Filter by attribute

Depending on the attribute you have chosen in diagram (e.g. header in Classic cluster diagram), the field "Operator" will list specific attribute value operations which are already described above.

Based on the selected operation, you can enter values, select from options, choose calendar dates or set a numeric range via a silder element.

To remove filtering completely, click the "x" in the top right corner and click "Close".

Or and And connectors

The combination of multiple filters is possible. Each filter can be deleted by clicking on the "x" right beside of it (3). 

Logically OR-combined attribute filters have a dark gray background while logically AND-combined attributes are combined within a light grayed background.

Manual selection of enumeration values

In addition to filtering by using clauses, you can manually select enumeration values, which should be used as a result set. This selection can be made on "Manual selection" tab of an Attribute Filter dialog.


  1. "Manual selection" tab
  2. Buttons for quick selection of All/None
  3. Quick search filter
  4. List of selectable enumeration values plus "Unspecified" item if elements with unspecified values exist.

The list of enumeration values contains the names of values and checkboxes, which allow to include or exclude them from the result set. This list contains all values, which fulfill the filter clauses on the Attribute Filter tab.

The Quick search allows to filter the values, which are visible in the selection list, but does not affect the current selection. If some value is hidden by the quick search it will still be present in the result set if it has the selection check box checked.

Whenever the filter clauses on the Filter tab are changed, the manual selection of values is reset.


  • No labels