Skip to main content
Skip table of contents

plan b Installationsanleitung

In dieser Anleitung werden die notwendigen Schritte zur Installation von plan b dokumentiert. Bei plan b handelt es sich um eine Single-Page-Webanwendung, welche auf einem Webserver gehostet wird und die dem Benutzer über einen Webbrowser Funktionalitäten aus der Pradtke-Produktpalette anbietet.

Im Gegensatz zu einer klassischen Desktop-Anwendung beschränken sich die System-voraussetzungen für den Benutzer 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 URI zum Zugriff auf die Pradtke.API bekannt sein muss.

  • HTTPS: plan b 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. Das heißt, Sie müssen 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, 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.planB.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 der Speicherort

CODE
"C:\Temp"

da das MSI-Paket den Inhalt später in das Verzeichnis

CODE
C:\inetpub\pradtke\plan-b

installiert werden soll.

MSI-Paket installieren

Doppelklicken Sie auf das MSI-Paket und führen Sie die nachfolgenden Anweisungen aus.

Klicken Sie auf Weiter.

Akzeptieren Sie die Lizenzvereinbarung und klicken Sie auf Weiter.

Geben Sie den Benutzernamen ein und drücken 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 Plan B IIS-Site beendet worden ist. Wählen Sie anschließend mit einem Klick die Option „Pradtke Plan B 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 „plan-b“ anzulegen.

Konfiguration der Website und deren Bindung:

  • Sitename: Hier kann ein Name für die Website innerhalb des IIS-Managers hinterlegt werden. Beispiel: „plan-B“.

  • 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 plan b, z. B.

    CODE
    C:\inetpub\pradtke\plan-b
  • 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 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 zu Zertifikatsfehlern kommt. Ggfs.

  • 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 plan b 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\plan-b“, befindet sich die Beispiel-Konfigurationsdatei „plan-b-config.default.json“. Diese Datei müssen Sie in „plan-b-config.json“ umbenennen.

Öffnen Sie diese Datei anschließend mit einem geeigneten Texteditor. Dort finden Sie folgende Einträge:

ACTIONSCRIPT3
{
"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 plan b auf eine Antwort von der Pradtke.API wartet. Vorgegeben sind hier 10000, d. h. nach 10 Sekunden bricht plan b 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 plan b 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 „plan-b-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 plan b 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 plan b 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, damit die neue Konfiguration wirksam wird.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.