Table of Contents

Install the Mobile Data Collection app

The Mobile Data Collection (MDC) app requires multiple components to be installed in your environment:

  • Business Central application
  • Web server files

We're here to help you install MDC. Please contact us for more information!

Business Central application

You can purchase the MDC application from Microsoft AppSource. This is required in order to run the MDC web client.

Web server files

Before installing the web server files, refer to the System Requirements to make sure your system meets the minimum specifications.

Install the app

  1. Download the appropriate version of the MDC web server files.

  2. Create a new website on your IIS server and extract the files you downloaded.

    Important

    Do not start the website yet.

  3. Register your application in Microsoft Entra (formerly known as the Azure Active Directory). See here for more information.

    • When registering your application, add the URL and port for the website you deployed in the step above as a redirect URL.

    • Once the application has been registered, copy the ClientID from the Entra application.

  4. On the IIS server, open config.js in the new website folder you created and update the following:

    • MS_API: Replace %environmentName% with the name of the Business Central environment you are connecting to.

    • NIC_API: Replace %environmentName% with the name of the Business Central environment you are connecting to.

    • clientId: The value you copied from your registered Entra application.

    • authority: Replace <your Entra tenant id> with your Entra tenant id. See How to find your tenant ID for more information.

    • redirectUrl: The URL and port of where you installed the MDC website. This should match the value you entered in the Entra application.

  5. Install the URL Rewrite module.

    MDC relies on the IIS URL Rewrite module to process URL redirections and configurations within the web.config file. If this module is not installed, certain features may not work as expected.

    • Download and install the IIS URL Rewrite module from the Microsoft IIS website.

    • Verify that the module is enabled in IIS Manager.

  6. Once all of the steps have been completed, start your website.