CopyToClientFields (For Transactions)
This business rule is attached to a transaction to allow one or more MathVariables to be copied from an activity to one or more client fields when the activity to which this rule is attached is processed.
In addition to field values, CopyToClientFields will automatically update the OptionText of combo box and radio button fields.
Note:
- The CopyToClientFields rule cannot be used to update external client information.
- In case, the <From> element does not exist (value is null, blank or zero length) in the AddressScreen for a particular AddressType, then the system will ignore copying that field and will continue with copying the next element.
Element/Tag | Definition | Attribute | Element/Attribute Value and Description |
---|---|---|---|
<CopyToClientFields> |
Required opening and closing tag of the CopyToClientFields rule. Note: CLIENTGUID attribute is optional. |
CLIENTGUID | Optional
attribute: MathVariable This attribute is used to specify the ClientGUID of the client whose records are to be updated. Note: Transaction to which this business rule is attached should contain the MathVariables that capture the ClientGUIDs. |
<Fields> |
Required element:
|
||
<Field> |
Repeatable element: |
If a <From> element is present, then a <To> element should be present. Similarly, a <FromCollection> element must have a <To> element. |
|
<From> |
This element is used to specify the MathVariable or activity field where the data should be copied from. |
Required
element value:
|
|
<To> |
Required element: |
Required
element value:
|
|
<FromCollection> |
Require element: This element is required when no CLIENTGUID attribute has been specified on the opening element. The collection consists of Client GUIDs as the key and data value for the indicated <To> field. |
Required element value: MathVariable of variable type Collection. |
|
<Client> |
Optional, repeatable element: Used to copy data to a particular client or clients. |
CLIENTGUID |
When the CLIENTGUID attribute is used with the <Client> element, CLIENTGUID and POLICYROLES attributes MUST not be used in the <CopyToClientFields> element. |
<Fields> |
See <Fields> element above. |
||
<MultiFields> | Optional, repeatable element: Defines the multifields to be updated/inserted. | ||
Note: The system will validate named "To" fields against the field name in the MultiField rule in the ClientScreen rule for the type code of the specified ClientGUID. |
|||
Required: Specifies the named section of the related entity's Multifield rule. | NAME | Literal name | |
Required: Specifies the total number of instances of multifields for the named section of the related entity's Multifield rule. If NAME is omitted or does not exist in the MultiField rule, all the fields in the MultiField rule will be repeated for "END" number of times. | END | Literal Integer or Integer Math Variable | |
<Field> | Optional, repeatable element: Contains the instructions for the specified "To" field. This element (and sub elements) may be omitted if the default field values are desired. | ||
<FromIndexCollection> | Required: A collection of index/value pairs for the target fields. Indices must be unique integers | Math variable collection of index/values. | |
<To> | Required: The target named field in the entity multifield rule. | Literal field name |
XML Example
<CopyToClientFields CLIENTGUID="ClientGUIDMV">
<Fields>
<Field>
<From>NewFirstNameMV</From>
<To>NewFirstNameField</To>
</Field>
<Field>
<From>NewLastNameMV</FromCollection>
<To>NewLastNameField</To>
</Field>
</Fields>
</CopyToClientFields>
XML Schema
<CopyToClientFields CLIENTGUID="[String]">
<Fields>
<Field>
<From\> <To\>
</Field>
<Field>
<FromCollection\>
<To\>
</Field>
</Fields>
<Multifields>
<Field>
<From></From>
<To></To>
</Field>
</MultiFields>
</CopyToClientFields>