not (Matcher)

images/download/attachments/201666871/image-2025-4-8_10-24-23-version-1-modificationdate-1744100663059-api-v2.pngSelection results: images/download/attachments/201666871/image-2025-4-8_10-24-45-version-1-modificationdate-1744100685020-api-v2.png

Unlike all other comparison types, the not (Matcher) can only be used in conjunction with one of the others.

Therefore it appears in the context menu for comparison type selection as a category (selected in the screenshot) where the other comparison types are selectable.

If a comparison type is selected from the 'not' submenu, then it is selected in conjunction with the not (Matcher). This reverses the evaluation logic of the selected comparison type.


images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/warning.svg CAUTIONimages/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/warning.svg From the 'not' submenu it is always possible to select a comparison type that differs from the current one. However, any value configurations made for the Compare value will be lost. When changing from Contains to 'not (Contains)' as shown in the screenshot, the value configuration for the Compare value remains unchanged.


The relationship between the selected comparison type and the not (Matcher) becomes clear in the following excerpt from the XML structure:

Object field rule with not(Contains) comparison type
<?xml version="1.0" encoding="UTF-8"?>
<core:EntityPropertyRule xmlns:core="CORESYSTEM">
...
<core:NotMatcher>
<core:ContainsMatcher/>
</core:NotMatcher>
...
</core:EntityPropertyRule>

If in an Entity property rule the not (Matcher) is already used in connection with another comparison type, it can be 'unselected' by selecting the same Matchers from the main level of the context menu.


images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/warning.svg CAUTIONimages/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/warning.svg It is essential to select the same Matchers that is already used in the existing 'negated' configuration when unselecting. Otherwise the possibly existing value configuration for the Compare value will be lost.