Select Page

Deploying a Per Tenant Customizations

There are 4 ways how we can extend Microsoft Dynamics 365 Business Central.

  1. Connect Apps  (A Connect app can be used in the scenario where there must be established a point-to-point connection between Dynamics 365 Business Central and a 3rd party solution or service.)
  2. Add-On Apps  (An Add-on app extends the experience and the existing functionality of Dynamics 365 Business Central. Add-on apps can be used in multiple scenarios, whether it is to integrate to online services, making custom web services, adding business functionality, or extending the user interface.)
  3. Embed Apps  (An Embed app defines a customer scenario. Specifically, the scenario of a customer wishing to acquire an end-to-end solution meeting the specific needs of an industry vertical or a micro-vertical.)
  4. Per Tenant Customizations

First three types of apps are available through Microsoft AppSource. Today we will see how we can deploy a per tenant customization to customer’s production tenant.

When you have finished developing and testing your tenant customization, you must deploy the extension (.app file) containing the customization to your customer’s production tenant. You must be able to log into the customer’s tenant as a user with permissions to the Extension Management page to complete the deployment.

Use the Upload Extension action to deploy the extension. The extension can be deployed for the current version or for the next version of the service. In most cases it is sufficient to select the current version, unless you have developed the extension specifically for the next version.


When you deploy an .app file for the next version, the extension will be queued up to be deployed as part of the customer’s tenant being upgraded to the next version. You can typically use this in a situation where you have built an upgrade of the extension to work with the next version.

The extension you are deploying could be the initial release of the customization or an upgrade to a previous version. You must use the same steps for uploading a new extension or an extension upgrade. The service will determine if the extension needs to be upgraded based on the extension’s app ID and version.


If you are developing an extension as an update to a previously deployed extension, you must keep the app ID the same and increase the version to successfully upgrade the extension to the new version.

Steps for deploying your .app file

Log into your customer’s Dynamics 365 Business Central tenant.

Enter this URL : in web browser. It will ask for username to Sign in.


Press Next for the password.

After the successful login you see the Home page of Microsoft dynamics 365 Business Central.

Open the Extension Management page.

Press the search button from Right-Top corner of the Home page and type Entension Management in search                 box. Select the first option available from the results. 

Choose the Upload Extension action.

It will open Upload and Deploy Extension page.

Select the browse button to select the .app file to upload. Browse to and select the extension’s .app file.

Select if you want to deploy for the current version (most common) or Next minor version or Next major version. Select the language for the deployment.

Choose the Deploy button. You will see the below information message. Press OK to continue.

The extension will be deployed in the background.

To check the status of the deployment, choose Deployment Status and then view the status of the extension deployment. Select the row to see additional details.

In the deployment status details there is a Refresh button in the actions you must press to retrieve the most               recent status and details.

It will show status as “InProgress”.

Once it is completed status will change to “Completed”. If the deployment is fail then it will show the status as “Failed”. As of now there are no any options available to check detailed error log why the deployment is failed.

When the extension has been successfully deployed, choose the Refresh button to see the new extension in the list of installed extensions.

Click on the installed extension to see the details.

To remove the extension from the customer’s production tenant first Uninstall it and then Unpublish it. Right click on extension which you want to remove.

Select Uninstall to open Extension Uninstallation window. Press Uninstall button from the window. It will show information message about Uninstallation.

And you can see status of extension as Uninstalled in the list.

After the uninstall we need to unpublish the extension to remove.

Once it is removed successfully you can’t see in Extensions list page.

Main source of information:

Stay tuned here for more information on Microsoft Dynamics 365 Business Central…

JSON Files in an AL project

In an AL project there are two JSON files; the app.json file and the launch.json file. These files are generated automatically when you start a new project. The app.json file contains information about extension that you are building, such as publisher information and specifies the minimum version of base application objects that the extension is built on. Often the app.json file is referred to as the manifest. The launch.json file contains information about the server that the extension launches on.

App.json file

The following table describes the settings in the app.json file:

