Request

Response

    Changelog – Data Exchange SDK 7.1.0

    Release Date: February 3, 2026

    Summary

    CategoryCount
    SDK Members Added 73
    SDK Members Removed 52
    UI Members Internalized 417
    Total Public API (6.3.0) 3,028
    Total Public API (7.1.0) 2,635

    Breaking Changes

    1. Geometry Type System Refactored

    The GeometryProperties class and GeometryDataTypes namespace have been replaced with a cleaner type hierarchy.

    Removed:

    • Autodesk.DataExchange.DataModels.GeometryProperties - Generic geometry wrapper
    • Autodesk.DataExchange.DataModels.GeometryDataTypes.GeometryStreamBase - Base stream class
    • Autodesk.DataExchange.DataModels.GeometryDataTypes.Ifc - IFC format
    • Autodesk.DataExchange.DataModels.GeometryDataTypes.Obj - OBJ format
    • Autodesk.DataExchange.DataModels.GeometryDataTypes.Step - STEP format

    Replacement:

    • Autodesk.DataExchange.DataModels.StreamGeometry - Unified stream-based geometry with Format, GetStream(), RenderStyles, SizeInBytes

    Migration:

    // BEFORE (6.3.0)
    var geomProps = new GeometryProperties(filePath, GeometryFormat.Step);
    
    // AFTER (7.1.0)
    var fileGeometry = ElementDataModel.CreateFileGeometry(filePath, GeometryFormat.Step);
    var streamGeometry = await fileGeometry.AsStreamGeometryAsync();
    

    2. Client API Changes

    Removed:

    • Client.SetGeometryConfiguration() - No longer needed
    • IClient.SetGeometryConfiguration() - Interface method removed

    Migration: Remove all SetGeometryConfiguration() calls from your code.

    3. ElementDataModel Method Changes

    Removed:

    • ElementDataModel.UpdateElement() - Use property setters directly
    • ElementDataModel.GetElementGeometryByElementAsync() - Use GetGeometriesAsync() instead
    • IElementDataModel.UpdateElement() - Interface method
    • IElementDataModel.GetTypeParameters() - Use GetTypeParameters() on class directly

    Migration:

    // BEFORE (6.3.0)
    var geometry = await elementDataModel.GetElementGeometryByElementAsync(element);
    
    // AFTER (7.1.0)
    var geometries = await elementDataModel.GetGeometriesAsync();
    var elementGeometry = geometries.FirstOrDefault(g => g.Element.Id == element.Id);
    

    4. Hosting Provider Interface Changes

    Removed:

    • IHostingProvider.GetExchangeMetaDataAsync() - Renamed

    Replacement:

    • IHostingProvider.GetExchangeMetadataDescriptorAsync() - Returns ExchangeMetadataDescriptor

    Migration:

    // BEFORE (6.3.0)
    public async Task<ExchangeMetaData> GetExchangeMetaDataAsync(string projectId, string itemId)
    {
        return await FetchMetadata(projectId, itemId);
    }
    
    // AFTER (7.1.0)
    public async Task<ExchangeMetadataDescriptor> GetExchangeMetadataDescriptorAsync(string projectId, string itemId)
    {
        try
        {
            var metadata = await FetchMetadata(projectId, itemId);
            return new ExchangeMetadataDescriptor { StatusCode = 200, Metadata = metadata };
        }
        catch (Exception ex)
        {
            return new ExchangeMetadataDescriptor { StatusCode = 500, ResponseMessage = ex.Message };
        }
    }
    
    Show More

    5. Parameter Property Changes

    Removed from Parameter:

    • IsForceCheckFSSSChemaPresent property
    • IsTypeParameter property

    Removed from IParameter:

    • IsTypeParameter property

    6. Assembly Loader Removed

    Entire namespace removed:

    • Autodesk.DataExchange.Extensions.Loader.AssemblyLoaderEvents
    • Autodesk.DataExchange.Extensions.Loader.AssemblyLoaderFactory
    • Autodesk.DataExchange.Extensions.Loader.IAssemblyLoader

    7. UI Package Internalized

    417 members from the following namespaces were made internal:

    • Autodesk.DataExchange.UI (46 members) - Application, Configuration, ConnectorAPI
    • Autodesk.DataExchange.UI.Interfaces - IApplication, IMainWindowView
    • Autodesk.DataExchange.UI.ViewModels (73 members)
    • Autodesk.DataExchange.UI.ViewModels.Commands - RelayCommand<T>
    • Autodesk.DataExchange.UI.ViewModels.Helpers - UserDetails, Utilities
    • Autodesk.DataExchange.UI.ViewModels.Interface (245 members)
    • Autodesk.DataExchange.UI.ViewModels.Interfaces - IUserDetails, IUserPrefCached

    Still Public:

    • Autodesk.DataExchange.UI.Core.*
    • Autodesk.DataExchange.UI.CustomForm.*
    • Autodesk.DataExchange.UI.Helper.*
    • Autodesk.DataExchange.UI.TestHarness.*

    8. Removed Projects

    The following internal projects have been removed from the SDK distribution:

    • ConnectorViewModels - View model classes (use Autodesk.DataExchange.UI.Core instead)
    • InvWebBrowser - Internal web browser component
    • ConnectorWebUI - Web-based UI component

    If you referenced these projects directly, migrate to the public Autodesk.DataExchange.UI.Core.* namespaces.


    Added

    Geometry Conversion Extensions

    New extension methods for geometry format conversion:

    • AsFileGeometryAsync(StreamGeometry) - Convert stream to file
    • AsStreamGeometryAsync(FileGeometry) - Convert file to stream
    • AsStreamGeometryAsync(ElementGeometry) - Convert element geometry to stream

    IFC Download Support

    • Client.DownloadCompleteExchangeAsIFC() - Download exchange as IFC format
    • IClient.DownloadCompleteExchangeAsIFC() - Interface method

    DownloadCompleteExchangeAsSTEP() and DownloadCompleteExchangeAsOBJ() remain available.

    Element Attributes

    New attribute system on Element and IElement:

    element.AddAttributes(new Dictionary<string, string>
    {
        { "Department", "Engineering" },
        { "ProjectPhase", "Design" }
    });
    
    string dept = element.GetAttribute("Department");
    IReadOnlyDictionary<string, string> allAttrs = element.Attributes;
    
    Show More

    ElementGeometry Parameters

    New parameter system on ElementGeometry:

    var param = await elementGeometry.CreateParameter(parameterDefinition);
    elementGeometry.UpdateParameter("schemaId", newValue);
    elementGeometry.DeleteParameter("schemaId");
    
    foreach (var p in elementGeometry.Parameters)
    {
        Console.WriteLine($"{p.Name}: {p.Value}");
    }
    
    Show More

    Validation Infrastructure

    New classes for exchange validation:

    • ValidationStatus - StatusCode, ResponseMessage, IsSuccess, IsDeleted, IsUnauthorized, IsError
    • ExchangeMetadataDescriptor - StatusCode, ResponseMessage, Metadata, IsSuccess
    • DataExchange.ValidationStatus property
    foreach (var exchange in exchanges)
    {
        if (exchange.ValidationStatus.IsSuccess)
        {
            // Process valid exchange
        }
        else if (exchange.ValidationStatus.IsUnauthorized)
        {
            Console.WriteLine("Access denied");
        }
    }
    
    Show More

    FileGeometry Disposable Pattern

    FileGeometry now implements IDisposable:

    using var fileGeometry = ElementDataModel.CreateFileGeometry(path, format);
    // Use geometry...
    // Automatically disposed
    

    Exchange Descriptions

    Add descriptions to exchanges to document changes, similar to Git commit messages:

    elementDataModel.Description = "Updated wall layout per design review";
    await client.SyncExchangeDataAsync(exchangeIdentifier, elementDataModel);
    

    Descriptions appear in:

    • Connector UI version history
    • Version tooltips in exchange list
    • ExchangeRevision.Description when querying history

    New properties:

    • ElementDataModel.Description - Set description before syncing
    • ExchangeDetails.Description - Read description from exchange details
    • ExchangeRevision.Description - Read description from revision history

    See Working with Exchange Descriptions for details.

    Exchange Details Enhancements

    • ExchangeDetails.ContractType property

    Element Categorization

    New methods for setting element category and type after creation:

    • ElementDataModel.SetElementCategory(element, category) - Assign or change an element’s category
    • ElementDataModel.SetElementType(element, type) - Assign or change an element’s type
    var element = elementDataModel.AddElement(new ElementProperties(...));
    
    // Change category and type after creation
    elementDataModel.SetElementCategory(element, "Walls");
    elementDataModel.SetElementType(element, "Fire-Rated Wall");
    

    Migration Checklist

    Priority 1: Critical API Changes

    • [ ] Replace GeometryProperties with FileGeometry/StreamGeometry
    • [ ] Replace GetElementGeometryByElementAsync() with GetGeometriesAsync()
    • [ ] Remove SetGeometryConfiguration() calls
    • [ ] Update IHostingProvider to use GetExchangeMetadataDescriptorAsync

    Priority 2: Interface Implementations

    • [ ] Implement new IElement members (if custom implementation)
    • [ ] Implement new IElementDataModel members (if custom implementation)
    • [ ] Implement IClient.DownloadCompleteExchangeAsIFC (if custom implementation)

    Priority 3: UI Integration

    • [ ] Remove references to Autodesk.DataExchange.UI.Application
    • [ ] Remove references to Autodesk.DataExchange.UI.ConnectorAPI
    • [ ] Remove references to Autodesk.DataExchange.UI.ViewModels.* interfaces
    • [ ] Use Autodesk.DataExchange.UI.Core.* types instead

    Priority 4: New Features (Optional)

    • [ ] Consider using Element Attributes for metadata
    • [ ] Consider using ElementGeometry Parameters
    • [ ] Consider using Exchange Descriptions for change documentation
    • [ ] Use ValidationStatus for error handling
    • [ ] Use FileGeometry.Dispose() pattern for cleanup

    Backward Compatibility

    Old APINew API
    GeometryProperties FileGeometry / StreamGeometry
    GetElementGeometryByElementAsync() GetGeometriesAsync()
    GetExchangeMetaDataAsync() GetExchangeMetadataDescriptorAsync()
    SetGeometryConfiguration() Removed - not needed
    UpdateElement() Removed - use property setters

    See Also