Installing the SDK
The Data Exchange Connector SDK is available as a NuGet package and must be installed into your Visual Studio project as a package reference. This setup is a one-time requirement. The build process will handle the package installation and updates automatically. You just need to add a package source in your setup and then proceed to install the package into your project.
Before You Begin
- Register an application, and select the Data Management and the Data Exchange APIs.
- Make sure the Callback URL follows the format
http://127.0.0.1:<portno>/orhttp://localhost:<portno>/, where the port number is not already in use by other processes. - Acquire a 3-legged OAuth token with data:create data:read and data:write scopes. For more information on specifying how to request scopes, see Direct the User to the Authorization Web Flow.
- Verify that you have access to Autodesk Construction Cloud (ACC).
- To access your BIM 360/ACC account, you must add your applications’s client ID to your BIM 360/ACC account. For more instructions, refer to Manage API Access to BIM 360 Services.
Important: The Data Exchange SDK supports both .NET 8 and .NET Framework 4.8.
Procedure
Follow these steps to install the Data Exchange SDK (.NET) NuGet package in Visual Studio.
- Download and extract the zip of Data Exchange SDK installable from the Feedback portal.
- Start Visual Studio > Create a new Project. This will create a new project.
- Navigate to the NuGet Package Manager settings through Tools -> NuGet Package Manager -> Package Manager Settings.
- Add a new entry under Package Sources and click the … button to select the local directory where the downloaded packages are located. This adds a local Package Source from where the NuGet packages can be installed.
- Navigate to your project through Solution Explorer. Select Project > Manage Nuget Packages. This opens the NuGet package manager.
- Switch to your new Package source by using the drop-down menu on the right, and then search for the following packages in the upper-left search box.
- Autodesk.DataExchange
- Autodesk.DataExchange.UI
- Autodesk.DataExchange.GeometryDefinitions
- In the right pane, select the latest version from the drop-down list. If you want to include pre-release versions in the Version list, select Include prerelease.
- Click Install to install the NuGet package. You may be asked to accept license terms or prompted to verify the installation.
- Visual Studio installs the package and its dependencies in the project. When installation is complete, the added packages appear on the Installed tab. You can also find packages in the Dependencies > Packages node of your project in Solution Explorer. After you install a package, you can refer to it in the project with a using statement.
Important: The Data Exchange SDK (.NET) and the associated support DLLs are 64-bit system. By default, Visual Studio automatically configures the newly created C# projects to Any CPU. You must make sure to set your projects to x64 platform to maintain a stable runtime behavior.