SuspenseField Math Variable

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, transaction math and event actions.

You can either use the default value or you can set the value and use SuspenseField to pull the new value from the field.

Important: 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.

Suspense Field Math Variable

SuspenseField Math Variable in Palette Window

For a comprehensive explanation of the characteristics of this math variable, refer to the XML Configuration Guide in the Help menu.

Define the SuspenseField Math Variable

Drag and drop the SuspenseField math variable from the Palette window onto the Events or Math Pane. Enter the following information for the math variable.

  • Type a name in the Name field. This is required.

  • The data types applicable are Activity, Boolean, Date, Decimal, Integer, Map, Object, and Text. This is required.

  • Make sure variable type is defined as SuspenseField. This is required.

  • Select Yes or No from Log field. Default is No. This is an optional field.

  • Select Yes or No to round the value. The number of decimal places to round the value can be entered in the Decimal Places field.

  • Enter a default value to use for the math variable, if one is needed.
  • Enter the name of the suspense field to be returned from the transaction. The following suspense fields are available in transaction math and screen math.

    • SuspenseGUID

    • SuspenseNumber

    • TypeCode

    • StatusCode

    • Amount

    • AttachedAmount

    • CompanyGUID

    • PolicyNumber

    • EffectiveDate

    • EffectiveFromDate

    • EffectiveToDate

    • ClientNumber

    • FirstName

    • LastName

    • AccountNumber

    • BankName

    • BankNumber

    • CheckNumber

    • BatchNumber

    • CurrencyCode

    • All dynamic suspense fields configured for the suspense item.

Check-in the transaction to save the information to the database.