Release Notes

Ucommerce 10.12.3

Release Date: 2025-03-26

Improvements

Performance: Improved the performance when adding an item to the cart.

Bug fixes

Fixed an issue with getting active promotions, where the orderProperty collection could be null.

Ucommerce 10.12.2

Release Date: 2025-03-21

Improvements

Headless API: The endpoint for getting active promotions related to specific products now groups the products and related promotions together.

Ucommerce 10.12.1

Release Date: 2025-03-20

Improvements

Performance: Definitions are now cached in memory to boost performance of Ucommerce. The default cache duration is 5 minutes. The value can be configured via appSettings Ucommerce:Persistence:Caching:Duration . To avoid cold start and cache misses, a new interface IPreHeatCacheAction can be used to put data in the cache before it is needed. The action will run on a schedule 5 seconds shorter than the specified duration to make sure the cache is re-populated before it expires.

Dependency Injection: Ucommerce now has a Decorate extension method on IServiceCollection that allows you to decorate an existing DI registration with extra logic. Internally in Ucommerce, it is the mechanism used to decorate the GetDefinitions pipeline with caching using the CachingPipelineDecorator . Other pipelines can be cached using

builder.Services
    .Decorate<IPipeline<XXXInput, XXXOutput>>((decorated, sp) =>
        new CachingPipelineDecorator<XXXInput, XXXOutput>(
            sp.GetRequiredService<IMemoryCache>(),
            sp.GetRequiredService<IOptionsMonitor<PersistenceOptions>>(),
            decorated));

New Features

Customer management: You can now see, create, update and delete addresses on organizations in the backoffice. These addresses can be used to prefill a dropdown of possible addresses in the checkout flow in the store front.
Headless API: New endpoint for getting active promotions related to specific products.

Bug fixes

Fixed an issue with order lines not using the multilingual DisplayName property of the products, but the default Name property. Now Name is only used as a fallback when no DisplayName is set.
Fixed an issue where discounts would sometimes disappear when adding shipping information to a cart.
Fixed an issue where clicking on a section title (left-hand side of details pages in the backoffice) would not scroll to the selected section.
Added missing payment information to GetOrderViewModel return by the GetOrder headless API endpoint
Fixed an issue where changing the variant list columns would store the changes but not rendered in the UI
Fixed missing (re-)indexing of products and categories when modifying categories from the product details page

Ucommerce 10.12.0

Release Date: 2025-03-03

Improvements

Order management: You can now define sections to group dynamic properties. Dynamic properties' sort order is used within the section and sections can be sorted on the page. This was introduced for products in 10.10.0 but is now available for orders as well.
Headless API: The performance of the promotions-flow is improved significantly when calculating a cart, while having many active promotions.
Product Information Management: The quick search list is now searchable with pagination.

Bug fixes

Fixed an issue with validation expressions for enum types when the enum value was null.
Fixed missing order line discounts hydration when getting an order using GetOrderInput.
Fixed an issue with the UI when selecting currencies for deletion.
Fixed missing order line properties hydration when running the default checkout-flow.
Fixed unnecessary NotNull constraint on DataTypeEnumDescriptionEntity.Description. The value can now be null.

Ucommerce 10.11.1

Release Date: 2025-02-21

Improvements

Product Information Management: It is now possible to search through the quick search list.

Bug fixes

Fixed an issue where price indexing would have duplicate data if multiple batches where fetched.
Fixed an issue where an incorrect guid would be used to fetch price definitions in payment integrations.

Ucommerce 10.11.0

Release Date: 2025-02-18

Breaking changes

Due to performance issues using the price index, we've changed the way prices are indexed. This means that the PriceSearchModel has changed significantly:
- The property PriceGuid is now available simply as Id replacing the random value generated previously.
- The property PriceGroupGuid has been renamed to PriceGroupGuids . It is now a list of GUIDs for all price groups the price is valid for. See Using the Price Index for details.
- The properties Tax, TaxRate, and PriceInclTax are not longer available. See Calculating Tax for details.

New Features

Catalog Management: You can now define the order of products in a category by drag and drop.

