共用方式為


Autodesk 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 Data Exchange Team
URL https://aps.autodesk.com/contact-support
Email data.exchange.support@autodesk.com
Connector Metadata
Publisher Autodesk Inc.
Website https://aps.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, Rhino parameters, and more. 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 (2023) 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) in a US-based hub. Moreover, an Autodesk Construction Cloud admin must enable the connector for your account.

You can author and edit Data Exchanges in two ways: through Autodesk Docs for published Revit 2023 models and directly through Revit (2023) or Rhino 7 by using the Revit and Rhino Connectors, respectively. While you can create and update exchanges without Revit or Rhino in the former method – that is, through Autodesk Docs – for the latter method, you will need to install Autodesk Revit 2023.

In the following section, we will walk you through a step-by-step tutorial for one of our supported workflows – sending an automated notification based on exchange updates. If you want to learn how to walk through a similar step-by-step tutorial for extracting data from an exchange to an Excel sheet, check out this link. You can of course always refer to our templates to get started even faster.

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-level access) 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-level access) 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-level access) 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-level access) 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 Power Automate flows!

image

Get started with your connector

Step 1: Navigate to the Autodesk Data Exchange Connector.

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 “Teams 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, make sure the "Post as" section shows "Flow bot". For the "Post in" section, select "Chat with Flow bot". Fill out the email recipient address in the “Recipient” section. In the “Message” section, 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 Teams message.

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 Data Exchange connector.

Get properties of objects by filter

The Get properties of objects by filter action allows you to extract properties of objects by filter.

Filter objects by category

You can now select the Category, Family or Type filter to extract elements that pass the selected filter.

Filter objects by category

Type a value in the ‘Filter Value’ field to extract specific elements that you want. For example, to extract the elements that fall under the "Roofs" category, the user can enter ‘Roofs’ in the Filter Value. Similarly, to extract all the elements which are of "Basic Wall" family, the user can enter ‘Basic Wall’ as the filter value. Refer to the standard Revit 2023 categories, families, and types for reference.

Unit Conversion: We can apply an additional unit conversion on the extracted Length, Area, and Volume properties. Select the ‘Metric’ or ‘Imperial’ Unit types.

Filter objects by category

You can further select the units – such as inches, feet, meters, and centimeters – based on the Unit Type that you selected earlier.

Filter objects by category

Get properties of objects

The Get properties of objects action allows you to extract properties of a Data Exchange in bulk, without the more specific filters mentioned in the previous action. You can select ‘All Properties’ to extract all properties or ‘Latest Properties’ to extract only the properties that were updated in the last exchange revision.

Data Exchange Properties

**Important:** Note that this action will be deprecated in an upcoming release, and merged with ‘Get properties of objects by filter’ action to provide all property extraction features and filters under one action.

Get details about a Data Exchange

The Get details about a Data Exchange action allows you to get details like Exchange identifier, Exchange URN, Exchange version, Hub name, Project name, Created by, Modified by, etc, for the selected Data Exchange.

Get details about a Data Exchange

Known issues and limitations

  • The Revit element parameter values are represented in metric irrespective of the units specified on the source model. You can use the "Get properties of objects by filter" action to convert the units as desired.
  • 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 objects 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 objects 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 objects 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.

FAQ

  • How can I get more details on a flow that has failed?

    You can get details about why the Data Exchange flow failed by providing the Data Exchange URN and selecting the OUTPUT option. The details of the flow along with the common error messages are displayed in a browser.

    a. Specify the Data Exchange URN.

    Get Data Exchange details

    b. Click the ‘Click to download’ button under OUTPUTs.

    Error message

  • How do I resolve the ‘Invalid Connection’ error seen when editing a flow?

    If you encounter this error while editing a flow using a specific connection, you must re-authenticate to establish the connection again to the Autodesk Data Exchange Connector. To re-authenticate and re-establish the connection, perform the following steps:

    a. Open the Connections page under Data -> Connections.

    Re-authenticate connections

    b. Search for the the Autodesk Data Exchange connection, and click the three dots kebab icon (...) for more options on the connection.

    c. Select ‘Switch Account’ option. This should open a Sign in page that will allow you to enter your credentials again and re-authenticate your connection.

  • Will deletion of an exchange execute the ‘When a Data Exchange is updated’ trigger that's associated with the exchange?

    Yes. When you delete a Data Exchange, it will execute the ‘When a Data Exchange is updated’ trigger that is linked to the exchange. However, if you try to extract the properties of a deleted exchange, you will get inconsistent output. We are working to resolve this.

  • Does a unit conversion inside ‘Get properties of objects by filter’ apply to all properties of the Data Exchange?

    The current unit conversion will be applied only on Length, Area, and Volume properties of a Data Exchange. The conversions will not be applied on other properties of the exchange. We are working to expand the property types supported for unit conversion.

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 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 (deprecated) [DEPRECATED]

This action has been deprecated. Please use Get details of a Data Exchange property instead.

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

Get properties of a Data Exchange (deprecated) [DEPRECATED]

This action has been deprecated. Please use Get properties of objects instead.

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

Get properties of objects

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

Get properties of objects by filter

This operation gets the properties of objects of a Data Exchange filtered by selection.

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 (deprecated) [DEPRECATED]

This action has been deprecated. Please use Get details of a Data Exchange property instead.

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

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 (deprecated) [DEPRECATED]

This action has been deprecated. Please use Get properties of objects instead.

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

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.

Get properties of objects

This operation gets the properties of objects 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.

Get properties of objects by filter

This operation gets the properties of objects of a Data Exchange filtered by selection.

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

Filter By
filterBy True string

Filter by Category, Family or Type

Filter Value
filterValue string

Enter a value

Unit Type
selectedUnitType string

Unit Type for Length, Area and Volume properties

Unit
selectedUnit string

Unit for Length, Area and Volume properties

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

Deleted
payload.hidden boolean

Is Data Exchange deleted

Data Exchange file name
payload.custom-metadata.file_name string

Name of the Data Exchange

Modified By
payload.context.lineage.lastModifiedUserName string

Modified By