Collision Rules for Import and Export
![]() |
[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. |
.gif)