Autodesk Forge Data Exchange (Preview)

Unleash your productivity and streamline collaboration by connecting design and make data between Revit and the tools of your choice.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Autodesk Forge Data Exchange Team
URL https://forge.autodesk.com/contact-support
Email data.exchange.support@autodesk.com
Connector Metadata
Publisher Autodesk Inc.
Website https://forge.autodesk.com
Privacy policy https://www.autodesk.com/company/legal-notices-trademarks/privacy-statement
Categories Data;Collaboration

Through data exchanges, you and your collaborators can share and use subsets of design-and-make data in your app of choice. Automatically receive notifications in Slack or Microsoft Teams when updates to your exchange occur. Create costing spreadsheets based on specific Revit categories. Or even generate insightful Power BI dashboards that include only the information you want to share, such as data associated with a specific set of rooms.

Currently available for Revit data through the Autodesk Construction Cloud.

Prerequisites

In order to use this connector - as well as create, share, and make use of data exchanges - you will need an Autodesk Construction Cloud license (or trial license). Moreover, an Autodesk Construction Cloud Admin must enable the connector for your account.

Because data exchanges are based off published Revit 2023 models, if you do not have access to either, then you need to install Autodesk Revit 2023 as well.

How to get credentials

Step 1: Sign up for a free Autodesk Construction Cloud trial license here (or use your existing license).

image

Step 2: (Requires Autodesk Construction Cloud Admin) After creating your account and logging in, navigate to the "Account Admin" page for the entire account / hub.

image

Step 3: (Requires Autodesk Construction Cloud Admin) In the "Account Admin", click on the "Apps" tab and select the "Power Automate" integration from the list of apps.

image

Step 4: (Requires Autodesk Construction Cloud Admin) If the integration is not installed, click on "Install" button to connect it to your Autodesk Construction Cloud account.

image

Step 5: (Requires Autodesk Construction Cloud Admin) Lastly, click "Authorize and Install" to complete the integration. The integration should now be shown as "Activated" for your hub / account. Now you can start creating automations!

image

Get started with your connector

Step 1: Navigate to the Autodesk Forge Data Exchange Connector. (LINK REQUIRED)

Step 2: Choose a template. You can start with sending an email or message when an exchange updates or begin to explore more complex templates, such as populating an Excel table with specific properties from your exchange. In the steps below, we cover the automated "email notification on exchange creation" template.

Step 3: Sign in with your Autodesk and Microsoft accounts - click "Continue".

image

Step 4: Name your Flow.

Step 5: In the first code block, the Flow Trigger, choose your hub / account. Then choose your project, and your folder.

image

Step 6: Leave the second code block filled with the "Exchange URN".

image

Step 7: In the third code block, file out the email recipient address in the "To" section. In the "Subject" and "Body" sections, you can add dynamic content related to the exchange (e.g., "Created by", "Time modified", etc.) as well as plain text to craft your automated email.

image

Step 8: "Save" your flow once you’re satisfied. We recommend you test your Flow before running it by clicking on the "Test" button on the top right.

Step 9: Congrats! You’ve created your first automation with the Autodesk Forge Data Exchange connector.

Known issues and limitations

  • The Revit element parameter values are represented in metric irrespective of the units specified on the source model.
  • There is no localization support for parameter names currently. The built-in parameters will be available in English while the shared/project parameters will be available in the language used for their creation.
  • Parameters of type Enumeration will currently only return the numeric value and not the string value.
  • The Get properties of a Data Exchange action can return a maximum of 1024 dynamic parameter names. For exchanges that contain more than 1024 unique parameters, the list will be truncated to contain the top 1024 parameters.
  • The Get properties of a Data Exchange action when used with the Latest properties option will not return records if only Type parameters have been changed. If the corresponding instance parameters have also been changed then both type parameters as well as instance parameters will be returned correctly.
  • The Get properties of a Data Exchange action returns all the possible parameters within the selected Exchange. In some cases, there may be different parameters that have the same user-visible name.
  • Reference Parameters require an additional look up via the Get details of a Data Exchange property action to extract one or more fields from the referenced asset.

Throttling Limits

Name Calls Renewal Period
API calls per connection10060 seconds

Actions

Get details about a Data Exchange

