Ucommerce
  • Ucommerce Next Gen
    • Getting Started
      • Prerequisites
      • Licensing
      • Ucommerce Templates
      • Headless Template
      • MVC Template
    • Headless
      • Postman Collection
      • Headless API Authentication
        • Token endpoint - Authorization Header
        • Authorization Scopes
        • Refreshing the Access Token
      • Reference
        • Cart
        • Cart / Order Line Items
        • Shipment
        • Billing
        • Promotion Codes
        • Price Groups
        • Payment Methods
        • Countries
        • Shipping Methods
        • Catalogs
        • Cart Custom Properties
        • Line Item Custom Properties
        • Orders
        • Views for Cart modifying operations
      • Custom Headless APIs
      • Error Handling
      • Pagination
      • Deprecation
    • Backoffice Authentication
      • Microsoft Entra ID Example
      • Auth0 Authentication Example
    • Definitions
      • What is a Definition
    • Search and indexing
      • Configuration
      • Indexing
        • Index Definitions
        • Facets
        • Indexing Prices
        • Suggestions
        • Custom Data
      • Searching
    • Payment Providers
      • Stripe Provider Integration
      • Implementing a custom payment provider
    • Data Import
    • Miscellaneous
      • Media
      • Price Group Inheritance
      • Price Group Criteria
      • Soft Deletion Of Entities
      • Logging
      • OpenTelemetry
    • Extensions
      • Extending Pipelines
        • Order Processing Pipelines
        • Checkout Pipelines
      • Changing Service Behavior
        • Images
        • Content
      • Custom Headless APIs
      • Extend the Backoffice
        • Custom UI Components
      • Custom Editor UI
      • Custom Promotion Criteria
      • Custom Price Group Criteria
    • How-To
      • Migrate from Classic
        • Common database issues
      • Entities from code
        • Bootstrapping data on startup
        • Product Definitions & Fields
      • Discover pipelines and their tasks
      • Executing a pipeline
    • Integrations
      • Umbraco Media Delivery API
      • App Slices
        • Product Picker
  • Release Notes
  • Contact Us
Powered by GitBook
On this page
  • Before Migrating
  • Migrating
  • Migrating the database
  • Installing and connecting Next-Gen
  • Migrating custom logic

Was this helpful?

  1. Ucommerce Next Gen
  2. How-To

Migrate from Classic

PreviousHow-ToNextCommon database issues

Last updated 11 months ago

Was this helpful?

Before Migrating

If you have any complex custom code in your Ucommerce Classic solution, we recommend contacting us before you start your migration. It's also important that your solution meets our prerequisites, which are listed .

Migrating

Migrating the database

First, you must upgrade your database to the latest version of Ucommerce 9. If you're already on a version of Ucommerce 9, this should be easily accomplished by upgrading your Ucommerce package and starting your application. If you're using a regular SQL Server for your database, make sure that your database has a SQL Server compatibility level of at least 130.

Installing and connecting Next-Gen

We recommend using our templates for easy installation of Ucommerce Next-Gen. Information on them can be found . Once you've created a new project from one of the templates, make sure you add the connection string for your database. When this is done, you're ready to start the project and it will migrate the database for you. After this, go to the Ucommerce backoffice at /ucommerce and verify that your data has been migrated.

Migrating custom logic

To migrate custom logic, we recommend getting an overview of which parts of the solution are custom-built and then using our documentation to guide you on the changes needed.

The main differences between Ucommerce Classic and Next-Gen are how dependency injection works, application setup, database access, and pipeline registration. Some articles that might be of use to you are listed below:

N.B.: All custom logic must be ported from the .Net framework to .Net 8.

here
here
here
Discover pipelines and their tasks
Extending Pipelines
Change Service Behaviour
Entities from code
Custom UI Components