ACC Download File

Overview

The ACC Download File node allows you to download a file from Autodesk Construction Cloud (ACC) to your local working folder within the automation workflow. It connects to ACC using your configured service account and retrieves the specified file based on its identifier.

---

Purpose

Use this node to:

• Retrieve files stored in ACC for use in downstream workflow tasks.
• Automate file downloads from specific projects or hubs within ACC.
• Integrate downloaded ACC files into your local processing pipelines.

---

Inputs

Label	Input Type	Description	Required	Example
Hub Name	Text	The name of the Autodesk Construction Cloud Hub containing the project.	✅ Yes	My ACC Hub
Project Name	Text	The name of the Project within the specified Hub.	✅ Yes	Design Project X
File Identifier	Text	The ACC File Identifier (URN or GUID). If not found by ID, the system will attempt to resolve by path.	✅ Yes	urn:adsk.wipprod:fs.file:...

---

Outputs

Output Variable Name	Description
DownloadedFile	Full local path to the downloaded file in working folder.
AccFile	The ACC File metadata object returned from the API.

---

Behaviour

1. Service Account Retrieval
   Retrieves the Autodesk service account token configured in your system.

2. Hub and Project Validation
   Validates the provided hub and project names against the authenticated account to ensure correct context.

3. File Retrieval
   Attempts to get the file by its ID. If not found, it attempts to resolve the file by path.

4. File Download
   Downloads the file to the workflow working folder.

5. Result

   • Sets DownloadedFile in the workflow data to the local file path.
   • Sets AccFile to the file metadata.
   • Marks the task as completed if successful.

---

Example Use Case

You have a file in ACC that needs to be processed for reporting or document conversion. Using DownloadAccFile, you can automate retrieving this file for use in subsequent workflow nodes, such as PDF conversion, CAD parsing, or archiving.

---

Error Handling

This node will fail with a clear message if:

• The Hub or Project is not found or accessible.
• The File Identifier is invalid or the file cannot be resolved.
• Download fails due to API errors or permission issues.

---

Notes

⚠️ Important:

• Ensure that your Autodesk service account has access to the hub and project.
• The file identifier should ideally be the exact ACC file ID for fastest retrieval.
• The node stores the downloaded file in the workflow’s working folder for subsequent node usage.

---

Areas for Manual Completion

✅ Confirmed: All mandatory input fields and outputs are covered.
🔲 To confirm manually:

• Exact naming of outputs in front-end modal configuration if different from DownloadedFile and AccFile.

---