Value Mapping

Description A value mapping controls the mapping of a single value from one object to another.
Template location /sitecore/templates/Data Exchange/Framework/Data Access/Mapping/Value Mapping

In this topic:

Configuration

Field Description
Source Accessor Value Accessor used to read the values to be mapped from the source object. (More precisely, the value reader assigned to the value accessor is used.) If multiple value accessors are specified, the value read from the source object are added to a collection. This is used when the value writer expects multiple values (such as when the value writer represents a method).
Always Read Values Into Collection When ticked, even if only one source value accessor is specified, a collection is read (meaning a new collection is created and the value read by is added to the collection). This option is used when the value writer expects a collection of values (such as when the value writer represents a method).
Target Accessor Value Accessor used to write the value to be mapped to the target object. (More precisely, the value writer assigned to the value accessor is used.)
Source Value Pre Transformer Value Reader used to convert the source object before the source accessor is used. The converted value becomes the source object within the context of this value mapping. This option is used when the source object must be converted into a different format before the source accessor can be used to read a value from it.
Source Value Transformer Value Reader used convert the value read by the source accessor before the value is written to the target object. This option is used when the value read from the source object must be converted into a different format before the target accessor can be used to write the value to the target object.
Do Not Fail If Unable To Read Source Value By default, the a value cannot be read from the source object, this is considered a failure in the data mapping process. When ticked, the value mapping does not fail, it simply does not run.
Ignore Null Values By default, if a null value is read from the source object, the value mapping does not run. This prevents existing data from being overwritten. When unticked, the value mapping runs even if a null value is read from the source object.
Apply Mapping Rules Apply Mapping Rules that determine whether the value mapping should run. When specified, all apply mapping rules must pass in order for the value mapping to run. If one apply mapping rule fails, the value mapping does not run.
Mapping Set Fails If This Mapping Fails By default, when a single value mapping fails, this does not result in the entire mapping process from failing. When ticked, if this value mapping fails, the entire mapping process fails. This option is used when the value mapping is critical to the data mapping process. For example, if the value mapping is the way a primary key is set on the target object, it will not be possible to update the target system. This is a critical error, so the mapping process should fail.

When to Extend

It is unusual to need to extend this component.