Start of Content Area

Function documentation Condition Editor  Locate the document in its SAP Library structure

Use

You use the condition editor to formulate logical conditions. You can use the condition editor in a range of areas:

Areas of Use for the Condition Editor

Area

Use

Defining Receiver Determinations (Integration Directory)

Used for entering a condition for forwarding a message to one or more receivers

Defining Interface Determinations (Integration Directory)

Used for entering a condition for forwarding a message to multiple inbound interfaces

Designing Integration Processes (ccBPM) (Integration Repository)

Used for entering a condition for processing process steps (see Step Types)

Screen Areas and Features of the Condition Editor

The condition editor comprises the following screen areas.

Screen Areas of the Condition Editor

Screen Area

Features

Upper screen area

Work area for defining a condition (see below).

Central screen area

This area displays a preview of the condition specified in the upper screen area.

Lower screen area

If the element in the message that you want to access is qualified by a namespace, you must give the namespace a prefix. The prefix is then used as an abbreviation of the namespace in XPath expressions.

You assign a prefix to a namespace (in the form of a prefix-namespace-pair) in the table.

To add a new prefix-namespace-pair to the table, choose Insert a Row Below Selection (This graphic is explained in the accompanying text). To delete a prefix-namespace-pair from the table, choose Delete Selected Row (This graphic is explained in the accompanying text).

If you copy an XPath expression from the structure of the message, the corresponding prefix-namespace-pair is created automatically.

Defining a Condition

You define a condition in the upper screen area in the form of a table.

You can do the following:

·        Specify a logical expression in a table line by linking two operands with an operator

·        Combine several table lines to form a complex condition by using the operators AND and OR

Creating a Logical Expression in a Table Line

Within a table line, you can link two operands to each other by using an operator. You specify an expression or a value for the operands, depending on the area of use.

·        If you are using the condition editor to define receiver determinations or interface determinations, you can only use the expression editor to create an expression for the left operand. You must specify a value for the right operand.

Note

Specify an element from the message payload with the expression in the left operand. Specify a fixed value with the expression in the right operand, against which the value of the element will be compared at runtime.

If you are using the condition editor to define an integration process, you can create an expression for the left and right operands by using the expression editor.

You select the relational operator from the dropdown list box in the Op. column.

Available Operators

Icon

Operator

=

Equal

This graphic is explained in the accompanying text

Not equal

This graphic is explained in the accompanying text

Contains Pattern (CP)

You use this operator to query a string with a pattern. You can use the following characters for this:

·        + for any single character

·        * for any string

Example

*mploymenttaxdeclarat+on This graphic is explained in the accompanying textannualemploymenttaxdeclaration.

EX

Exists

You use this operator to check the existence of the expression (in the left operand). This enables you to find out whether a substructure represented by the expression exists.

You can use this operator if you want to check whether a particular element exists in the payload, for example. To do so, enter the element you want to check in the left-hand operand and leave the right-hand operand empty. You can also use the = operand for this check.

Linking Multiple Logical Expressions

The following functions are available for inserting multiple table lines and linking the expressions in these lines to each other logically:

Functions for Linking Multiple Logical Expressions

Icon

Function

This graphic is explained in the accompanying text

Insert Group: Insert Inserts a new line for a new logical expression below the selected line.

The new expression is linked to the expression in the selected row by the OR operator.

This graphic is explained in the accompanying text

Insert Expression: Inserts a new line for a new logical expression below the selected line.

The new logical expression is linked to the expression in the selected line by the AND operator. Expressions that are linked by an AND operator are combined using a parenthesis symbol.

 

 

 

End of Content Area