Setting Mandatory Value
id Yes The unique ID of the extension. When app.json file is automatically created, the ID is set to a new GUID value.
name Yes The unique extension name.
publisher Yes The name of your publisher, for example: NAV Partner, LLC
brief No, but required for AppSource submission Short description of the extension.
description No, but required for AppSource submission Longer description of the extension.
version Yes The version of the app package.
privacyStatement No, but required for AppSource submission URL to the privacy statement for the extension.
EULA No, but required for AppSource submission URL to the license terms for the extension.
help No, but required for AppSource submission URL to the help for the extension.
url No URL of the extension package.
logo No, but required for AppSource submission URL to the logo for the extension package.
dependencies No List of dependencies for the extension package. For example: “dependencies”: [ { “appId”: “4805fd15-75a5-46a2-952f-39c1c4eab821”, “name”: “WeatherLibrary”, “publisher”: “Microsoft”, “version”: “”}],
screenshots No Relative paths to any screenshots that should be in the extension package.
platform Yes, if system tables are referenced in the extension The minimum supported version of the platform symbol package file, for example: “”. See the Symbols for the list of object symbols contained in the platform symbol package file.
application Yes, if base application objects are extended or referenced. The AL package will be compiled against the application that is present on the server that you connect to. This allows you to write a single AL Language extension for multiple country versions as long as you do not depend on country-specific code. If you do depend on country-specific code you should only try to compile your app against a server set up for that country. The minimum supported version, for example: “application”: “”
idRange Yes A range for application object IDs. For all objects outside the range, a compilation error will be raised. When you create new objects, an ID is automatically suggested.
showMyCode No This is by default set to false and not visible in the manifest. To enable viewing the source code when debugging into an extension, add the following setting: “showMyCode”: true
target No By default this is Extension. For Dynamics NAV, you can set this to Internal to get access to otherwise restricted APIs. The Dynamics NAV Server setting must then also be set to Internal.

Launch.json file

The following table describes the settings in the launch.json file. The launch.json file has two configurations depending on whether the extension is published to a local server or to the cloud.

Publish to local server settings

Setting Mandatory Value
name Yes “Publish to your own server”
type Yes Must be set to “.al”. Required by Visual Studio Code.
request Yes Request type of the configuration. Must be set to “launch”. Required by Visual Studio Code.
server Yes The HTTP URL of your server, for example: “http://localhost|serverInstance”
serverInstance Yes The instance name of your server, for example: “US”
authentication Yes Specifies the server authentication method.
startupObjectType No Specifies whether the object to open after publishing is a Page type (“Page”) or Table type (“Table”) object. The default is “Page”.
startupObjectId No Specifies the ID of the object to open after publishing. Only objects of type Page and Table are currently supported.
schemaUpdateMode No Specifies the data synchronization mode when you publish an extension to the development server, for example:
“schemaUpdateMode”: “Synchronize Recreate”
The default value is Synchronize. For more information, see Retaining table data after publishing
This feature is not supported in Dynamics NAV.
breakOnError No Specifies whether to break on errors when debugging. The default value is true.
breakOnRecordWrite No Specifies if the debugger breaks on record changes. The default value is false.

Publish to cloud settings

Setting Mandatory Value
name Yes “Publish to Microsoft cloud sandbox”
type Yes Must be set to “.al”. Required by Visual Studio Code.
request Yes Request type of the configuration. Must be set to “launch”. Required by Visual Studio Code.
startupObjectType No Specifies whether the object to open after publishing is a Page type (“Page”) or Table type (“Table”) object. The default is “Page”.
startupObjectId No Specifies the ID of the object to open after publishing. Only objects of type Page and Table are currently supported.
tenant No Specifies the tenant to which the package is deployed. If you specify multiple configurations, a drop-down of options will be available when you deploy.

The platform symbol file

The platform symbol file contains all of the base app objects that your extension builds on. If the AL Language extension in Visual Studio Code detects that the referenced symbols are not present on local disk, you will get a visual prompt in Visual Studio Code to download the symbols from one of the servers specified in the launch.json file. For more information about the platform symbol file, see Symbols.

Source of Information :

Overview of Dynamics 365 Business Central October ’18 release

With the October ’18 release, Dynamics 365 Business Central is available in the cloud, on-premises, and in hybrid deployments. Pick your flavor of Business Central, or use your existing on-premises solution of Dynamics GP, Dynamics NAV, or Dynamics SL and connect to the cloud through Business Central.

Business Central partners get a portal to facilitate their interactions with customers and to manage the lifecycle of their applications and customizations. Business users get a further streamlined and refreshed user experience with many productivity improvements, facilitating heavy transactional users. The service is also going through a hardening process, with much improved resiliency, robustness, and performance across the application.

Download the October ’18 Release Notes PDF

Summary of what’s new in Dynamics 365 Business Central

This topic lists the features planned for release in Microsoft Dynamics 365 Business Central between October 2018 and March 2019.

Feature Release type Target release month
Productivity features for desktop users General Availability October 2018
Accessibility features for desktop users General Availability October 2018
Refreshed experience on major desktop screens General Availability October 2018
Business Central everywhere General Availability October 2018
Combined mobile/companion app for Business Central General Availability October 2018
Enhanced Power BI embed experience General Availability October 2018
Permission sets are editable General Availability October 2018
Tenant administration for VARs General Availability October 2018
Improved Visual Studio Code AL experience General Availability October 2018
Localization apps and translation apps General Availability October 2018
Intelligent edge for Dynamics GP, Dynamics SL, and Dynamics NAV General Availability October 2018
Additional productivity features for desktop users Unscheduled
Refreshed experience on additional desktop screens Unscheduled

