Contains

See also: Starts with, Ends with

images/download/attachments/201666797/image-2025-4-1_16-12-38-version-1-modificationdate-1743516758847-api-v2.png

The Enthält compare type checks if the text (String) given as the Check value (value configuration on the left) exactly contains the string (String) defined as the Compare value (value configuration on the right).

  • The screenshot above uses static text value resolvers (see Static values) with the texts 'Check value' and 'Compare value' to illustrate the interaction of the components.

NOTE

  • The text comparison is case sensitive.

  • There is no automatic conversion of unsuitable values to text (String). When required, the Input object (type safe) value resolver or a suitable value resolver from the String processing category can be used to convert another data type into a string.

Special cases:

  • The check is considered failed if at least one of the value configurations (Check value, Compare value) does not return a String.

  • Since 'No value' ($null) is also not a String, a check like ($null) Enthält ($null) is considered failed.

  • If the Check value and the Compare value match completely, an Enthält comparison is considered passed.

  • An empty string ("") can be used as a Check value and as a Compare value. A check with "" as a Compare value will always pass if the Check value is a String.

Specific examples:

Check value
(JSON notation)

Compare value
(JSON notation)

Check result

Comments

"123.45"
"123.45"
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/check.svg
 true

Check value Contains the Compare value

"123.45"
"3.4"
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/check.svg
 true

Check value Contains the Compare value

"123.45"
"34"
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/error.svg
 false

Check value Contains no Compare value

""
"3.4"
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/error.svg
 false

Check value Contains no Compare value

123.45
"3.4"
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/error.svg
 false

Check value is not a String

$null
"3.4"
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/error.svg
 false

Check value is not a String

"123.45"
3.4
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/error.svg
 false

Compare value is not a String

"123.45"
$null
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/error.svg
 false

Compare value is not a String

"123.45"
""
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/check.svg
 true

Check value Contains the Compare value

$null
$null
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/error.svg
 false

Check value is not a StringCompare value is not a String

""
""
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/check.svg
 true

Check value Contains the Compare value

Configuration

The value configurations for Check value (left) and Compare value (right) are not optional for the Contains compare type.

Both value configurations must return strings (String) at runtime, otherwise the Entity property rule is considered failed.

Example

Check for a plain text qualifier in a reference attribute of an address

In the context of an 'Address' entity (see Addresses), the value of a reference attribute with the Reference type 'Info' (REF_INFORMATION) is searched for a plain text indicator ('§13a'), which is evaluated as an indication of a certain property of the goods.

Configuration:

In an association criteria, two rules are combined in an AND conjunction as shown on the right:

NOTE◄ When searching for contained text, it should always be considered that the Compare value could be found as part of a longer context by mistake. In the case of the string '§304' searched for here, the recognition is most likely relatively precise. A search for '§30' would also find '§304' by mistake.

images/download/attachments/201666797/image-2025-4-1_16-1-38-version-1-modificationdate-1743516098867-api-v2.png