The list of products on CategorySearchModel is now sorted based on the SortOrder
ProductSearchModel now contains a new property CategoriesWithSortOrder containing all categories and the product's SortOrder in that category.
- CategorySearchModel list of products is now sorted by default by this property.

Improvements

Product Information Management: Sorting product lists in the backoffice now supports sorting on multilingual fields.
Order Management: The filter can now be saved for later visits.
Core: Ucommerce no longer log sensitive data and EF Core queries by default. See Logging for details.
Headless API: A new endpoint has been added to get order details from a payment GUID. See Orders for details.
Headless API: The CreatePayment and Checkout pipelines now accept Guid for entities on input. This change has also been released as a patch for 10.9 (10.9.6) previously.
Headless API: Improved cart calculation performance for shops with many active campaigns.

Bug fixes

Fixed a LINQ error that happened when some entities were saved.
Product lists in the backoffice returned status code 500 when sorting on some fields.
Fixed issue where, when in the root folder of a media picker, it's possible to click back infinitely.
Fixed issue where creating a payment would try to save the payment method.
Fixed issue creating new sections for the backoffice.

Ucommerce 10.10.0

Release Date: 2025-01-23

Breaking changes

As part of finally fixing the issues with definition inheritance, the pipelines to get one or more definitions now returns an immutable copy of the definition-system related entities (.e.g. DefinitionEntity, DefinitionFieldEntityand DataTypeEntity ). This means that entity properties (e.g. ProductProperty, PaymentMethodProperty and EntityProperty) can no longer have a direct reference to the DefinitionFieldEntity it relates to. Instead they now have a DefinitionFieldGuid uniquely identifying the field it relates to.

New Features

Product Information Management: You can now create, update, delete, and use product quick searches. Quick searches means you can now search for any dynamic property value, not just name, sku, etc. Quick searches can be private or shared with everyone.
Product Information Management: You can now define sections to group dynamic properties. Dynamic properties' sort order is used within the section and sections can be sorted on the page.
Product Information Management: You can now toggle variants on in the product list. This is especially useful when using a quick search that targets variant properties, but can also be used for regular searches.

Improvements

The AddressEntity was not auditable. This means you can now inspect the CreatedBy, CreatedOn, ModifiedBy, and ModifiedOn to see who created or modified an address.
The OrderEntity is now added to the OrderProcessingOutput used in all order processing pipelines. This makes it easier for developers to follow our best-practices of treating the input as immutable and always use the output when making modifications to objects.
Various UI improvements.
Removed dependency on the System.Linq.Dynamic.Core package

Bug fixes

Fixed an issue with boolean fields in the Organization area not always being able to save when updated.
Fixed an issue with updating fields in the Organization area when the new value is empty.
Fixed wrong RenderInEditor setting for DisplayName in products app.
Fixed issue where adding an image to a product would add it twice in the backend.
Fixed an issue where undoing changes to phone number would not always be saved.
Fixed an issue with the decimal separator for the number editor. It now aligns with the currency editor using "." (dot) as the separator.
Fixed an issue in the Orders app, where the filters tab would sometimes show an incorrect number of filters set when reloading the page.
Fixed an issue where the LastModifiedMiddleware for definitions would log exceptions for some definition types.
Fixed an issue where the AddToCart pipeline would always add a new line when called using the ProductGuid. It now respects the AddToExistingOrderLine flag on AddToCartInput.
Fixed an issue where the tax rate from the price group was not used as a fallback when the tax rate on the input was not set.
Fixed an issue where AddToCart with a negative quantity could be used to remove the order line. Use DeleteCartOrderLine pipeline instead.
Fixed an issue where recalculation of the cart total etc. was not triggered when the cart was emptied.
Dynamic properties are now correctly initialized with the default value set up for the field.
Deleting a product family now correctly deletes the variant products related to the family.

Ucommerce 10.9.6

Release Date: 2025-01-30

Improvements

The CreatePayment and Checkout pipelines now accept Guid for entities on input.

Ucommerce 10.9.5

Release Date: 2025-01-10

Bug fixes

