Manage apps
A Business Central environment is built as a collection of apps. These apps include Microsoft apps and third-party apps, for example, apps from AppSource. The apps work together to provide customers with a broad set of features to address their various business, market, and industry needs.
Updates are frequently made available for these apps by Microsoft, partners, and ISVs. App updates add new features and fix known problems. To keep your environment up to date and running smoothly, you should check for and install the latest updates regularly.
To help you manage app updates, the administration center includes the Manage Apps page. Like other features in the administration center, this functionality can be used by the partner (delegated administrator) or a local customer administrator.
Currently there is a process right now of apps moving to the new FAME service. This means that apps need to support the new Manage Apps page, and that you no longer must uninstall and reinstall to get an updated version of your app.
This approach is a cleaner way to manage app updates and is the preferable way going forward. Each tenant can see their tenant installed apps in one window, and see when updates are available to each app.
The capability to update apps using the administration center is being made available gradually. Until the feature is generally available, some apps can't be updated using this feature. For information about the timeline, see Installing AppSource apps updates in the Business Central administration center.
Get an overview and check for updates
Open the Manage Apps page from the environment details page. Select Environments > select the environment > Manage Apps.
The Manage Apps page lists all the apps installed on the environment and indicates whether updates are available. When first opened, the system starts checking for updates. Wait for this operation to complete.
When completed, if an update is available for an app, there are two indications:
The Latest Available Version column contains the new version number of the app.
The Available Update Action column contains one of the following actions:
Action required - This action means that you have to do something before you install the update for the app. For example, you may have to first update another app or install a new app. Select the link and read the Requirements for App Updates pane to see what is required. For more information, see Resolving requirements for app updates.
Install update - This action means that the app is ready to install. Select the link to start the installation.
Install an app update - the flow
We recommend you always install and test an app update on a Sandbox environment first. You want to make sure the app update won't disrupt the operational flow or cause problems for the users.
The following steps provide the general flow for updating an app.
If you don't have a sandbox environment, create one.
Open the Sandbox environment and select Manage Apps.
On the Manage Apps, find the app in the list that you want to update.
If the Available Update Action column for the app shows the Action required link, resolve the update requirements.
When the Available Update Action column for the app shows Install update, select this action to install the new version of the app. The update will be applied immediately after you accept the confirmation dialogue. The users can continue working during update installation but depending on the app changes coming with the update, they may receive a message asking them to log out and login again. It's therefore recommended that you apply the updates outside of working hours.
Wait for the app to be installed. Select Refresh occasionally to check the status.
If the app installs successfully, the new version displays in the Installed version column and the Available Update Action column is Up to date.
If the installation fails, the Available Update Action column changes to Update failed. Refer to the section in this unit on what to do when an update fails if this occurs.
If the app update succeeded, sign in the Sandbox environment and test the new app version.
If the app update works as expected on the Sandbox, switch to the production environment, and repeat the installation steps for the app update.
Resolve requirements for app updates
For apps that have dependencies on other apps, you may have to update or install the dependency apps. The Requirements for App Updates page provide this information. The requirements are divided into two categories; Update requirements and Install requirements.
After you resolve all requirements, the app that you want to update will be ready to install.
Update requirements
The Update requirements category lists existing dependency apps the have updates to be installed.
To resolve these requirements, complete the following steps for each app:
Return to the Manage Apps page.
Find the app in the list and select Install update.
Wait for Available update action column to change to Up to date.
Install requirements:
The Install requirements category lists dependency apps that haven't been installed yet. For example, a new app was introduced that app update depends on. You can't, however, install a new app from the Manage Apps page. Use the Extension Management page in the client instead. Completing this step will resolve the requirement.
What happens when an app update is installed?
The new app version starts to install immediately, following the confirmation dialogue. The new app version will be published, synchronized, and updated in the background. This process usually doesn't take long, and users won't be interrupted. However, we still recommend you install the updates outside of working hours.
What do you do when an update fails?
When the installation of an app update fails, the Available Update Action column displays the Update failed action. Select this action to get more information. The App Update Details pane provides some details about update and what might have caused the failure.
Sometimes the update could fail because of a transient problem. Select Retry to try to install the update again. If the installation continues to fail, contact your ISV. You can find the support details of each ISV on their app page on AppSource. Contact Microsoft support if the app publisher is Microsoft.
When reporting issues to Microsoft Support, always provide the Operation ID displayed in the error message. This will help expedite the investigations.