BIM360/ACC Data Flow Type

Admin Content

Add and Configure a BIM360/ACC Data Flow Type

Warning: BIM360/ACC (Autodesk Construction Cloud) uses AWS to store their files. However, when 12d Synergy requests data for ingress via their API, they provide a separate URL to download the associated files directly from their stores in AWS. This is a different/new connection that the 12d Synergy Server needs to create for the file download. Please ensure that the 12d Synergy Server can access AWS resources via HTTPS.

There are two steps involved in this configuration.

Step 1 - Create and Set up an App for BIM360 Data flow in Autodesk Construction Cloud and Autodesk Platform Services

1.1. Create an App for BIM360/ACC Data flow in Autodesk Platform Services

1. Access and log in to Autodesk Platform Services at https://aps.autodesk.com/.

2. Click the Go to my apps button and then click the Create application button. The Create Application prompt is displayed.
   

   

3. Enter a name for the application in the Name box. For example, say BIM360 12dSynergy Dataflow.

4. Select the Server-to-Server App option as the Application Type (as shown in the image above).

5. Click the Create button. A Server-to-Server app with the provided name is created.

   

6. Click the Copy icon displayed next to the Client ID and Client Secret credentials, and make a note of them. You will need them later.

7. Click the Save changes button.

1.2. Set Up the App in Autodesk Construction Cloud

1.2.1. Without SSA (Secure Service Account)

1. Access and log in to Autodesk Construction Cloud at https://acc.autodesk.com/projects to view all your projects.

2. Click the Account Admin link > Custom Integrations tab as shown below.

   

   
   Also, make note of the Autodesk Construction Cloud Account Name, TDSynergyDev, in the above example. This Account Name has to be entered in the 12d Synergy Administration application > Data Flows > Data Flows tab > Basic Configuration tab for ACC Data Flow > ACC Account Name configuration details’ Value column. (Please refer to step 10 in Step 2-Configure a BIM360 Data Flow type in the 12d Synergy Administration application)

3. Click the Add custom integration button.
   The Add custom integration prompt is displayed.

   

4. Enter the copied Client ID from step 6 of this procedure in the Autodesk Platform Services Client ID box.

5. Enter the name of the server-to-server app you created, BIM360 12dSynergy Dataflow, in the Custom integration name box.

6. Enter a brief description of the custom integration that you are setting up. The custom integration is added and displayed in the Custom Integrations tab shown above in step 2 of this procedure.

7. Select the app you just created from the displayed list (BIM360 12dSynergy Dataflow). The details of the BIM360 12dSynergy Dataflow are displayed to the right of the page.

   When adding the custom integration, you must be a member of the project you want to connect to.

1.2.2. With SSA (Secure Service Account)

V6.2.1 feature

1. Access the Autodesk Platform Services Sample SSA Management Tool at https://ssa-manager.autodesk.io/.

2. Log in with the Client ID and Client Secret ID that you created in procedure 1.1. above.
   All the existing SSA Accounts are displayed in the Accounts box. The details of the selected account in the Accounts box are displayed in the Account Details box.
   
   

   Whenever a data flow runs, a key is created and is displayed in the Keys box. As a user with administrative privileges, you can delete, enable, disable or create a key from this window.

3. Under the Accounts box, enter the First Name and Last Name in their respective boxes and click the Create Account with Name: button.
   
   

   The account is created and is displayed in the Accounts box.
   
   

4. Select the created account in the Accounts box.
   The Service Account ID  and an email address are displayed in the Account Details box. Make a note of these details, as you will be using them in the next steps.

5. Access Autodesk BIM360 (Autodesk Construction Cloud) at https://docs.b360.autodesk.com/ and log in with your credentials.
   The project you are accessing is displayed as shown below.
   
   

   Ensure that you are accessing the correct project in ACC.

6. Click the Document Management icon, and select the Project Admin option.
   
   

7. Click the Members menu and click the Add button.
   

   
   The Add Project Members page is displayed.
   
   

8. Copy the email address that is displayed in the Account Details box in step 4 of this procedure.
   The added user is displayed in the box.
   
   

9. Click the Select button.
   The details of the selected account are displayed.
   
   

10. Click the Add to Project button to add the created account to the project.
    The account/user is added to the project.

11. Click the Project Admin icon and select the Document Management option.
    
    
    All the existing folders with their details are displayed in the Folders tab.

