This component lets you take any combination of variables and properties that exist in your project and selectively map them into a target datatype. You can map variables, values, and constants into properties directly or you can transform them using simple rules or embedded process models.
For example, suppose you have a user-defined type of Person with three properties: Name, Age, Job. Also, you have a form that gathers input into three global variables named LocalName, LocalAge, and LocalJob. You can use this component to map LocalName to Person[Name], LocalAge to Person[Age], and LocalJob to Person[Job].
Component Toolbox Path - Process Components > Data
Properties with descriptions
The specific mapping definition for your convergence. When you click the [...] button, the value source selector opens. You can select which values of a datatype are mapped when you click an arrow on the line under Data definitions and, while you hold the mouse button, drag to an arrow on the line under chosen datatype and let go of the mouse button. More arrows appear under Data definitions when you expand data definitions. You can click Validate to see if your mapping is valid.
This option only appears after you enter the Target Type.
Lets you select if you have data that can be handled in more than one way (for example, in two different datatypes).
If it is inconvenient for data to be mapped in the way you propose, you can select this control to cause this component to opt out of mapping the data and handle the data in its original form.
The type of array you want to map your source array into. When you click the [...] button, the value source selector opens.
For example, if transferring from type A to B, you would set the B to this option.
Map Into Existing Value
Lets you select to overwrite an existing variable with the output data. You then choose the target variable in the Target Variable Name option.
Target Variable Name
The variable to overwrite with the output data. When you click the [...] button, the value source selector opens. This variable holds the output, mapped array and must be the same datatype as the target type.
This option appears if you select Map Into Existing Value.
Output Variable Name
The output variable name. When you click the [...] button, the value source selector opens. This variable holds the output, mapped array and must be the same datatype as the target type.
This option only appears after you enter the Target Type and if Map Into Existing Value is not selected.