Zum Inhalt

Einrichten eines Business Portals Portals

Dieser Artikel beschreibt den detaillierten Bereitstellungsprozess eines Business Portals Portals. Das Portal kann entweder über einen Azure App Service in Azure oder auf Ihrem eigenen Server bereitgestellt werden.

Note

Wenn Sie Business Central in der Cloud verwenden, wird empfohlen, das Portal über Azure zu hosten, da die Aktualisierungs- und Bereitstellungsprozesse automatisiert sind.

Einrichten eines Portals (Gehostet in Azure)

Business Portals von Simova bietet Ihnen die Möglichkeit, Portale zu erstellen, ohne Business Central zu verlassen, über einen Azure Appservice. Um einen Appservice über Business Portals zu konfigurieren, müssen Sie eine App-Registrierung konfiguriert haben. Wenn Sie noch keine konfiguriert haben, lesen Sie bitte diese Dokumentation.

Um einen Azure Appservice über Business Central bereitzustellen, befolgen Sie diese Schritte:

  1. Öffnen Sie die Suche nach der Seite Business Portals - Portals, alternativ können Sie die Seite über die Aktionen Portal öffnen, wenn Sie das Business Portals Admin Rolecenter zugewiesen haben.
  2. Führen Sie auf der neu geöffneten Seite die Aktion Erstellen aus.
  3. Klicken Sie im geöffneten Assistenten auf Beginnen.
  4. Stimmen Sie auf der folgenden Seite zu, dass die Erstellung eines Azure Web Service Kosten für das ausgewählte Abonnement verursachen kann, abhängig von den gewählten Einstellungen.
  5. Geben Sie im nächsten Schritt einen Namen und eine Beschreibung ein.
  6. Wählen Sie im nächsten Schritt aus, dass ein neuer App Service erstellt werden soll.
  7. Wählen Sie die Version aus. (Business Portals ruft nur die Versionen ab, die mit Ihrer in Ihrem System installierten Business Central-Anwendung kompatibel sind).
  8. Danach müssen Sie Ihr Azure-Abonnement auswählen, das auf Ihrem Mandanten gehostet wird. Wenn Sie kein Azure-Abonnement haben, lesen Sie bitte diesen Leitfaden.
  9. Wählen Sie Ihre Preisstufe und Region aus. Für weitere Informationen zu Preisstufen lesen Sie bitte diese Dokumentation.
  10. Beenden Sie den Assistenten.

Nach diesen Schritten wurde ein Azure Appservice mit Ihren gewählten Parametern in Azure bereitgestellt. Der Name, der für den App Service verwendet wird, wird dynamisch erstellt und folgt diesem Muster: SIM-APPS-DPS-000000000000000000. Nachdem der Appservice erstellt wurde, müssen Sie weiterhin alle dps-Pakete, die mit Ihrer gewählten Version verbunden sind, bereitstellen und installieren. Klicken Sie dazu auf Build oder Build(Auto). Der Hauptunterschied besteht darin, dass Build nur einen Build-Schritt gleichzeitig ausführt, während Build(Auto) alle Prozesse durchläuft. Der Prozess kann einige Minuten dauern. Die Geschwindigkeit wird durch die Geschwindigkeit des Scale Ihres gewählten App Service Plans bestimmt.

Info

Anwendungen, die auf einem kostenlosen oder gemeinsamen App Service-Plan ausgeführt werden, unterliegen bestimmten Nutzungslimits. Wenn eines dieser Limits überschritten wird, wird die App automatisch pausiert, bis das Kontingent zurückgesetzt wird. Um diese Einschränkungen dauerhaft zu entfernen, können Sie Ihren App Service-Plan jederzeit auf eine höhere Stufe skalieren.

Einrichten eines Portals (Selbstgehostet)

Der folgende Text bietet Schritt-für-Schritt-Anleitungen zur Installation von Business Portals by Simova mit dem Inno Setup-Installer. Der Installer wird: * Notwendige Abhängigkeiten wie Node.js und .NET Framework 4.8 installieren. * IIS-Einstellungen konfigurieren und die erforderliche Website erstellen. * Firewall-Regeln für Node.js einrichten.

Installer ausführen

  1. Doppelklicken Sie auf die Installationsdatei, um die Installation zu starten.
  2. Wenn Sie von Windows UAC dazu aufgefordert werden, klicken Sie auf Ja, um administrative Berechtigungen zu gewähren.

Folgen Sie dem Installationsassistenten

  1. Willkommensbildschirm
  2. Klicken Sie auf Weiter, um fortzufahren.
  3. Zielordner auswählen
  4. Der Standardinstallationspfad ist C:\inetpub\wwwroot\DPSManagement.
  5. Klicken Sie auf Weiter, um fortzufahren.
  6. Installationsfortschritt
  7. Der Installer kopiert die erforderlichen Dateien und richtet die Anwendung ein.

Installation der Abhängigkeiten

Der Installer installiert die folgenden Abhängigkeiten: * Node.js v21.6.1 * Der Installer führt aus: 

msiexec /passive /i "{app}\node-v21.6.1-x64.msi"
* .NET Framework 4.8 * Wenn es noch nicht installiert ist, führt der Installer aus: 
{tmp}\dotNet48Setup.exe /passive /norestart /showrmui /showfinalerror

Firewall-Regeln konfigurieren

Der Installer erstellt eingehende und ausgehende Firewall-Regeln für Node.js: 

