Defining a Property Key
The property key defines the context in which the copy over property should be considered. Here, context specifies that only when the user executes a particular action for a specific part type, the attributes or associations should be carried over.
The property key is configured in the following format:
copy over delimiter.module name.action name.mode.fully qualified class name.container class name(optional).container name(optional)
The table describes the elements of the property key.
|
Key Element
|
Element Value
|
|---|---|
|
copy over delimiter
|
For BOM Transformer:com.ptc.windchill.mpml.copyOver
For SAPSB:com.ptc.arbortext.windchill.copyOver
|
|
module name
|
Applicable when using transformation actions.
For BOM Transformer: mapsb
For SAPSB: sapsb
|
|
action name.mode
|
Applicable when using actions such as the following:
New Downstream Part, Paste as New Part: newPart.create
New Downstream Branch, Paste as New Branch: newBranch.create
Create Equivalent Link: create
Update All Downstream Equivalent Objects, Update to Current Upstream Equivalent Object: update
|
|
fully qualified class name
|
For part: wt.part.WTPart
For part master: wt.part.WTPartMaster
For part usage: wt.part.WTPartUsageLink
For part subtype: Append the class name for part with the internal name of the subtype.
|
|
container class name
|
For product: PDMLinkProduct
For library: WTLibrary
It is optional to provide the container class name.
|
|
container name
|
The display name of a product in Windchill. You should have the rights to access the product. For example, Drive System.
It is optional to provide the container name.
|
 |
If you do not specify the container details, the property configuration will apply to all the containers in Windchill. If you want the property to be applicable only to a specific container, provide the container details. However, you will need to check if a similar property already exists for a different container or all containers, which is the case when the container details are not specified. Remove any such property to avoid overriding issues, and add a new property with the container details.
|
Property Key for Transformation Actions
The following examples define property keys for the New Downstream Part and Paste as New Part actions in BOM Transformer for a part, part subtype, and part usage.
• Part
com.ptc.windchill.mpml.copyOver.mapsb.newPart.create.wt.part.WTPart
• Part subtype
com.ptc.windchill.mpml.copyOver.mapsb.newPart.create.wt.part.WTPart.org.rnd.SoftType
The property key is defined for SoftType, which is a subtype of WTPart. The internal name of the subtype is separated from the class name of its parent type using a dot(.) when defining a key.
|
|
If you have not configured a property for the subtype, the property configured for its parent type is used when the attribute defined for the subtype is carried over.
|
• Part usage
com.ptc.windchill.mpml.copyOver.update.wt.part.WTPartUsageLink
This property key is defined to carry over the attributes and associations of part usage from upstream to downstream.
Property Key for Creating or Updating Equivalent Links
The following examples define property keys for the actions that create and update an equivalent link for a part, part subtype, and part usage. The actions are Create Equivalent Link, Update All Downstream Equivalent Objects, and Update to Current Upstream Equivalent Object.
• Part
◦ com.ptc.windchill.mpml.copyOver.create.wt.part.WTPart
◦ com.ptc.windchill.mpml.copyOver.update.wt.part.WTPart
|
|
The com.ptc.windchill.mpml.copyOver.update.wt.part.WTPart property key can also be used for reconciliation actions, such as Propagate changes to downstream.
|
• Part subtype
◦ com.ptc.windchill.mpml.copyOver.create.wt.part.WTPart.org.rnd.SoftType
◦ com.ptc.windchill.mpml.copyOver.update.wt.part.WTPart.org.rnd.SoftType
The property key is defined for SoftType, which is a subtype of WTPart. The internal name of the subtype is separated from the class name of its parent type using a dot(.) when defining a key.
|
|
If you have not configured a property for the subtype, the property configured for its parent type is used when the attribute defined for the subtype is carried over.
|
• Part usage
◦ com.ptc.windchill.mpml.copyOver.create.wt.part.WTPartUsageLink
◦ com.ptc.windchill.mpml.copyOver.update.wt.part.WTPartUsageLink