TIMEOFFICE Web Installationsanleitung
In dieser Anleitung werden die notwendigen Schritte zur Installation von TIMEOFFICE Web dokumentiert. Bei TIMEOFFICE Web handelt es sich um eine Single-Page-Webanwendung, welche auf einem Webserver gehostet wird und die dem Benutzer über einen Webbrowser Funktionalitäten aus dem Pradtke Kosmos wie plan b oder Vakante Dienste anbietet.
Im Gegensatz zu einer klassischen Desktop-Anwendung beschränken sich die Systemvoraussetzungen für die Benutzenden auf die Verfügbarkeit eines geeigneten Webbrowsers.
Voraussetzungen für den Webserver
Voraussetzungen und Konfigurationen
Die Pradtke API muss installiert und der Zugriff auf die Pradtke API muss gewährleistet sein. Letzteres bedeutet insbesondere, dass die URL zum Zugriff auf die Pradtke API bekannt sein muss.
HTTPS: TIMEOFFICE Web muss für Konsumenten unter der an HTTPS gebundenen Adresse (sowie entsprechendem Port) erreichbar sein. Standardmäßig wird HTTPS an Port 443 gebunden. Dieser Port darf aber nicht bereits durch eine andere Site benutzt werden. Daher müssen Sie sicherstellen, dass die verwendeten Ports keine Kollisionen aufweisen.
Unterstützung von mindestens TLS 1.2 ohne Fallback auf eine frühere Version.
Es ist zwingend ein überprüfbares und nach den aktuellen Regeln gültiges Serverzertifikat für die Verwendung von TLS nötig.
Installation der Webanwendung
Zur Installation der Single-Page-Webanwendung sind folgende Schritte durchzuführen:
Speicherort auf einem Webserver festlegen
Die Programmdateien, die durch das Installationspaket „Pradtke-Timeoffice-Web.x.x.x.msi“ bereitgestellt werden, können für den Betrieb in einem Wunschverzeichnis auf dem Dateisystem des Webservers abgelegt werden. Als Zwischenspeicher eignet sich zunächst für das MSI-Paket folgender Speicherort:
"C:\Temp"
Grund dafür ist, dass das MSI-Paket den Inhalt später in folgendem Verzeichnis installieren soll:
C:\inetpub\pradtke\timeoffice-web
MSI-Paket installieren
Doppelklicken auf das MSI-Paket.
Klicken Sie auf Weiter.
Akzeptieren Sie die Lizenzvereinbarung und klicken Sie auf Weiter.
Geben Sie den Benutzernamen ein und klicken Sie auf Weiter.
Der Zielordner ist bereits vorgegeben. Klicken Sie auf Weiter.
Wichtiger Hinweis für eine Update-Installation: Prüfen Sie im IIS-Manager, ob Ihre bereits vorhandene TIMEOFFICE Web IIS-Site beendet worden ist. Wählen Sie anschließend mit einem Klick die Option „Pradtke Timeoffice Web IIS-Site ist beendet“ aus.
Die Installation ist abgeschlossen. Drücken Sie auf Fertig stellen, um den Installationsassistenten zu verlassen.
Einrichten der Site im IIS-Webserver
Im IIS-Manager ist eine neue Website unter dem Namen „timeoffice-web“ anzulegen.
Konfiguration der Website und deren Bindung:
Sitename: Hier kann ein Name für die Website innerhalb des IIS-Managers hinterlegt werden. Beispiel: „timeoffice-web“.
Anwendungspool: Hier ist der zu verwendende Anwendungspool anzugeben.
Typ: Hier muss zwangsweise das zu verwendende Protokoll „HTTPS“ angegeben werden.
Physischer Pfad: Hinterlegen Sie hier den Installationspfad von TIMEOFFICE Web, z. B.
CODEC:\inetpub\pradtke\timeoffice-web
IP-Adresse: Nach Möglichkeit sollte keine explizite IP-Adresse angegeben werden.
Port: Der Port, über den die Site erreichbar sein soll; bei HTTPS ist der Standardport 443. Da Ports nicht mehrfach vergeben werden können, ist es jedoch möglich, einen anderen Port zu wählen, falls z. B. das Web-Portal oder die Pradtke API bereits über den Port 443 aufgerufen werden.
Hostname: Der Name, unter welchem die Site im Netzwerk erreichbar sein soll. Dieser Eintrag kann in der Regel ebenfalls leer gelassen werden. Der Hostname entspricht dann dem Servernamen im Netzwerk. Beachten Sie aber, dass der Hostname zu dem im Zertifikat hinterlegten Hostnamen (Authority-Teil der URI) passt, da es sonst ggf. zu Zertifikatsfehlern kommt.
SSL-Zertifikat: Hier muss ein überprüfbares, nach den aktuellen Regeln gültiges Serverzertifikat für den Betrieb hinterlegt werden.
Konfiguration der mit der Single-Page-Webanwendung kommunizierenden REST-Schnittstelle „Pradtke API“.
Zur Bereitstellung der Funktionalitäten von TIMEOFFICE 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 Dateiverzeichnisses, in unserem Beispiel der Pfad „C:\inetpub\pradtke\timeoffice-web“, befindet sich die Beispiel-Konfigurationsdatei „timeoffice-web-config.default.json“. Diese Datei müssen Sie in „timeoffice-web-config.json“ umbenennen.
Öffnen Sie diese Datei anschließend mit einem geeigneten Texteditor. Dort finden Sie folgende Einträge:
{
"apiBaseUrl": "https://API_server.pradtke.de:4200/api",
"apiClientTimeoutInMs": 10000
}
Diese müssen Sie entsprechend anpassen:
Unter „apiBaseUrl“ tragen Sie die URL des Servers ein, auf dem Ihre Pradtke API gehostet wird. Dabei sollten Sie immer den Port angeben, über den die Pradtke API erreicht werden kann, sofern der Port keinem HTTP-Standardport (80 für HTTP, 443 für HTTPS) entspricht. Die Adresse wird immer mit einem „/api“ abgeschlossen.
Unter "apiClientTimeoutInMs" wird in Millisekunden vorgegeben, wie lange TIMEOFFICE Web auf eine Antwort von der Pradtke API wartet. Vorgegeben sind hier 10000, d. h. nach 10 Sekunden bricht TIMEOFFICE Web die Anfrage ab. Bei einer sehr langsamen Verbindung kann es sinnvoll sein, den Wert hochzusetzen.
Damit die geänderte Konfiguration übernommen wird, muss die IIS-Site einmal neu gestartet werden.
Konfiguration von TIMEOFFICE Web in der Pradtke API
Navigieren Sie auf die Konfigurationsoberfläche der Pradtke API unter https://api.deine-krankenhaus-infrastruktur.de:5001/config, d. h. Sie nehmen die URL der Pradtke API und ergänzen diese um den Zusatz "/config". Falls bei Ihnen mehrere Instanzen der Pradtke API gehostet sind, wählen Sie bitte die Instanz aus, die Sie im vorhergehenden Schritt in der „timeoffice-web-config.json“ eingetragen haben.
Melden Sie sich mit den Zugangsdaten für den Adminzugang zur Pradtke API an. Der Adminzugang wurde von Ihnen beim ersten Aufruf der Konfigurationsoberfläche angelegt.
Für die Konfiguration von TIMEOFFICE Web sind die Bereiche „Datenbanken“ und „CORS“ relevant, die Sie jeweils durch Klicken auf die entsprechende Kachel öffnen können.Öffnen Sie den Bereich "Datenbanken". Prüfen Sie, ob es sich bei der dort hinterlegten Datenbank um die Produktivinstanz der TIMEOFFICE-Datenbank (1) handelt und testen Sie die Verbindung über die Schaltfläche “Datenbank” (2) .
Öffnen Sie nun den Bereich "CORS". Hier muss der Origin (Schema + Authority-Teil der URI) von TIMEOFFICE Web in der Liste der freigegebenen Hosts hinterlegt sein. Der eingetragene Origin sollte nicht mit einem "/" abgeschlossen werden.
Loggen Sie sich aus der Konfigurationsoberfläche aus.
Starten Sie die Pradtke API im IIS-Manager neu.
TIMEOFFICE Web in der Pradtke API ist konfiguriert.