Skip to content

ACC Get AEC Model Basic Data

The ACC Get AEC Model Basic Data node retrieves basic data for elements within Autodesk Construction Cloud (ACC) AEC Data Models using a simple GraphQL query based on provided filters and element groups.

Purpose

Use this node to quickly extract basic model data for specified elements and properties without requiring advanced AI-based parsing or complex query building.

Inputs

Field LabelInput TypeDescription
Element IdTextThe ID of the element group within the AEC Data Model to query.
FilterTextA GraphQL-compatible filter string to restrict which elements are returned (e.g. category or property filters).
Return PropertiesJSON ArrayA list of property names to include in the returned data (e.g. ["Width","Height","Family Name"]).

Outputs

Output VariableDescription
AecDataThe JSON string result containing a list of elements with their requested properties.

Functionality

This node:

  1. Validates required inputs (Element Id, Filter, Return Properties).
  2. Retrieves the Autodesk service account token from stored credentials.
  3. Executes a simple GraphQL query against the AEC Data Model API for the specified element group and filter.
  4. Returns the retrieved elements as a JSON string in the AecData output variable.

Example Use Case

✅ Retrieve all walls in a model with their height, width, and type properties for quantity take-off reports.
✅ Extract door elements with their family name and dimensions for an automated door schedule export.

Task Success Criteria

  • Success: Elements are retrieved from the AEC Model and stored as AecData.
  • Failure: If the service account is invalid, or if data retrieval fails, the task fails with a descriptive error message indicating the failure point.

Notes

  • Ensure the ThirdParty-Autodesk service account is configured with valid credentials and has access to the relevant AEC Data Models.
  • The Return Properties input must be a JSON array of property names to include in the output.
  • The output (AecData) is a JSON string representing a list of ElementResult objects as returned by the ACC API integration.

Tentech 2024