Reimport of assets with content containing environment-specific references

When a solution is reimported to the same object store, environment-specific changes to the assets of that solution might not show up in the reimported version.

When you import a solution package by using the IBM® Business Automation Workflow Case administration client or the IBM Business Automation Workflow Case configuration tool , environment-specific values can be mapped from those in the development environment to those in the target environment.
Important: Environment-specific mapping options are not presented when a solution is imported by using a solution manifest file.
If the current version of a solution is reimported into the same design or staging object store multiple times without changes to the solution package, some mapping values might not appear in the target system. This can occur when a document object with content is reimported to a destination object store that contains a document object with the same ID. For more information, see Can't refer to document version IDs in the target object store.

In IBM FileNet® Content Manager, a document object's properties can be modified with a reimport, but the content elements cannot. Solution application artifacts, such as pages that include a website widget or workflow definitions that include URL references, might be affected. Similarly, if non-IBM Business Automation Workflow assets that are represented as documents with content are reimported into the same object store multiple times by using FileNet Deployment Manager, modifications to environment-specific information by the FileNet Deployment Manager data conversion feature might not appear in the target system. This can occur with solution application artifacts such as form templates and workflow definitions that include URL references.

If a reimport appears not to convert document content as expected, do one of the following actions:
  • From the destination design object store, staging object store, or target object store, delete the current version of the document prior to the reimport. Deleting this version causes the document version to be created, rather than modified, by the reimport.
  • If the current document version cannot be deleted prior to the reimport, modify the content manually by using the appropriate tools in the destination object store after the reimport completes.

To find the current version of a document, use the IBM Administration Console for Content Platform Engine to navigate to the destination object store and browse to find the solution folder or the folder that contains the asset. Locate the desired document and use the versions tab on its details pane to view the versions.