Web-Client bereitstellen¶

Der Web-Client der Webdisposition ist eine ASP.NET-Core-Anwendung. Für die Bereitstellung stehen drei Varianten zur Verfügung: die Nutzung des von DSC bereitgestellten Webservers, das Hosting auf einem eigenen Internet Information Services (IIS) oder in einem Docker-Container. Für die beiden letztgenannten Varianten müssen die jeweils beschriebenen Voraussetzungen erfüllt sein.

Webserver der DSC (empfohlen)¶

Alternativ zum eigenen Hosting kann der von DSC bereitgestellte Webserver unter https://webdisposition.dynamics-service.de genutzt werden. Hierzu muss kein separater IIS und kein Docker-Container installiert werden.

Hinterlegen Sie in diesem Fall die genannte Adresse als Dispositionserver-URL in der Webdisposition Einrichtung. Die weitere Einrichtung (Authentifizierung und Links) erfolgt unverändert.

Hinweis

Diese Variante ist die einfachste Möglichkeit, die Webdisposition zu nutzen, da kein eigener Webserver betrieben werden muss. Ein eigenes Hosting über IIS oder Docker ist nur erforderlich, wenn der Web-Client innerhalb der eigenen Infrastruktur betrieben werden soll.

Internet Information Services (IIS)¶

Über den IIS können ASP.NET-Anwendungen ausgeführt und im Netzwerk zugänglich gemacht werden. Gehen Sie zum Hosting auf einem IIS wie folgt vor:

Kopieren Sie den Inhalt des Ordners WebdispoInstall in das Verzeichnis der Webseite (z. B. C:\inetpub\wwwroot\...).
Installieren Sie das Windows Hosting Bundle für die ASP.NET Core Runtime. Der Installer steht auf der Download-Seite von Microsoft bereit.
Stellen Sie sicher, dass im IIS-Manager unter den Modulen die folgenden Einträge vorhanden sind:
```
AspNetCoreModule
AspNetCoreModuleV2
```

Anschließend kann die Webdisposition über den zugehörigen Link aufgerufen werden.

Hinweis

Die benötigte Version der ASP.NET Core Runtime richtet sich nach der ausgelieferten Version des Web-Clients. Verwenden Sie die vom Hersteller zur jeweiligen Auslieferung angegebene Runtime-Version.

Docker-Container¶

Docker-Container stellen abgekapselte Einheiten dar, die unabhängig voneinander ausgeführt werden können. Gehen Sie zum Hosting in einem Container wie folgt vor:

Navigieren Sie in der Eingabeaufforderung zum Pfad des Ordners WebdispoInstall (z. B. cd C:\inetpub\wwwroot\WebdispoInstall).
Falls im Ordner noch keine Dockerfile liegt, erstellen und öffnen Sie diese:
```
copy NUL Dockerfile
notepad Dockerfile
```
Fügen Sie den folgenden Inhalt ein und speichern Sie die Datei. Passen Sie die Basis-Image-Version an die ausgelieferte Version des Web-Clients an:
```
FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS runtime
WORKDIR C:/
RUN mkdir -p temp
COPY webdispoconfigfile.txt /temp/webdispoconfigfile.txt
WORKDIR /app
COPY ./ ./
EXPOSE 80
ENTRYPOINT ["dotnet", "Webdisposition.dll"]
```
Das Dockerfile lädt das ASP.NET-Basis-Image, kopiert die für die Webdisposition benötigte Konfigurationsdatei nach C:/temp und stellt die Anwendung auf Port 80 bereit.
Erstellen Sie das Image:
```
docker build -t <Imagename>:<Version> .
```
Mit docker images können Sie prüfen, ob das Image erstellt wurde.
Erstellen Sie einen Container auf Basis des Images:
```
docker run -p 8080:80 -d --name <Containername> --hostname <Hostname> --dns=8.8.8.8 <Imagename>:<Version>
```
Der Container ist damit über den lokalen Port 8080 erreichbar, während der Server im Container auf Port 80 läuft. Die Ports können bei Bedarf angepasst werden.

Optional können Sie das erstellte Image speichern bzw. laden:

docker save -o <Ordnerpfad/Dateiname>.tar <Imagename>:<Version>
docker load -i <Dateipfad>.tar

Die Webdisposition kann anschließend im Browser über localhost oder den angegebenen Hostnamen aufgerufen werden – jeweils unter Angabe des gewählten Ports.

Achtung

Der Aufruf der Webdisposition erfolgt im Regelfall nicht direkt über den Browser, sondern aus Business Central heraus. Die im Web-Client angezeigten Daten werden über die in der Webdisposition Einrichtung hinterlegten Zugangsdaten und Links gesteuert.