Introduction to Key Mappings

Key Mappings are an attribute of a Form Mapping.  They are used to define which fields are primary keys on source and target forms.  Primary keys are important because they can be used to affect the behaviour of the migration; In particular whether a new record is created on the Target Form or whether an existing record is updated.

Please note that for ServiceNow -> ServiceNow migrations, the Migration Method ‘Import Set (Scripted)’ with the Migrate SysID’s option always takes precedence over any Key Mappings that you define.  See the Migration Method in Execution Options article for more information on this.

To view the Key Mappings for a Form Mapping click on the Key Mapping tab on the Form Mapping screen:

If a key mapping has already been defined for this Form Mapping, it will be displayed here.  If not the default (No Key Mappings) will be set.  There are three different types of Key Mappings (as indicated above), that can be defined and the behaviour of each type is described in the following articles.

Related Articles

No Key Mapping Behaviour

Select Key Mappings Option

Using Key Mappings Derived from Earlier Form Mapping