Collision Rules for Import and Export

banner art

[Applies to: Microsoft Dynamics CRM 4.0]

Find the latest SDK documentation: CRM 2015 SDK

If there are conflicts between objects in the import file and the target system, one of the following actions is taken:

  • Overwrite. The object definition in the import file overwrites the object on the target system.
  • Error. A SOAP exception that contains the error code is thrown.
  • New Object. A new object is created on the target system with the same name.
  • Skip. The object definition in the import file is skipped.

The following table describes the possible import collision conditions.

Object Collision condition Collision action taken
Modifiable entity properties Same entity name, different property Overwrite
Non-modifiable entity properties Same entity name Error
Modifiable1 attribute properties Same entity name, same attribute name, Overwrite
Non-modifiable attribute properties Same entity name, same attribute name Error
Forms Same name Overwrite
Views Same name Overwrite
Attribute mappings Different attribute mappings for a source/target pair Overwrite
Templates Same name Overwrite
Isv.config Same name Overwrite
Modifiable1 custom relationship properties Same primary/related entity, different property Overwrite
Modifiable1 customer relationship properties Same name, different property New object
Non-modifiable customer relationship properties Same name, different property Error
Custom security role Same ID Merge
System security role Same name Overwrite
System security role System Administrator Skip

1 - Modifiable in the Web application.

Rules for Labels in Multiple Languages

If you import a customization file that contains customizations (labels) in a different language, the languages are merged. If labels are missing, they are taken from the base language.

The following table shows an example.

Source system Destination system Result
base language:

1041 (Japanese)

additional languages:

1049 (Russian)

1033 (English – US)

base language:

1036 (French)

additional languages

1049 (Russian)

Because no labels for 1036 are contained with the file the Import process substitutes them with the 1041 labels (the base language of System A).

The labels for 1049 are processed normally.

© 2010 Microsoft Corporation. All rights reserved.