When you run the conversion operation, the deployment data set and the data maps are used to
convert the source environment objects with information that is specific to the destination
environment.
On the source-destination pair tab, the check boxes
Use when converting
assets can be used to control if a data map is applied during the conversion phase. The
following examples are possible use cases for which you would not want to convert assets:
- If the assets are being imported into an object store that uses the same LDAP as the source and
the conversion process can be made faster by not applying the Security Principal mappings, as they
would have no real effect.
- If many documents are in the export data set, and you are not using the import option
Use storage policies or areas from the imported objects in the deploy data
set. The conversion process can then be faster because the values that you are not using
during the import process are not converted.
Restriction: During the conversion process, an unmapped entry is benign if it is not
referenced by the export data to be converted. Errors occur only when unmapped entries are
referenced for conversion.
If a data map contains unmapped entries that are referenced for
conversion, complete one of the following steps:
- Modify the unmapped entries in the environments to eliminate the inconsistencies, then re-create
the half maps and the data map.
- Elect not to convert objects that are referenced by the unmapped entries. In this case,
re-create the half maps, excluding these objects in the selection criteria, then re-create the data
map.
- Edit the half maps to add matching labels for any unmapped entries; then, re-create the data
map. For more information, see Edit
labels in a half map.
The conversion process fails if a required map that is referenced by the export data is not
mapped to a destination item. To prevent this situation, review the data maps for the deployment
before you run the Convert Assets deployment operation. You might also want to perform a trial
conversion to verify that the result is as expected.