Installation step 2: Enable communication with Microsoft Dynamics 365 Business Central

Set up the Netronic Manufacturing application API in Microsoft Dynamics 365 Business Central

Netronic Manufacturing applications have a hidden, “system” user, i.e. an application that is used to communicate with the Business Central API. You or your Microsoft Partner need to set up this application in the Azure Portal. To do so, first select App registrations in the Azure Portal, then click New registration.

Fill in the form displayed:

• Enter an application name of your choice.
• Select the account type Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant).
• Set the Redirect URI to Web, and enter the address https://businesscentral.dynamics.com/OAuthLanding.htm .

When done, press Register at the bottom of the form.

Once done with the application registration, select API permissions in the menu bar on the left.

Click Add a permission, and request API permissions for Business Central.

Select Application permissions, tick the checkbox for API.ReadWrite.All, then press Add permissions.

A warning will indicate that you need administrator approval for the newly added permissions (which will be done in Business Central, as described later).

Next, create a client secret for your application. Select Certificates and secrets from the menu on the left, and press New client secret.

In the form displayed you may fill in the Description field with the name of your new application. Select the expiration period most convenient for you, then press Add.

Make sure to take note of the secret's expiration date, as there is no automatic warning about it.

Copy and save the secret's Value for later use, e.g. in a Notepad file.

Please note that it is your (or your partner's) responsibility to renew the secret, and make sure that it is stored in a secure place, so that it later can be entered into the Boyum Portal.

Now, select Overview in the menu on the left and copy the Application (client) ID of your new application in the Azure Portal.

You may also want to paste and save this ID in the Notepad file that you used for saving the client secret. Both will be needed in Installation step 3: Set up your license to Netronic Manufacturing in the Boyum Portal.

Next, you need to register this application (client) ID in Business Central, more precisely, in Microsoft Entra, in order to enable it to send requests to the API.

To add your application, search for "Microsoft Entra Applications" in Business Central, then click the New button on the screen displayed:

This will open a card to be filled in for the new application as shown below:

Here you will need to enter the application (client) ID that you have copied previously from the Azure Portal, and set the State dropdown to Enabled. Next, scroll down in the card to User permission sets, and click New line.

Select D365 BUS PREMIUM from the dropdown displayed in the new field.

The permissions need to be granted by a superuser or administrator. They will need to click on the Grant Consent button (shown in a red frame in the screenshot of the Microsoft Entra Application Card above) to do so.

In the example below, the application is installed with the name Boyum IT BC API Staging.

To confirm that the registration has been completed, you should open the App registrations page on the Azure Portal. The API permission for Business Central should have the status Granted, as in the screenshot below.

Install Netronic Manufacturing Connector(s)

To integrate Netronic Manufacturing with Business Central, the standard Business Central API needs to be extended with custom APIs for each Netronic Manufacturing application. To achieve this, you need to install .app files in your Microsoft Business Central environment. Boyum IT calls the extensions (.app files) that are needed to connect Netronic Manufacturing to MSBC connectors. Each Netronic Manufacturing application needs its own connector installed.

To download the latest version of the connector you need, search for "extension" in the Business Central search bar, then select Extension Marketplace from the list displayed.

Once on the Extension Marketplace page, enter "Boyum" in the search field. As a result, you will see the list of available connectors. The screenshot below shows the Inspect Connector in a red frame.

Clicking the Get it now button will display a legal message. Confirm it by hitting Get it now again.

Click Install in the appearing modal to complete the installation, but consider the modal's warning: installing an extension will disrupt others who are working in the same system.

To confirm that the installation has been completed, you may want to search for "extension" again in the Business Central search bar, but this time select Extension Management from the list of results:

Searching for "Boyum" in the Extension Management page should display your newly installed connector:

After installation, your session will refresh, and Netronic Manufacturing will be connected to the Business Central API.

You can also download and install Netronic Manufacturing connector(s) by searching for "Boyum" in Microsoft App Source.

Configure a Microsoft Entra application

After the Netronic Manufacturing connector has been installed, you must configure an Entra application to connect to it:

Click Next. In the Allow Application modal displayed, insert the Client ID of the Netronic Manufacturing Entra application:

You will be prompted for a confirmation.

When you click Yes, then the name is filled out:

Click Next, and then Finish in the appearing modal to complete the process.

With this step done, you can continue with synchronizing your Netronic Manufacturing database with that in Business Central.

Next installation step:

Set up your license to Netronic Manufacturing in the Boyum Portal