Changelog – Data Exchange SDK 7.1.0
Release Date: February 3, 2026
Summary
| Category | Count |
|---|---|
| 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 wrapperAutodesk.DataExchange.DataModels.GeometryDataTypes.GeometryStreamBase- Base stream classAutodesk.DataExchange.DataModels.GeometryDataTypes.Ifc- IFC formatAutodesk.DataExchange.DataModels.GeometryDataTypes.Obj- OBJ formatAutodesk.DataExchange.DataModels.GeometryDataTypes.Step- STEP format
Replacement:
Autodesk.DataExchange.DataModels.StreamGeometry- Unified stream-based geometry withFormat,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 neededIClient.SetGeometryConfiguration()- Interface method removed
Migration: Remove all SetGeometryConfiguration() calls from your code.
3. ElementDataModel Method Changes
Removed:
ElementDataModel.UpdateElement()- Use property setters directlyElementDataModel.GetElementGeometryByElementAsync()- UseGetGeometriesAsync()insteadIElementDataModel.UpdateElement()- Interface methodIElementDataModel.GetTypeParameters()- UseGetTypeParameters()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()- ReturnsExchangeMetadataDescriptor
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 };
}
}
5. Parameter Property Changes
Removed from Parameter:
IsForceCheckFSSSChemaPresentpropertyIsTypeParameterproperty
Removed from IParameter:
IsTypeParameterproperty
6. Assembly Loader Removed
Entire namespace removed:
Autodesk.DataExchange.Extensions.Loader.AssemblyLoaderEventsAutodesk.DataExchange.Extensions.Loader.AssemblyLoaderFactoryAutodesk.DataExchange.Extensions.Loader.IAssemblyLoader
7. UI Package Internalized
417 members from the following namespaces were made internal:
Autodesk.DataExchange.UI(46 members) -Application,Configuration,ConnectorAPIAutodesk.DataExchange.UI.Interfaces-IApplication,IMainWindowViewAutodesk.DataExchange.UI.ViewModels(73 members)Autodesk.DataExchange.UI.ViewModels.Commands-RelayCommand<T>Autodesk.DataExchange.UI.ViewModels.Helpers-UserDetails,UtilitiesAutodesk.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 (useAutodesk.DataExchange.UI.Coreinstead)InvWebBrowser- Internal web browser componentConnectorWebUI- 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 fileAsStreamGeometryAsync(FileGeometry)- Convert file to streamAsStreamGeometryAsync(ElementGeometry)- Convert element geometry to stream
IFC Download Support
Client.DownloadCompleteExchangeAsIFC()- Download exchange as IFC formatIClient.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;
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}");
}
Validation Infrastructure
New classes for exchange validation:
ValidationStatus-StatusCode,ResponseMessage,IsSuccess,IsDeleted,IsUnauthorized,IsErrorExchangeMetadataDescriptor-StatusCode,ResponseMessage,Metadata,IsSuccessDataExchange.ValidationStatusproperty
foreach (var exchange in exchanges)
{
if (exchange.ValidationStatus.IsSuccess)
{
// Process valid exchange
}
else if (exchange.ValidationStatus.IsUnauthorized)
{
Console.WriteLine("Access denied");
}
}
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.Descriptionwhen querying history
New properties:
ElementDataModel.Description- Set description before syncingExchangeDetails.Description- Read description from exchange detailsExchangeRevision.Description- Read description from revision history
See Working with Exchange Descriptions for details.
Exchange Details Enhancements
ExchangeDetails.ContractTypeproperty
Element Categorization
New methods for setting element category and type after creation:
ElementDataModel.SetElementCategory(element, category)- Assign or change an element’s categoryElementDataModel.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
GeometryPropertieswithFileGeometry/StreamGeometry - [ ] Replace
GetElementGeometryByElementAsync()withGetGeometriesAsync() - [ ] Remove
SetGeometryConfiguration()calls - [ ] Update
IHostingProviderto useGetExchangeMetadataDescriptorAsync
Priority 2: Interface Implementations
- [ ] Implement new
IElementmembers (if custom implementation) - [ ] Implement new
IElementDataModelmembers (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
ValidationStatusfor error handling - [ ] Use
FileGeometry.Dispose()pattern for cleanup
Backward Compatibility
| Old API | New API |
|---|---|
GeometryProperties |
FileGeometry / StreamGeometry |
GetElementGeometryByElementAsync() |
GetGeometriesAsync() |
GetExchangeMetaDataAsync() |
GetExchangeMetadataDescriptorAsync() |
SetGeometryConfiguration() |
Removed - not needed |
UpdateElement() |
Removed - use property setters |
See Also
- Migration Guide - Detailed attribute migration guide