Configuring the Help Experience for Dynamics 365 Business Central

The default version of Business Central comes with conceptual overviews and other articles that publish to the https://docs.microsoft.com/dynamics365/business-central/ site. This location is then accessible from the Help menu and through the Learn More links in all tooltips. Each extension that you add will include its own tooltips and links to Help. But what if you want to deploy Business Central locally? Or if you have a vertical solution so that you want to refer your customers to your own website for Help? Or if you have a legacy Help collection based on the Dynamics NAV Help Server?

These and other scenarios are also supported in Business Central. But the options and possibilities are different, depending on your deployment scenario.

Apps for online tenants

When you build an app for Business Central using the AL developer experience, you are expected to comply with the Business Central user assistance model. This includes tooltips and context-sensitive links to Help.

For more information, see User Assistance Model and Configure Context-Sensitive Help.

On-premises deployments

For deploying Business Central on-premises, you must choose between using the legacy Dynamics NAV Help Server or an online website. Help Server is a simple website that requires your Help to be in a specific format (HTML files), and the online website can host any content that you want to make available. Your choice depends on the concrete needs of your solution and your users.

Important

You can configure each client to use either an online library or Help Server. If you add configuration for an online library, you must remove the settings for Help Server.

Online library

If you want to use a website that is not based on Help Server, then you must specify the URL in the settings for the Web client. The website does not have to be publicly accessible, but it must be accessible to all users of the solution that it support.

For the Web client, which is accessed by users from a browser or from the mobile apps, the navsettings.json file must contain the following setting:

    "//BaseHelpUrl":  "The location of Help for this application.",
    "BaseHelpUrl": "https://mysite.com/{0}/documentation/",

Note

Replace the value of the BaseHelpUrl key with the URL for your own website. The parameter, {0}, represents the locale of the browser that the user is using, such as en-us or da-dk, and is set automatically at runtime.

Help Server

If you want to use Help Server, then you must specify the server and port in the installation options. The Help Server website can also serve as a starting point for adding a library to your existing website, for example.

For the Web client, which is accessed by users from a browser or from the mobile apps, the navsettings.json file must contain the following settings:

    "//HelpServer": "Name of the Dynamics NAV Help Server to connect to.",
    "HelpServer": "https://myserver.com",
    "//HelpServerPort":  "The listening TCP port for the Dynamics NAV Help Server. Valid range: 1-65535",
    "HelpServerPort": "49000",

In the example, https://myserver.com represents the URL to the Help Server instance. For more information, see Configuring Microsoft Dynamics NAV Help Server in the developer and ITpro content for Dynamics NAV.

Important

If you use Help Server, the UI-to-Help mapping functionality that is described in Configure Context-Sensitive Help does not work. Neither does the original Help lookup mechanism that was based on filenames that reflected the object IDs, such as N_123.htm for the page object with the ID 123. For more information, see Blog post: Reusing classic object-based Help on your Dynamics 365 Business Central Help Server.

Tip

If you are upgrading from Microsoft Dynamics NAV 2017, you can reuse your existing Help Server content by simply replacing the product name and make any other changes that apply to your Business Central environment.

You can also still download the files that were made available for Microsoft Dynamics NAV 2017. The download consists of 45 CAB files with the content from the Dynamics NAVĀ 2016 DVD rebranded to Microsoft Dynamics NAV 2017. There are CAB files with the W1 application Help translated into each of the supported languages plus the local functionality for the country/region where that language is spoken. There are also CAB files with local functionality in English. The files were published as a single download so each administrator could choose exactly the files that they needed at the time. For more information, see Microsoft Dynamics NAV 2017 Classic Help Download.

Fork the Microsoft repos, and customize or extend the content

If you want to customize or extend the Microsoft Help, you can fork our public repo for either the source repo in English (US) at https://github.com/MicrosoftDocs/dynamics365smb-docs, or one of the related repos with translations into the supported languages. For guidance about how to generate HTML files for your website, see Building HTML files. For more information, see Extend, Customize, and Collaborate on the Help.

See Also

User Assistance Model
Adding Help Links from Pages, Reports, and XMLports
Working with Dynamics NAV Help Server
Configuring Microsoft Dynamics NAV Help Server
Migrate Legacy Help to the Business Central Format
Building Your First Sample Extension With Extension Objects, Install Code, and Upgrade Code
Building an Advanced Sample Extension
Development of a Localization Solution
System Requirements
Resources for Help and Support
Blog post: Extending and customizing the Help
Blog post: Collaborate on content for Business Central
Blog post: Reusing classic object-based Help on your Dynamics 365 Business Central Help Server
Docs Contributor Guide
Docs Authoring Pack for Visual Studio Code