The content service now works correctly.
- Check out this new doc, for more information on how to implement your own content service.
Fixed an issue where updating non-multilingual definition field properties created duplicate properties.

Ucommerce 10.9.4

Release Date: 2025-01-06

Bug Fixes

Fixed issue where facets on product variant definition fields of type IEnumerable<string> would throw an exception when fetching facets from the product index.
Fixed issue with Percent off order lines discount being added multiple times to the list of discounts on order lines when the quantity changes.

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

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.

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

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 the PriceGroupGuid of the Customer A price group. Now, the price will also have SourcePriceGroupGuid containing the PriceGroupGuid 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: See common database issues for more details.

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. When ChildrenCount 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 new DefinitionGuid 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 to Ucommerce.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 to Ucommerce: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 by EnsureSuccess. We believe that the new name better reflects the fact that a PipelineException is thrown if any errors occur during the execution of the pipeline. Also, in case EnsureSuccess does not throw a PipelineException, it returns the output from the pipeline execution.
- PipelineTaskArgs has been removed. PipelineContext now contains the input and output instead. The PipelineContext has been made generic to support this change. In addition, the CancellationToken has been moved out of the PipelineContext and is now a part of the Execute method signature to make your IDE recognize its existence. Method signature before:
  Task Execute(PipelineTaskArgs<TInput, TOutput> subject, PipelineContext context);
  Method signature now:
  Task Execute(PipelineContext<TInput, TOutput> context, CancellationToken cancellationToken);
- 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 calling EnsureSuccess on the PipelineExecutionResponse, 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 on IIndex using the namespace Ucommerce.Search.Elastic.Extensions. Note: The extension methods will throw an exception if the IIndex instance is not ElasticsearchIndex
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 for
- Catalogs,
- Customers,
- PriceGroups,
- ShippingMethods,
- Users,
- Campaigns,
- Carts,
- Orders,
- Products,
- Categories and
- Stores

Breaking changes

Migrated the search driver from Elasticsearch.Net and NEST 7.17.5 to Elastic.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 in IPriceCalculationService - removing intermediate value object
Renamed WebSiteControllerBase to HeadlessControllerBase 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

Alpha Releases

Alpha 13

Build 4021

Breaking Changes

The navigation property called Properties of DefinitionFieldEntity has been removed.
The navigation property called ProductDescriptionProperties of ProductDefinitionFieldEntity has been removed.

Features

It is now possible to see users' permissions when navigating to the settings app.
When clicking the user permissions item on the settings app, it is now possible to see a list of available users.
The user entity has been extended with Name and IsAdmin properties. As part of the migration Name is set to ExternalId.
The settings area of the backoffice is now only available to users with admin privileges.

The user permissions settings will be added to the backoffice in the next release.

Bugs

Fixed an issue where the ElasticSearch cloud options were not set to use the correct serializer. This meant that custom-defined fields would not be added to the index as they should when they are added to the index definition.
Fixed an issue with date pickers on custom definition fields.

Improvements

Guid generation for new entity objects has been moved from an EF Core SavingChanges-interceptor to object creation time.
Fewer database calls are needed for security checks.
Added cascade on delete for relevant foreign key constraints in the database.
Added Ucommerce.Web.Core.Constants.DateFormattingConstants.DEFAULT_DATE_TIME_FORMATTING as a constant for date formatting in Ucommerce.
Added helper method ToUcommerceString() as an extension method for DateTime and DateTimeOffset to convert time to UTC and format it using Ucommerce.Web.Core.Constants.DateFormattingConstants.DEFAULT_DATE_TIME_FORMATTING. This aligns with how dates persisted in V9.
- This method (or the constant above) should be used when importing dates into definitions to make sure that the dates are displayed as expected in Ucommerce.

Alpha 12

Build 4019

Features

Search Adorners are now available. This allows you to add custom data to search models. See Custom Data for more details.
It is now possible to create, update, edit, and delete order number series from the Backoffice → Settings app → order number series.

Improvements

ElasticSearch Implementation now handles large data sets better.
Added logging of execution time for indexing service.

Alpha 11

Build 4017

Features

