Documentation Center

Business rules for changing mappings

Changing mappings is a powerful feature that you must use with caution. Make sure that you use mapping only to rename and/or move items. To make sure that items are mapped correctly, adhere to a number of rules. If you do not respect these rules, an error will be raised, either before or during import.

Observe the following rules when changing mappings:
  • Do not change the export part of the mapping, only the import part.
  • Do not delete mappings from the table, or create new ones.
  • Do not attempt to move the following items using mapping:
    • Publications
    • Approval Statuses
    • Groups
    • Multimedia Types

    You can, however, rename all of these items.

  • Only map to import locations that you know exist on the destination instance.
  • Only map to an import item that has the same type and subtype as the exported item. You cannot map, for example, a Folder to a Structure Group, or a Multimedia Schema to a Metadata Schema.
  • Do not perform two interdependent mappings at the same time. For example, do not attempt to make a parent and a child folder switch places, or to give two items each other's names.
  • If your mapping moves items from one Publication to another Publication, you must add a mapping for the Publication itself (for example, change the title of the source Publication to a target one) and, if necessary, add additional mappings to adjust the locations and/or titles of any dependencies in the Publication of the item you are mapping. Failure to map the Publication leads to an error during import.