Installation and Registration
This article describes the prerequisites and installation and registration steps for Bonuses & Accruals or Bonuses & Accruals Extension PL in Business Central online and on-premises.
Important
Polish Localization and Bonuses & Accruals applications must be installed before Bonuses & Accruals Extension PL.
Installing the Application for Business Central Online
To install the application (even if it is only the free trial version), first you must perform the buying process on application offer page on Microsoft AppSource. To purchase the application, follow the steps that have been described in the Buy from AppSource.
To install the Bonuses & Accruals or Bonuses & Accruals Extension PL applications for Business Central online perform the following steps:
On the Microsoft AppSource Apps set a filter to find Bonuses & Accruals or Bonuses & Accruals Extension PL.
Place the cursor on the application name and select the application.
In the App Overview window that is displayed, choose the Install App action to run the installation process. The installation process may take a while.
To check if the application has been installed successfully, go to the Extension Management/Installed Extensions page where you can view the list of all installed applications.
Installing the Application for Business Central On-Premises
To install applications for Business Central on-premises perform the following steps:
- Download the installation files from the IT.integro Product Portal.
Important
The IT.integro Product Portal can be accessed only by authorized IT.integro partners.
Caution
When installing the application, you have to be assisted by an authorized IT.integro partner.
Run Dynamics NAV Administration Shell as an administrator.
To publish the application run the command:
Publish-NAVApp -ServerInstance YourDynamicsNAVServer -Path ".\\IntegroBonusApp.app"
- To synchronize the application run the command:
Sync-NAVApp -ServerInstance YourDynamicsNAVServer -Name "App Name" -Version VersionNo. -Tenant [Tenant1, Tenant 2, default]
Tip
The Tenant parameter can be skipped for a single-tenant instance or set as default. For multi-tenant instances, each tenant to be synchronized has to be listed.
- To install the application run the command:
Install-NAVApp -ServerInstance YourDynamicsNAVServer -Name "App Name" -Tenant [Tenant1, Tenant2, default]
Tip
It is recommended to install the latest application version available.
Installing the Preview Version for Microsoft Dynamics 365 Business Central Online
This section describes how to install the preview version of the Bonuses & Accruals for Microsoft Dynamics 365 Business Central online. The preview version provides new features that are not yet available in the officially released version and is only possible to install as a trial version (Sandbox) in an online environment.
To install the preview version of Bonuses & Accruals for Microsoft Dynamics 365 Business Central online:
- Create a special installation link containing a unique key. The link consists of the following elements:
https://businesscentral.dynamics.com/[TenantID]/?noSignUpCheck=1&filter='ID' IS '[AppID]' AND 'PreviewKey' IS '[PreviewKey]'&page=2503
where- TenantID - The ID of the tenant on which the preview version of the application is to be installed.
- AppId - application ID, i.e. application ID Bonuses & Accruals.
- PreviewKey - A unique identifier for the preview. Usually, it is one key for a given functionality. The unique key will be available on the functionality documentation page, which will be made available as a preview version.
Sample link:
- By selecting the prepared installation link in the browser, you will open a page with sandbox environments available for the selected tenant. Select the specific instance on which the preview app should be installed.
- Read the preview installation message carefully, and then select the Install.
On AppSource, multiple preview versions can be maintained at the same time. However, this means that a specific version (along with specific functionality) can be installed on one "sandbox". Because that subsequent versions that are released receive a specific version number, the last part of the version number means the build number and is automatically incremented. It will not always be possible to overwrite an existing application with a different preview version. In the event of a version conflict or simultaneous testing of different functionalities, a new instance of the sandbox environment should be created.
See Also
Technical Support - Contact IT.integro or your Business Central partner