Installing the extension

How you install the Business Central connector depends on where BC runs:

• On-premises: an .app file you install on the BC server with PowerShell.
• Cloud: published on AppSource, installable in a few clicks.

Jump to your scenario below.

On-premises (PowerShell)

You have two routes: our installation script (the easy path) or plain PowerShell commands. Run everything in the Business Central Administration Shell.

Option 1: the installation script (recommended)

We maintain an installation script, DimeScheduler.InstallBCExtension.ps1, on the PowerShell Gallery.

Install it:

Install-Script -Name DimeScheduler.InstallBCExtension

Find where it landed:

(Get-InstalledScript -Name "DimeScheduler.InstallBCExtension").InstalledLocation

tip

Prepend cd to drop your terminal straight into that folder, and chain the install in one line:

cd (Get-InstalledScript -Name "DimeScheduler.InstallBCExtension").InstalledLocation; & .\DimeScheduler.InstallBCExtension.ps1 -serverInstance BC -version 24

Run it. The script takes these parameters:

Parameter	Description	Required
serverInstance	The BC instance's name	✅
version	The major version of the BC wave (e.g. 14, 22, 23, 24)	Either -version or -path
path	The full path of the Dime.Scheduler .app file	Either -version or -path
skipVerification	Switch -skipVerification to skip verification. Dev/testing only.	❌

Use -version to download and install the latest extension for that BC wave:

.\DimeScheduler.InstallBCExtension.ps1 -serverInstance BC -version 24

Use -path instead when you need a specific version or your own .app file:

.\DimeScheduler.InstallBCExtension.ps1 -serverInstance BC -path C:\dsfiles\Dime_Dime.Scheduler_2.3.0.3.app

Option 2: plain PowerShell

The script is just a wrapper around these commands. If you'd rather not use it, run them directly:

Publish-NAVApp -ServerInstance BC -Path ".\Dime_Dime.Scheduler_x.x.x.x.app"
Sync-NavApp -ServerInstance BC -Name "Dime.Scheduler"
Install-NAVApp -ServerInstance BC -Name "Dime.Scheduler"

Replace x.x.x.x with your chosen version. On a multi-tenant server instance, add a -Tenant parameter to the second and third commands. The third command is optional: you can also install the app from the client.

Within moments the Dime.Scheduler extension appears in the extension list:

Cloud (AppSource)

The connector is on AppSource.

Find it

Open the AppSource listing directly, or search AppSource for Dime.Scheduler:

Open the card, then click Get it now, tick the checkbox, and continue:

Install it

AppSource shows your available Business Central instances. Pick the right one:

Choose a language, and AppSource deploys the connector:

Track the deployment on the Extension Management page. It may take a minute:

Next

The extension is installed, but nothing is connected yet. Next, connect Business Central to Dime.Scheduler with the FastTrack Wizard.