Text comparison condition

The text comparison condition can perform very extensive operations on all string attributes and text attributes.

In the text comparison condition, the attribute with which the specified expression is compared is selected in the Attributes section. The expression can either consist of a normal text or a regular expression.

Configuration:

Property

Description
Logic operation (objects)

If the condition is executed on multiple objects, you can use the Logical operation(Objects) property to determine how the results of the condition (true or false) are linked and evaluated:

  • OR: Condition is true if one of the results or all results are true.

  • AND: Condition is true if all results are true.

  • Exclusive OR: Condition is true if one of the results is true and the rest are false.
Queries

You can create a query here which determines the objects for which the condition is evaluated.

If the condition is to be executed on objects that are referenced in another object, you can create a query here that determines the corresponding objects.
Logic operation (attributes)

Select here the logical operation of the attributes for the evaluation of the condition:

  • OR: The condition is true if one of the attributes or all attributes have the value set or not set, depending on whether the property Value set is enabled or disabled.

  • AND: The condition is true if all attributes have the value set or not set, depending on whether the property Value set is enabled or disabled.

  • Exclusive OR: The condition is true if any of the attributes have the value set or not set, depending on whether the property Value set is enabled or disabled, and all other attributes have the opposite.
Attributes

Reference here the attributes that are to be checked.

Expression

Enter here the expression with which the attribute value is compared.
Consider session language With this property the language for checking the attribute values is observed.

Case sensitive

If the option is enabled, case sensitivity must be considered (not valid for regular expressions).

Regular expression

If the option is enabled, the expression is evaluated as a regular expression.

Compare entire text

If the option is activated, the expression must apply to the entire content of the attribute.

If the option is not enabled, the expression must apply only to parts of the attribute.
Variables

You can activate the enabled attributes of a query and condition in the Variables property so that they can be changed by users at the time of execution.

See also: Chapter Variables.

Example: Searching for objects via a text comparison condition

The system searches for all business processes that have the partial expression 'process' in their name.

For this purpose, a condition filter is created which contains the following:

  • a reference query that searches everything

  • a text comparison condition that searches for all processes with 'process' in their name under the selected folder Business Processes

Configuration:

The text comparison condition is configured as follows:

  • The Regular expression option is enabled.

  • The Compare entire text option is disabled. That is, the searched expression must be only part of the compared attribute.

  • In the Attributes section, the schema attribute Label is defined.

  • The regular expression [A-Za-z]*process is defined in the Expression section. Since the Compare entire text option is not enabled, processes that have 'process' in the middle can also be found. (If the whole text would be compared, only processes ending with 'process' would be found)

Result:

The reference query searches for all processes of the selected object and returns all processes that have 'process' in their name.