Installation step 2: Enable communication between Produce / Inspect and Business Central

  • Updated

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.

2024-05-1218_21_35-Home-MicrosoftAzure-nUc.png

2024-05-1218_27_07-Appregistrations-MicrosoftAzure-yd4.png

Fill in the form displayed:

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

2024-05-1218_44_21-Registeranapplication-MicrosoftAzure-Pys.png

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

2024-05-1218_48_00-TED-MicrosoftAzure-hDU.png

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

2024-05-1218_53_07-RequestAPIpermissions-MicrosoftAzure-_sA.png

Select Application permissions, tick the checkbox for

2024-05-1219_01_54-Chat_Demo_MSBC-ConnectionsettingsviaBoyumPortal_BoyumITSolutionsA_-_vg.png

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

2024-05-1219_27_24-TED-MicrosoftAzure-1WQ.png

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.

2024-05-1219_58_12-Chat_Demo_MSBC-ConnectionsettingsviaBoyumPortal_BoyumITSolutionsA_-Lsk.png

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.

2024-05-1220_07_19-TED-MicrosoftAzure-Zy4.png

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.

2024-05-1219_37_04-TED-MicrosoftAzure-Hjs.png

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:

1706095698409-LlM-Fkk.png

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

2024-01-24 12_29_28-New - Microsoft Entra Application Card-JU0.png

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.

1695303716484-SYw.png

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

1695304123928-etY.png

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.

2024-01-24 14_42_34-Microsoft Entra Applications-yns.png

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.

image2-B9Y.png

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.

1692704851948-j0Q.png

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.

1692705014502-OXs.png

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

1692774748885-bZw.png

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.

1692705264206-dEE.png

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:

1692705849516-0zQ.png

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

1692705970767-DYM.png

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:

1693477426914-jfQ.jpeg

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

1693477426961-1os.jpeg

You will be prompted for a confirmation.

1693477426989-LWw.jpeg

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

1693477427012-tKw.jpeg

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

1693477427033--8I.jpeg

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

Was this article helpful?

0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.