Request

Response

    Changelog – Data Exchange SDK 7.5.0

    Release Date: June 30, 2026

    This release upgrades the geometry engine (GUSDK 0.9.3) and migrates geometry types to the Autodesk.GeometryUtilities.PrimitivesAPI namespace, introduces a new streaming sync pipeline for large models, removes the local viewable-generation API (viewables are now generated server-side), and requires a region for SchemaSDK/ASR calls.

    Breaking changes: Local viewable-generation API removed, geometry namespace migration, region now required for schema calls, a new member on IExchangeSearchFilter, and the Autodesk.Newtonsoft.Json packaging change (add a direct Newtonsoft.Json reference). See Breaking Changes.


    What’s New

    • Local viewable generation removed — the in-process viewable-generation API (GenerateViewableAsync, viewable events, and related types) is removed; viewables are now generated server-side as part of sync. See Breaking Changes.
    • Geometry namespace migration — geometry types move from Autodesk.GeometryPrimitives.* to Autodesk.GeometryUtilities.PrimitivesAPI[.IO] (GUSDK 0.9.3). See Breaking Changes.
    • Streaming sync pipeline — large models now sync through a bounded-parallelism streaming pipeline with on-demand serialization and timeout-retry. See Changed.
    • Region-aware schema calls — ISchemaSDK.GetSchemaAsync / GetSchemasAsync now require a region. See Breaking Changes.
    • Refresh control — ExchangeSearchFilter.ForceRefresh lets the Connector UI distinguish a user-initiated refresh from a background one. See Added.
    • Sync tuning knobs — GeometryConfiguration.SyncUploadConcurrency and TuneThreadPool. See Added.
    • Packaging (breaking for affected connectors) — Autodesk.Newtonsoft.Json is internalized into Autodesk.DataExchange.dll in Release and no longer flows transitively. Connectors that referenced it, or relied on it transitively for their own JSON code, must add a direct Newtonsoft.Json (NuGet.org) reference. See Breaking Changes.

    Breaking Changes

    1. Local Viewable-Generation API Removed

    Breaking change: Code that calls the viewable-generation API, subscribes to its events, or references its status/exception/details types will not compile. Viewable generation is now handled server-side as part of sync — there is no client-side replacement.

    The entire in-process viewable-generation surface was removed:

    Removed memberLocation
    GenerateViewableAsync(...) (both overloads — were [Obsolete]) IClient / Client
    ViewableGenerationStarted, ViewableGenerationCompleted (events) IClient / Client, IExchangeWriter, ExchangeWriter
    ViewableGenerationException (type) Autodesk.DataExchange.Exceptions
    ViewableGenerationStatus (enum) Autodesk.DataExchange.Core.Enums
    ViewableDetails (type) Autodesk.DataExchange.Core.Models
    ViewDataInfoData (type) Autodesk.DataExchange.GeometryUtilitiesService.Client
    GenerateSVFViewableAsync(...) IGeometryUtilitiesServiceClient

    Remove all calls to GenerateViewableAsync, unsubscribe from the viewable-generation events, and delete any catch (ViewableGenerationException) handlers or references to ViewableGenerationStatus / ViewableDetails.

    Migration steps: Migration Guide — Local Viewable Generation Removed


    2. Geometry Namespace Migration (GUSDK 0.9.3)

    Breaking change: Public members that take or return geometry types now reference Autodesk.GeometryUtilities.PrimitivesAPI instead of Autodesk.GeometryPrimitives.*. Consumer code that constructs or reads Geometry, Vector3d, or related style types must update its using directives.

    The geometry engine upgraded to GUSDK 0.9.3, and the public geometry type surface migrated namespaces. Affected members include:

    • ElementDataModel.CreatePrimitiveGeometry(...) — the Geometry parameter is now Autodesk.GeometryUtilities.PrimitivesAPI.Geometry.
    • ViewableWorldCoordinates.UP / Front / North — now Autodesk.GeometryUtilities.PrimitivesAPI.Vector3d (was Autodesk.GeometryPrimitives.Data.Vector3d).
    • PrimitiveGeometry, IPrimitiveGeometry, GeometryWrapper, Design, CoordinateSystemVector, and related types now reference Autodesk.GeometryUtilities.PrimitivesAPI[.IO].

    The previous dual-version (0.7.x / newer) conditional package switch was dropped; the SDK now pins a single geometry-utilities package set at 0.9.3.

    Note: ViewableWorldCoordinates and IElementDataModel.GetViewableWorldCoordinates / SetViewableWorldCoordinates are retained in this release; only the Vector3d type they use changed namespaces. A GetHashCode() override was added to ViewableWorldCoordinates.

    Migration: Replace using Autodesk.GeometryPrimitives.Data; / Autodesk.GeometryPrimitives.IO.* with using Autodesk.GeometryUtilities.PrimitivesAPI[.IO.*]; throughout consumer code that constructs or reads geometry, Vector3d, or style types.


    3. Region Now Required for Schema (ASR) Calls

    Breaking change: ISchemaSDK.GetSchemaAsync / GetSchemasAsync gained a required region parameter, sent as a region HTTP header. On a cache miss with a null or empty region, the call now throws ArgumentException("Region is required for ASR calls."). Previously a missing region silently defaulted to US, which risked serving wrong-region data.

    Impact: Any connector flow operating outside US that implicitly relied on the silent US default will now throw on a cold cache. Ensure region is plumbed through to your schema calls. Cache hits do not require a region.


    4. New Member on IExchangeSearchFilter

    Breaking change (external implementers only): bool ForceRefresh { get; set; } was added to the public IExchangeSearchFilter interface. This is additive for callers but breaking for any external implementer of the interface. The concrete ExchangeSearchFilter defaults it to false.

    See ExchangeSearchFilter.ForceRefresh below and Migration Guide — Refresh Trigger on the Exchange List.


    5. Packaging — Autodesk.Newtonsoft.Json Internalized

    Breaking change (packaging/dependency): This does not change any public API signature — no public type exposes a Newtonsoft type. But Autodesk.Newtonsoft.Json (13.0.3) is now ILRepacked into Autodesk.DataExchange.dll in Release builds and no longer ships as a standalone DLL or flows as a transitive NuGet dependency. Any connector that referenced Autodesk.Newtonsoft.Json directly, or that relied on the SDK’s transitive reference for its own JSON code, will fail to build or run until it updates its dependencies.

    Impact and migration:

    • If your connector code uses JSON serialization, add an explicit Newtonsoft.Json package reference from NuGet.org:

      <PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
      
    • Remove any direct reference to Autodesk.Newtonsoft.Json. It is an internal SDK dependency and is no longer available to consumers.
    • The public namespace remains Newtonsoft.Json, so source code changes are typically not required once the package reference is in place.

    Migration steps: Migration Guide — Newtonsoft.Json packaging


    Added

    MemberTypeNotes
    GeometryConfiguration.SyncUploadConcurrency int Bounded upload concurrency for sync. Default 20, clamped to 1–35.
    GeometryConfiguration.TuneThreadPool bool Opt out of process-wide ThreadPool min-thread tuning. Default true.
    ExchangeSearchFilter.ForceRefresh bool When true, bypass any cached exchange list and re-read from the host. Default false.
    ViewableWorldCoordinates.GetHashCode() method GetHashCode() override.
    ExchangeData.ResetUnsavedMappings() method Clears unsaved geometry mappings (used on cancel/retry).

    The connector version number is now emitted in logs.

    ForceRefresh details: The Connector UI sets ForceRefresh = true only when the user clicks Refresh; host-driven background refreshes leave it false, so your GetExchangesAsync implementation may serve cached results. See Refreshing the exchange list.


    Changed

    New Streaming Sync Pipeline

    Sync now uses a streaming pipeline for all model sizes (no runtime fallback to the previous path). Payloads are serialized on demand in 990-item batches and uploaded with bounded concurrency (SyncUploadConcurrency), faults are observed eagerly (a failing sync aborts within roughly one batch instead of after the whole model), and the SDK applies ThreadPool min-thread tuning (process-wide, opt out via TuneThreadPool).

    Behavioral notes:

    • Timeout retries — an HttpClient self-timeout (as opposed to a real user cancel) is now retried with exponential backoff and jitter. As a result, the idempotency of the publish/sync request is load-bearing: a request that reached the server but timed out on response may be re-sent.
    • Sync item ordering — assets, relationships, and schemas are now packed into mixed batches and uploaded concurrently rather than all-assets-then-all-relationships. Relationships may be in flight alongside the assets they reference.

    Geometry Render/Style Behavior (GUSDK 0.9.x)

    • StyleInfo.Transparency is now nullable; a null transparency renders fully opaque.
    • Per-face style mapping (SubEntStyles) changed shape for STEP/IFC.
    • STEP/IFC export runs ATF single-threaded for stability.

    Long-Path Handling

    The previous %TEMP% long-path workaround was removed. Mesh translation now uses the per-connector OutputDirectory (GUSDK 0.9.x handles long paths) and fails fast with InvalidOperationException if OutputDirectory is empty.

    Packaging — Newtonsoft Internalized

    Autodesk.Newtonsoft.Json is internalized into Autodesk.DataExchange.dll and no longer flows transitively. Although no public API signature changes, this can break connectors that used the assembly. It is documented as a highlighted breaking change: see Breaking Changes — Packaging: Autodesk.Newtonsoft.Json Internalized.


    Fixed

    Retry After Cancel No Longer Throws

    On cancel or failure, unsaved geometry mappings are now cleared, so retrying the same ExchangeData no longer throws a NullReferenceException during asset-info collection.

    Collection 404 Recovery

    GetOrCreateCollection now creates the collection on any HTTP 404 (including an empty-body response), fixing a case where CreateExchange ended in CompletedWithErrors.

    Geometry Performance and Correctness

    Single-pass valid/invalid geometry partitioning, O(1) dictionary removal during asset deletion, and mesh path / null-id alignment fixes.


    Connector UI Changes

    • Filter By hides SDK and shared-coordinate metadata (connectorname, connectorversion, sourceapplicationname, sourceapplicationversion, sharedcoordinates); these still feed the Authoring rows.
    • Refresh now sends forceRefresh: true; host-driven background refreshes do not.
    • The Update available badge no longer clears when a load-latest is cancelled or fails.
    • Double-click guards on Create exchange and Advanced load — one request per click; buttons disabled in-flight and re-enabled on failure.
    • The FormSelector dropdown caps at ~300px and scrolls vertically.
    • New status tooltips for deleted-source and errored exchanges; zh-CN localization pass.

    See Also