If you're looking to connect to Autodesk Construction Cloud or BIM 360 Hub through the AutodeskDocsConnector, please see Adding FME through the Autodesk App Store for Use in the AutodeskDocsConnector for a simpler and recommended method to connect. Both of these methods will allow you to connect to your ACC and BIM 360.
Introduction
When constructing a workflow in FME, users may want to connect to and pull data from the Autodesk Construction Cloud or BIM360. This can be done by using the AutodeskDocsConnector transformer and setting up an Autodesk Docs web connection.
This article will walk through the two different ways to set up an Autodesk Docs web connection. This web connection is provided as part of the Autodesk Docs package, which is available on the FME Hub and contains the Autodesk Docs (safe.autodesk-docs) web service definition.
There are two methods to set up a web connection for use in the AutodeskDocsConnector to access Autodesk Docs: one through the Autodesk Construction Cloud (ACC), and the other through BIM 360 Hub.
How to Create an Autodesk Docs Web Connection
To get the web connections working for your organization with your own Client ID and secret, you will need:
- Access to Autodesk Platform Services(formerly known as Forge) — If you don’t have access, share these instructions with your Administrator who can set the application up for you.
- Access to Autodesk BIM 360 Hub or Autodesk Construction Cloud
This service definition, safe.autodesk-docs, is provided
by Safe Software for demonstration purposes and ease of use. The Client ID
and
Client Secret may become deactivated at any time.
For production use, we recommend users obtain their own Client ID and Client
Secret from the web service provider.
Set Up Your Application in Autodesk Platform Services
In order to configure the web service correctly, you will need to retrieve/configure an app in Autodesk Platform Services(APS) and BIM 360.
- APS App
- Redirect URI
- Client ID & Client Secret
- BIM 360 Hub: Custom Integration
The final step is to gather the above information and edit the web service in FME:
Configure the web service in FME
Autodesk Platform Services(APS) App
For Application Type, ensure you are selecting the ‘Traditional Web App’.
At a minimum, the app must have access to BIM 360 and Data Management APIs.
Redirect URI/Callback URL
When configuring the Forge App, you will need to also configure the callback URL, which will be used for the Redirect URI.
In FME, you will need to set the Redirect URI so that it is consistent between FME and the APS App.
Client ID and Client Secret
Once you have created the app, the details of the app will have the Client ID and Client Secret. Take note of these for use in BIM 360 Hub and in FME.
Autodesk Construction Cloud or BIM 360 Hub: Custom Integration
It is also required to add the chosen Forge App as a custom integration on the BIM 360 Hub page or via Autodesk Construction Cloud.
Setting up with ACC will require an extra navigation step detailed below before continuing with the BIM 360 Hub instruction. If you wish to set up using the BIM 360 Hub only, skip to the BIM 360 Hub.
Custom Integration Via Autodesk Construction Cloud
As an admin, sign in to Autodesk Construction Cloud by going to https://construction.autodesk.com/ and navigate to Account Admin > BIM 360 admin > Settings > Custom Integrations
After selecting Settings, continue with the instructions below to set up the Custom Integrations.
Custom Integration Via BIM 360 Hub
To set up via BIM 360 Hub, an admin can do this by going to https://admin.b360.autodesk.com/ and login with their credentials, then navigating to Settings > Custom Integrations > Add Custom Integration
Setting up the Custom Integration
Here you can select what access the custom integration will have:
Select I’m the developer and then enter the Client ID of the connected APS App (still referred to as Forge when configuring the app).
Configure the web service in FME
In FME Workbench, open up the Manage Web Services dialog. You can get to this from Utilities > FME Options > Web Connections > Manage Services
You will need to edit the Autodesk Docs (safe.autodesk-docs) web service. If it isn’t installed, you must first download it from the Manage Web Services page:
Complete your web service configuration by entering in your Client ID and Secret, and the Redirect URI matches the callback URL that is specified for your application in APS:
Save your web service and create a new web connection by clicking the “+” sign from FME Options or the AutodeskDocsConnector:
You can now begin using your web connection with the AutodeskDocsConnector.