Business Central 2022 release wave 1

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

Overview

This section collects the articles for upgrading on-premises Business Central to 2022 release wave 1 (version 20). The entry page, “Upgrade to Business Central 2022 Wave 1”, describes the upgrade paths: a technical upgrade, or application refactoring to the system application. The compatibility matrix shows the minimum update versions needed between major versions. For versions 15 to 19, use the technical upgrade pages, which cover database conversion, extension publishing and recompilation, tenant synchronization and data upgrade with PowerShell. For version 14, there are separate articles for unmodified C/AL applications, customized C/AL applications and the technical upgrade from version 14 to 20. They rely on the Txt2Al conversion tool, the DestinationAppsForMigration server setting and migration.json. Supporting pages cover changes that affect the upgrade: permission sets as AL objects, the report platform rendering model, moving tables and fields between extensions (up or down the dependency graph), and installing a version 20 cumulative update. An India data migration toolkit page is also included. Start with the entry page and the compatibility matrix, then pick the article for your source version.

Key points

• Entry page names two paths to version 20: technical upgrade, or application refactoring to the system application.
• Versions 15 to 19 upgrade to version 20 through database conversion, extension publishing and recompilation, tenant mounting and synchronization, and data upgrade, all scriptable with PowerShell.
• Version 14 upgrades differ for unmodified C/AL (replace the base application with Microsoft System and Base Application extensions) and customized C/AL (convert code with Txt2Al and migrate tables in two phases).
• Table migration between extensions uses migration.json; moving down the dependency graph is direct, while moving up needs a transition extension and a two-stage deployment.
• Permission sets move to an AL object-based model (Permission Set and Permission Set Extension objects), so customizations must be identified and recreated as AL objects.
• Report upgrade covers the new platform rendering model, event changes and handling of Word and custom report layouts for version 20 and later.
• The compatibility matrix lists minimum update versions for upgrading between versions 15 to 28, and upgrades from version 24 or earlier must target version 25 first.
• The India Data Migration Toolkit supports moving from Dynamics NAV 2016 India to Business Central 2021 release wave 2 in two steps. It covers localization data but not 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.
• India Data migration Toolkit Overview: Specifies India Data Migration Toolkit Overview
• Install a version 20 update: This article describes the tasks required for getting the monthly version 20 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 20: Describes how to do a technical upgrade from Business Central 14 to 20
• Technical Upgrade to Version 20: Describes how to do a technical upgrade from Business Central 17, V18, and V19 to V20
• Upgrade to Business Central 2022 Wave 1: Provides an overview of Business Central 2022 release wave 1 upgrade
• Upgrading customized C/AL application to Microsoft Base Application for version 20: Describes how to do an upgrade from a customized Business Central 14 to Microsoft Base Application for version 20.
• 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 20: Describes how to upgrade an unmodified Business Central 14 application to version 20
• Upgrading Version 15, 16, 17, or 18 Base Application to Version 20: Describes how to upgrade an unmodified Business Central 17, 18, or 19 to version 20

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.