MultiFields Business Rule

Description

The MultiFields business rule defines a multifield rule configuration. This configuration defines a set of one or more fields and a number range. The number range allows the user to select the number of fields to display on the screen. Each configured multifields business rule can be referenced by its rule name in MultiFields elements in screen and transaction configurations that use multifields.

MultiFields Business Rule Element/Attribute Table
Element Definition Attribute Element/Attribute Values

<MultiFields>

Required:

The opening and closing tag of the MultiFields rule.

 

 

<MultiField>

Required:

 

 

<Name>

 

Used to define the name of the multifield for Events. This name can be different than Title but must be unique.    

<Title>

Optional element:  

Defines the title of the MultiFields pop-up display window.

 

If this element is omitted in the business rule, the MultiFields window title will be "MultiFields".

<ComboDisplay>

Optional element:  

Defines the display name of the Number of Fields combo box where the user can select the number of multifields to display.

 

 

<Start>

Required:

This specifies the starting value of the Number of Fields combo box that allows the user to select how many multifields to display.

 

Integer 

<End>

Required:

This specifies the ending value of the Number of Fields combo box.

 

Integer 

<Fields>

Optional element: 

If no fields are specified, the Number of Fields combo box in the Multifield section will be empty.

See Fields Element.

 

 

<Events>

 

 

 

 

<Event>

 

Optional conditional logic. All existing Elements and Attributes for Actions/Events are available for use within MultiField tags.

 

 

MultiValueFieldIndex=(starting from 0) This is a built in variable available when the Event processing is in multifields scope.

<Actions>

All existing Elements and Attributes are available for use within MultiField tags. See Actions/Events.

 

<ActionSet>

 

All existing Elements and Attributes are available for use within MultiField tags    

<Condition>

 

Optional conditional logic. All existing Elements and Attributes are available for use within MultiField tags IF

Any expression resulting in a true or false value.

MultiValueFieldIndex=(starting from 0) This is a built in variable available when the Event processing is in multifields scope.

<Action>

 

All existing Elements and Attributes are available for use within MultiField tags ACTIONTYPE

String

$$$MultiValueFieldIndex$$$ This can be used within string. It is a built in variable available when the Event processing is in multifields scope.

XML Sample

<MultiFields>
<MultiField>
<Name>TextTestMF</Name>
<Title>Text Test</Title>
<ComboDisplay>Text Test</ComboDisplay>
<Start>3</Start>
<End>5</End>
<Fields>
<Field>
<Name>TextTest1</Name>
<Display>Text Test 1</Display>
<DataType>Text</DataType>
</Field>
<Field>
<Name>TextTest2</Name>
<Display>Text Test 2</Display>
<DataType>Text</DataType>
</Field>
<Field>
<Name>TextTest3</Name>
<Display>Text Test 3</Display>
<DataType>Text</DataType>
</Field>
<Field>
<Name>TextTest4</Name>
<Display>Text Test 4</Display>
<DataType>Text</DataType>
<Default>Test4</Default>
</Field>
</Fields>
<Events>
<Event TYPE="ONLOAD">
<ActionSet ID="TestTextAction"/>
</Event>
<Event TYPE="ONCHANGE" FIELD="TextTest1">
<ActionSet ID="TestTextAction"/>
</Event>
<Event TYPE="ONSUBMIT">
<ActionSet ID="TestTextAction"/>
</Event>
</Events>
<Actions>
<ActionSet ID="TestTextAction">
<Condition IF="IsEmpty( TextTest1 ) And multiValueFieldIndex=1">
<Action ACTIONTYPE="ERROR">TextTest1 $$$multiValueFieldIndex$$$ cannot be empty.
</Action>
</Condition>
<Condition IF="Not IsEmpty(TextTest1) And TextTest1 = 'Test'">
<Action ACTIONTYPE="ERROR">TextTest1 $$$multiValueFieldIndex$$$ cannot be Test.
</Action>
</Condition>
<Action ACTIONTYPE="ASSIGN" FIELD="TextTest4">'Text4'</Action>
<Action ACTIONTYPE="HIDE" FIELD="TextTest3"/>
<Action ACTIONTYPE="DISABLE" FIELD="TextTest4"/>
</ActionSet>
</Actions>
</MultiField>
</MultiFields>