The promotions engine now applies to carts based on the promotions set up in the Backoffice.
Changing the priority of campaigns is now undoable.
Deleting campaigns is now undoable.
The list of campaigns is now searchable.

Bugs

Clicking on "create new campaign" to open the modal will now show the loading state until ready.
Creating a new campaign from the Backoffice will now have all the required fields marked with "required".
Creating a new campaign from the Backoffice will now have fields disabled while sending a POST request.

Other improvements

Scratch indexing was slow for categories containing a large number of products.

Alpha 10

Build 4016

Breaking

Renamed all pipeline tasks that save changes using the DbContext to "SaveChangesPipelineTask" to keep naming consistent

Features

It is now possible to create and replace an Index Definition to configure what information will be indexed to ElasticSearch (e.g., custom definition fields).
- More here: Index Definitions
It is now possible to implement product filtering using Faceted Search based on price or any custom definition field.
- More here: Facets
It's now possible to search for menu items in the settings app, and pressing enter will open the highlighted menu item.
It's now possible to see, create, edit, and delete product relations from the Backoffice → Settings app → Product relations menu.
For all selectable lists in Backoffice, when we start selecting a row, it will switch to select mode, which means the cursor will change to a check sign, and when clicking any row, it will check/uncheck the row instead of opening the edit page.

Bugs

Fixed: When editing order billing or shipping through Backoffice, the country and shipping methods wouldn't show up correctly.
Fixed: On the orders app, when a user starts selecting orders to change status, the orders with different statuses should be disabled.
Fixed: Product indexer could not find related categories.
Fixed: Category indexer could not find related products.
Fixed: Product indexer now correctly indexes parent products.
Fixed: Existing relations between products and categories when adding a new product to a category would result in duplicates.
Fixed: Filtering issue for user-defined multilingual enums when fetching products for indexing.
Fixed: User-defined multilingual enums would not be saved correctly when changed in the Backoffice.

Other improvements

Fewer database lookups are needed when indexing a category.

Known bugs

Product relation names can't be longer than 50 characters. The backend will throw an exception, but the UI doesn't notify the user of the problem.

Alpha 9

Breaking

Refactored the UpdateCart pipeline to CalculateCart and SaveOrder pipeline to CalculateOrder - and updated all other pipelines using those
- Added the possibility to use entities on the inputs instead of entity GUIDs
- Added the possibility to optionally not save database changes in these pipelines (they always saved before)

Features

Added loading and error states to the product app.
Search terms, sort options and render types (search or navigate) are part of query params in backoffice (the user is able to share the search result URL)
It is now possible to see the price groups menu item in the settings of the backoffice, and a list of price groups when navigating into it.
It is now possible to add a new price group directly from the backoffice.
It is now possible to delete a list of price groups and undo deletion in the backoffice settings.
It is now possible to edit a price group and undo changes when clicking the undo button after editing from backoffice.
Improved index consistency using a persistent queue of entities to add/update/remove from the index.
- Interval/schedule and lock duration for the indexing can be set on SearchOptions. Defaults are 5 seconds (IndexingInterval) and 30 seconds (IndexingLockDuration).

Bugs

Fixed an issue from alpha 7, where stripe and adyen definitions were no longer added correctly when migrating from an old database.

Alpha 8

Breaking

The authentication changes in this alpha mean you need to update your project, see this gist for details.

Features

It is now possible to implement authentication for the backoffice
It is now possible to get an overview of the registered pipelines and tasks

Alpha 7

Breaking

