Request

Response

    Changelog – Data Exchange SDK 7.6.0

    Release date: August 7, 2026

    The full 7.6.0 documentation set remains available at Data Exchange SDK 7.6.0. Links in this changelog point at the current 8.0.0 documentation.

    This release reshapes two consumer-facing API surfaces. The exchange model interfaces return IElement and IElementGeometry abstractions instead of concrete types, and the validation hooks take strongly typed parameters instead of loose dictionaries. 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 — IElement and IElementGeometry replace the concrete Element and ElementGeometry types across the element and data model APIs. See Breaking changes.
    • Strongly typed validation hooks — the Validate* hooks take ExchangeItem and ExchangeInput instead of Dictionary<string, object>. See Breaking changes.
    • USD download support — use DownloadExchangeAsUSD to 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.DXLive package adds an IConnectorExtension plugin interface, a ConnectorExtensionRegistry, a UseDXLive() dependency injection bootstrap with DXLiveOptions, and an ILiveClient and LiveClient skeleton 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 for AddElement, GetOrCreateDesignRef, and InstantiateDesignBySourceId complement 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 Element and ElementGeometry types now use the IElement and IElementGeometry interfaces. Connector code that declares variables or overrides methods with the concrete types doesn’t compile.

    These members now use the interface types:

    MemberLocation
    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:

    BeforeAfter
    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. 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 GeometryUtilitiesService and 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.


    4. 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

    MemberTypeNotes
    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.Protobuf consolidates to a single version, 3.30.1, across the SDK projects. GeometryUtilitiesService now references protobuf-net directly rather than transitively.
    • SourceLink and .snupkg symbol 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

    • GetAssetsByType uses a type index on ExchangeData and no longer scans the full asset set by type.
    • ConversionBatchSize reaches 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 SourceId is unique.
    • Fixed an in-memory mesh regression, along with gRPC service timings and Conversion API geometry paths.
    • Fixed a CreateFileGeometry and face-colors regression.
    • Corrected the ttmesh output path for the Conversion API.

    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-CN locale is no longer available. See Breaking changes.

    See also