Windchill REST Services > Windchill REST Services Domain Capabilities > Examples for Basic REST Operations > Examples for the PTC Product Management Domain > Creating a Part Reference Link Between an Existing Part and a Reference Document
Creating a Part Reference Link Between an Existing Part and a Reference Document
A part reference link exists between an existing part and a reference document.
You can create a part reference link by specifying the part OID in the request URI and the reference document OID in the request body. To create a part reference link, the master document must exist for the specified reference document.
You can also create a part reference link by specifying the defined IBA attributes of type String, Integer Number, or Real Number in the request body.
* 
• When the Part to Document Association Logic preference is set to No in the Preference Management utility in Windchill, you can create a part reference link only for a document of type Reference Document.
• When the Part to Document Association Logic preference is set to Yes, you can create a part reference link for any of the document types.
Example: Creating a Part Reference Link
The following example shows you how to create a part reference link for the part OID specified in the request URI.
Use the following POST URI with the request body.
URI
POST /Windchill/servlet/odata/ProdMgmt/Parts('OR:wt.part.WTPart:278450')/References
Request Headers
Content-Type: application/json
CSRF_NONCE: <Use the value from Fetch NONCE example>
Request Body
{
"[email protected]": "Documents('OR:wt.doc.WTDocument:302118')"
}
The request creates a part reference link and returns the details of the link in the response.
The specified reference document is added to the Reference Documents table in the Related Objects tab available for the specified part in Windchill.
Example: Creating a Part Reference Link with Attributes
The following example shows you how to create a part reference link with IBA attributes for the part OID specified in the request URI.
Use the following POST URI with the request body.
URI
POST /Windchill/servlet/odata/ProdMgmt/Parts('OR:wt.part.WTPart:278489')/References
Request Headers
Content-Type: application/json
CSRF_NONCE: <Use the value from Fetch NONCE example>
Request Body
{
"[email protected]": "Documents('OR:wt.doc.WTDocument:302120')",
"TestStringIBA1": "TestValue1",
"TestIntegerIBA2": 123
}
The request creates a part reference link and returns the TestStringIBA1 and TestIntegerIBA2 attributes along with other details of the link in the response.
The specified reference document is added to the Reference Documents table in the Related Objects tab available for the specified part in Windchill.
Was this helpful?