IBM FileNet P8, Version 5.2

Converting objects for import

Use FileNet® Deployment Manager to convert the objects in the export files for import.

The conversion process fails if a source object store, service, or security principal that is referenced by the export data is not mapped to a destination item. To prevent this situation, review the object store, service data, and security principal 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.

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, perform 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.

To convert objects for import:

In FileNet Deployment Manager, right-click the source-destination pair for this deployment and then click Convert Assets.

Select the type of asset to convert and click Next.

Option	Description
If you select Content Platform Engine Deploy data set:	In the Select Deploy data set field, enter the fully qualified name of the data set that is exported from the source environment. Click Next. In the Select Folder for Converted Deploy data set field, enter the fully qualified name of the folder in which FileNet Deployment Manager is to place the converted deploy data set. The default directory is P8DeploymentData/Environments/<destination_environment>/Assets. FileNet Deployment Manager places the converted data set into a new subfolder of the folder that you specify in this field. The subfolder will be named after the deploy data set name with ".converted" appended to the name. For example, if you accept the default directory of P8DeploymentData/Environments/<destination_environment>/Assets, where <destination_environment> is "targetSystem", and if the deploy data set is named "invoiceFolder", FileNet Deployment Manager creates the following folder for the converted data set: P8DeploymentData/Environments/targetSystem/Assets/invoiceFolder.converted.
If you select the Configuration export file	In the Select Manifest File field, enter the fully qualified name of the Process Configuration export file from the source environment. Click Next. In the Destination Folder, enter the fully qualified name of the folder in which FileNet Deployment Manager is to place the converted export file. The default directory is: P8DeploymentData/Environments/<source_environment>/Assets/Converted . Click Next. If a file of the same name is found in the specified path, you are prompted to overwrite the converted export file. Click Finish.

Option

Description

If you select Content Platform Engine Deploy data set:

In the Select Deploy data set field, enter the fully qualified name of the data set that is exported from the source environment.
Click Next.
In the Select Folder for Converted Deploy data set field, enter the fully qualified name of the folder in which FileNet Deployment Manager is to place the converted deploy data set. The default directory is P8DeploymentData/Environments/<destination_environment>/Assets.
FileNet Deployment Manager places the converted data set into a new subfolder of the folder that you specify in this field. The subfolder will be named after the deploy data set name with ".converted" appended to the name. For example, if you accept the default directory of P8DeploymentData/Environments/<destination_environment>/Assets, where <destination_environment> is "targetSystem", and if the deploy data set is named "invoiceFolder", FileNet Deployment Manager creates the following folder for the converted data set: P8DeploymentData/Environments/targetSystem/Assets/invoiceFolder.converted.

If you select the Configuration export file

In the Select Manifest File field, enter the fully qualified name of the Process Configuration export file from the source environment.
Click Next.
In the Destination Folder, enter the fully qualified name of the folder in which FileNet Deployment Manager is to place the converted export file.
The default directory is: P8DeploymentData/Environments/<source_environment>/Assets/Converted
.
Click Next. If a file of the same name is found in the specified path, you are prompted to overwrite the converted export file.
Click Finish.