Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »



On This Page

Overview

The Autodesk BIM 360 connector in SkySync allows you to analyze, migrate, copy, and synchronize files between your Autodesk BIM 360 account and cloud storage repositories and on-premise network file shares. The first step is to create the Autodesk BIM 360 connection by providing the connection information required for SkySync to connect to the platform. The connector can be created using any user account with permissions to access the content.

Creating a connection using OAuth 2.0 authentication requires different information than connecting to an account that doesn’t use this authentication. Review the table below to ensure you have the information required to create the connection.


Create Connection | SkySync Application User Interface

  1. Select Connections > Add connection.

  2. Select Autodesk Data Management (OAuth 2.0) as the platform on the Add connection modal.

  3. Enter the connection information. Reference the table below for details about each field.

  4. Select Sign in with Autodesk Data Management (OAuth 2.0).

  5. On the Sign In modal, enter the email address and click Next.

  6. Enter the password and select Sign In.

  7. Select Allow access when prompted to authorize the connection.

  8. You will see a "Connection test succeeded" message on the Add connection modal. (If you don't see this message, repeat the sign in and authorization steps above.)

  9. Select Done.


Add connection modal - Autodesk BIM 360 (OAuth 2.0)

Field

Description

Required

Display as

Enter the display name for the connection. If you will be creating multiple connections, ensure the name readily identifies the connection. The name displays in the application, and you can use it to search for the connection and filter lists.

If you do not add a display name, the connection will automatically be named “Autodesk BIM 360 (OAuth 2.0).” SkySync recommends you add a custom name if you will be creating multiple Autodesk connectors you need to readily identify.

Optional

Platform API client credentials

Required

Use the system default client credentials

Select this option to use the default SkySync client application.

Use custom client credentials

Select this option to use custom client credentials provided by your administrator. When selected, two additional fields will be available to enter the credentials.

Client ID

This field displays only when you select Use custom client credentials. This value will be provided by your administrator.

Optional

Client Secret

This field displays only when you select Use custom client credentials. This value will be provided by your administrator.

Optional

Autodesk Sign In

Authorize Application

Connection Test Succeeded


Features and Limitations

Platforms all have unique features and limitations. SkySync’s transfer engine manages these differences between platforms and allows you to configure actions based on Job Policies and Behaviors. The information below is platform specific. Use the Platform Comparison tool to see how your integration platforms may interact regarding features and limitations. 

Files and Folders

Below is list of supported and unsupported features as well as additional file/folder restrictions for the Autodesk BIM 360 connector. 

Supported Features(tick)

Unsupported Features(error)

Other Features/Limitations(warning)

Version preservation

File lock propagation

File size maximum: N/A

Timestamp preservation
See below for more information.

Mirror lock ownership

Invalid characters: \ / < > : " | ? * ` \n \r \t \f ¢ ™ $ ®

Author/Owner preservation
See below for more information.

Account map

Path length maximum: N/A
(See Path Lengths below)

Group map

Segment path length: 255
(See Path Lengths below)

Permission preservation

Restricted types: N/A

User impersonation

Metadata map

Tags map

Author/Owner Preservation

When Autodesk BIM 360 is the destination platform, author/owner preservation is not supported.

When Autodesk BIM 360 is the source platform, author/owner preservation is supported only for destination platforms that support this attribute.

Path Lengths

Autodesk does not impose restrictions for the total path length.

Segment path lengths are limited to 255 character. Segments are delimited by a forward slash (/). For example, <max 255 characters>/<max 255 characters>.

Timestamp Preservation

When Autodesk BIM 360 is the destination platform, timestamp preservation is not supported.

When Autodesk BIM 360 is the source platform, timestamp preservation is supported only for destination platforms that support this attribute.


Create Connection | SkySync API

The following GET will return a target URL. Use this URL to log in to the Dropbox for Business account to authenticate and create the connection. Make sure you connect using an Administrator account. 

Create New AutoDesk Dta Management Connection using OAuth 2.0

GET {{url}}v1/connections/platforms/autodesk-bim360-oauth2/new


Create a Job | SkySync API Job Configuration Example

The sample code below shows how to create a job for an Autodesk connection created to connect as a standard user.

When creating a job with Autodesk, you must select the project and then the project directory when configuring the job location paths in order to transfer content. Otherwise the job will fail with an "Unknown failure" error.

POST {{url}}v1/jobs

{
    "name":"Simple Job",
    "kind": "transfer",
    "transfer": {
      "transfer_type": "copy",
        "source": {
            "connection": { "id": "Source connection ID" },
            "target": {
                "path": "/sourceDocumentLibrary"
            }
        },
        "destination": {
            "connection": { "id": "Destination Connection ID" },
            "target": {
                "path": "/destinationFolder"
            }
        },
        "simulation_mode": false
    },
    "schedule": {
        "mode": "manual"
    },
    "stop_policy": {
        "on_success": 5,
        "on_failure": 5,
        "on_execute": 25
    },
    "category": {
      "name": "Report {Name}"
    }
}

  • No labels