Skip to main content

Few things that can save you a lot of hassle in Per Tenant Extension Code Upgrade in Microsoft Dynamics 365 Business Central Wave 2 (version 15) Upgrade

Problem Statement:

With a change in Business Central Version from Version 14 to Version 15, I had noticed a few things got deprecated. Instead, these functions where deprecated and overloaded which why function definition remains the same but the parameters change.


In this blog, let us discuss the changes in Business Central BaseApp coding that can possibly break your extension and prevent you from upgrading. 

Also, I will be discussing the list data type introduced since the 2019 Wave 2 release.


Microsoft Dynamics Business Central Version 14
Microsoft Dynamics Business Central Version 15

Books & References:

List DataType


In this blog, let us take an emailing codeunit as a use-case.

1. Change in Variable Declaration:
Earlier in Emailing functionality, we made use of Text to store the Email. For multiple emails, we would append a  SEMICOLON ';' after each recipient.
Text Variable Declaration

Now, Text is replaced by List of Text and we don't need to add SEMICOLON ';' in between
List of Text  variable declaration
2. Change in Codes and functions:
 With respect to the SMTP Mail codeunit, the function is deprecated and overloaded with another function. Also, the deprecated function uses the newly created function
Change in functions

3. Fixing the code:

After the change of the standard codeunit, your functionality code also requires change so that even if the function in support right now but it can be deprecated pretty soon and that your upgrade process should be smooth.
Errors in Version 14 Extension Code
The fix for this is as below.
Old Email Appending Code replaced with ListVariable.Add() function
Change in function parameters

4. List DataType:
List Data Type is pretty straightforward in terms of usage.
You can refer

The illustrated examples can help you understand the functionality pretty easily.

Just to add, I have copied the syntax from
you can add and retrieve data using Get() and Set() methods.

Also, could this mean that Lists are replacing arrays in the near future??
Let me know your comments.

5. TempBlob is marked for removal:
A simple solution is to replace TempBlob record with TempBlob codeunit.
Basically, all the functions inside TempBlob tables will be copied in TempBlob Codeunit.

6. Deploying the app:
In order to deploy your app to version 15, you will need to change the app.json file and deploy as the next major version.

Refer Dmitry Katson's blog


In this blog, I have attempted to give a glimpse of what I had to change in order to prevent my package from breaking in Business Central version 15 Upgrade.
Also, if I find a few more changes that can break your code I will post it in continuation of this blog.

In the upcoming blogs, I'm planning to write about the new DataTypes that have been added to Microsoft Dynamics Business Central since 2019  Wave 2 Version 15.

Hope this helps :)


Popular posts from this blog

Creating APIs in Business Central - 1

While writing a blog on Automated Testing in Business Central, I was going through sample apps provided by Microsoft and realized that the complexity is nowhere close to what examples Microsoft has provided on In this blog, I will try to explain how APIs work and how to be creative with the implementation. Also, an API which were in beta are finally out with version V1.0 in the April 2019 release let's see some important key things from development aspects.
This blog is going to be theoretical one kindly bear with me.

Microsoft Dynamics Business Central (SaaS)VS Code( Language Extension( V1 from Business Central On-Premise DVD
Books & References:
API V1 from Business Central On-Premise DVDAPI(V1.0) for Business Central (Click Here)API(Beta) for Business Central (Click Here)

Key Requirements:
API source table must have an Id(GUID) field per record for m…

How Business Central Modern Client Reverse Compatibility With NAV Can Help You Improve Your Work.

Introduction: Today, I was playing around with Business Central Modern Client (Windows App).
Out of curiosity I was trying to login to one of my NAV 2017 through SSO.
Pre-requisites: Microsoft Dynamics NAV with SSO configured
Microsoft Dynamics Business Central
Demonstration: 1. Business Central App - Main Page:

Clicking on locally hosted service and putting in the credentials configured for NAV 2017 SSO, we get.
Still skeptical when Business Central login into NAV.

2. Business Central App - Reverse compatible with NAV 2017:

Well well well...
Look whose here.
NAV disguised as  Dynamics 365 for Financials.

I think we all agree that Business Central Modern Client is a WebApp version of Busines Central Online. Basically just like browser in an App.
The difference is that it can connect to NAV as it is just like a browser.

3. Does Business Central Modern Client follow DynamicsNAV protocol?:
Well, it simply does not.
It would be amazing  if it did, as it would mean that we could deal with runni…

Generic way of Attaching Documents on any Record of the Page in Microsoft Dynamics Business Central - Template Code

Problem Statement: In Microsoft Business Central, there is a way to attach attachments only on Documents or Master Table records. But, what if this requirement is for other tables such as Opportunities, custom tables, etc. Introduction: I have seen many developers afraid to touch the attachment-related customization as it seems complicated.
Well, I have found a solution and here it goes.
In this blog, I'm attempting to create a generic template for code that needs to have an attachment feature on any table that you like using AL Code.
This means that you simply cannot copy-paste the same code for all the tables but a simple change in variable sub-type will ease your work significantly
Pre-requisites:Microsoft Dynamics Business CentralVS CodeAl Language ExtensionSource Code: Demonstration:1. How it works:
Document Attachment is a table which stores a few things that help in tracking information related to the attachment

The main u…