DefaultRoundingService now uses MidpointRounding.AwayFromZeroinstead of MidpointRounding.ToEven(C# standard). See Midpoint values and rounding conventions for further details
IRepository has been removed. Instead, use UcommerceDbContextto interact with EF Core directly

Features

It is now possible to create, see, edit, and delete (CRUD) currencies from the backoffice, settings app, and currencies menu.
It is now possible to create, see, edit, and delete (CRUD) shipping methods from the backoffice, settings app, and shipping methods menu.
- It is possible to edit the general properties of a shipping method as well as pricing and restrictions.
It is now possible to see and change the image on a payment method through the backoffice (requires custom IImageService).
It is now possible to update which pipeline a payment method uses after its creation.

Bugs

Custom, non-multilingual definition field updates are now persistent again.
Category Search Models list of product IDs now reflects the IDs of the products and not the category product relations.
Categories and payment methods now get their display names set in all languages on creation.
Categories with "display on site" set to false are not indexed; they are not shown in the indexed products' category list.
It is now possible to create a category on the default store again.
Changed the name of the category field "Show Prices Including VAT" to "Show Prices Including Tax", and updating the field is now persistent again.
When generating promo codes, the amount field is now limited to 6000, just like the API, effectively avoiding a silent fail in the backoffice when going over this limit.
A custom definition field on a product definition now correctly defaults to the data type editor instead of an editor property, effectively meaning that the field now appears consistently in the backoffice.
Missing Tax Rate and incorrect net price calculated for products. (Thank you Gratsiela!)
Better error messages.
Better differentiated empty state messages depending on order status for order lines and discounts section.
Content Picker Editors: Dynamic rendering of related entity type names in translations, replacing the previous hardcoded “product” label in the sub-header.
The item name in the breadcrumbs navigation is truncated now if it's more than 42 characters.

Alpha 5

Main Features

The pricing section has been added to the payment method edit page.
It is now possible to delete a payment method and undo that deletion.
It is now possible to deep link to a product
It is now possible to edit the store, country and price group related restrictions on payment methods

Bug fixes

Clicking on a product variant now redirects you to it again.
Product criteria no longer throws an error when adding a product.
"Spend more than" criteria now handles too large numbers properly.
Account payment method no longer throws 500 after a fresh install.
Display name for categories, catalogs, products and payment methods, can no longer be empty.
Updating, adding or deleting an order line now live-updates the log book.
Validation errors of Product upon creation is now displayed properly.
Dropdown items are now easier to click.
Get payment methods method in transaction library now returns hydrated payment method.
Get payment methods endpoint in headless now respects price group restriction.
Default payment method Account now has the relevant information to function as intended.
Removing Display names completely is no longer possible on any Entity through back office.

Alpha 3

Main Features

All new Api Acces page for configuring headless properties like client id, client secret, and a list of URIs that should be whitelisted.
You can change the client secret for your stores in the UI, granting a much faster headless setup.
You can add URLs to your whitelist for headless through the ui, granting a much smoother experience than earlier alpha builds.
You can remove URLs from the URL whitelist.

Bug fixes

Adding specific discounts to a promotion no longer throws an error.
Adding a product to a product criteria no longer throws an error.
The country field in the orders app is now more responsive.
Create store modal now closes when clicking cancel.
Creating a category now normalizes the sort order as expected.
Moving a category to another category now sorts them correctly.
A negative quantity in AddToCart will decrease the amount on an order line or delete it if the value drops to 0 or below.
Variant products will now correctly show in the Backoffice that they inherit parent prices if no prices are set.
Store pickers are now reactive; new stores will appear immediately.
Deleted stores will immediately be removed from store pickers.
Undo button now disappears after deleting an entity.
Multiple requests are no longer sent when getting stores on high-resolution devices.

Alpha 2

Main Features

Payment Method Settings, the settings area of the backoffice now has a section for configuring your payment methods. It's possible to see payment methods, create new ones, and edit the properties for a payment method.
Support for acquiring payments with Stripe as provider.
Support for refunding payments with Stripe as provider.
Support for cancelling payments with Stripe as provider.
New template for an MVC project with Ucommerce with a single index page, scratch indexing and pages for categories, products, adding products as well as viewing and clearing a cart.

Bug fixes

It's now possible to change the SKU of a product in backoffice again.
Store domain dropdown in backoffice now supports different port numbers.
Store domain dropdown in backoffice is no longer triplicated.
Creating a cart now includes it's order lines.
Re-ordering catalogs and categories no longer throws a server error.
It's now possible to change order status from the backoffice again.
It's now possible to update the long description on a product in backoffice again.

PreviousProduct Picker

Last updated 2 days ago

Was this helpful?