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.*toAutodesk.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/GetSchemasAsyncnow require aregion. See Breaking Changes. - Refresh control —
ExchangeSearchFilter.ForceRefreshlets the Connector UI distinguish a user-initiated refresh from a background one. See Added. - Sync tuning knobs —
GeometryConfiguration.SyncUploadConcurrencyandTuneThreadPool. See Added. - Packaging (breaking for affected connectors) —
Autodesk.Newtonsoft.Jsonis internalized intoAutodesk.DataExchange.dllin Release and no longer flows transitively. Connectors that referenced it, or relied on it transitively for their own JSON code, must add a directNewtonsoft.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 member | Location |
|---|---|
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.PrimitivesAPIinstead ofAutodesk.GeometryPrimitives.*. Consumer code that constructs or readsGeometry,Vector3d, or related style types must update itsusingdirectives.
The geometry engine upgraded to GUSDK 0.9.3, and the public geometry type surface migrated namespaces. Affected members include:
ElementDataModel.CreatePrimitiveGeometry(...)— theGeometryparameter is nowAutodesk.GeometryUtilities.PrimitivesAPI.Geometry.ViewableWorldCoordinates.UP/Front/North— nowAutodesk.GeometryUtilities.PrimitivesAPI.Vector3d(wasAutodesk.GeometryPrimitives.Data.Vector3d).PrimitiveGeometry,IPrimitiveGeometry,GeometryWrapper,Design,CoordinateSystemVector, and related types now referenceAutodesk.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:
ViewableWorldCoordinatesandIElementDataModel.GetViewableWorldCoordinates/SetViewableWorldCoordinatesare retained in this release; only theVector3dtype they use changed namespaces. AGetHashCode()override was added toViewableWorldCoordinates.
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/GetSchemasAsyncgained a requiredregionparameter, sent as aregionHTTP header. On a cache miss with a null or empty region, the call now throwsArgumentException("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 publicIExchangeSearchFilterinterface. This is additive for callers but breaking for any external implementer of the interface. The concreteExchangeSearchFilterdefaults it tofalse.
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 intoAutodesk.DataExchange.dllin Release builds and no longer ships as a standalone DLL or flows as a transitive NuGet dependency. Any connector that referencedAutodesk.Newtonsoft.Jsondirectly, 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.Jsonpackage 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
| Member | Type | Notes |
|---|---|---|
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
HttpClientself-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.Transparencyis now nullable; anulltransparency 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.