ACC Add File

Overview

The AddACCFile node allows you to upload a local file to Autodesk Construction Cloud (ACC) by specifying the target Hub, Project, and Folder within your connected ACC environment.

This node is useful when automating document management workflows requiring files to be stored within ACC for team access, compliance, or downstream automation.

---

Inputs

Label	Input Type	Description	Required
Hub Name	text	The name of the ACC Hub where the project resides.	✅
Project Name	text	The name of the project within the Hub.	✅
Full Path to File	text	The full local file system path to the file you wish to upload. E.g. C:\Files\Drawing.pdf	✅
Folder Identifier	text	The folder identifier (GUID or path) within the ACC project where the file will be uploaded.	✅
ThirdParty-Autodesk	service account	The Autodesk service account to use for authentication. (System populated; not user visible in form)	✅

---

Outputs

Name	Description
AccFile	The BIMFile object representing the uploaded file. Contains metadata such as file ID, name, version, and storage location.

---

Functionality

1. Validation

   • Ensures all required inputs are provided.
   • Confirms the specified local file exists before proceeding.

2. Authentication

   • Uses the provided Autodesk service account to authenticate against ACC.

3. Hub & Project Resolution

   • Retrieves the list of hubs and locates the specified Hub Name.
   • Retrieves the list of projects within the hub and locates the specified Project Name.

4. Folder Resolution

   • Attempts to retrieve the folder by its identifier.
   • If not found by ID, attempts retrieval by path.

5. File Upload

   • Uploads the local file to the resolved folder within ACC using the AccDocsService.
   • Returns the uploaded BIMFile metadata as output.

6. Error Handling

   • Returns a failed task status with descriptive messages if:
     • Authentication fails
     • Hub or Project cannot be found
     • File does not exist locally
     • Folder cannot be found
     • Upload fails

---

Example Use Case

✅ Scenario: You have generated PDF drawings in an earlier workflow node and need to upload them to a specific project folder within ACC for team collaboration.

• Hub Name: My Company Hub
• Project Name: Project ABC
• Full Path to File: C:\Generated\Drawing-RevA.pdf
• Folder Identifier: b.1234abcd5678efgh (example folder GUID)

Upon successful execution, the file will be available in the specified folder within Autodesk Construction Cloud.

---

Implementation Notes

⚠️ Areas to Confirm / Manually Update

• Folder Identifier Input: Confirm whether this input should always be GUID or if folder path (e.g. /Plans/Drawings) is valid in your current implementation.
• Output BIMFile Object Schema: Document the properties of BIMFile if needed for end-user clarity.

---

Status Returns

Status	Description
Completed	File was uploaded successfully.
Fail	Includes reason such as file not found, authentication failure, or upload error.

---

Task Type

Type	Value
Node Type	Task
Task Type	AddACCFile

---