Changelog – Data Exchange SDK 7.4.0
Release Date: May 22, 2026
This release introduces a new out-of-process geometry utilities service, expands the public API surface, reorganizes the exceptions namespace, and introduces IExchangeContextForm for context-aware Load forms.
Breaking changes: Exception namespace flattening and 4 new interface members. See Breaking Changes.
New subsystem: GeometryUtilitiesService Client — replaces in-process geometry calls with gRPC-backed out-of-process calls. See Added.
What’s New
- New subsystem: GeometryUtilitiesService Client — gRPC-backed out-of-process geometry utilities replacing in-process calls.
- Instance render style:
IElement.RenderStyle— Read the instance-level render style attached to an element, when present. Non-breaking addition. - Service warm-up:
SDKOptions.WarmupServices— Pre-warm gRPC and geometry translation services at SDK initialization to eliminate first-call latency. Alreadytrueby default onSDKOptionsDefaultSetup. - Port fallback:
AuthOptions.FallbackRedirectUrls— Retry OAuth callback on alternate ports if the primary port is occupied. - Context-aware Load forms:
IExchangeContextForm— Load forms can now receive exchange metadata before building input fields. - Exception namespace flattening —
CustomExceptionssub-namespace removed; a single find-replace migrates all references. See Breaking Changes. - 4 new interface members —
IElement,IElementDataModel,IInteropBridge, andIInputDescriptoreach gained one new member. See Breaking Changes. - Self-contained package — SDK ships as a self-contained build. Package sizes: SDK — 264.9 MB, UI — 7.9 MB. Assembly trimming planned for a future release.
Breaking Changes
1. Exception Namespace Reorganization
Breaking change: Code referencing the
CustomExceptionssub-namespace will not compile. A single find-replace resolves all occurrences.
All 14 custom exception types and the ValidationContext enum have moved from Autodesk.DataExchange.Exceptions.CustomExceptions up one level to Autodesk.DataExchange.Exceptions. Class shapes, constructors, and base types are unchanged.
Affected types:
Old namespace (...Exceptions.CustomExceptions) | New namespace (...Exceptions) |
|---|---|
DataSyncException |
DataSyncException |
GeneralException |
GeneralException |
GeometryDownloadException |
GeometryDownloadException |
GeometryTranslationException |
GeometryTranslationException |
GeometryUploadException |
GeometryUploadException |
IntermediateGeometryConversionException |
IntermediateGeometryConversionException |
InvalidAssetStateTransitionException |
InvalidAssetStateTransitionException |
InvalidExchangeTitleException |
InvalidExchangeTitleException |
JSONSerializeException |
JSONSerializeException |
ParameterRegistrationException |
ParameterRegistrationException |
TranslationException |
TranslationException |
ValidationContext (enum) |
ValidationContext |
ValidationException |
ValidationException |
ValidationFailedException |
ValidationFailedException |
A repo-wide find-replace of Autodesk.DataExchange.Exceptions.CustomExceptions. → Autodesk.DataExchange.Exceptions. resolves all occurrences. No CustomExceptions-scoped names survive in 7.4.0.
Migration steps: Migration Guide — Exception Namespace Reorganization
2. New Members on Existing Interfaces
Breaking change: Custom implementations of the interfaces below will not compile until the new members are added. Consumers using the SDK’s built-in implementations (
Element,ElementDataModel, the bridge factory’sIInteropBridge, andBaseInputDescriptor) are unaffected.
| Interface | New member | Kind |
|---|---|---|
Autodesk.DataExchange.Interface.IElement |
RenderStyle RenderStyle { get; } |
Property |
Autodesk.DataExchange.Interface.IElementDataModel |
string RootAssetName { get; set; } |
Property |
Autodesk.DataExchange.UI.Core.Interfaces.IInteropBridge |
void SetApplicationMode(ApplicationMode applicationMode) |
Method |
Autodesk.DataExchange.UI.CustomForm.Interfaces.IInputDescriptor |
bool IsBeta { get; set; } |
Property |
Migration steps: Migration Guide — New Interface Members
3. IGeometryUtilitiesServiceClient Interface (test harnesses only)
Breaking change (test code only): If you mock
IGeometryUtilitiesServiceClientin tests, your mock must implement the new interface contract (15 methods, 4 properties). Typical consumers who use the SDK’s built-inGeometryUtilitiesServiceClientare unaffected.
The new Autodesk.DataExchange.GeometryUtilitiesService.Client.IGeometryUtilitiesServiceClient interface fronts gRPC access to the Geometry Utilities Service. See GeometryUtilitiesService Client in the Added section for full details.
Added
GeometryUtilitiesService Client (new subsystem)
A new gRPC client surface under Autodesk.DataExchange.GeometryUtilitiesService.Client replaces in-process geometry calls with out-of-process service calls, improving isolation and enabling independent scaling of geometry processing.
Interface and concrete class:
IGeometryUtilitiesServiceClientGeometryUtilitiesServiceClient
Client methods:
| Method | Description |
|---|---|
EnsureConnectedAsync |
Verify or establish the gRPC connection |
PingAsync |
Liveness check |
GeometriesToInternalAsync |
Convert external geometries to internal format |
InternalToGeometriesAsync |
Convert internal format to external geometries |
ConvertSourcesAsync |
Convert geometry sources |
ConvertSerializedMeshFileAsync |
Convert a serialized mesh file |
DownloadExchangeAsIFCAsync |
Download exchange in IFC format |
DownloadExchangeAsOBJAsync |
Download exchange in OBJ format |
DownloadExchangeAsSTEPAsync |
Download exchange in STEP format |
GenerateSVFViewableAsync |
Generate an SVF viewable |
SerializeGeometryToJsonAsync |
Serialize geometry to JSON |
DeserializeJsonToGeometryAsync |
Deserialize JSON to geometry |
GetSourceBodyCountAsync |
Get the count of source bodies |
CancelTranslationAsync |
Cancel an in-progress translation |
ShutdownAsync |
Shut down the service process |
Diagnostic properties: IsConnected, LastCallTimings, LastStartupDurationMs, LastProcessSpawnDurationMs
Data types added:
AssetConversionSpecInfo, AssetInfoData, AssetResultInfo, BodyInfoData, BodyType, ConversionContextInfo, ConversionResultInfo, ConversionSpecInfo, ConversionStatusType, DataFormatType, ExchangeConversionSpecInfo, GeometryConfigInfo, GrpcCallTimings, MeshTransferData, PrimitiveGeometryTypeInfo, STEPProtocolType, StyleInfoData, ViewDataInfoData
Note: The service now runs out-of-process. Test harnesses must allow the SDK to spawn helper processes.
New Top-Level Types
Autodesk.DataExchange.Core.TaskExtensions—SafeFireAndForgetextension for intentional fire-and-forget async paths with logger-backed exception swallowing.
using Autodesk.DataExchange.Core;
// Instead of an unobserved Task that swallows exceptions silently:
SomeAsyncOperation().SafeFireAndForget(logger, operationName: "TelemetryFlush");
Autodesk.DataExchange.Insights.CounterMetric— Counter metric used by the Insights metrics system; integrates withPerformanceMetricReport.AddCounter.
New Exceptions
Five new exception types are available under Autodesk.DataExchange.Exceptions:
| Exception | Description |
|---|---|
AllCallbackPortsInUseException |
All OAuth callback ports are occupied |
ExchangeAlreadyDeletedException |
Operation attempted on a deleted exchange |
ExchangeOperationException |
General exchange operation failure |
InvalidMessageTypeException |
Unexpected message type received |
PermissionDeniedException |
Caller lacks required permission |
ValidationFailedException also gained a new constructor overload that accepts an inner exception:
public ValidationFailedException(string message, ValidationContext context, Exception innerException);
SDKOptions.WarmupServices Property
The WarmupServices property on SDKOptions eagerly establishes gRPC service connections when the SDK Client is initialized, instead of deferring them to the first geometry or exchange call.
| Aspect | Detail |
|---|---|
| Default | false — lazy initialization; unchanged from prior behavior |
| Scope | SDKOptions and SDKOptionsDefaultSetup (mirrored) |
Effect on SDKOptionsDefaultSetup |
Setting WarmupServices = true on SDKOptionsDefaultSetup is equivalent to setting it directly on SDKOptions |
Use case: Production connectors where the first geometry or exchange operation is user-visible. Enabling warm-up shifts the startup cost to Client initialization, so the first user action is not delayed by a cold gRPC connection.
Details: Migration Guide — Pre-warm Services
New Members on Existing Types
| Type | New member | Notes |
|---|---|---|
Autodesk.DataExchange.SDKOptions |
bool WarmupServices { get; set; } |
See SDKOptions.WarmupServices Property. |
Autodesk.DataExchange.GeometryConfiguration |
string ProxyUrl { get; set; } |
Proxy URL for GUSDK calls. |
Autodesk.DataExchange.Authentication.AuthOptions |
List<string> FallbackRedirectUrls { get; set; } |
Try these callback URLs if the primary CallBack port is in use. |
Autodesk.DataExchange.SDKOptionsDefaultSetup |
List<string> FallbackRedirectUrls { get; set; } |
Mirrors AuthOptions.FallbackRedirectUrls on the default-setup helper. |
Autodesk.DataExchange.DataModels.Element |
RenderStyle RenderStyle { get; } |
Instance-level render-style override on the element. |
Autodesk.DataExchange.DataModels.ElementDataModel |
static ElementDataModel Create(IClient, string rootAssetName) |
Create with a custom root-asset name (default "TopLevelAssembly"). |
Autodesk.DataExchange.DataModels.ElementDataModel |
string RootAssetName { get; set; } |
Read or override the root asset name after creation. |
Autodesk.DataExchange.Insights.Metrics |
static void RecordTiming(string id, long elapsedMilliseconds) |
Direct timing recording API. |
Autodesk.DataExchange.Insights.PerformanceMetricReport |
void AddCounter(string, int) |
Add a counter metric to the report. |
Autodesk.DataExchange.Insights.PerformanceMetricReport |
List<CounterMetric> Counters { get; } |
Read counter metrics alongside timings. |
Autodesk.DataExchange.Storage |
Storage(string path, ILogger logger) |
Constructor overload accepting a logger. |
Autodesk.DataExchange.Exceptions.HTTPResponseException |
HTTPResponseException(int statusCode, string message, Exception innerException) |
Constructor overload preserving inner exception. |
Autodesk.DataExchange.UI.Core.Interfaces.IInteropBridge |
void SetApplicationMode(ApplicationMode) |
Switch between ReadOnly and ReadWrite at runtime. |
Autodesk.DataExchange.UI.Core.FeatureCapabilities |
bool ShowTitleBarBetaBadge { get; set; } |
Toggle the title-bar "Beta" badge. |
Autodesk.DataExchange.UI.Core.InteropBridgeOptions |
string ContactSupportUrl { get; set; } |
Override the "Contact support" link target. |
Autodesk.DataExchange.UI.CustomForm.Descriptors.BaseInputDescriptor |
bool IsBeta { get; set; } |
Mark a custom-form input as beta. |
IExchangeContextForm
Autodesk.DataExchange.UI.CustomForm.Interfaces.IExchangeContextForm is a new opt-in interface that extends ICustomForm. Load forms can implement it to receive exchange metadata — such as ConnectorName or SourceApplicationName — before building input fields. The bridge calls ApplyExchangeContext once per session, after CreateAsync and before GetInputFieldsAsync.
Why this was added: Without it, Load forms could only render static options regardless of which exchange the user selected. Forms that do not implement IExchangeContextForm are completely unaffected.
Full guidance: Context-Aware Load Forms
IElement.RenderStyle Property
Some authoring applications (for example, Inventor) attach a body or instance color directly to the element instance instead of the geometry. Until now, the SDK had no public surface to read that override, so connectors fell back to the geometry-level color.
The new RenderStyle property on IElement (and Element) exposes this override. It is read-only and returns null when no instance-level override is set.
| Aspect | Detail |
|---|---|
| Access | Read-only — no setter |
| Returns | The instance-level RenderStyle if attached; otherwise null |
| Independence | Not auto-merged with IElementGeometry.RenderStyle — the connector decides precedence |
| Caching | Resolved on first access; subsequent reads are cheap |
Use the recommended precedence rule — instance over geometry (element.RenderStyle ?? geometry?.RenderStyle) to surface instance-level overrides that were previously dropped silently. This change is additive and non-breaking.
Details: Resolving an Element’s Render Style · Migration Guide — Adopt Instance-Level Render Style
Changed
Self-Contained SDK Package
The SDK now ships as a self-contained build. Package sizes: SDK — 264.9 MB, UI — 7.9 MB. Assembly trimming is planned for a future release to reduce the package size.
Fixed
Connector UI progress and connection state
Summary: The global progress overlay could stay open when the session moved to a host unreachable state.
Details: ProgressScreen now closes the overlay when connectionState === HostUnreachable, so the unreachable-host experience is not hidden behind a spinner. WebSocket connection setup also uses a 3 second guard so failed opens fail fast instead of hanging.
Upgrade impact: Behavioral fix in the Connector UI only; no public .NET API changes for host applications.
Exchange visibility actions
Summary: Show/Hide exchange actions now align list visibility with the host result and show a progress message while the host runs setExchangeVisibility.
Details: Visibility updates are applied through session state when the host returns success (not optimistically from selection helpers). Progress uses the UPDATING_EXCHANGE_VISIBILITY string during the call.
Upgrade impact: Connector UI behavior only.
Binary Pack Integer Overflow
Large geometry buffers with offsets exceeding 2.1 billion bytes could cause integer overflow in binary slice processing (BinaryReference.Start / BinaryReference.End). Guards were added before Buffer.BlockCopy to prevent truncation and data corruption.
Upgrade impact: Connectors processing very large geometry (>2 GB raw) now handle offsets correctly.