netsh advfirewall firewall add rule name="Node In" program="{commonpf64}\nodejs\node.exe" dir=in action=allow enable=yes
netsh advfirewall firewall add rule name="Node Out" program="{commonpf64}\nodejs\node.exe" dir=out action=allow enable=yes

IIS konfigurieren

Der Installer führt PowerShell-Skripte aus, um: * IIS-Komponenten zu installieren. * Einen Webanwendungspool und eine Website zu erstellen. * Die Identität des Anwendungspools festzulegen. * Die Website an Port 14000 zu binden.

Der IIS-Einrichtungsprozess umfasst: 

import-module servermanager
New-WebAppPool -name "DPSManagement"
New-Website -name "DPSManagement" -ApplicationPool "DPSManagement" -PhysicalPath "{app}"
New-WebBinding -name "DPSManagement" -port 14000 -Protocol "http" -HostHeader "localhost" -IPAddress "*"
Start-WebSite DPSManagement

Letzte Schritte

  • Sobald die Installation abgeschlossen ist, klicken Sie auf Fertigstellen.
  • Öffnen Sie einen Webbrowser und navigieren Sie zu http://localhost:14000, um auf DPS Management zuzugreifen.

Portal über DPS Management bereitstellen

Um ein Portal nach der Installation des Setups zu erstellen, greifen Sie auf DPS Management zu, das standardmäßig der URI http://localhost:14000 zugewiesen ist. Befolgen Sie danach diese Schritte, um ein Portal auf Ihrem eigenen System bereitzustellen:

  1. Klicken Sie auf Hinzufügen +
  2. Füllen Sie das neu geöffnete Formular aus und bestätigen Sie Ihre Eingabe mit OK.
  3. Warten Sie, bis das Management die Site erstellt hat. Sie können den Status über die Benachrichtigungsaktion in der oberen rechten Ecke einsehen.
  4. Nachdem die Site erstellt wurde, können Sie die Bearbeitungsaktion ausführen.
  5. Öffnen Sie den Abschnitt Erweitert.
  6. Füllen Sie für den Knoten NavisionWSURL Ihre Webservice-URI ein. Sie sollte die folgende Struktur haben: https://api.businesscentral.dynamics.com/v2.0/{TENANT-ID}/{ENVRIONMENT-NAME}/ODataV4 und kann auf der Webservice-Seite von Business Central gefunden werden.
  7. Füllen Sie für DefaultCompany den Namen Ihres Standardunternehmens ein.
  8. Geben Sie für ConnectionType ODATA ein.
  9. Geben Sie für TenantID, ClientID und ClientSecret die Werte ein, die in Ihrer konfigurierten App-Registrierung bereitgestellt werden. Der Wert für Scope sollte https://api.businesscentral.dynamics.com/.default sein. Wenn Sie noch keine App-Registrierung erstellt haben, folgen Sie bitte dieser Dokumentation.

Nach diesen Schritten sollten Sie ein funktionierendes Portal haben, das mit Ihrer Business Central-Umgebung verbunden ist.

Warning

Bitte beachten Sie, dass dieser Konfigurationsleitfaden nicht gilt, wenn Sie ein Legacy Dynamics NAV-System haben. Für diese Arten von Systemen müssen Sie nur die Webservice-URL angeben. Die Anmeldeinformationen des Dienstbenutzers werden verwendet, um sich bei der Umgebung zu authentifizieren (Basic). Bitte beachten Sie, dass Dynamics NAV KEIN OAuth2 unterstützt und weiterhin auf die älteren, unsicheren Web Service Access Keys (Basic Auth) angewiesen ist. Microsoft hat die Unterstützung für die Basisauthentifizierung am 1. Oktober 2022 (BC21) eingestellt.

Fehlersuche

Fehlendes .NET Framework

Wenn die Installation aufgrund eines fehlenden .NET Frameworks fehlschlägt, laden Sie es manuell von folgender Seite herunter und installieren Sie es: Microsoft .NET Framework 4.8

IIS-Konfigurationsprobleme

Wenn IIS nicht korrekt startet, führen Sie manuell aus: 

Import-Module ServerManager
Get-WebBinding -name "DPSManagement" -port 80 | Remove-WebBinding
Start-WebSite DPSManagement

Firewall-Regeln nicht angewendet

Führen Sie den folgenden Befehl manuell aus: 

netsh advfirewall reset

Löschen eines Portals in Business Central

Beim Entfernen eines Portals aus Business Central stehen zwei Löschoptionen zur Verfügung. Jede Option bestimmt, ob Daten nur innerhalb von Business Central oder auch in der verbundenen Azure-Umgebung entfernt werden. Dies stellt sicher, dass Portalumgebungen je nach Systemanforderungen flexibel verwaltet werden können.

Befolgen Sie diese Schritte, um ein Portal zu löschen:

  1. Öffnen Sie Business Portal – Portals.
  2. Wählen Sie das Portal aus, das gelöscht werden soll.
  3. Klicken Sie in der Menüleiste auf Löschen.

  4. Wählen Sie eine der folgenden Löschoptionen:

    Nur Daten von Business Central löschen

    Nur die innerhalb von Business Central erstellten Daten werden gelöscht.
    Die zugehörigen Azure-Ressourcen bleiben unverändert.
    Bei der Erstellung eines neuen Portals kann ein vorhandener App Service wiederverwendet werden.

    Alle Daten löschen

    Alle Daten, einschließlich der mit dem Portal verknüpften Azure-Ressourcen, werden dauerhaft gelöscht.

  5. Nach Auswahl einer Aktion wird das Portal gelöscht.

Siehe auch