Request

Response

    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. Already true by default on SDKOptionsDefaultSetup.
    • 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 — CustomExceptions sub-namespace removed; a single find-replace migrates all references. See Breaking Changes.
    • 4 new interface members — IElement, IElementDataModel, IInteropBridge, and IInputDescriptor each 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 CustomExceptions sub-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’s IInteropBridge, and BaseInputDescriptor) are unaffected.

    InterfaceNew memberKind
    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 IGeometryUtilitiesServiceClient in tests, your mock must implement the new interface contract (15 methods, 4 properties). Typical consumers who use the SDK’s built-in GeometryUtilitiesServiceClient are 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:

    • IGeometryUtilitiesServiceClient
    • GeometryUtilitiesServiceClient

    Client methods:

    MethodDescription
    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 — SafeFireAndForget extension 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 with PerformanceMetricReport.AddCounter.

    New Exceptions

    Five new exception types are available under Autodesk.DataExchange.Exceptions:

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

    AspectDetail
    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

    TypeNew memberNotes
    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.

    Details: Migration Guide — Fallback Callback URLs


    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.

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


    See Also