Documentation Index

Fetch the complete documentation index at: https://docs.staedean.com/llms.txt

Use this file to discover all available pages before exploring further.

Update Business Integration Solutions

  • Updated on Jun 25, 2026
  • Published on Jun 25, 2026
  • 1 minute(s) read
Prev Next

Upgrade apps

Notes

Business Integration Solutions for on-premises comes with libraries. Although these rarely change, when updating to a new major Microsoft Dynamics 365 Business Central version, replace them with new ones. This affects the upgrade process. See Update libraries.

Part of an upgrade is uninstalling the app versions already installed. Run the upgrade using the general PowerShell scripts provided.

Notes

Older versions of Business Integration Solutions (BC version 18 or older) also have dependency apps not visible on the Extension Management page (so-called Exclude apps) in Microsoft Dynamics 365 Business Central. STAEDEAN recommends uninstalling the apps using a script.

Notes

Scripts are not supported.

To display all apps, use this command to check the apps and version numbers.

For a clear overview of STAEDEAN apps:

Get-NAVAppInfo -ServerInstance

D365 BC -Publisher "STAEDEAN"

Steps - Upgrade app

  1. Uninstall the app(s):

    Uninstall-NAVApp -ServerInstance

    D365 BC -Name "[AppName]" -Version "[Previous version]"

  2. Publish the new app (file)*:

    Publish-NavApp -ServerInstance

    D365 BC -Path "[AppPath]"

  3. Synchronize the app:

    Sync-NAVApp -ServerInstance

    D365 BC -Name "[AppName]" -Version "[New version]"

  4. Run the data upgrade:

    Start-NAVAppDataUpgrade -ServerInstance

    D365 BC -Name "[AppName]" -Version "[New version]"

  5. Unpublish the old app:

    Unpublish-NAVApp -ServerInstance

    D365 BC -Name "[AppName]" -Version "[Previous version]"

Update libraries

Steps - Update libraries

Before publishing apps with libraries, complete the following steps:

  1. Uninstall the old libraries.

  2. Install the new libraries.

  3. Restart the Microsoft Dynamics 365 Business Central Service.

    When several instances of the Microsoft Dynamics 365 Business Central service are running, ensure all of them are down at one point, or the old libraries remain loaded in memory.

When the new version installs before the libraries/add-ins deploy, unpublish the app.