Show TOC

ifWithoutElseLocate this document in the navigation structure

Use

If the if -condition of ifWithoutElse gets the value true , the input value of then is returned as the result. In this way, you can use this function as a filter in target-field mappings.

What Does the Function Return as the Else Value?

To investigate the different cases in which the if condition does not get the value true , we will use the following outbound message:

Figure 1: Outbound Message

In this structure, the e-mail addresses and telephone numbers of one person (root element Person ) can be created within a single element communication that occurs multiple times. The element phoneNumber from the outbound message can have different types. They are saved as an enumeration for the attribute type of the element. The enumeration has the values private , office , and fax . A test instance for the given outbound message might look as follows:

Figure 2: Test Instance

The Else value of ifWithoutElse depends on whether the result of this function is transferred to a target field or to a function. We will now look at both cases by using the outbound message and test instance above. In both cases, only the fax numbers are to be transferred to a target field faxNumber .

Else Value for Target Fields

In the target-field mapping in the table below, the result value of ifWithoutElse is transferred directly to the target field faxNumber .

Figure 3: Else Value for Target Fields

In such cases, you want to either create the target element faxNumber and use phoneNumber as the fax number, or the target element is not to be created at all. Correspondingly, ifWithoutElse creates the value ResultList.SUPPRESS if the if-condition is not satisfied. The second column in the table displays the queue for ifWithoutElse in this target-field mapping with the test instance above: whenever type is not equal to " fax ", ResultList.SUPPRESS is shown in the queue.

Else Value for Functions

Transferring the result value of ifWithoutElse to a standard function with multiple input parameters can have two different effects:

  • ifWithoutElse acts like a filter. If you only require as input parameters those values in the subsequent function for which the if-condition was satisfied when filtering, choose the empty string as the Else value for ifWithoutElse . In this case, the standard function does not interpret the entry as a value and skips it.

  • If the input queues in the standard function are to be synchronized, ifWithoutElse must get the value ResultList.SUPPRESS . In this case, the standard function does not skip the SUPPRESS value.