Configure mappings you have created to determine how data values are transferred from the source to the target of the mapping. Different types of mappings are available depending on whether the source and target are entities or data elements. The available mapping types are:
Copy value (data-element-to-data-element mappings): This type of mapping copies the value of the source parameter directly to the target parameter.
Value transformation (entity-to-data-element mappings and data-element-to-data-element mappings): This type of mapping enables you to set up a list of value mappings, where a source value is mapped to a target value.
Unit of measure (data-element-to-data-element mappings): This type of mapping enables you to perform conversions between numeric values having different units of measure. The units of measure must be defined on the data elements for this type of mapping to work. For more information about setting up units of measure, see "Conceptual Model Unit of Measure Editor." For more information about setting units of measure for individual data elements, see "Details or Attributes Tab."
Advanced (all mapping types): This type of mapping enables you to define the mapping using XQuery.
In addition to the procedures below, you can change the type of a mapping from one to another and perform other actions relating to the mapping by right-clicking the target of the mapping and selecting an appropriate item from the context menu.
When configuring mappings, see the following topics:
Configuring Bi-Directional Mapping
Configuring Multi-Instance Structure Key Mapping
The types of mapping between entities are:
Advanced mapping
To configure an entity-to-entity advanced mapping:
Open a mapping rule and click the Mapping tab.
In the Entries table, select the named relationship for the mapping you would like to configure.
In the Mapping subtab, click the target of the mapping you would like to configure.
In the Mapping Rule Item area, Advanced is selected.
In the Mapping Rule Item area, enter information about the XQuery expression you would like to use. See "About Creating XQuery Expressions with Design Studio" for more information about entering information into XQuery controls. See "About Entity-to-Entity Advanced Mapping XQuery Expressions" for more information about this XQuery field.
Configure the information in the Details, Condition, and Actions subtabs as necessary.
The types of mapping between entities and data elements are:
Value transformation mapping
Advanced mapping
To configure an entity-to-data-element value transformation mapping:
Open a mapping rule and click the Mapping tab.
In the Entries table, select the mapping you would like to configure.
In the Mapping subtab, click the target of the mapping you would like to configure.
In the Mapping Rule Item area, select Value Map.
In the Configuration subtab, Transform Value Selection area, click Add.
In the Output Value field, enter a value and click OK.
Configure the information in the Details, Condition, and Actions subtabs as necessary.
To configure an entity-to-data-element advanced mapping:
Open a mapping rule and click the Mapping tab.
In the Entries table, select the mapping you would like to configure.
In the Mapping subtab, click the target of the mapping you would like to configure.
In the Mapping Rule Item area, select Advanced.
In the Mapping Rule Item area, enter information about the XQuery expression you would like to use. See "About Creating XQuery Expressions with Design Studio" for more information about entering information into XQuery controls. See "About Entity-to-Data-Element Advanced Mapping XQuery Expressions" for more information about this XQuery field.
Configure the information in the Details, Condition, and Actions subtabs as necessary.
The types of mapping between data elements are:
Copy value mapping
Value transformation mapping
Unit-of-measure mapping
Advanced mapping
When you create a mapping between data elements, the default mapping type created depends on the data elements being mapped:
If the source and target elements are of the same type (except if one or both has units of measure defined for it) or if the target element is of string type, the default mapping is copy value mapping.
If either the source or target data element has enumerations defined for it, the default mapping type is value transformation mapping.
If both the source and target have units defined from the same Units of Measure common model entity, the default mapping is unit-of-measure mapping.
If the source and target elements are of incompatible types (for example only one has units of measure defined or the source is dateTime and the target is Boolean), the default mapping type is an advanced mapping.
To configure a data-element-to-data-element copy value mapping:
Open a mapping rule and click the Mapping tab.
In the Entries table, select the mapping you would like to configure.
In the Mapping subtab, click the target of the mapping you would like to configure.
In the Mapping Rule Item area, select Copy Value.
Configure the information in the Details, Condition, and Actions subtabs as necessary.
To configure a data-element-to-data-element value transformation mapping:
Open a mapping rule and click the Mapping tab.
In the Entries table, select the mapping you would like to configure.
In the Mapping subtab, click the target of the mapping you would like to configure.
In the Mapping Rule Item area, select Value Map.
For each incoming value that you wish to transform, do the following:
In the Configuration subtab, Transform Value Selection area, click Add.
Enter values in the Input Value and Output Value fields and click OK.
Configure the information in the Details, Condition, and Actions subtabs as necessary.
To configure a data-element-to-data-element unit-of-measure mapping:
In general, there is no need to configure unit-of-measure mappings. If you create a mapping between two data elements with compatible units of measure defined for them, when you create a mapping between them, it is created as a unit-of-measure mapping by default. If you create a mapping between any other types of data elements, the unit-of-measure mapping is not available. However, if you have a mapping between compatible data elements that you have changed to another type of mapping, and you want to reconfigure it as a unit-of-measure mapping, you can use the following procedure.
Open a mapping rule and click the Mapping tab.
In the Entries table, select the mapping you would like to configure.
In the Mapping subtab, click the target of the mapping you would like to configure.
In the Mapping Rule Item area, select Unit Of Measure.
The units defined for the data elements are automatically populated in the Target Unit and Source Unit fields and cannot be changed.
To configure a data-element-to-data-element advanced mapping:
Open a mapping rule and click the Mapping tab.
In the Entries table, select the mapping you would like to configure.
In the Mapping subtab, click the target of the mapping you would like to configure.
In the Mapping Rule Item area, select Advanced.
In the Mapping Rule Item area, enter information about the XQuery expression you would like to use. See "About Creating XQuery Expressions with Design Studio" for more information about entering information into XQuery controls. See "About Data-Element-to-Data-Element Advanced Mapping XQuery Expressions" for more information about this XQuery field.
Configure the information in the Details, Condition, and Actions subtabs as necessary.