This operation gets details about a Data Exchange such as its Autodesk Docs project name, author of the file, and the last modified time, etc.

Get details of a Data Exchange property

This operation gets details of a property associated with a Data Exchange.

Get properties of a Data Exchange

This operation gets the properties of a Data Exchange. You can specify to get all the properties or only the latest properties.

Get details about a Data Exchange

This operation gets details about a Data Exchange such as its Autodesk Docs project name, author of the file, and the last modified time, etc.

Parameters

Name Key Required Type Description
Data Exchange
fileId True string

Select the Data Exchange in Autodesk Docs

Returns

Exchange data

Get details of a Data Exchange property

This operation gets details of a property associated with a Data Exchange.

Parameters

Name Key Required Type Description
Data Exchange
fileId True string

Select the Data Exchange in Autodesk Docs

Property identifier
assetid True string

Property identifier for a property within the selected Data Exchange

Returns

The outputs of this operation are dynamic.

Get properties of a Data Exchange

This operation gets the properties of a Data Exchange. You can specify to get all the properties or only the latest properties.

Parameters

Name Key Required Type Description
Data Exchange
fileId True string

Select the Data Exchange in Autodesk Docs

Get all or latest properties
getlatest True string

Get all or latest properties for the selected Data Exchange

Next page of properties
cursor string

A pagination token for the next page of properties

Returns

The outputs of this operation are dynamic.

Triggers

When a Data Exchange is created

This operation triggers a flow when a Data Exchange is created.

When a Data Exchange is updated

This operation triggers a flow when a Data Exchange is updated.

When a Data Exchange is created

This operation triggers a flow when a Data Exchange is created.

Parameters

Name Key Required Type Description
Hub
hubId True string

Select the hub (account) for the Data Exchange in Autodesk Docs

Project
projectId True string

Select the project for the Data Exchange in Autodesk Docs

Top Folder
topFolderId True string

Select the top folder for the Data Exchange in Autodesk Docs

Exchange Folder
folderId True string

Select Exchange Folder to Monitor

Returns

When a Data Exchange is updated

This operation triggers a flow when a Data Exchange is updated.

Parameters

Name Key Required Type Description
Hub
hubId True string

Select the hub (account) for the Data Exchange in Autodesk Docs

Project
projectId True string

Select the project for the Data Exchange in Autodesk Docs

Top Folder
topFolderId True string

Select the top folder for the Data Exchange in Autodesk Docs

Data Exchange
folderId True string

Select the Data Exchange in Autodesk Docs

Returns

Definitions

ExchangeData

Exchange data

Name Path Type Description
Hub Name
hubName string

Hub name in Autodesk Docs

Project Name
projectName string

Project name in Autodesk Docs

Folder Name
folderName string

Folder name in Autodesk Docs

Collection Id
collectionId string

Collection Id

Id
id string

Id

Version
version string

Exchange Version

Source version URN
sourceVersionUrn string

Source version URN

Hosting provider name
hostingProviderName string

Hosting provider name

Exchange project URN
exchangeFileProjectUrn string

Exchange project URN

Base source version URN
baseSourceVersionUrn string

Base source version URN

Exchange folder URN
exchangeFileFolderUrn string

Exchange folder URN

Data Exchange file name
exchangeFileName string

Name of the Data Exchange

Exchange URN
exchangeFileUrn string

Exchange URN

Exchange version URN
exchangeFileVersionUrn string

Exchange version URN

Created by
createdBy string

Created by

Created
created string

Created

Last modified by
lastModifiedBy string

Last modified by

Last modified
lastModified string

Last modified

ExchangeAdded

Name Path Type Description
Time modified
payload.modifiedTime string

Time modified

Data Exchange file name
payload.name string

Name of the Data Exchange

Exchange URN
payload.lineageUrn string

Exchange URN

Created by
payload.context.lineage.createUserName string

Created by

Modified By
payload.context.lineage.lastModifiedUserName string

Modified By

VersionAdded

Name Path Type Description
Exchange URN
hook.hookAttribute.fileId string

Exchange URN

Last modified
payload.modifiedTime string

Last modified

Data Exchange file name
payload.name string

Name of the Data Exchange

Modified by
payload.modifiedBy string

Modified by