About This Release
This release only includes event updates and hotfixes since version 22.3 and is an on-premises version only.
Released - September 21, 2023
This version is built on Microsoft Dynamics 365 Business Central 2023, release wave 1, cumulative update 5, 22.5.59966.60134.
Important Notices!
For information about breaking changes in previous releases, click here.
LS Central release plan changes
We are changing how we release new features in LS Central. Until now, we have included new features in our monthly releases. The monthly releases therefore included new events and hotfixes as well as new functionality.
Based on feedback from our partners and customers, we are scaling this back a little. We have decided to align our product development with the release timeline used by Microsoft for Business Central. This means that we will release new features for LS Central in two major release waves every year – scheduled for April and October, coinciding with the general availability of Business Central Release Wave 1 & 2. Our partners will be granted access to a feature-complete release candidate five to six weeks ahead of time.
We will continue to release new events and hotfixes on a weekly basis and cumulative updates on a monthly basis, but new features will be focused on the April and October updates.
We will have a release candidate ready five to six weeks before the major release from Microsoft. This means that the release candidate for version 23.0 will be made available by the end of August.
After the changes, the LS Central release plan looks like this:
- Version 22.3 released August 24.
- Version 22.4 released September 21, only includes new event updates and hotfixes and is an on-premises version only.
- Versions 23.0 is scheduled for the first week of October, depending on the availability of the 2023 Wave 2 update from Microsoft.
- After this, minor versions will be made available on a monthly basis, depending on the availability of the minor update from Microsoft.
We expect to follow the same process for the 2024 wave 1 version, with a release candidate scheduled to be made available late February 2024 and an official release coinciding with the release of Business Central 2024 wave 1 from Microsoft.
LS Central Universal Code Compliant
From version 22.0 LS Central is Universal Code compliant. This means that the property Target in the app.json files for the LS Central and LS Central System apps has been set to Cloud.
Customers who have the granule Implemented code is not cloud-optimized in their license can ask for this granule to be removed, once they have upgraded to LS Central 22.0 or higher, unless there are other extensions installed that are not Universal Code compliant.
Deprecation of Windows Authentication for Web Services
Windows authentication for web services has been deprecated. The Windows authentication was based on Business Central Windows authentication code. The Business Central Windows authentication code is marked as OnPrem and can therefore not be used by Universal Code compliant applications. This does not affect SaaS customers as the only authentication method supported in SaaS is Oauth authentication. On-premises customers must switch from Windows authentication to either Basic authentication (Web Service Access Key) or OAuth authentication for web services before upgrading to version 22.0 or higher.
See How to: Set Up Basic Authentication for Web Services in the LS Central Help for instructions.
Obsolete code marked with tag 20.0 and below removed
Our solution gets bigger with every release, but we intend to clean up by removing obsolete code in major releases as soon as the code has been marked obsolete for at least a year.
In release 22.0 we removed constructs like procedures and events, but there are no breaking schema changes yet, like Tables and Table fields.
Recommended action: Check if you are using a feature that has been marked obsolete for more than a year. The warning should state the reason and the alternative that is intended to be used.
OnPrem-only procedures are now obsolete
All procedures and objects that are marked #if _IS_SAAS_, previously marked [Scope('OnPrem')], have become internal, unless otherwise requested.
If your extension is using any of these, they will now get a warning.
Recommended action: If you have an OnPrem extension, check if there are any warnings. Usually, there are alternative procedures available, but partners can also request that a list of these is made public through the same flow as event requests.
Integration event triggers are now internal/local
In rare cases, it has been technically possible to trigger some of our events from an extension.
These cases are usually an oversight, since the internal/local keyword was missing for the IntegrationEvents so they became public, by default.
This has prevented us from adding new arguments to existing events, and therefore unnecessarily forcing new versions for events where a breaking change would not have been needed.
Recommended action: This should not require any work. There is a chance that somewhere an upgrade might fail, if it is calling an event function, for example in POS Transaction Event, which usually has no effect. Instead, the events are intended to be subscribed to, with an EventSubscriber.
Click here for a printable version of this notification.
New or Enhanced Features
Not applicable
Fixed Issues
Not applicable
Hotfixes
See the LS Central Help for information about hotfixes that have been released since the previous release.