PasteSpecial
The PasteSpecial action validates the information that is copied on the upstream parts and pastes the information to the specified downstream part. The action pastes the information based on the configuration you specify in the automatic BOM transformation template. You can add the copied parts using inline or specific upstream and downstream navigation criteria.
You can also copy and paste using PasteSpecial in the context of change (change task or change notice).
|
|
The action is not available in the Occurrence mode.
|
See the Configuring and Customizing Automatic BOM Transformation topic in the Windchill Help Center, for more information.
The attributes in the request payload of the PasteSpecial action are described in the following table:
|
Request Attribute
|
Description
|
Required
|
||
|---|---|---|---|---|
|
SourceRoot
|
Attribute in the DiscrepancyContext entity type to specify the root part of the upstream structure.
|
Yes
|
||
|
SourcePartSelection
|
Attribute in the DiscrepancyContext entity type to specify the parent Part from the upstream structure.
Alternatively, you can specify the Path of the parent part.
|
Yes
|
||
|
UpstreamNavigationCriteria
|
Attribute in the DiscrepancyContext entity type to specify the navigation criteria applied in the upstream.
|
Yes
|
||
|
DownstreamNavigationCriteria
|
Attribute in the DiscrepancyContext entity type to specify the navigation criteria applied in the downstream.
|
Optional
|
||
|
TargetRoot
|
Attribute in the DiscrepancyContext entity type to specify the root part of the downstream structure.
|
Yes
|
||
|
TargetPart
|
Attribute in the DiscrepancyContext entity type to specify the downstream part to which you want to paste the copied parts.
Alternatively, you can specify the path of the downstream part, that is, TargetPath to which you want to paste the copied parts.
|
Yes
|
||
|
ChangeOid
|
Attribute to specify the change task or change notice.
|
Optional
|
The request adds each specified upstream part as a new part under the specified downstream part based on the configuration in the automatic BOM transformation template. The request creates new equivalence links between the downstream BOM and the upstream BOM.
POST Windchill/servlet/odata/BomTransformation/PasteSpecial
For example, the response to the request URI is as follows:
{
"@odata.context": "$metadata#EquivalentUsageAssociations",
"value": [
{
"UpstreamPartId": "OR:wt.part.WTPart:189986",
"DownstreamPartId": "OR:wt.part.WTPart:189986",
"EquivalenceLinkId": "OR:wt.associativity.EquivalenceLink:190604",
"UsageLinkId": "OR:wt.part.WTPartUsageLink:190605"
}
],
"@PTC.AppliedContainerContext.LocalTimeZone": "Europe/Warsaw"
}
"@odata.context": "$metadata#EquivalentUsageAssociations",
"value": [
{
"UpstreamPartId": "OR:wt.part.WTPart:189986",
"DownstreamPartId": "OR:wt.part.WTPart:189986",
"EquivalenceLinkId": "OR:wt.associativity.EquivalenceLink:190604",
"UsageLinkId": "OR:wt.part.WTPartUsageLink:190605"
}
],
"@PTC.AppliedContainerContext.LocalTimeZone": "Europe/Warsaw"
}
The attributes in the response for the PasteSpecial action are described in the following table:
|
Response Attribute
|
Description
|
|---|---|
|
UpstreamPartId
|
Attribute in a collection that returns the ID of the upstream part which was copied.
|
|
DownstreamPartId
|
Attribute in a collection that returns the ID of the downstream equivalent part.
|
|
EquivalenceLinkId
|
Attribute in a collection that returns the ID of the equivalence link between the upstream part and the downstream equivalent part.
|
|
UsageLinkId
|
Attribute in a collection that returns the ID of the usage link between the downstream target part and the added downstream part.
|