Customizing the Collection Logic of Missing Objects
When replicating an object that has associated objects, if these associated objects are not included in the package or were not previously replicated, the default logic may collect all the associated objects as missing objects. You can configure the logic to collect only specific associated objects using the missingObjectTraversalFrom attribute that is available in the WorkPackageRelationshipMap.xml file. For a given binary link, you can set the value of this attribute as ROLE_A, ROLE_B, or BOTH. These values are case sensitive and must be provided in the specified format only.
The following table illustrates the object displayed as missing for each value set in the missingObjectTraversalFrom attribute in different replication scenarios.
|
Attribute Value
|
Missing Object Collected When Replicating Role A
|
Missing Object Collected When Replicating Role B
|
|
ROLE_A
|
Role B
|
None
|
|
ROLE_B
|
None
|
Role A
|
|
BOTH
|
Role B
|
Role A
|
Here is an example where Parent Part A gets replicated, and the associated Child Part B is in a different context. The following table describes the object displayed as missing for each attribute value.
|
Attribute Value
|
Missing Object
|
|
ROLE_A
|
Child Part B
|
|
ROLE_B
|
None
|
|
BOTH
|
Child Part B
|
Perform the following steps to define the logic for missing object collection:
1. Copy the WorkPackageRelationshipMap.xml file located at codebase/com/ptc/Windchill/Wp/Delivery/Export and save it in a different location.
2. Open the file, and set a value for the missingObjectTraversalFrom attribute for the required binary link.
3. Access the wt.properties file located at Windchill/codebase/.
4. In this file, add the following property to specify the location where you have saved the WorkPackageRelationshipMap.xml file:
com.ptc.windchill.wp.delivery.export.relationship.config.location
The following example illustrates the property configuration for the location Windchill/wtCustom/config:
$(wt.home)$(dir.sep)wtCustom$(dir.sep)config$(dir.sep)
5. Restart the Windchill server.