12. Right-click the top-level folder (project) for which you want to update/give permissions to the created user, and select the Permission Settings option. (first top-level and then ingress/egress subfolder)
    

    All users with their assigned permissions are displayed in the Permissions -<Folder Name> panel on the right.
    
    

13. Search for the newly created user in the Search for name or email search box in the Permissions -<Folder Name> panel.

    • To update an existing user's permissions, select the user from the displayed list of members, right-click their permission level, and select the permission option you want to change to.

    • When you hover over a user, their email address is displayed. Check this to ensure you are giving permissions to the required user.

14. Click the Add button.
    The Add Permissions prompt is displayed with the newly created user you searched for in the Add New box.  
    
    

15. Select the permission option  (or combination of permissions) you want to provide to the user, and then click the Add button.
    The user is provided with the selected permissions and is displayed in the list of users in the Permissions -<Folder Name> panel.

16. Follow the same procedure (step 13 to step 16 of this procedure) to give users the permissions for ingressing and egressing files from/to 12d Synergy to/from BIM 360/ACC.
    The user is provided with the necessary permissions to ingress and egress files between 12d Synergy and the BIM360/ACC application.

Step 2 - Configure a BIM360/ACC Data Flow type in the 12d Synergy Administration application

1. In the 12d Synergy Administration application, select the Data Flows > Data Flows tab.

   
   

2. Click the Add button.

   The Upload a data flow window is displayed.

   

3. Click the ellipsis button in the Upload a data flow window.

   The Select a task library prompt is displayed.

4. Select the BIM360DataFlow.dll file in the Select a task library prompt and click the Open button.
   The path to the selected BIM360DataFlow.dll file is displayed in the Path box of the Upload a data flow window.

5. Click the Upload button.

   The data flow type is added, and a confirmation message is displayed.

6. Click the Ok button.
   The data flow type is displayed as ACC Data Flow in the left panel of the Data Flows tab

   The Basic Configuration and Profiles tabs are added to the 12d Synergy Administration application > Data Flows > Data Flows tab.
   
   

   By default, the added data flow type is Enabled, and its name is displayed in the Name box. The configuration details of the added data flow type are displayed in the Configuration section.

7. Select one of the following:

   • Stop on error option as the Error Behaviour.

     When an error occurs while working with the BIM360 Data Flow Type, selecting this option will stop the process and log the error.

   • Log and continue option as the Error Behaviour.

     When an error occurs while working with the BIM360 Data Flow Type, selecting this option will write an error message in the log files and continue processing the data flow, if possible.  

8. When the system encounters a blank value for an attribute, you can choose its reaction to it. Select one of the following options for the Blank Attribute Value field.

   • Skip the attribute

   • Write a null value

   • Write an empty value

9. In the Configuration section, do one of the following:

   • To use SSA Authentication

     • Select True from the Use SSA Authentication list.

     • Copy the Service Account ID from step 4 of 1.2.2. procedure and paste it in the  Value column adjacent to the Service Account ID row.

   • To not use SSA Authentication

     • Select False from the Use SSA Authentication list.

     • The Service Account ID is applicable only for SSA Authentication. Leave its value blank.

10. Enter the Client ID and Client Secret code in the Value column adjacent to the Client ID and Client Secret rows for accessing the ACC Data Flow Type in the 12d Synergy Client application. You can get these details from the copied content in step 6 of the Create and set up an app for BIM360 Dataflow in Autodesk Construction Cloud and Autodesk Platform Services above.

11. Also, enter the Autodesk Construction Cloud Account Name in the Value column of the ACC Account Name row. (Please refer to step 9 of the Create and set up an app for BIM360 Dataflow in Autodesk Construction Cloud and Autodesk Platform Services procedure above.

12. Enter the URL of API base of BIM360 (https://developer.api.autodesk.com/) in the Value column of the ACC Base URL row.

    Client ID, Client Secret, BIM360 Docs Account Name and BIM360 API Base URL are all mandatory fields, and without entering the correct details, a user cannot run a BIM360 data flow.

13. You can set the maximum time within which the files should be uploaded in the Upload Timeout (minutes) row.

14. You can create profiles for the selected data flow type in the Profiles tab.

15. Click the Save button.

    The BIM360/ACC Data Flow Type is configured.

Back to Data Flows