CopyToAddressFields
This business rule allows one or more MathVariables to be copied from an activity to one or more Address fields.
In addition to field values, CopyToAddressFields will automatically update the OptionText of combo box and radio button fields.
Note: 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 | Attributes | Parent Element | Description | Element/Attribute Values |
|---|---|---|---|---|
|
<CopyToAddressFields> |
|
The opening and closing tags of this rule. |
||
| ADDRESSGUID | String | |||
|
<Fields> |
<CopyToAddressFields> |
Allows configuration of dynamic fields. |
||
|
<Field> |
<Fields> | Repeatable element; The opening and closing tag that encompasses <From> and <To> |
||
|
<From> |
<Field> |
Name of the Math Variable or activity field data is being copied from. |
Required
element value; MathVariable/ActivityField Name of the MathVariable or field from the transaction. |
|
|
<To> |
<Field> |
Name of Address field data is being copied to. |
Required
element value
Field; Name of the field in Client screen. |
|
| <OptionText> | <Field> |
Optional element: Identifies the source of the data that will update the OptionText for the field defined in the <To> element. Note: This element and the <OptionTextCollection> element are mutually exclusive. |
MathVariable | |
| <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 AddressScreen rule for the address GUID specified. |
|||
| NAME |
Required: Specifies the named section of the related entity's Multifield rule. |
Literal name | ||
| END |
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. Literal Integer or Integer Math Variable |
|||
| <Field> | <Fields> | 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> | <Field> |
Required: The target named field in the entity multifield rule. |
Literal field name |
XML Example
<CopyToAddressFields ADDRESSGUID="AddressGUID"> <Fields>
<Field>
<From>AddressLineOne</From>
<To>AddressLine1</To>
<OptionText>[AddressLine1OptionText]</OptionText>
</Field>
<Field>
<From>AddressEffectiveDate</From>
<To>EffectiveDate</To>
<OptionText>[EffectiveDateOptionText]</OptionText>
</Field>
<Field>
<From>MVNationCode</From>
<To>NationCode</To>
<OptionText>[NationCodeOptionText]</OptionText>
</Field>
<Field>
<From>MVReturnMailIndicator</From>
<To>ReturnMailIndicator</To>
<OptionText>[ReturnMailIndicatorOptionText]</OptionText>
</Field>
</Fields>
</CopyToAddressFields>
