Dev GuideAPI ReferenceUser Guide
Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunityOptimizely AcademySubmit a ticketLog In
Dev Guide
GitHubNuGetDev CommunityOptimizely AcademySubmit a ticket

Breaking changes for Commerce Connect 15

Breaking changes for upgrading from Optimizely Commerce Connect 14 to Commerce Connect 15.

Review the following breaking changes before you upgrade an Optimizely Commerce Connect implementation from version 14 to version 15. Each item identifies a removed type, removed member, or newly obsolete API that requires code updates. For the full upgrade procedure, see Upgrade from Commerce Connect 14 to 15.

  • .NET 10 – Commerce Connect 15 requires .NET 10 and includes all .NET API breaking changes from CMS 13 compatibility (COM-19569, COM-20778).
  • CMS 13 obsoletes – SiteDefinition, ISiteDefinitionResolver, IMimeTypeResolver, ScheduledPlugInAttribute, ContentTypeModelRepository, IndexOutput.Seek, PropertyPageReference, and many serialization constructors are removed or replaced (COM-21005 through COM-21021).
  • SiteId – Data type changed from Guid to string to align with the CMS 13 Application class that replaces SiteDefinition (COM-21203, COM-17391).
  • Credit card classes – CreditCard, CreditCardPayment, ICreditCardPayment, and SerializableCreditCardPayment are removed.
  • CustomerContext – CreditCard relations are removed.
  • Organization – CreditCard relations are removed.
  • Order abstraction identifiers – Changed from integer to GUID (COM-8324).
  • Newtonsoft.Json – Replaced by System.Text.Json throughout the codebase (COM-20991).
  • IExtendedProperties.Properties – Type changed from Hashtable to IDictionary<string, object>. Runtime checks limit the accepted value types (COM-3922).
  • Obsolete interfaces – All interfaces previously marked [Obsolete] are removed (COM-20691).
  • Obsolete classes and methods – All classes and methods previously marked [Obsolete] are removed.
  • BinaryFormatter – Dependencies removed throughout the codebase. Update any code that relies on binary serialization of Commerce Connect types (COM-17448).
  • SQL Server data types – ntext, text, and image are replaced with non-deprecated alternatives (COM-10857).
  • HierarchicalCatalogPartialRouter – Updated to use the supported URL resolver API (COM-15119).
  • ICatalogSystem methods – Marked obsolete because the underlying implementation is already obsolete.

Updated 12 days ago