Windchill REST Services Domain Capabilities > PTC Domains > PTC BOM Transformation Domain > Actions Available in the BOM Transformation Domain for Creating or Updating Downstream BOMs > NewDownstreamPart
NewDownstreamPart
The NewDownstreamPart action creates a new downstream part and then creates new equivalent links to the specified upstream part. The action creates an equivalent downstream assembly with a new part number and view. You can create a new downstream part for the specified upstream part using inline or specific upstream and downstream navigation criteria.
You can also create the new downstream part in the context of change (change task or change notice).
The attributes in the request payload of the NewDownstreamPart action are described in the following table:
Request Attribute
Description
Required
SourcePart
Attribute in the TransformationDefinitions collection to specify the OID of the upstream part for which you want to create a new downstream part.
Yes
ReviseExistingDownstream
Flag in the TransformationDefinitions collection to specify whether the existing downstream objects should be revised or not during the transformation.
 
*ReviseExistingDownstream is a required attribute when you specify ExistingDownstreamAssociations.
When ExistingDownstreamAssociations is not specified, the ReviseExistingDownstream flag is ignored, even if it is provided.
Yes*
TransformationOption
Attribute in the TransformationDefinitions collection to specify the child structure option as Do not duplicate, Duplicate with propagating, or Duplicate without propagating for the transformation.
 
*TransformationOption is not applicable when you specify ExistingDownstreamAssociations.
Yes*
ExistingDownstreamAssociations
Array type of attribute in the TransformationDefinitions collection to specify the OID of the equivalent link between a specified upstream part and its existing downstream equivalent object.
Alternatively, you can specify the value composed of an upstream part OID and its existing downstream part OID. The value is specified for the upstream part when its existing downstream object is not equivalent to it.
Optional
View
Attribute in the TransformationEntity entity type to specify the downstream view to be used in the transformation.
Yes
BOMType
Attribute in the TransformationEntity entity type to specify the type of downstream BOM being used.
Optional
AlternateBOM
Attribute in the TransformationEntity entity type to specify an alternate BOM for the transformation.
Optional
Context
Attribute in the TransformationEntity entity type to specify the context in which you want to create the downstream object.
Yes
Folder
Attribute in the TransformationEntity entity type to specify the location at which you want to create the downstream object.
Yes
Number
Attribute in the TransformationEntity collection to specify an identification number for the new part in the downstream.
If you specify an existing part number, then the system searches for that part in Windchill and shows it as an existing downstream part along with the other existing downstream parts.
Optional
DownstreamNavigationCriteria
Inline or specific navigation criteria applied in the downstream.
Yes
UpstreamNavigationCriteria
Inline or specific navigation criteria applied in the upstream.
Yes
ChangeOid
Attribute to specify the change task or change notice.
Optional
The request creates a new downstream part and an equivalence link between the new downstream part and the specified upstream part. The request also returns information for the equivalence link.
If child parts exist for a specified upstream part, the request also returns information about the equivalence link for each child part, according to the specified child structure option.
POST Windchill/servlet/odata/BomTransformation/NewDownstreamPart
For example, the response to the request URI is as follows:
{
"@odata.context": "$metadata#ExistingDownstreamAssociations",
"value": [
{
"ID": "OR:wt.associativity.EquivalenceLink:213450",
"UpstreamPartId": "OR:wt.part.WTPart:213274",
"DownstreamPartId": "OR:wt.part.WTPart:213408",
"EquivalenceLinkId": "OR:wt.associativity.EquivalenceLink:213440",
"IsEquivalenceLinkOutdated": false
}
"@PTC.AppliedContainerContext.LocalTimeZone": "Europe/Warsaw"
}
The attributes in the response for the NewDownstreamPart action are described in detail in the following table:
Response Attribute
Description
ID
Attribute in a collection that returns the ID of the associative link between the upstream part specified in the request and the newly created downstream equivalent part.
UpstreamPartId
Attribute in a collection that returns the ID of the upstream part specified in the request for which a new downstream part is created.
 
If child parts exist for the specified upstream part, the attribute also returns the ID of each upstream child part for which a new downstream equivalent part is created.
DownstreamPartId
Attribute in a collection that returns the ID of the newly created downstream equivalent part.
EquivalenceLinkId
Attribute in a collection that returns the ID of the equivalence link between the upstream part and the newly created downstream equivalent part.
IsEquivalenceLinkOutdated
Attribute in a collection that indicates whether the equivalence link between the upstream part specified in the request and the newly created downstream equivalent part is outdated or not.