8.3.12 MultiFieldOperation
The MultiFieldOperation modifier makes it possible to perform an operation using several operands. The parameters from TDFs and SDFs are available for selection, see Figure 184. If the entered value is of the type Amount, then the operator has the behavior described in Section 8.3.12.1. The result from the operation is stored in the Destination Field field.
The mathematical expression to be calculated is defined row by row in the Expression field. A new row may be added using the button marked Insert a new expression row below the selected row. Existing expression rows may be editing using the button marked Edit the selected expression row. Rows may be removed from the expression using the button marked Delete the selected expression row.
Adding a new expression row or editing an existing row brings up a dialog in which the row is defined, see Figure 185. The operations available are found in Table 85.
| Operation. | Add – adds a value to the expression. Subtract – subtracts a value from the expression. Multiply – multiplies the expression by a value. Divide – divides the expression by a value. Integer divide – divides the expression by a value, truncating the answer to the nearest integer. . Modulus – finds the modulus of the expression and a value. Power – raises the expression to the power of a value. |
- Note:
- The order in which the operations are carried out is parentheses, power, multiplication/division/modulus/integer division and addition/subtraction. The power operation is right associative, while the others are left associative.
The Operand may be defined in a number of ways. It may be entered manually, as a floating point number. It may be read from the service defined fields by selecting the Use Field check box. If the indicated field is a value list or map, it is possible to define the index of the value to be read from the list by entering the index number manually, or selecting the Use Field check box and choosing a field from the subsequent drop-down list.
When choosing more than one row of the expression, it is possible to use the parentheses button, 
, to set parentheses around those rows to further define the mathematical expression.
Several rows of the expression may be highlighted simultaneously.
When choosing more than one row of the expression, it is possible to use the parentheses button to set parentheses around those rows, to further define the expression.
Several mathematical functions have been defined, and may be selected using the Add/insert a function button. Selecting this button opens a drop-down menu with several predefined functions. The number of terms in the function is defined when adding the function, and may not be changed without removing the function and adding a new. The functions available are described in Table 86.
| round (number) | Rounds the number to the nearest integer. |
| round (number, precision) | Rounds the number, with the number of digits after the decimal point defined by precision. |
| round (number, precision, mode) | Rounds the number, with the number of digits after the decimal point defined by precision. The different modes which may be chosen are:
|
| truncate (number) | Truncates the number to its integer part. |
| truncate (number, precision) | Truncates the number, with the number of digits after the decimal point defined by precision. |
| BalanceOf (amount) | Selects the numerical part of an amount. |
| BalanceOf (amount, currency) | Separates the numerical part of an amount from the currency. |
Functions may be nested within one another. To nest a function, the expression row highest in the list is selected, and the button selected again. The most recently added function is placed closest to the operand.
To delete a function, the expression row highest in the list must be highlighted. Nested functions are deleted one at a time, starting with the last one added to the expression.
The Resulting Expression field displays the operation defined in the modifier, which also appears in the Selection Tree tab on the left.