You are here: Business Rules > Attached Rules > MaintainSuspense

MaintainSuspense

Description

The MaintainSuspense business rule will allow suspense field values to be changed and accounting generated through a collection of multiple suspense tickets. This rule is attached to a transaction and must be listed in TransactionBusinessRulePacket.s

MaintainSuspense Atttribute/Element Table
Element/Tag	Definition	Attribute	Element/Attribute Value and Description
<MaintainSuspense>	The opening and closing elements of this business rule.
<Tests>	Optional The opening and closing elements holding one or more conditions that allow the rest of the rule to execute.
<Test>	Required, Repeatable Designates a condition.		A conditional expression that must evaluate to a true or false value
<Test>	Required, Repeatable Designates a condition.	TYPE	Required Expression
<SuspenseArrays>	Required Identifies multiple sections of suspense updates.
<SuspenseArray>	Required, Repeatable Identifies a section of suspense updates.		Array Name of the Math Variable that Holds an Array of SuspenseGUIDS
<SuspenseArray>		NAME	Required Identifies the suspense records that may be affected by execution of this rule. A math variable that contains an array of suspense GUIDs.
<GenerateAccounting>	Optional Designates a section of the rule to allow accounting to be updated.
<SuspenseTestCollection>	Required Identifies the collection used to generate accounting. Entries with a value of “True” will generate accounting.		A math variable of type collection. The keys are suspense guids. These guids must be present in the <SuspenseArray>. The values are text values of either “True” or “False”.
<CopyToSuspenseFields>	Optional Designates a section of the rule where field updates are identified.
<Fields>	Required The opening and closing elements that associates the fields and their updated values.
<Field>	Required, Repeatable This element designates a suspense field definition block.
<FromCollection>	Required Identifies the collection containing the suspense identities and their new values.		A math variable of type collection. The keys are suspense guids. The guids must be present in the <SuspenseArray>. The values are the updated data appropriate for the field identified in the <To> element.
<To>	Required Target Suspense Field Name		The literal name of the field that will update.

XML Example

<MaintainSuspense>

<Tests>

<Test TYPE="Expression">1=1</Test>

</Tests>

<SuspenseArrays>

<SuspenseArray NAME="SuspenseGuidArray">

<GenerateAccounting>

<SuspenseTestCollection>SuspenseTestCollection </SuspenseTestCollection>

</GenerateAccounting>

<CopyToSuspenseFields>

<Fields>

<Field>

<FromCollection> SuspenseSourceValueCollection</FromCollection>

<To>SuspenseTargetField</To>

</Field>

</Fields>

</CopyToSuspenseFields>

</SuspenseArray>

</SuspenseArrays>

</MaintainSuspense>

XML Schema

<MaintainSuspense>

<Tests>

<Test TYPE="Expression">[conditional expression]</Test>

<Test TYPE="Expression">. . .</Test>

. . .

</Tests>

<SuspenseArrays>

<SuspenseArray NAME="[math variable]">

<GenerateAccounting>

<SuspenseTestCollection>[math variable]</SuspenseTestCollection>

</GenerateAccounting>

<CopyToSuspenseFields>

<Fields>

<Field>

<FromCollection>[math variable]</FromCollection>

<To>[math variable]</To>

</Field>

<Field>

. . .

</Field>

. . .

</Fields>

</CopyToSuspenseFields>

</SuspenseArray>

<SuspenseArray>

. . .

</SuspenseArray>

. . .

</SuspenseArrays>

</MaintainSuspense>