Business Central 2023 release wave 2

Path: Business Central on-premises > Upgrade > Earlier versions > Business Central 2023 release wave 2 · tier official · system platform · narrative reviewed (checked by Opus)

Overview

This section collects the Learn pages for upgrading on-premises Business Central to 2023 release wave 2 (version 23). It starts with an overview page covering upgrade paths, deprecated features and on-premises to online migration, plus a general considerations page and a compatibility matrix that shows the minimum versions needed between major versions.

The technical upgrade pages are split by starting version: one for version 14, one for version 19, and one for versions 20, 21 and 22. Separate pages cover upgrading the Microsoft System and Base Application from versions 15-22, and upgrading a version 14 C/AL application, either unmodified or customized. Each covers database conversion, extension publishing and synchronization. A page on installing a version 23 update covers platform and application updates with PowerShell.

Supporting pages handle specific work: C/AL to AL conversion with Txt2Al, moving tables and fields between extensions (up or down the dependency graph with migration.json), upgrading permission sets, and upgrading reports. Start with the overview and compatibility matrix, then choose the technical upgrade page for your starting version.

Key points

• The compatibility matrix lists minimum update versions for upgrades between major versions; upgrades from version 24 or earlier must target version 25 first.
• Separate technical upgrade guides exist for version 14, version 19, and versions 20-22 to version 23.
• Upgrading a version 14 C/AL application to version 23 uses the System and Base Application extensions, with the DestinationAppsForMigration setting and migration.json for table migration.
• Customized C/AL code is converted to AL with the Txt2Al tool, including .NET interoperability and test library conversion.
• Moving tables and fields down the dependency graph uses migration.json; moving up requires a two-stage process with a transition extension.
• Permission sets move from legacy data-based permissions to AL object-based Permission Set and Permission Set Extension objects.
• Report upgrade guidance for version 20 and later covers the new platform rendering model, report events, and Word and RDLC custom layouts.
• The India Data Migration Toolkit page covers NAV 2016 India to Business Central 2021 release wave 2 in two steps, without customizations.

Learn pages

• Business Central Upgrade Compatibility Matrix: Provides an overview of the Business Central versions and their compatibility
• Code Conversion from C/AL to AL: Description of the conversion process from C/AL to AL.
• General Information and Considerations When Upgrading to Business Central: This article provides tips and considerations to prepare a solution when you’re planning to upgrade to Business Central 2023 release wave 2 and later.
• India Data migration Toolkit Overview: Specifies India Data Migration Toolkit Overview
• Install a version 23 update: This article describes the tasks required for getting the monthly version 23 update applied to your Dynamics 365 Business Central on-premises.
• Migrating Tables and Fields Between Extensions: Explains how to migrate tables and fields from one extension to another.
• Moving Tables and Fields to Extensions Down the Dependency Graph: Explains how to move tables and fields from an extension to another extension that is down the dependency graph.
• Moving Tables and Fields to Extensions Up the Dependency Graph: Explains how to move tables and fields from an extension to another extension that is up the dependency graph
• Technical upgrade from version 14 to version 23: Describes how to do a technical upgrade from Business Central 14 to 23.
• Technical Upgrade From Version 19 to Version 23: Describes how to do a technical upgrade from Business Central V19 to V23
• Technical Upgrade to Version 23: Describes how to do a technical upgrade from Business Central V19, V20, V21, V22 to V23
• Upgrade to Business Central 2023 Wave 2: Provides an overview of Business Central 2023 Release Wave 2 upgrade.
• Upgrading Customized C/AL Application to Microsoft Base Application for version 23: Describes how to do an upgrade from a customized Business Central 14 to Microsoft Base Application for version 23.
• Upgrading Microsoft System and Base Application to Version 23: Describes how to upgrade an unmodified Business Central versions 15 through 22 to version 23
• Upgrading Permission Sets and Permissions: Describes how to upgrade permissions and permission sets
• Upgrading Reports: Describes how to upgrade reports
• Upgrading Unmodified C/AL Application to version 23: Describes how to upgrade an unmodified Business Central 14 application to version 23

Business Central pages and reports

The pages, reports and queries this hub’s Learn pages name (ms.search.form, API reference), joined to the code by exact object id (data/index/docs-objects.json); a page shows the table it runs on.

Learn also names 1 object with no object page: page/19010.

Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn’s own.