# Installation On Premise

Um die DeDeSales Connector App in einer On-Premise-Installation zu nutzen, gehen Sie wie folgt vor.

#### Vorbereitung

- Business Central Version 20 oder höher ist installiert.
- Die erforderlichen Dienste sind in der Business Central Administration aktiviert (siehe [Systemvoraussetzungen](https://wiki.dedesales.de/link/595#bkmrk-page-title)).
- Die .app-Datei liegt bereit, zum Beispiel unter `C:\DEV\BCAPI_Runtime\DeDeSales_Connector_runtime.app`.

#### App bereitstellen

Starten Sie die Business Central Administration Shell als Administrator und stellen Sie die App mit „Publish-NAVApp“ auf dem Server bereit:

```
Publish-NAVApp -ServerInstance BC200 -Path "C:\DEV\BCAPI_Runtime\DeDeSales_Connector_runtime.app" -SkipVerification
```

Danach installieren Sie die App. Dafür gibt es zwei Wege.

#### Installation über die Oberfläche

Die bereitgestellte DeDeSales Connector App ist jetzt in Business Central über die Erweiterungen sichtbar.

1. Öffnen Sie über das Zahnrad oben rechts die *Erweiterten Einstellungen*.

[![Zahnrad-Menü mit „Erweiterte Einstellungen“](https://wiki.dedesales.de/uploads/images/gallery/2026-11/jw84TxmgDTyBXq9U-bc-image6.png)](https://wiki.dedesales.de/uploads/images/gallery/2026-11/jw84TxmgDTyBXq9U-bc-image6.png)

Wählen Sie *Extensions*. 

[![Erweiterte Einstellungen mit dem Eintrag „Extensions“](https://wiki.dedesales.de/uploads/images/gallery/2026-11/pwybimmr7CJZHtnR-bc-image7.png)](https://wiki.dedesales.de/uploads/images/gallery/2026-11/pwybimmr7CJZHtnR-bc-image7.png)

Suchen Sie die Kachel „DeDeSales Connector“ und öffnen Sie über die drei Punkte das Menü. 

[![Kachel „DeDeSales Connector“ der DeDeNet GmbH](https://wiki.dedesales.de/uploads/images/gallery/2026-11/56rD0FYydtlV8tau-bc-image9.png)](https://wiki.dedesales.de/uploads/images/gallery/2026-11/56rD0FYydtlV8tau-bc-image9.png)

Wählen Sie *Installieren*. 

[![Menü der Erweiterung mit dem Eintrag „Installieren“](https://wiki.dedesales.de/uploads/images/gallery/2026-11/QazNSbARW7FA7TEp-bc-image8.png)](https://wiki.dedesales.de/uploads/images/gallery/2026-11/QazNSbARW7FA7TEp-bc-image8.png)

Prüfen Sie die Angaben im Dialog „Erweiterungsinstallation“ und klicken Sie auf *Weiter*. 

[![Dialog „Erweiterungsinstallation“ mit Name, Beschreibung, Version und App-ID](https://wiki.dedesales.de/uploads/images/gallery/2026-11/Nvl4bKCW1opA2xys-bc-image10.png)](https://wiki.dedesales.de/uploads/images/gallery/2026-11/Nvl4bKCW1opA2xys-bc-image10.png)

Prüfen Sie Name, Herausgeber und Sprache und klicken Sie auf *Installieren*. 

[![Dialog „Erweiterungsinformationen vor der Installation prüfen“](https://wiki.dedesales.de/uploads/images/gallery/2026-11/21ZLqoxR18ePJb3l-bc-image11.png)](https://wiki.dedesales.de/uploads/images/gallery/2026-11/21ZLqoxR18ePJb3l-bc-image11.png)

Bestätigen Sie die Meldung mit *OK*. Alle aktiven Benutzer müssen sich abmelden und wieder anmelden, um die Änderungen an der Navigation zu sehen. 

[![Meldung „Die DeDeSales Connector-Erweiterung wurde installiert“](https://wiki.dedesales.de/uploads/images/gallery/2026-11/R2P6YZ2eE2Nn0BCo-bc-image12.png)](https://wiki.dedesales.de/uploads/images/gallery/2026-11/R2P6YZ2eE2Nn0BCo-bc-image12.png)

#### Installation über die Administration Shell

Alternativ installieren Sie die App in der Shell. Synchronisieren Sie zuerst das Schema und installieren Sie dann die App:

```
Sync-NAVApp -ServerInstance BC200 -Name "DeDeSales Connector Runtime"
Install-NAVApp -ServerInstance BC200 -Name "DeDeSales Connector Runtime"
```

Prüfen Sie anschließend im Business Central Web Client unter *Extension Management*, dass die App als „Installed“ angezeigt wird.

#### Berechtigungen

Weisen Sie dem Auth User folgende Berechtigungen zu:

- **D365 API:** für den Zugriff auf die Standard-APIs von Business Central.
- **DeDeSales\_<CustomName>:** der mit dem Connector gelieferte Satz für alle Anpassungen.
- Optional zum Testen: **SUPER**.

Für die Kommunikation mit dem DeDeSales Server ist bei On-Premise-Installationen ein [VPN](https://wiki.dedesales.de/link/599#bkmrk-page-title) erforderlich.