Business Central everywhere – cloud, hybrid, and on-premises availability

Business Central gets an on-premises deployment option that serves as a successor to Dynamics NAV. In other words, rather than a new version number for Dynamics NAV, customers can get Business Central on-premises. The experience for partners and customers on-premises is no different from the familiar Dynamics NAV upgrades, except for the change in name. This is a convergence point for Dynamics SMB products—going forward, they are all considered customers of Business Central, in the cloud or on-premises, even if they are running differently branded products such as Dynamics SL, Dynamics GP, and older versions of Dynamics NAV.

High productivity user experience

Get more work done with productivity features such as filtering of lists and totals, and copy and paste. With a host of new keyboard shortcuts to accelerate your business tasks, and improved keyboard navigation throughout, Business Central is ready to support the diverse needs of your workforce. Get to your data faster with improved search for pages, reports, and Help documentation.

Business users get a fresh and modern experience in all main screens of Business Central. Whether you are accessing your data from the browser or the Windows 10 desktop app, you will experience a consistently smooth, intuitive, and modern interface as you transition across role centers, lists, worksheets, transaction documents, or details pages (such as the customer card).

Enhanced Power BI embed experience

Permission sets are editable

Intelligent edge for Dynamics GP, Dynamics SL, and Dynamics NAV

Tenant administration

Business Central partners manage the lifecycle of the tenant through the Dynamics 365 Business Central administration center. The administration center is the portal for VARs to engage with customers and manage health, troubleshooting, notifications, and sandboxes of the customer tenant.

Improved Visual Studio Code AL experience

Be more productive when developing and troubleshooting extensions with new and improved developer tools, such as sandbox environments with production data, improved breakpoint support, better inline Help, ability to trace raised events in a given user scenario, support for .NET Interop for on-premises deployments, extension support for enums, report data set and field groups, and more.

Making Business Central available in new markets

Business Central has a combined localization strategy inclusive of both Microsoft-led and partner-led models. We continue to respond to partner-led scenarios and anticipate additional countries being delivered via localization app extensions in Microsoft AppSource. Additionally, Microsoft will also deliver a localized version of Business Central in Iceland, Norway, and Mexico in this release.

Dynamics 365 Business Central is now available in Australia and New Zealand

On July 1, 2018 Microsoft announce the availability of Dynamics 365 Business Central in Australia and New Zealand. But the W1 version of Dynamics 365 Business Central is not available yet.

Now, Dynamics 365 Business Central is available in 16 markets:

  • Europe:
    • Austria
    • Belgium
    • Denmark
    • Germany
    • Finland
    • France
    • Italy
    • Netherlands
    • Spain
    • Sweden
    • Switzerland
    • United Kingdom
  • North America:
    • Canada
    • United States
  • Oceania:
    • Australia
    • New Zealand

Business Central brings the full power of Dynamics NAV to the cloud, as a modern solutions for modern businesses. Business Central has at its foundation a set of trusted, proven technologies in a single, end-to-end application

You can start a free trial for Business Central from our homepage. We look forward to hearing your questions and thoughts on the community forum, and to your product suggestions and requests on the ideas site.

As announced earlier, the next major functionality update for Business Central across all markets will be part of the October 2018 release wave—keep an eye out on this blog for future announcements.

Microsoft Dynamics 365 Business Central is now live!

As promised, Microsoft released Microsoft Dynamics 365 Business Central yesterday.

Official announcement from Microsoft :

A modern solution for modern businesses

With 160,000+ customers, more than 2.7 million users, and 3500 partners worldwide, Dynamics NAV has sold in 195 countries – that’s pretty much every country in the world. Microsoft announce that they are furthering this success story with Dynamics 365 Business Central by making it generally available as a cloud service starting today.

Dynamics 365 Business Central brings the full power of Dynamics NAV to the cloud. As such, Business Central has at its foundation a set of trusted, proven technologies in a single, end-to-end application. As such, Business Central offers:

  • Business without silos. Unify your business, and boost efficiency with automated tasks and workflows—all integrated within familiar Office tools like Outlook, Word, and Excel.
  • Actionable insights. Achieve greater outcomes and gain a complete view of your business with connected data, business analytics, and guidance delivered by Microsoft’s leading intelligent technologies.
  • Solutions built to evolve. Start quickly, grow at your own pace and adapt in real time with a flexible platform that makes it easy to extend Business Central based on your changing business needs.

Free Trial available here:

For an intro to Dynamics 365 Business Central, view the announcement made by Alysa Taylor here:

Announcing Dynamics 365 Business Central

If you would like to go deeper, enjoy this video:

Dynamics 365 Business Central Deep Dive

For more information on coming updates, please keep an eye on the roadmap site.

Stay tuned from more information here…