Asite CDE Connector for Autodesk Construction Cloud
The Asite CDE Connector enables a secure bi-directional exchange of documents and metadata between Asite CDE and Autodesk Construction Cloud (ACC).
This integration enables project teams to always work with synchronised and up-to-date information, supporting collaboration on large and complex projects.
Main Features
Secure, trusted platforms with a full audit trail.
Simple configuration and management.
Real-time document exchange.
Bi-directional synchronisation of documents and metadata.
Trigger-based automations to improve efficiency.
Prerequisites
Privileges
The following privileges are required to configure and manage the integration.
Privilege | Description |
Webhook Enablement | Required to configure webhooks for integrations. |
Can Manage Integrations - Own Org | Allows the user to manage integrations for their own organisation. |
Enable ACC Integration - Own Org | Allows the user to enable the ACC integration for their own organisation. |
NOTE: All the privileges listed above are enabled by Asite Support at a user level. They must be granted to the user configuring the integration. To request any of these privileges, contact support@asite.com
Subscriptions and Plugins
The following subscriptions and plugin are required.
Subscription/ Plugin | Description |
Asite CDE | An active Asite CDE subscription is required. |
Autodesk Construction Cloud | An active ACC subscription is required. |
Asite Autodesk Construction Cloud Connector | A plugin within ACC apps. You must be an ACC Account Admin to see this option in ACC. |
NOTE: For assistance on any of the above, contact the Support Team at support@asite.com.
System Requirements
The following system requirement must be met before the integration can be enabled.
Requirement | Description |
Whitelisted Call Back URL for Organisation |
|
Setting Up an Integration
To enable integration between Asite CDE and ACC, there are four main steps:
Create an Integration
Map Projects, Folders, Files and Attributes
Set Up Webhook
Create a Trigger
(1) How Do I Create an Integration with Autodesk Construction Cloud?
Log in to your Asite account.
Click the More tab.
Select Admin from the dropdown.
Select Integrations from available options.
On the Integrations listing page, click Create Integration (top-right).
Select Autodesk Construction Cloud from the dropdown.
In the pop-up window, input the required details:
Organization
Email
Send Failure Notifications To
For additional information on these fields, see Available Options When Creating an Integration.
Click Save (bottom-right).
An Autodesk window will appear.
Enter your email address then click Next.
Enter your password and click Sign in.
On the Autodesk authorisation screen, click Allow.
Once complete, you will receive a success message and the integration will appear in your list of integrations.
Click Okay to continue.
Available Options When Creating an Integration
Name | Function |
Integration | Select Autodesk Cloud Construction from the dropdown. |
Organisation | Enter the full name of your organisation or select it from the dropdown. |
Enter or select an email address from the dropdown. | |
Send Failure Notifications To | Enter one or more email addresses to receive failure notifications.
|
(2) How Do I Map Projects, Folders, Files and Attributes?
Mapping creates a bi-directional connection between Asite CDE and ACC. Once mapping is complete, updates made in one platform are reflected in the other automatically.
After creating an Integration, you must edit it to begin mapping projects, folders and attributes.
NOTE: The steps below assume the integration has already been created. If not, return to (1) How Do I Create an Integration?.
From within the Integrations page, click the Edit
icon next to your ACC integration listing.
In the Webhook Configuration pop-up, choose one of the following setup flows:
TIP: In the Webhook Configuration panel, the Edit Integration panel appears on the left-hand side and displays key details about the created integration.
You can click the Edit
icon to update the Email and Send Failure Notifications To fields.
For additional information on the available fields in this panel, check Available Fields in the Edit Integration Panel.
Available Fields in the Edit Integration Panel
Field | Description |
Integration | Indicates which platform is integrated. |
Partner ID | An automatically generated ID that is unique to ACC integrations. This value cannot be changed. |
Organisation | The name of the organisation that created the integration. |
The email address of the user who created the integration. | |
Send Failure Notifications To | One or more email addresses that will receive notifications if the integration encounters any failures. Multiple addresses must be separated by commas. |
(2.1) Enable Integration Using a Code Block
Select Code Block Setup.
Paste the required JSON Script in the code field.
Click Save Integration to enable the integration.
TIP: For detailed guide, check Set Up Asite and ACC Integration Using a Code Block.
(2.2) Enable Integration Using Step-by-Step Setup
Select Step-by-Step Setup.
When the option appears, click Map Project.
A mapping pop-up will open:
Left: Asite Data Centre (pre-set and cannot be changed).
Right: ACC Region and Hub.
From the Region dropdown, select the region that matches your ACC setup.
From the Hub dropdown, select the relevant ACC account name.
NOTE: The available hubs depend on your ACC access and may include hubs from multiple organisations. I.e. if you were given access to projects created by different accounts/ organisations on ACC, these account names will also appear under the Hub dropdown.
Once completed, click Next (bottom-right).
NOTE: Only one project can be mapped at a time. Repeat this process to map additional projects.
Select one project from Asite and one project from ACC.
Click Map Folder (bottom-right) to proceed.
To complete mapping later, click Save and Continue Later.
NOTE: A success message appears (top-right) when mapping is successful. This applies to all mapping stages.
Since projects are now mapped, select the folders you want to map next.
Map one folder from Asite to one folder in ACC.
Click Map Attribute (bottom-right) to proceed.
NOTE: Only one folder can be mapped at a time between Asite and ACC.
Next, map one attribute from Asite to one attribute from ACC.
NOTE: Only attributes of type date, dropdown, and textbox are supported.
Click Map Attribute Value (bottom-right).
If an attribute contains predefined values (e.g. dropdown values), the system will prompt you to map attribute values between Asite and ACC.
For each attribute value select one value from Asite then select the matching value from ACC.
Mapped values will appear at the top of the screen.
Repeat until all required values have been mapped.
NOTE: Attribute value mapping is only supported for dropdown attributes.
Click Save and Finish (bottom-right).
(3) Set up Webhook
NOTE: You must have Webhook enabled at a user level by Asite Support before completing the steps below. To request this, contact support@asite.com.
Log in to your Asite account.
Select the required Project.
Navigate to the Workflows tab.
Click + System Task (top-right).
In the pop-up, enter a recognisable name for the webhook task in the Name field.
Confirm that Document is selected in the Task Context field.
This value is preselected by default.
Select Webhook from the Task dropdown.
Once Webhook is selected as the task type, additional fields will automatically appear that are specific to webhook configuration.
Enter the Call Back URL configured for integration in ACC (https://integration.asite.com/integration/acc/callback).
This is a standard URL, however, it must be whitelisted by Asite Support for your organisation in order for it to work.
To request whitelisting, contact (support@asite.com).
Complete any additional fields if required. If not, click Create (bottom-right) to proceed.
Mandatory fields are marked with an asterisk (*), these include:
Name
Task Context
Task
Call Back URL
NOTE: For a detailed guide on webhook integration for project files, click here.
(4) Create a Trigger
Log in to your Asite account.
Select the required Project.
Navigate to the Workflows tab.
From the left-hand menu, select Workflow Triggers.
Click +Trigger (top-right).
In the Configure Trigger pop-up, fill in the required details.
TIP: For step-by-step guidance, see Create a Workflow Trigger for Files in a Project.
Click Create (bottom-right).
How Does the Trigger Activate the Integration?
Whenever the trigger conditions are met, a bi-directional exchange of information between Asite CDE and ACC will occur automatically, ensuring both platforms stay in sync.