Zum Hauptinhalt springen

Installation

Die Erweiterungen von SPOTS-BSS GmbH installieren Sie in Business Central Online über den Microsoft Marketplace (AppSource), in Business Central On-Premises über die App-Dateien von der Seite Releases. Alle Erweiterungen setzen den SPOTS License Manager voraus.

Business Central Online (AppSource)​

Für die Installation brauchen Sie in Business Central Berechtigungen zum Verwalten von Erweiterungen.

Aus Business Central​

  1. Öffnen Sie über die Suche die Seite Erweiterungsverwaltung.
  2. Suchen Sie dort im Marketplace nach der Erweiterung, z. B. „ScanSPOT“. Anbieter ist SPOTS-BSS GmbH.
  3. Wählen Sie Jetzt herunterladen und bestätigen Sie die Installation.

Über den Microsoft Marketplace​

  1. Öffnen Sie den Microsoft Marketplace und suchen Sie nach der Erweiterung, z. B. „ScanSPOT“. Anbieter ist SPOTS-BSS GmbH.
  2. Wählen Sie Jetzt herunterladen und melden Sie sich mit Ihrem Business-Central-Konto an.
  3. Wählen Sie die Umgebung, in der die Erweiterung installiert werden soll, und bestätigen Sie die Installation.

License Manager und Updates​

Business Central installiert den SPOTS License Manager automatisch mit. Den Stand der Installation sehen Sie in der Erweiterungsverwaltung. Updates spielt Microsoft mit den Updates der Umgebung ein. Im Business Central Admin Center können Sie verfügbare Updates auch vorziehen.

Business Central On-Premises​

App-Dateien herunterladen​

Auf der Seite Releases stehen alle Versionen der Erweiterungen zum Download. Je Version gibt es eine ZIP-Datei pro Business-Central-Version, z. B. ScanSPOT-29.0.1.0-BC25.zip für Business Central 25. Laden Sie die Datei, die zu Ihrer Business-Central-Version passt, und entpacken Sie sie.

Die ZIP-Datei enthält die Erweiterung und alle Apps, die sie voraussetzt, also auch den SPOTS License Manager, z. B.:

  • SPOTS-BSS GmbH_ScanSPOT_29.0.1.0_BC25.app
  • SPOTS-BSS GmbH_SPOTS License Manager_29.0.1.0_BC25.app

Installieren​

Installieren Sie die Apps in der Business Central Administration Shell als Administrator des Servers. Installieren Sie zuerst den SPOTS License Manager, danach die Erweiterung. Ist der License Manager in dieser Version schon installiert, überspringen Sie ihn.

Beispiel: ScanSPOT 29.0.1.0 in der Serverinstanz BC250, Tenant default. Die ZIP-Datei ist nach C:\Apps\ScanSPOT-29.0.1.0-BC25 entpackt.

$Instance = 'BC250'
$Tenant   = 'default'
$Folder   = 'C:\Apps\ScanSPOT-29.0.1.0-BC25'

# 1. SPOTS License Manager
Publish-NAVApp -ServerInstance $Instance -Path "$Folder\SPOTS-BSS GmbH_SPOTS License Manager_29.0.1.0_BC25.app"
Sync-NAVApp    -ServerInstance $Instance -Tenant $Tenant -Name 'SPOTS License Manager' -Version 29.0.1.0
Install-NAVApp -ServerInstance $Instance -Tenant $Tenant -Name 'SPOTS License Manager' -Version 29.0.1.0

# 2. ScanSPOT
Publish-NAVApp -ServerInstance $Instance -Path "$Folder\SPOTS-BSS GmbH_ScanSPOT_29.0.1.0_BC25.app"
Sync-NAVApp    -ServerInstance $Instance -Tenant $Tenant -Name 'ScanSPOT' -Version 29.0.1.0
Install-NAVApp -ServerInstance $Instance -Tenant $Tenant -Name 'ScanSPOT' -Version 29.0.1.0

Aktualisieren​

Eine neue Version veröffentlichen Sie, synchronisieren sie und führen dann das Datenupgrade aus. Danach können Sie die alte Version zurücknehmen. Aktualisieren Sie auch hier zuerst den SPOTS License Manager, wenn die ZIP-Datei eine neuere Version enthält als die installierte.

Beispiel: ScanSPOT von 29.0.1.0 auf 29.0.2.0, der License Manager ist schon aktuell.

$Instance = 'BC250'
$Tenant   = 'default'
$Folder   = 'C:\Apps\ScanSPOT-29.0.2.0-BC25'

Publish-NAVApp          -ServerInstance $Instance -Path "$Folder\SPOTS-BSS GmbH_ScanSPOT_29.0.2.0_BC25.app"
Sync-NAVApp             -ServerInstance $Instance -Tenant $Tenant -Name 'ScanSPOT' -Version 29.0.2.0
Start-NAVAppDataUpgrade -ServerInstance $Instance -Tenant $Tenant -Name 'ScanSPOT' -Version 29.0.2.0

# Alte Version zurücknehmen
Unpublish-NAVApp        -ServerInstance $Instance -Name 'ScanSPOT' -Version 29.0.1.0

Welche Versionen veröffentlicht und installiert sind, zeigt Get-NAVAppInfo -ServerInstance $Instance -Tenant $Tenant -TenantSpecificProperties.

Lizenz​

Ohne AppSource-Lizenz lizenzieren Sie die Erweiterungen über den SPOTS License Manager. Den Lizenzstatus jeder Erweiterung sehen Sie auf der Seite Installierte Produkte – SPOTS-BSS® GmbH. Dort aktivieren Sie eine Erweiterung mit Produkt aktivieren und laden den aktuellen Stand mit Lizenz aktualisieren.

Nach der Installation​

Richten Sie die Erweiterung ein, wie in ihrer Dokumentation unter „Einrichtung“ beschrieben. Die Dokumentationen der Erweiterungen finden Sie unter Get Started.