Setup

Installing Therefore™ Connector for Business Central - Online scenario

The Therefore™ Connector for the hosted version of Business Central can be installed via the Microsoft AppSource.

  1. Enter "AppSource" into the search and select Microsoft AppSource apps.

  2. This will bring up a list of all available apps from Microsoft AppSource.

    It should find one results, named “Therefore Connector”.

  3. After clicking on that entry, it should be possible to install it:

    If the “Install App” button is missing, the app might already be installed.

  4. Confirm the installation by clicking on “Install”:

  5. To check the status of the app installation, you can go to the “Extension Management” or “Extension Installation Status” pages:

    The connector should show up in “Extension Management” when filtering for “Therefore”:

  6. If you are working on a Sandbox-Environment of Business Central, HTTP-Requests have to be enabled for the Therefore Connector to work.

    Click on the “Therefore Connector” entry in Extension Management and enable “Allow HttpClient Requests”:

    This step is not required on production environments

    The language of the connector will change depending on a user’s personal settings:

Updating Therefore™ Connector for Business Central - Online scenario

The following steps are required to update an existing Therefore™ Connector on a hosted version of Business Central.

  1. Open the Extension Management

  2. Search for the "Therefore™ Connector"

  3. Click on the three dots and choose "Uninstall"

    Ensure the option "Delete Extension Data" is not active. If the extension data is deleted all the settings and mappings will be lost.

  4. Click on "Uninstall" to uninstall the connector

  5. If prompted, log out and back in again.

  6. Proceed with the regular installation steps described above.

Installing Therefore™ Connector for Business Central - On-Premises scenario

The Therefore™ Connector for Business Central can be installed on an On-Premises scenario by using the following commands:

Publish-NavApp
Sync-NavApp
Install-NavApp.
You can either open Business Central Administration Shell or execute the command directly in PowerShell.

Here is an example of how the commands can be used:

Copy 
Publish-NavApp -ServerInstance YourInstance -Path "BC23.0 - Therefore Corporation GmbH_Therefore Connector_15.0.647.0.runtime.app"
Sync-NavApp -ServerInstance YourInstance -Name "Therefore Connector"
Install-NavApp -ServerInstance YourInstance -Name "Therefore Connector"

The "ServerInstance" and "Path" parameters will need to be adjusted to your specifications.

In order to ensure you have the latest version of our connector, suitable to your version of Business Central, please contact our Support:
https://support.therefore.net/support/login

If the installation was successful, you should see the “Therefore Connector” App in “Extension Management”: