Release Notes
Ucommerce 10.9.3
Release Date: 2024-12-19
Bug Fixes
Resolved a critical issue with definition inheritance that could inadvertently destroy the definition inheritance.
Affected Versions: All releases from 10.7.0 to 10.9.2. Use of these versions is strongly discouraged if any definition inheritance is utilized. Please note: If you have used any of the affected versions, the relationships between your definitions and definition fields may have been updated incorrectly if using inheritance.
A 10.8.2 version is also available with this same fix applied.
Ucommerce 10.9.2
Release Date: 2024-12-12
Bug Fixes
It is now required to select cart/order definition on a store, as well as customer definition.
These define the definitions used, when one of these entities are created automatically through checkout.
Fixed a bug where the validation of address entities required first and last names, which did not match the entity description and the database schema. First and last names are no longer required by the validator.
We now properly display audit information for customer center entities.
Corrected display of floating point numbers in the backoffice
Currently, we only support using '.' as a decimal separator. We plan to also enforce this in the Number Editor in a future release.
Indexing of floating point numbers in search has been corrected
Related to the fix above.
Various UI bug fixes
Improvements
The apply and remove promotion code, headless endpoints can now return a mini cart view to save you from requesting the cart again after applying or removing a promotion code. Add the query parameter
views=miniCart
to your request to get the mini cart.
Ucommerce 10.9.1
Improvements
When using the price index, the source price group of a price is now included. This is useful when working with derived price groups. Example: Base prices is a price group containing all list prices and Customer A is a customer-specific price group, derived from Base prices, containing discounted prices for only some products. Previously, all prices derived from Base prices would only contain the
ProductGuid
as well as thePriceGroupGuid
of the Customer A price group. Now, the price will also haveSourcePriceGroupGuid
containing thePriceGroupGuid
of Base prices, making it easy to determine the origin of a price.
Bug Fixes
Fixed a bug where a price would only be indexed for a single price group even if it was derived from a base price group into multiple derived price groups.
Fixed styling issue on the products list view.
Fixed a bug in a migration script that prevented definition fields with the same name as a previous, soft-deleted, field to exist.
Fixed a bug in a migration script so that it deletes the right duplicate definition field when migrating from Ucommerce Classic.
Order lines are now correctly associated with the discounts applied to them.
Non-multilingual fields no longer saves the culture code, which prevented the value from showing up when using another culture code.
Product families are now displayed when selected as a criteria for a promotion. Previously product families could be selected but would never show on the list of selected criteria.
Ucommerce 10.9.0
Release Date: 2024-12-02
Breaking changes
We have added a unique index on a definition's field names. This means that fields on the same definition can no longer have the same name. If you have such an issue in your data, you might encounter the error:
New Features
New Customer groups area in the Customer Center app. This allows you to see, update and create new customer groups as well as adding and removing customers from a group.
New customer-related criteria.
New criteria are available for promotions and price groups. These will allow for targeting specific customer groups or organizations.
New customer group and organization picker modals are available.
These modals are now available through the definitions system. To use them anywhere, set your definition field's data type to be any of the two pickers.
Improvements
Content.ChildrenCount
is now nullable to support integration with systems that do not supply it, e.g. Umbraco Delivery API. WhenChildrenCount
is zero, you can't navigate to the folder, otherwise, the navigation arrow will show.Improved Catalogs app so that it handles 100.000+ price groups gracefully.
Scratch indexing now uses the DistributedLock.SqlServer implementation as the distributed lock by default. The
NullDistributedLockProvider
, which simply logs an error, has now been deprecated.
Bug Fixes
Updating and deleting a catalog now updates the category index correctly.
The Catalogs app now displays the new value when changing the name of a price group.
Promo codes no longer disappear in the UI when going to the unique tab of the promo code generation dialog.
The Category picker in promotion criteria no longer scrolls indefinitely.
Adding, removing, or changing definitions fields through EF Core now correctly updates the definition's
ModifiedOn
property meaning it will invalidate the cache and reload the definition in the backoffice UI.IEnumerable<string>
now works as expected in index definitions.Creating a catalog now also sets the Allowed price groups.
Referencing a (soft-)deleted definition on an entity no longer breaks the backoffice UI.
Fixed a filtering issue when adding a product to an order in the backoffice UI.
Fixed an issue with selecting a price group for a payment method and then de-selecting it.
Custom properties on a product family no longer show up on variants.
Some error messages were not shown when creating customers and organizations
Ucommerce 10.8.1
Release Date: 2024-11-18
Bug Fixes
Fixed an issue where ElasticSearch would sometimes attempt to access an internal method from a Microsoft library.
Ucommerce 10.8.0
Release Date: 2024-11-04
New Features
A whole new Customer center app in the back office. This app contains two areas: Customers and Organizations. Customers allow you to see, update, and create new customers while Organizations allow you to see, update, and create new organizations as well as adding and removing customers from an organization.
Performance Improvements
Improved performance of orders and promotions apps.
Improved search indexing speed.
Improved performance and usability of the Products list.
Bug Fixes
Headless Access and Refresh Token duration settings are now respected.
Headless Access and Refresh token clock skew default value changed to 30 seconds instead of the default 5 minutes set by Microsoft. The value can be configured via appSettings (
Ucommerce:Website:Headless:AccessTokenClockSkew
).Fixed an issue where a null valued definition in the database could break the pages.
Fixed an issue where missing database indexes could cause migration errors.
Ucommerce 10.7.1
Release Date: 2024-10-16
Performance Improvements
Improved performance of definition caching.
Improved performance of store, catalog and product apps.
Bug Fixes
Fixed an issue where a selected product definition would show as removed when clicking change definition.
Fixed an issue with retrieving a cart after adding shipping information.
Fixed an issue with definition inheritance with more than one parent definition.
Fixed nullability for promotion name in the database. A default value is set if the name is null when upgrading.
Fixed an issue with licensing when Visual Studio starts sending request(s) before the application has fully initialized the license.
Fixed an issue with writing license information to the database when license is not valid.
Ucommerce 10.7.0
Release Date: 2024-10-04
Breaking changes
Definitions: (Re-)enablement of definition inheritance has resulted in a major rewrite of how entities works with their definitions to make sure that the inheritance is always considered. This means that the
Definition
property is no longer available on definition-based entities. Instead use the newDefinitionGuid
property to look up the definition using the new get definition pipeline (IPipeline<GetDefinitionInput, GetDefinitionOutput>
).
New Features
Product Picker: New Product Picker Widget which can be used inside your CMS.
Prices: Prices can now be indexed in their own index to avoid transferring large amounts of superfluous prices from the product index. See Indexing Prices for more details.
Products: You can now add a product to any categories from inside the products app.
Carts & Orders: Carts and Orders are now definition based, which means that it's possible to create your own definitions with custom fields now. The definition is set on a per store basis.
Discounts: You can create your own discount types with the definition system now.
Bug Fixes
Fixed sizing of price groups container in settings.
Added payment reference id to the payment section of an order.
Fixed an issue where it was not possible to have categories with the same name across multiple stores.
Fixed performance issue when retrieving a cart through the transactions API because of a missing index.
Fixed an issue where a selected definition would show as removed when clicking change definition.
Ucommerce 10.6.0
Release Date: 2024-08-30
Breaking changes
Ucommerce.Web.Core.Constants.CriteriaTypeConstants
has been renamed toUcommerce.Web.Core.Constants.PromotionCriteriaTypeConstants
to make it clearly distinct from the new price group criteria constants.
New Features
Price Groups: Price groups can now have criteria, allowing for more flexible control over access to specific price groups. Learn more about how to use price group criteria and create custom price group criteria.
Note: Price groups can now be enabled or disabled. All existing price groups will be enabled when upgrading. By default, new price groups will be disabled when created.
Shipping Methods: Shipping methods are now definition-based, providing enhanced customization options.
Bug Fixes
Promotion Criteria: Fixed an issue that prevented updates to various definition-based promotion criteria. Data validation now works correctly.
Catalog Definition Update: Resolved an issue preventing updates to catalog definitions.
Product Categorization: Fixed a bug that blocked certain products from being added to categories.
Price Group Tax Rates: Corrected an issue where creating a price group with a 0% tax rate was not possible. The backoffice now also provides a clearer error message when updating tax rates.
Backoffice Display: Fixed a visual bug in the backoffice that displayed "(removed)" after every selected definition name.
Cart Custom Pricing: Addressed an issue where a null
priceGroup
value was used when adding an item with a custom price to the cart.Order Line Properties: Fixed a bug that caused an exception when deleting an order line property from a cart with multiple order lines.
Cart Shipment Updates: Resolved an issue where updating or deleting order lines on a cart with shipment information could throw an exception.
Ucommerce 10.5.3
Release Date: 2024-08-20
Bug Fixes
Fixed a bug where it was not possible to add a product to the cart after adding shipping information.
Ucommerce 10.5.2
Release Date: 2024-08-05
Bug Fixes
Fixed a bug where it was not possible to set a custom price on a product.
Ucommerce 10.5.1
Release Date: 2024-07-30
aking Changes
Property Splitting Character Alignment: The character used for splitting properties in the database has been standardized across Ucommerce. All splitting will now be done using the
;
or|
characters. Adjustments will be necessary if you have custom logic related to these properties. Most changes involve replacing,
with;
.API Controller Request Model Updates: Most backoffice API controllers have had their request models updated. All parameters that refer to a GUID are now correctly named "Guid" instead of "Id" in property names. This change may impact your project if you use the backoffice controllers.
Improvements
Grid View Enhancement: The new grid view for the price group list now retains your column reordering preferences.
Improved User Information Formatting: The "modified by" and "created by" information in sub-menus has been reformatted for more clarity.
Enhanced Order Validation Messages: Clearer messages are now provided when a user is not allowed to create an order in a store or when trying to add an invalid order line.
Bug Fixes
Currency Update Fix: Resolved an issue where updating the currency on a base price group would not propagate to child price groups.
Catalog Criterion Dropdown Error: Fixed an error that could occur with the catalog criterion dropdown.
Currency ISO Code Validation: Addressed an unnecessary validation of the currency ISO code in the backoffice.
Price Group Update Issue: Corrected an issue where the price group in the products list would not update properly.
Migration Table Name Length Issue: Fixed a migration issue where the old
uCommerce_CategoryTarget
table could contain names that exceeded the allowed length in the new table, ensuring compatibility for all name lengths.Custom Category Picker Registration: Fixed an issue where a custom category picker could not be correctly registered via the definitions system.
Ucommerce 10.5.0
Release Date: 2024-07-08
Breaking Changes
Removed the dependency on the Microsoft.AspNetCore.Mvc.NewtonsoftJson package.
Features
Custom Definition-Based UI Editors: Added support for creating custom editors for the Ucommerce backoffice. Learn how to create your own editor.
Price Group Inheritance: When creating a new price group, selecting a base price group is now possible. Learn more about price group inheritance.
Price Group List UI Changes: The price group list view was redesigned.
The new design makes use of pages instead of infinite scroll, which could cause performance issues in some cases.
Improvements
Now using the built-in System.Text.Json for (de-)serialization instead of Newtonsoft.Json
Bug Fixes
Resolved an issue where deleting a product relation could result in an error.
Notes
The data importer tool, introduced in version 10.3.0, has been updated to support price group inheritance. The import model now includes a new property for defining a base price group.
Ucommerce 10.4.0
Release Date: 2024-06-18
Features
Definitions-Based Promotion Criteria: Promotion criteria are now definitions-based, allowing for easier extension of criteria. For more information, Discover how to set up definitions for promotions.
Bug Fixes
Logbook Entry for Cart: Resolved an issue where adding a logbook entry for a cart was not possible.
Order Number Series: Order number series on the store is now a required field and will not fail due to undo actions.
UI Flickering: Fixed an issue causing the UI to flicker when changing values on a promotion.
Navigation Header: Addressed a problem where the left-side header navigation was unresponsive on the product page.
Ucommerce 10.3.0
Release Date: 2024-06-07
Breaking changes
The connection string setting has been moved from
Ucommerce:ConnectionStrings:UcommerceConnectionString
toUcommerce:Persistence:ConnectionString
to consolidate all persistence options in one place.Additionally, the
Ucommerce:Persistence:ConnectionTimeout
option is now properly utilized to set the maximum duration (in seconds) for a database query before it times out. This improvement is particularly beneficial when migrating large databases from version 9.7 to 10.
Features
Prices Bulk Editing: The "Price Groups" section in settings has been renamed to "Prices". This area still includes price groups and price group editing, but now also allows for bulk editing of prices within each price group. This change aims to simplify the use of price groups and streamline the mass editing of prices.
Introducing the new data importer tool! This tool allows you to seamlessly import products, prices, and more into Ucommerce from external sources. For more details, see Data Import.
Note: This is the initial release of the tool. Future updates and improvements are planned.
Bug Fixes
Order Page Optimization: Fixed an issue causing the orders page to timeout when too many orders were loaded. The fetching process has been optimized for speed, and the timeout limit has been increased.
Error Message Display: Error messages now correctly appear in the back office when an error occurs during the creation of a price group.
Pipeline Task Exception Handling: An exception is now thrown if you attempt to add a pipeline task before or after itself, unless the instances have different IDs. Previously, this operation was allowed but produced unexpected results.
Database Migration Debugging: During database migrations, the inner exception is now surfaced, making debugging easier.
Product Page Price Groups: Fixed an issue where the product page would only load a maximum of 12 price groups. Note: We are aware of another potential issue affecting this area and will address it in the next release.
Free Gift Reward Editor: The loading indicator in the Free Gift reward editor no longer displays indefinitely.
Promo Code Download: It is now possible to download a list of promo codes again.
Cart default data: The default carts had invalid data, causing errors. This has been adjusted.
Ucommerce 10.2.1
Release Date: 2024-05-03
Bug Fixes
(Migrations) Added safeguards to migration logic that could break migrations in rare cases.
Ucommerce 10.2.0
Release Date: 2024-04-25
Breaking changes
(Pipelines) Pipelines have been improved. If you have any custom pipeline tasks or are executing any pipelines, you will need to change your code.
IsSuccessful
has been deprecated. It is replaced byEnsureSuccess
. We believe that the new name better reflects the fact that aPipelineException
is thrown if any errors occur during the execution of the pipeline. Also, in caseEnsureSuccess
does not throw aPipelineException
, it returns the output from the pipeline execution.PipelineTaskArgs
has been removed.PipelineContext
now contains the input and output instead. ThePipelineContext
has been made generic to support this change. In addition, theCancellationToken
has been moved out of thePipelineContext
and is now a part of theExecute
method signature to make your IDE recognize its existence. Method signature before:Method signature now:
Executing a pipeline no longer requires an output or
PipelineTaskArgs
object. To run a pipeline, you only need to provide the input. When the pipeline has executed, we recommend callingEnsureSuccess
on thePipelineExecutionResponse
, to make sure no errors occured and get the output from the pipeline.
Features
(UI extensibility) It is now possible to inject custom web components into the Ucommerce backoffice. Learn more about Custom UI components.
Bug Fixes
(Indexing) The product indexer now works correctly when indexing products outside of categories.
(Pipelines) The checkout and order processing pipelines are now discoverable in the pipeline discoverability endpoint. Learn more about pipelines and discoverability.
Ucommerce 10.1.2
Release Date: 2024-04-09
Bug Fixes
(Licensing) The application will no longer shut down end of June even if a valid license key is given
Ucommerce 10.1.1
Release Date: 2024-03-22
Improvements
(Migration) Migration script execution speed and reliability is improved
Bug Fixes
(Backoffice) Changing language will now update labels on custom fields.
(Backoffice) Lazy loading fixed in the products app now works regardless of screen height.
(Backoffice) The result count when searching will now show in the correct format.
(Backoffice) After updating a product the product list will update with the correct values.
(Search) Sorting on product unit price now sorts the result correctly. This was caused by the index definition defining the values as long instead of floating points.
Ucommerce 10.1.0
Release Date: 2024-03-08
Breaking changes
We improved setting up an external identity provider for our Backoffice. See BackOffice Authentication documentation for details.
Features
It is now possible to assign store permissions to individual users.
A user will be created or updated when using an external identity provider. See BackOffice Authentication documentation for details.
It is now possible to rebuild the search index and/or check the status from Backoffice -> Settings -> Search - rebuild index.
It is now possible to undo the deletion of promotions.
It is now possible to undo the update of a criterion or discount.
Bug Fixes
Undo widgets in Backoffice will disappear if the route changes.
Ucommerce 10.0.1
Release Date: 2023-02-23
Features
It is now easier to add and edit the checkout pipelines through the
PaymentBuilder.CheckoutPipelines
property. See Checkout Pipelines documentation for details.It is now possible to add and edit order processing pipelines through the
PaymentBuilder.OrderProcessingPipelines
property. See Order processing Pipelines documentation for details.When a user searches within any searchable list in the back office, it is now possible to change the focus on search results using the arrow keys and to open a selected item by pressing the Enter key.
A new type;
UserDefinedEnum
, was created to be used for index definitions on fields containing user-defined enums.Using the
UserDefinedEnum
type, multilingual user-defined enums can now display the appropriate display name while using the enum's value for queries.
Bug Fixes
Order processing pipelines are now triggered correctly on order status updates.
Fixed an issue where the selection of a catalog criteria in the promotions page caused an error.
The product page -> Display name is now correctly set as required.
The product page -> No longer displays the variants section for products that can not have variants.
Product page -> Focusing and unfocusing the Long Description now only sends a PATCH request if any changes were made.
CatalogLibrary.GetFacets()
returns the expected facets now.Faceted search returns the correct products.
Using the
UserDefinedEnum
type, multilingual user-defined enums are now displayed correctly.Parent products no longer index all language versions of enum variant properties.
Notes
Raw search capabilities for Elasticsearch have been moved out of
Ucommerce.Extensions.Search.Abstractions
. They are now available as extension methods onIIndex
using the namespaceUcommerce.Search.Elastic.Extensions
. Note: The extension methods will throw an exception if theIIndex
instance is notElasticsearchIndex
The unused table
uCommerce_ProductCatalogGroupTarget
has been removed from the database. This table was used to link a promotion to a store. This is now done using the campaign.
Ucommerce 10.0.0
Release Date: 2023-02-08
Features
Changing the priority of promotions is now undoable.
Deleting a campaign is now undoable.
Adds convenience accessors to
UCommerceDBContext
forCatalogs,
Customers,
PriceGroups,
ShippingMethods,
Users,
Campaigns,
Carts,
Orders,
Products,
Categories and
Stores
Breaking changes
Migrated the search driver from
Elasticsearch.Net
andNEST
7.17.5
toElastic.Clients.Elasticsearch
8.11.0
There will be a need to update any existing search configurations. Please take a look at the Configuration documentation for more information.
Upgraded from .Net 7 to .Net 8
Changed signature of
GetPrices
inIPriceCalculationService
- removing intermediate value objectRenamed
WebSiteControllerBase
toHeadlessControllerBase
for better readability for partner developers.The default back office URL moved from
/ucommerce-ui/
to/ucommerce/
Bug fixes
Price group validation now happens before updates in headless calls - meaning a wrong price group guid will now actually block the update of the entity.
Fixed an issue where having no stores at all would cause errors in the back office.
If no store exists, the sidebar tabs for catalogs, products, orders, and promotions are now hidden.
Removed some corrupted data from the default database migration, which caused issues in the default campaign.
Fixed an issue with payment provider callbacks not being registered correctly.
Alpha
Last updated