Business Central 2024 release wave 1

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

Overview

This section collects the Learn pages for upgrading on-premises Business Central to version 24 (2024 release wave 1). It has no subtopics. The pages fall into groups: general upgrade information and the compatibility matrix, step-by-step upgrade paths, code and data migration topics, and platform changes.

The upgrade paths depend on your starting point. Unmodified Microsoft System and Base Applications on versions 15-23 follow one PowerShell-based path. An unmodified C/AL application on version 14 follows another. A customized version 14 C/AL application needs conversion with Txt2Al and table migration using migration.json and the destinationappsformigration setting. A separate page covers installing a version 24 update, including platform and application updates.

Start with the general information page and the compatibility matrix to confirm your path and minimum versions. Then follow the page that matches your application. Use the table and field migration pages (up or down the dependency graph), the permissions page, and the report upgrade page for the related changes.

Key points

• The compatibility matrix lists minimum update versions for upgrades between versions 15-28, on-premises and online. Upgrades from version 24 or earlier must target version 25 first. A separate matrix covers version 14.
• Unmodified System and Base Application upgrades from versions 15-23 use PowerShell tasks. These cover database conversion, license import, extension publishing and synchronization, and data upgrade through the task scheduler.
• Version 14 C/AL upgrades come in two forms. An unmodified application is replaced by the Microsoft System and Base Application extensions. A customized application is converted with Txt2Al and its tables are migrated with migration.json and the destinationappsformigration server setting.
• Installing a version 24 update involves a platform update and an application update. The application update includes database conversion, extension publishing and recompilation, and data synchronization.
• Table and field migration between extensions uses migration.json. Moving down the dependency graph is a direct transfer. Moving up needs a transition extension and a two-stage deployment.
• Permissions move from legacy data-based permissions to AL object-based permission sets, using Permission Set and Permission Set Extension objects.
• Report changes from version 20 include a new rendering model, obsoleted events, and custom layout upgrades that affect version 24 and later.
• Version 24 introduces the Business Foundation extension, which provides number series functionality, along with a refactoring of the System Application.

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 24 update: This article describes the tasks required for getting the monthly version 24 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
• Upgrade reports: Describes how to upgrade reports in Business Central.
• Upgrade to Business Central 2024 Wave 2: Provides an overview of Business Central 2024 Release Wave 2 upgrade.
• Upgrading Customized C/AL Application to Microsoft Base Application for version 24: Describes how to do an upgrade from a customized Business Central 14 to Microsoft Base Application for version 24.
• Upgrading Microsoft System and Base Application to Version 24: Describes how to upgrade an unmodified Business Central versions 14 through 23 to version 24
• Upgrading Permission Sets and Permissions: Describes how to upgrade permissions and permission sets
• Upgrading Unmodified C/AL Application to version 24: Describes how to upgrade an unmodified Business Central 14 application to version 24

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.