Framework apply mapping rules

Version: 8.0

This topic describes the apply mapping rules that are included with Data Exchange Framework.

Collection count

This rule is used to ensure a value is a collection with a number of members within a specific range.

Expected type of the value being written to the target object

System.Collections.ICollection

Template location

Data Exchange/Framework/Data Access/Apply Mapping Rules/Collection Count Mapping Rule

Template fields

Field name

Description

Minimum Count

The collection must contain at least this many members.

Maximum Count

The collection must not contain more than this many members. The default value is -1, which means that the collection can contain an unlimited number of members.

Default value

You use this rule to ensure a value is not the default value.

The rule uses the value’s type to determine what the default value is. This enables value types and object types to be supported.

You usually use this rule to prevent actual values being replaced with default values. For example, imagine you are trying to update the phone number, which is stored as a string, on an existing contact. The contact already has a phone number specified, but the source object does not have a phone number set on it. This rule can be used to ensure the existing phone number is not overwritten with a null string from the source.

Expected type of the value being written to the target object

System.Object

Template location

Data Exchange/Framework/Data Access/Apply Mapping Rules/Default Value Mapping Rule

Template fields

This template has no fields on it.

GUID value matches

You use this rule to ensure that a value is a GUID and that it either matches or does not match specified GUIDs.

Expected type of the value being written to the target object

System.Guid

Template location

Data Exchange/Framework/Data Access/Apply Mapping Rules/Guid Value Matches Mapping Rule

Template fields

Field name

Description

Required Source Values

The value read from the source object must match one of the specified GUIDs.

Disallowed Source Values

The value read from the source object must not match any of the specified GUIDs.

Source Value Transformer

The value read from the source object is transformed using this component before it is compared to the required and disallowed source values.

Required Target Values

The value read from the target object must match one of the specified GUIDs.

Disallowed Target Values

The value read from the target object must not match any of the specified GUIDs.

Target Value Transformer

The value read from the target object is transformed using this component before it is compared to the required and disallowed target values.

Null value

This rule is used to ensure a value is not null.

Expected type of the value being written to the target object

System.Object

Template location

Data Exchange/Framework/Data Access/Apply Mapping Rules/Null Value Mapping Rule

Template fields

This template has no fields on it.

Objects are different

This rule is used to ensure the value read from the source object is different from the value read from the target object.

Expected type of the value being written to the target object

System.Object

Template location

Data Exchange/Framework/Data Access/Apply Mapping Rules/Objects Are Different Mapping Rule

Template fields

This template has no fields on it.

Do you have some feedback for us?

If you have suggestions for improving this article,