App Monitor - setup
App Update Monitor automatically keeps an eye on whether new versions have been released of the apps you have installed in your Business Central environments.
The system can run both manually and automatically via the job queue.
1. Purpose
App Update Monitor automatically monitors whether new versions have been released of the apps you have installed in your Business Central environments.
The app can run manually from the setup page or automatically via the job queue.
A prerequisite for using the system is that a valid app registration has been created in the Entra Admin Center, see the section App registration
Setup
Open the App Monitor Setup page and fill in the following fields:
Active: Switch the monitoring on or off. It must be active for the check to run.
Include Microsoft apps: Select if you also want to check for updates to Microsoft's own apps.
Email recipients: Enter one or more email addresses that are to receive notifications. Separate several addresses with a semicolon (;).
Last run: Filled in automatically after a completed check and shows the time of the last run.
Environment (optional): Enter the environment name if you want to check an environment other than the current one. Leave the field empty to use the current environment.
Tenant ID: The Tenant ID from your app registration in the Entra Admin Center.
Client ID: The Application (Client) ID from your app registration.
Client secret: The secret key from your app registration.
Manual check
From the setup page you can click Run check now to start a manual check.
The system then contacts the Admin Center and compares your installed apps with the latest available versions.
The result is shown directly in Business Central, and an email notification may be sent if new versions are available.
Automatic check via the job queue
To automate the check you can create a job queue entry:
-
Go to Job Queue Entries in Business Central.
-
Create a new entry with Codeunit = App Update Monitor (or the relevant codeunit).
-
Enter a suitable interval – for example every night.
-
Activate the job queue.
The system will then perform the check automatically at the selected interval and send notifications about updates.
Notifications
When the system finds new app versions, an email is sent to the specified recipient with information about:
-
Which app has a new version
-
The installed version
-
The latest available version
App registration
-
Select the menu item "App registrations" in the left-hand menu – click "New registration"
-
Give it a "Name", e.g. "BC App Monitor" – leave the other defaults as they are
-
Select "Register" – the registration has now been created.
-
Select API Permissions in the left-hand menu – click "Add a permission"
-
Click Dynamics 365 Business Central and then "Application permissions"
-
Tick AdminCenter.ReadWrite.All – click "Add permission"
-
From the permissions overview click "Grant admin consent for XXXX"
-
Select Certificates & Secrets in the left-hand menu – click "New client secret"
-
Enter a Description, e.g. Secret + <today's date> – set Expires to e.g. 24 months – click Add.
-
IMPORTANT: Copy the "Value" (once the window is closed it can no longer be copied).
-
Click Overview and copy "Directory (tenant) ID" and "Application (client) ID"
-
Paste the 2 IDs from step 12 and the secret from step 11 into the respective fields in BC
