Installation in Dynamics 365 Business Central On-Premise
Für Microsoft Dynamics 365 Business Central On-Premise Umgebungen werden sogenannte Runtime Packages zur Verfügung gestellt. Hierbei handelt es sich um vorkompilierte Erweiterungen, die Sie direkt in Ihrer Microsoft Dynamics 365 Business Central Umgebung installieren können.
Gut zu wissen
Es ist wichtig die korrekte Version, für die bei Ihnen eingesetzte Plattform Version von Microsoft Dynamics 365 Business Central, zu verwenden. Runtime Packages sind nur für die Version für die Sie kompiliert wurden kompatibel.
Der Einsatz in einer anderen Version kann zu Fehlern führen.
Voraussetzungen
Da alle 365 business development Apps als ISV-Module im ISV-Objektbereich bereitgestellt werden, ist eine Erweiterung der Microsoft Dynamics 365 Business Central-Lizenz erforderlich, um Zugriff auf den ISV-Objektbereich und die entsprechende App-Funktionalität zu erhalten.
Gut zu wissen
Die Erweiterung der Microsoft Dynamics 365 Business Central-Kundenlizenz mit der 365 business development App-Lizenz ist nur für Microsoft Dynamics 365 Business Central On-Premise-Umgebungen notwendig und erfordert nicht, dass der Kunde die 365 business development App-Lizenz tatsächlich kauft.
Die 365 business development App-Lizenz wird allen Microsoft Dynamics 365 Business Central-Kunden kostenlos zur Verfügung gestellt, solange eine gültige Microsoft Dynamics 365 Business Central-Kundenlizenz besteht.
Um 365 business development Apps in Microsoft Dynamics 365 Business Central On-Premise-Umgebungen auszuführen, muss die Microsoft Dynamics 365 Business Central-Kundenlizenz (*.bclicense) mit der entsprechenden 365 business development App-Lizenz erweitert werden. In der Regel wird dies von Ihrem Microsoft Dynamics 365 Business Central-Partner über das Microsoft Partner Source Business Center (PSBC) durchgeführt.
Info
Um Zugriff auf die 365 business development App-Lizenz zu erhalten, muss der Microsoft Dynamics 365 Business Central-Partner die 365 business development Partnervereinbarung unterzeichnet haben.
Wenn Sie Microsoft Dynamics 365 Business Central-Partner sind und die 365 business development Partnervereinbarung noch nicht unterzeichnet haben, kontaktieren Sie uns bitte unter info@365businessdev.com, um die Vereinbarung zu erhalten. Nach der Unterzeichnung erhalten Sie als autorisierter Reseller Zugriff auf die 365 business development App-Lizenz und können die Lizenzen Ihrer Kunden entsprechend erweitern.
ISV-Modul
Alle 365 business development Apps werden als ISV-Module bereitgestellt. Die folgende Tabelle listet den ISV-Anbieter, die Modul-ID, die ID und den Namen der 365 business development Apps auf, die Sie zur Erweiterung der Microsoft Dynamics 365 Business Central-Kundenlizenz (*.bclicense) verwenden können:
| ISV-Anbieter | Modul-ID | ID | Name |
|---|---|---|---|
| 7058648 | 78954 | 5523650 | 365 business development Apps |
Gut zu wissen
Seit Anfang 2025 werden die 365 business development Apps nicht mehr in einzelne ISV-Module für die Lizenzierung aufgeteilt. Stattdessen werden alle 365 business development Apps nun als ein einziges ISV-Modul mit der ID 5523650 bereitgestellt. Dies vereinfacht den Lizenzierungsprozess und ermöglicht die Nutzung aller 365 business development Apps, ohne diese einzeln lizenzieren zu müssen.
Installation
Die Installation von Erweiterungen in Microsoft Dynamics 365 Business Central On-Premise Umgebungen findet über die Windows PowerShell statt. Um die Installation zu vereinfachen und das Fehlerpotential zu verringern stellen wir ein PowerShell Script, den 365 business development App Installer, zur Verfügung, welches Sie zur Installation unserer Erweiterungen für Microsoft Dynamics 365 Business Central verwenden können.
Download
Den 365 business development App Installer stellen wir auf unserer GitHub Seite zur Verfügung. Dort finden Sie den Quellcode des PowerShell Skripts und können es von hier herunterladen. Der 365 business development App Installer ist unter der MIT-Lizenz lizenziert. Das bedeutet, dass Sie das Skript für Ihre eigenen Zwecke verwenden können, solange Sie die Lizenzbedingungen einhalten.
365 business development App InstallerVerwendung
In diesem Abschnitt erfahren Sie, wie Sie den 365 business development App Installer verwenden können, um unsere Erweiterungen in Microsoft Dynamics 365 Business Central On-Premise Umgebungen zu installieren.
Hinweis
Bitte beachten Sie, dass der 365 business development App Installer in einer PowerShell Sitzung mit erhöhten Rechten (Administrator) ausgeführt werden muss.
Die Ausführung muss auf dem Microsoft Dynamics 365 Business Central Server erfolgen, da die Microsoft Dynamics 365 Business Central PowerShell Module für die Installation benötigt werden.
- Laden Sie den 365 business development App Installer herunter.
- Starten Sie Microsoft PowerShell oder Microsoft Dynamics 365 Administration Shell als Administrator.
- Navigieren Sie zu dem Ort des Downloads (z.B.
C:\Run). - Führen Sie das
Install-Apps.ps1PowerShell Skript aus.Code - Wählen Sie die Microsoft Dynamics 365 Business Central-Dienstinstanz aus (nur wenn mehr als eine Instanz installiert ist).
Hinweis
Sie finden die Application ID, sowie den vollständigen Aufruf des 365 business development App Installer auf der jeweiligen Downloadseite des Produkts.
Mögliche Probleme
PowerShell Ausführungsrichtlinie
Je nach Ihrer Einrichtung müssen Sie möglicherweise die Ausführung des PowerShell-Skripts Install-Apps.ps1 zulassen. Verwenden Sie Set-ExecutionPolicy CmdLet, um die Ausführung zu erlauben. Für weitere Informationen besuchen Sie die Dokumentation.
Code
Funktionsweise
Der 365 business development App Installer führt grundsätzlich folgende Schritte aus:
- Identifizierung der, auf dem aktuellen Computer, installierten Microsoft Dynamics 365 Business Central Service Instanzen.
- Auswahl der Microsoft Dynamics 365 Business Central Service Instanz für die Installation (Nur wenn mehr als eine Instanz gefunden wurde).
- Identifizierung der Plattform Version.
- Download der korrekten Version der zu installierenden Erweiterungen / Apps.
- Installation der Erweiterungen / Apps.
- Schemasynchronisation der Erweiterungen / Apps.
- Update der Erweiterungen / Apps (Falls bereits eine frühere Version installiert war).
- Deinstallation der alten Version der Erweiterung / Apps (Falls bereits eine frühere Version installiert war).
Beispiel
Code