SUSPENSEFIELD

The SuspenseField math variable is used to extract the value of a fixed or dynamic suspense field within transaction configuration. This math variable is supported in local screen math, actions and transaction math. It enables transactions to evaluate the suspense information, perform validations, and execute calculations with the details pertaining to the suspense information for the transaction.

  • You can either use a default value or you can set the value and use SuspenseField to pull the new value from the field.
  • Screen math configuration will only have access to the suspense fields for the single suspense item from the activity details of the activity being processed. Suspense multifields are not available using the SUSPENSEFIELD math variable type.
  • Configuring a math variable with a type equal to SUSPENSEFIELD in a transaction that does not use suspense will result in a null pointer exception. As a result the SUSPENSEFIELD math variable should be contained within an IsEmpty check to prevent a system error.
SUSPENSEFIELD: Elements and Attributes
TYPE=SUSPENSEFIELD
Element Attributes Parent Element Description Attribute Value

<MathVariable>

TYPE

  The SUSPENSEFIELD math variable type supports the retrieval of suspense field data in screen and transaction math configuration.

SUSPENSEFIELD

 

CLEARVALUE

 

Optional Element

Value: Yes / No

Default Value: No

Yes: The value of the math variable will be deleted after the execution of all the Attached Rules at the end of activity processing and will not be visible on the Math tab in the Activity details screen.

No: The value of the math variable will be retained after activity processing and will be displayed in the Math tab in the Activity details screen.

XML Example

<Math>
<MathVariables>
<MathVariable VARIABLENAME=”SuspenseAmount” TYPE=”SUSPENSEFIELD” DATATYPE=”DECIMAL” ROUND="2" DEFAULT="0">SuspenseAmount</MathVariable>
</MathVariables>
</Math>