Configuring Version Mapping for Imports

Data Management Capabilities > Using Packages to Import and Export Data for Offline Collaboration > Define Mapping > Defining Received Delivery Version Mapping > Configuring Version Mapping for Imports

To specify the version mapping to be followed when importing a package, configure the com.ptc.windchill.rd.labelBasedImportHandling.trackedSenders property in the wt.properties file located at WT_HOME\codebase. This property is not available by default. If the property is not configured in the wt.properties file, position mapping is used by default.

To configure the imports to use the version information from the source system without implicit mapping, specify a comma-separated list of the GUIDs of senders, which are the source systems. Only the packages exported by the specified senders are considered for such mapping.

com.ptc.windchill.rd.labelBasedImportHandling.trackedSenders=<GUID1>,<GUID2>,<GUID3>

An example is given below:

com.ptc.windchill.rd.labelBasedImportHandling.trackedSenders=408654286-1604483643848-1777043124-1-33-168-192,238654276-5503283643444-5677033128-1-73-455-144

The wildcard character (*) can be specified to consider all senders.

com.ptc.windchill.rd.labelBasedImportHandling.trackedSenders=*

You can find the GUID of a system using one of the following methods:

• Navigate to the \importData\0.data file in the zipped package.

• Enter the following command in the Windchill shell in the source system:

windchill wt.scm.client.SCMCMD displayRepository -u <admin username> —p <admin password>

For example: windchill wt.scm.client.SCMCMD displayRepository -u wcadmin -p wcadmin

• It is recommended to configure the property before importing a package. Do not change the settings later as it may cause conflicts in object versioning in subsequent or incremental imports.

• Support for using the version information from the source system without implicit mapping, is available only in the Windchill 12.0.2.0 release and onwards. You can use this method when importing packages only from Windchill 12.0.0.0, Windchill 12.0.1.0, or Windchill 12.0.2.0 to Windchill 12.0.2.0.

• Objects with non-integer series of iterations, such as 1.A, A.A, are imported successfully only when the mapping is set to None and the iteration series configured in the target system allows such labels.