Pradtke-Web (für PPP-RL Center) Installationsanleitung

In diesem Dokument finden Sie eine Anleitung zur Installation der Webanwendung Pradtke-Web, welche auf einem Applikationsserver installiert werden muss, dessen Systemvoraussetzungen hier zu finden sind. Sie können Pradtke-Web auf dem selben Server installieren, auf denen auch andere Module aus dem TIMEOFFICE Kosmos wie die Pradtke.API oder plan b installiert sind.

Hinweis zu besonderen Systemanforderungen zu Pradtke-Web:

Für Pradkte-Web wird die IIS-Erweiterung “URL REwrite für IIS” benötigt.
(verfügbar z.B. unter https://www.iis.net/downloads/microsoft/url-rewrite)

Nachdem Sie die Erweiterung installiert haben, laden Sie das aktuelle msi-Paket für Pradtke-Web aus dem Kundencenter herunter.

Führen Sie dieses anschließend mit einen Doppelklick aus, um den Installationsassistenten zu öffnen. Der Assistent führt Sie durch die Installation.

Drücken Sie auf Weiter.

Akzeptieren Sie die Lizenzvereinbarung und drücken Sie auf Weiter.

Geben Sie Ihren Benutzernamen ein. Die Eingabe des Unternehmens ist nicht erforderlich. Drücken Sie auf Weiter.

Als Zielordner für die Installation wird der Pfad

CODE

C:\inetpub\pradtke\web\

vorgeschlagen. Wenn Sie einen anderen Zielordner für die Installation möchten, drücken Sie auf Ändern… und folgen Sie dem Installationsassistenten.

Wenn die Installation auf den vorgeschlagenen Pfad erfolgen soll, drücken Sie auf Weiter.

Wichtiger Hinweis: Prüfen Sie, ob Ihre vorhandene Pradtke Web IIS-Site beendet ist. Wählen Sie anschließend „Pradtke Web IIIS Site ist beendet“. (Bei der Erstinstallation ist i.d.R. noch keine Webseite für das PPP-RL Center vorhanden.)

Erst nach diesen Schritten drücken Sie auf Weiter.

Drücken Sie auf Installieren.

2. Einrichten der Site im IIS-Webserver

Legen Sie nun im IIS-Manager eine neue Website unter dem Namen „Pradtke-Web“ an.

Wählen Sie im Kontextmenü „Webseite hinzufügen“.

Es öffnet sich die Seite mit den Einstellungen.

Nehmen Sie nun die Einstellungen vor. Beachten Sie die Hinweise zur Konfiguration der Seite.

Schritte zur Konfiguration der Website und Bindung:

Sitename: Hier hinterlegen Sie einen Namen für die Website innerhalb des IIS-Managers. Beispiel: „pradtke.web“
Anwendungspool: Geben Sie hier den verwendenden Anwendungspool an.
Typ: Wählen Sie das Protokoll „https“ aus.
Physischer Pfad: Wählen Sie den „Physischen Pfad“ aus. Dieser Pfad entspricht dem erzeugten Pfad. Beispielpfad:
CODE
```
C:\inetpub\pradtke\web\
```
IP-Adresse: Sie können hier eine IP-Adresse auswählen. Es kann explizit eine der IP-Adressen des Servers festgelegt werden, es muss jedoch nicht zwangsweise eine Auswahl vorgenommen werden.
Port: Wählen Sie einen Port aus, über den die Site zu erreichen ist. Bei HTTPS ist der Standardport 443. Ports können nicht mehrfach vergeben werden.
Hostname: Dies ist der Name, unter welchem die Site im Netzwerk erreichbar sein soll. Wählen Sie hier einen Namen, der zu dem im Zertifikat hinterlegten Hostnamen (Authority-Teil der URI) passt, da es sonst zu Zertifikatsfehlern kommt.
SSL-Zertifikat: Wählen Sie eines der Serverzertifikate für den Betrieb aus.

3. Konfiguration der mit der Single-Page-Webanwendung kommunizierenden REST-Schnittstelle „Pradtke.Api“

Zur Bereitstellung der Funktionalitäten des Pradtke-Web muss eine Verbindung zu einer bereits in der Kundeninfrastruktur installierten Pradtke.Api (REST-Schnittstelle) hinterlegt werden. Die dafür nötige Konfiguration kann folgendermaßen vorgenommen werden:

Im Stammverzeichnis des im ersten Schritt angelegten Dateiverzeichnis, in unserem Beispiel C:\inetpub\pradtke\web\ “ befindet sich die Konfigurationsdatei „pradtke-web-config-default“. Diese muss umbenannt werden in „pradkte-web-config.json“.

Öffnen Sie diese Datei mit einem geeigneten Texteditor (bspw. Notepad++ oder “Editor” von Windows) und verweisen Sie auf die API.

Dort finden Sie folgende Einträge:

Diese müssen Sie entsprechend anpassen:

Unter „apiBaseUrl“ tragen Sie die URL des Servers ein, auf dem die Pradtke.Api gehostet wird. Dabei sollten Sie immer den Port angeben (z. B. 5001), über den die Pradtke.Api erreicht werden kann. Die Adresse wird immer mit einem „/api“ abgeschlossen.
Unter "apiClientTimeoutInMs" wird in Millisekunden vorgegeben, wie lange das Pradtke-Web auf eine Antwort von der Pradtke.Api wartet. Vorgegeben sind hier 10000, d. h. nach 10 Sekunden bricht Pradtke-Web die Anfrage ab. Bei einer sehr langsamen Verbindung kann es sinnvoll sein, den Wert hochzusetzen. Wenn beide Webseiten (API und Pradtke.Web) auf demselben Sever gehostet werden, kann der Wert unverändert bleiben.

Die Website kann nun gestartet werden und ist nun nutzbar.

Wenn Sie die hinterlegte Adresse im Webbrowser aufrufen, wird eine Login-Maske angezeigt.

4. Registrieren der über das Pradtke-Web zur Verfügung gestellten Funktionen in der Pradtke.Api

Damit die über die Funktionen des Pradtke-Web in TIMEOFFICE verfügbar sind, muss die Konfiguration der Pradtke.Api angepasst werden.

Öffnen Sie die Konfigurationsseite der Pradtke.Api.
Im Bereich CORS muss der Server freigegeben sein, auf dem das Pradtke-Web installiert wurde. Prüfen Sie also die Freigaben und legen Sie bei Bedarf eine zusätzliche Freigabe an.
Im Bereich Einstellungen sollten Sie jetzt die passende Kategorie zu den freigegebenen Funktionen finden, z. B. PPPRL-Center. Hinterlegen Sie hier alle benötigten Informationen. Im Fall des PPRL-Centers reicht hier die Angabe der URL der pradtke-web Site.

Nähere Informationen zur Konfiguration der Pradtke.Api finden Sie in der Installationsanleitung zur Pradtke.Api.