Changelog – Data Exchange SDK 7.6.0
Release date: August 7, 2026
This release reshapes three consumer-facing API surfaces. The exchange model interfaces return IElement and IElementGeometry abstractions instead of concrete types, the validation hooks take strongly typed parameters instead of loose dictionaries, and ADP Analytics moves into a standalone, independently versioned Abstractions package. On the geometry side, the SDK adds USD download support and mirrored STEP file support, and upgrades the geometry engine to GUSDK 0.9.4. This release also ships a ConsoleConnector sample application and the DXLive SDK skeleton, hardens authentication, and adds a delta pipeline for RetrieveLatestExchangeAsync.
Breaking changes: Several public interfaces changed, so your connector needs code changes when you recompile against this release. Read Breaking changes first.
What’s new
- Interface-typed exchange model —
IElementandIElementGeometryreplace the concreteElementandElementGeometrytypes across the element and data model APIs. See Breaking changes. - Strongly typed validation hooks — the
Validate*hooks takeExchangeItemandExchangeInputinstead ofDictionary<string, object>. See Breaking changes. - Decoupled ADP Analytics —
IAdpAnalyticsand its data transfer objects move toAutodesk.DataExchange.ADPAnalytics.Abstractions, which versions independently of the SDK. See Breaking changes. - USD download support — use
DownloadExchangeAsUSDto download an exchange as USD alongside OBJ, STEP, and IFC. See Added. - Mirrored STEP file support — the SDK now handles BRep elements from mirrored STEP geometry correctly.
- ConsoleConnector sample application — a runnable sample connector that demonstrates the SDK end to end, covering geometry attachment, primitives, design references, download as IFC, OBJ, and STEP, telemetry, and end-to-end scenarios.
- DXLive SDK package (skeleton) — the new
Autodesk.DataExchange.DXLivepackage adds anIConnectorExtensionplugin interface, aConnectorExtensionRegistry, aUseDXLive()dependency injection bootstrap withDXLiveOptions, and anILiveClientandLiveClientskeleton that wraps the GA client. - Delta pipeline for
RetrieveLatestExchangeAsync— a delta retrieval pipeline pulls the latest exchange changes. IElement-typed API overloads — interface-typed overloads forAddElement,GetOrCreateDesignRef, andInstantiateDesignBySourceIdcomplement the interface-return migration.- Hardened authentication — token acquisition retries with backoff and refreshes proactively before expiry, and PKCE uses a per-request state and verifier.
- Geometry engine upgrade — GUSDK moves from 0.9.3 to 0.9.4. See Breaking changes.
Breaking changes
1. Exchange model interfaces return and accept interface types
Breaking change: Members that previously exposed the concrete
ElementandElementGeometrytypes now use theIElementandIElementGeometryinterfaces. Connector code that declares variables or overrides methods with the concrete types doesn’t compile.
These members now use the interface types:
| Member | Location |
|---|---|
GetChildElements() |
IElement |
Elements, TopLevelElements, DeletedElements |
IElementDataModel |
GetAllElements, GetCreatedElements, GetDeletedElements, GetModifiedElements |
IElementDataModel |
GetElementGeometriesAsync, GetGeometriesAsync |
IElementDataModel |
GetElementGeometryCounts |
IElementDataModel |
This release adds these members alongside the migration: IElement.Classifications, IElement.Type, IElement.TypeParameters, GetElementById, SetElementGeometry, Classify, DefineType, SetType, and AddTypeParameterAsync. See Added.
What to do: Change variable declarations and method signatures in your connector from Element and ElementGeometry to IElement and IElementGeometry. Move code that depends on members only present on the concrete types to the interface surface, or cast explicitly.
2. Validation hooks take strongly typed parameters
Breaking change: The exchange validation hooks no longer take a loose
Dictionary<string, object>. Any override of these methods doesn’t compile until you update its signature.
These signatures changed on BaseReadWriteExchangeModel, BaseWriteOnlyExchangeModel, BaseReadOnlyExchangeModel, ExchangeReader, and ExchangeWriter:
| Before | After |
|---|---|
ValidateCanUpdateExchangeAsync(Dictionary<string, object> parameters) |
ValidateCanUpdateExchangeAsync(ExchangeItem exchangeItem) |
ValidateCanCreateExchangeAsync() |
ValidateCanCreateExchangeAsync(ExchangeInput exchangeInput) |
ValidateGetLatestExchangeAsync() |
ValidateGetLatestExchangeAsync(ExchangeItem exchangeItem) |
ValidateGetLatestExchangeDetailsAsync() |
ValidateGetLatestExchangeDetailsAsync(ExchangeItem exchangeItem) |
What to do: Update the signature of every validation hook you override, and read fields from the typed ExchangeItem or ExchangeInput instead of dictionary keys.
3. ADP Analytics moves to a standalone Abstractions package
Breaking change:
IAdpAnalyticsand its data transfer objects now live in a separate package, and the SDK no longer registersIAdpAnalyticsthrough its ownConfigureServices.
IAdpAnalytics, AdpEvent, and ExchangeProcessStatus move to the new Autodesk.DataExchange.ADPAnalytics.Abstractions package, which ships at version 1.0.0 and versions independently of the SDK.
What to do: Add a package reference to Autodesk.DataExchange.ADPAnalytics.Abstractions if you reference the ADP analytics types, update the using directives for the moved types, and register IAdpAnalytics yourself if your dependency injection wiring relied on the SDK to register it.
4. GUSDK upgrades to 0.9.4
Breaking change: The geometry engine moves from GUSDK 0.9.3 to 0.9.4. The out-of-process
GeometryUtilitiesServiceand its native payload change accordingly.
This release bumps GUSDKVersion in Directory.Build.props to 0.9.4.
What to do: Rebuild and repack so your connector deploys the new GUSDK native binaries, then verify geometry translation against your regression set.
5. zh-CN UI locale removed
Breaking change: This release deletes the Chinese localization resource file from the Connector UI and simplifies the locale wiring.
What to do: If you ship the Connector UI in zh-CN, add that locale downstream. The SDK no longer bundles it.
Added
| Member | Type | Notes |
|---|---|---|
DownloadExchangeAsUSD |
method | Downloads an exchange as USD. Adds DATA_FORMAT_USD to the format enum and a USD option to the AdvanceLoad custom form. |
IElement.Classifications |
property | The classifications on an element. |
IElement.Type |
property | The element type. |
IElement.TypeParameters |
property | The parameters defined on the element type. |
GetElementById |
method | Retrieves an element by identifier. |
SetElementGeometry |
method | Sets the geometry on an element. |
Classify |
method | Applies a classification to an element. |
DefineType, SetType |
methods | Define a shared type and reference it on an element. |
AddTypeParameterAsync |
method | Attaches a parameter to a type. |
AddElement, GetOrCreateDesignRef, InstantiateDesignBySourceId |
overloads | IElement-typed overloads that complement the interface-return migration. |
Deprecated
Design lookup by id
InstantiateDesignById, GetDesignInstancesById, and IDesign.ID are [Obsolete]. Use InstantiateDesignBySourceId, GetDesignInstancesBySourceId, and IDesign.SourceId instead. GetOrCreateDesignRef names its third parameter sourceId, so update any call that passes it by name.
This change is non-breaking — existing code continues to compile and run, with a CS0618 deprecation warning. The obsolete members are removed in the next major version.
Changed
Geometry translation behind the Conversion API
All Data Exchange interactions with GUSDK now run behind the Conversion APIs, controlled by a feature flag. The SDK passes ConversionBatchSize through to the gRPC layer, so the batch size you configure reaches GUSDK.
Packaging and dependencies
Google.Protobufconsolidates to a single version, 3.30.1, across the SDK projects.GeometryUtilitiesServicenow referencesprotobuf-netdirectly rather than transitively.- SourceLink and
.snupkgsymbol packages are available, with portable PDBs and a git commit hash build stamp, so you can step into SDK sources when you debug a connector.
Performance
GetAssetsByTypeuses a type index onExchangeDataand no longer scans the full asset set by type.ConversionBatchSizereaches the gRPC layer, so conversion applies the batch size you configure.- The upload file-read buffer increases to 64 KB.
Fixed
- Reference parameter display names resolve identifiers to asset names instead of showing raw GUIDs.
- Exchange and spec handling no longer assumes that
SourceIdis unique. - Fixed an in-memory mesh regression, along with gRPC service timings and Conversion API geometry paths.
- Fixed a
CreateFileGeometryand face-colors regression. - Corrected the ttmesh output path for the Conversion API.
- Restored ADP stack traces.
Security
- PKCE uses a per-request state and verifier.
- Fixed the security vulnerabilities reported for the SDK.
Connector UI changes
- Tooltips render correctly, and this release removes unused components.
- Reverted the FormSelector custom-height styles and updated the MUI modal styles.
- The AdvanceLoad custom form offers a USD option.
- The
zh-CNlocale is no longer available. See Breaking changes.