Using AEC Data Model Nodes
Once the Data Connector for Dynamo is installed, it can be accessed through either Revit or Dynamo Sandbox software. For more details, please refer to the Data Connector for Dynamo - Install and Update topic. All the AECDM nodes will be listed under the Add-ons section in the Autodesk Data Models library.
Nodes
The Autodesk Data Models library consists of the following nodes:
- Hubs
- Projects
- Items
- Data Object
- Object Filter
- Property Selection
The detailed explanation of all the above nodes is as follows:
Hubs
The Hubs node allows you to retrieve details related to the Hub you select.
When you click on the Hubs node, it initiates an authentication process and executes a query to retrieve hub details such as the hub ID and hub name. These details are then sent to the output node. The output node can be used as an input for other nodes such as Projects.
Click the Hubs node from the Autodesk Data Models library.
The Hubs node will get placed on the canvas.
Projects
The Projects node allows you to retrieve all the projects available within a specified Hub.
It requires two inputs:
- Hubs: This is the Hub ID obtained from the output of the Hubs node. Please refer to the Hubs topic to know how it works.
- Project Name (string): This is an optional input. If this input is not provided, the node will retrieve all the Projects within the hub. However, if you provide a Project Name, the node will specifically retrieve the project that matches the provided name within the hub.
| Supported Input Type | Expected Output |
|---|---|
| Hub ID Project Name |
List of projects |
Click the Projects node from the library.
Connect the Hub ID obtained from the Hubs node to the Hubs input of the Projects node.
If a string input is provided to the Project Name, the Projects Node will filter the projects based on this criteria and display only the projects that match the provided input.
Items
The Items node allows you to retrieve all the Items (AEC designs in rvt format) within a specified project.
It requires three inputs:
- Projects: This is the Project ID obtained from the output of the Projects node. Please refer to the Projects topic to know how it works.
- ItemFilterInput (string): This is an optional input. If this input is not provided, the node will retrieve all the items within the project. However, if you provide a ItemFilterInput, the node will specifically retrieve the item that matches the provided name within the project.
- Refresh Data: This is an optional input. If you want to clear cache data from the Items node, provide a true (bool) value to the Refresh Data Input.
| Supported Input Type | Expected Output |
|---|---|
| Projects Item ID or Name Refesh Data |
List of Items |
Click the Items node from the library.
Connect the output of the Projects node to the input of the Items node. This will fetch all the items present in the project and send it to the output node.
Data Object
The Data Object node allows you to retrieve the element properties associated with the Items.
It requires four inputs:
- Items: This is the Items ID obtained from the output of the Items node. Please refer to the Items topic to know how it works.
- Property Selection: This is an optional input. Please refer to the Property Selection topic to know how it works.
- Object Filter. This is an optional input. Please refer to the Object Filter topic to know how it works.
- Refresh Data: This is an optional input. If you want to clear cache data from the Data Object node, provide a true (bool) value to the Refresh Data Input.
| Supported Input Type | Expected Output |
|---|---|
| AEC Design (Items) Property Selection Object Filter Refresh Data |
List of Properties |
Click the Data Object node from the library.
Connect the output of the Hubs node to the input of the Projects node. Then connect the output of the Projects node to the input of the Items node. From the Items node, a specific index input is provided to the Data Object node. This allows the Data Object node to fetch the properties of the element at the specified index.
Object Filter
The Object Filter node allows you to retrieve objects based on selected property and its value.
The Object Filter node takes input from the Items node. Within the Object Filter node, you can retrieve objects based on selected property and its value. This can be done by selecting the desired properties and its value from the combobox. This node's output is then passed to the Data Object node, which retrieves the elements that match the selected property and value.
| Supported Input Type | Expected Output |
|---|---|
| AEC Design (Items) | List of selected property and its values |
Click the Object Filter node from the library.
Connect the output of the Hubs node to the input of the Projects node. Then connect output of the Projects node to the input of the Items node. From the Items node, a specific index input is provided to the Object Filter node. This allows the Object Filter node to filter the elements based on the specified index.
Property Selection
The Property Selection node allows you to choose the necessary properties associated with the Items.
The Property Selection node takes input from the Items node. Within this node you have the option to select the properties you need. This can be done by using the drop-down menu to choose the properties you prefer. Once you've picked the properties, pass the output from the Property Selection node to the Data Object node. The selected list of properties is received in the output node.
| Supported Input Type | Expected Output |
|---|---|
| AEC Design (Items) | List of Selected Properties |
Click the Property Selection node from the library.
Connect the output of the Hubs Node to the input of the Projects Node. Then connect The output of the Projects Node to the input of the Items Node. The output of the Items Node is further connected to the input of the Property Selection Node. The selected list of properties will be received in the output node
