Link Property Definition Collection to a Hub
This topic provides instructions on how to link a property definition collection to a Hub.
Note: Linking a collection is only possible if you are an administrator of the hub.
You will use the following operation in this topic:
| Type | Operation | Description |
|---|---|---|
| Mutation | linkPropertyDefinitionCollection | Links a property definition collection to a hub. |
Step 1 - Link property definition collection to the hub
The linkPropertyDefinitionCollection mutation links a property definition collection to a hub.
- In the Query Pane of the Manufacturing Data Model Explorer, enter the following mutation:
Mutation
mutation LinkPropertyDefinitionCollection($propertyDefinitionCollectionId: ID!, $hubId: ID!) { linkPropertyDefinitionCollection( input: {propertyDefinitionCollectionId: $propertyDefinitionCollectionId, hubId: $hubId} ) { hub { id } } }Show More
- In the Query Variables Pane, enter the following values:
- propertyDefinitionCollectionId: Enter the value of
propertyDefinitionCollectionId. To know how to obtainpropertyDefinitionCollectionId, refer to Create Property Definition Collection topic. - hubId: Enter the ID of the hub where you want to link the property definition collection . To know how to obtain the
hubId, refer to Retrieve Hubs.
{ "propertyDefinitionCollectionId": "cHJvcGRlZmNvbH5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5wcm9wX2RlZl9jb2xfMTc0NjUzOTM5NzcyMA", "hubId": "urn:adsk.ace:beta.scope:e7c7f5a9-a88a-40b4-85f6-ba1454def997" } - propertyDefinitionCollectionId: Enter the value of
- Click Play. The response will show the details of the linking activity between the collection and the hub. You should see a response similar to the following:
Response
{ "data": { "linkPropertyDefinitionCollection": { "hub": { "id": "urn:adsk.ace:beta.scope:e7c7f5a9-a88a-40b4-85f6-ba1454def997" } } } }Show More
Step 2 - Validate if the Property Definition Collection is Linked
To confirm whether a property has been successfully linked, you can fetch the property collection details using the PropertyDefinitionCollection field in hub query.
- Enter the following query in the Query Pane of the Manufacturing Data Model Explorer.
Query
query GetHub($hubId: ID!) { hub(hubId: $hubId) { id name propertyDefinitionCollections { results { id name description definitions { results { id name propertyBehavior } } } } } }Show More
- In the Query Variables Pane, enter the value of the
hubId. To know how to obtain thehubId, refer to Retrieve Hubs.Query Variables
{ "hubId": "urn:adsk.ace:beta.scope:820457c5-9637-4a85-a03a-526759b67b5b" }
- Click Play. The response will display property definition collections linked within a hub. You can expect a response similar to the one shown in the following code block.
Response
{ "data": { "hub": { "id": "urn:adsk.ace:beta.scope:820457c5-9637-4a85-a03a-526759b67b5b", "name": "Shubham's Team", "propertyDefinitionCollections": { "results": [ { "id": "cHJvcGRlZmNvbH5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5wcm9wX2RlZl9jb2xfMTcyODQ2NDYxMTE2MQ", "name": "prop_def_col_1728464611161", "description": "collection description", "definitions": { "results": [ { "id": "cHJvcGRlZn5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5wcm9wX2RlZl9jb2xfMTcyODQ2NDYxMTE2MX5wYXJhbWV0ZXJzLkFDTjRFdmRITE1UWml3N25ma0hVcFBqc0E0VmZaYW5UOmFhYTI3NDUzM2M4OTRhZmNiMmZhZjVkOWEwODQ0ZTY5LTEuMC4w", "name": "Base Property", "propertyBehavior": "STANDARD" }, { "id": "cHJvcGRlZn5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5wcm9wX2RlZl9jb2xfMTcyODQ2NDYxMTE2MX5wYXJhbWV0ZXJzLkFDTjRFdmRITE1UWml3N25ma0hVcFBqc0E0VmZaYW5UOjMwMmJiM2Y5ZDhlYTQwYTU4N2U4OGZmNDNmYzkzNDBjLTEuMC4w", "name": "Base Property 1", "propertyBehavior": "STANDARD" } ] } }, { "id": "cHJvcGRlZmNvbH5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5GaXJzdENvbGxlY3Rpb24", "name": "FirstCollection", "description": "", "definitions": { "results": [ { "id": "cHJvcGRlZn5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5GaXJzdENvbGxlY3Rpb25-cGFyYW1ldGVycy5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVDplZGI5NDZmOGJmMmQ0ZjdiYmY5N2Y1ZTg2OGUxZTM3MS0xLjAuMA", "name": "dublicate", "propertyBehavior": "STANDARD" }, { "id": "cHJvcGRlZn5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5GaXJzdENvbGxlY3Rpb25-cGFyYW1ldGVycy5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVDphODk3ZjNjNzkwYjE0YjRiOTQzOGE3NmYzNDQ4YTRmNy0xLjAuMA", "name": "DYNAMIC", "propertyBehavior": "STANDARD" }, { "id": "cHJvcGRlZn5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5GaXJzdENvbGxlY3Rpb25-cGFyYW1ldGVycy5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVDo4MjA1Y2E4NjkzOTM0MDAxOGU0Mzk4OWNjZDQxNjExMi0xLjAuMA", "name": "Timeless", "propertyBehavior": "TIMELESS" }, { "id": "cHJvcGRlZn5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5GaXJzdENvbGxlY3Rpb25-cGFyYW1ldGVycy5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVDo2NGJjZDdkMDc2MGU0Mzc1YjE4NmUwMTk0ZTBmMDhmMy0xLjAuMA", "name": "Standard", "propertyBehavior": "STANDARD" }, { "id": "cHJvcGRlZn5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5GaXJzdENvbGxlY3Rpb25-cGFyYW1ldGVycy5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVDoyNjBmMDhiYWYwNGM0ZWQwYTdmNjMzNjMzMDY1M2UwZS0xLjAuMA", "name": "temp", "propertyBehavior": "STANDARD" } ] } }, { "id": "cHJvcGRlZmNvbH5DZlhvYUM0SzUzU1R3YjZUbklyWFhaVEFJRWRkRzlBcn5DZlhvYUM0SzUzU1R3YjZUbklyWFhaVEFJRWRkRzlBcn5wcm9wX2RlZl9jb2xfMTcyODQ2MzIxODA5Mg", "name": "prop_def_col_1728463218092", "description": "collection description", "definitions": { "results": [] } }, { "id": "cHJvcGRlZmNvbH5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5wcm9wX2RlZl9jb2xfMTczODE1ODA2NTE3MQ", "name": "prop_def_col_1738158065171", "description": "collection description", "definitions": { "results": [ { "id": "cHJvcGRlZn5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5BQ040RXZkSExNVFppdzduZmtIVXBQanNBNFZmWmFuVH5wcm9wX2RlZl9jb2xfMTczODE1ODA2NTE3MX5wYXJhbWV0ZXJzLkFDTjRFdmRITE1UWml3N25ma0hVcFBqc0E0VmZaYW5UOjBjMWU4NzEwZThhMjQ5NzJiNTAzMGMyNDBiMWQ3Y2IxLTEuMC4w", "name": "material length", "propertyBehavior": "STANDARD" } ] } }, { "id": "cHJvcGRlZmNvbH5nNXFkdWVDNWJEZXE2dkU0RHhqSjVibzNBVzJZUElVeX5nNXFkdWVDNWJEZXE2dkU0RHhqSjVibzNBVzJZUElVeX5UZXN0X2NvbGxlY3Rpb25fVmluaXQ", "name": "Test_collection_Vinit", "description": "Test_collection_Vinit", "definitions": { "results": [ { "id": "cHJvcGRlZn5nNXFkdWVDNWJEZXE2dkU0RHhqSjVibzNBVzJZUElVeX5nNXFkdWVDNWJEZXE2dkU0RHhqSjVibzNBVzJZUElVeX5UZXN0X2NvbGxlY3Rpb25fVmluaXR-cGFyYW1ldGVycy5nNXFkdWVDNWJEZXE2dkU0RHhqSjVibzNBVzJZUElVeToyNjU5YTY3ZjVhZjc0NDAwOTMzNGVjNWYzMDI4MDBjZi0xLjAuMA", "name": "Standard_String", "propertyBehavior": "STANDARD" } ] } } ] } } }, "extensions": { "pointValue": { "requestedQueryPointValue": 73 } } }Show More