Systemvoraussetzungen

Für den Betrieb muss das Thieme Compliance Gateway stets in einer Version installiert sein, die kompatibel ist zur installierten E-ConsentPro Version. Das Thieme Compliance Gateway 9.0.0 kann nur zusammen mit E-ConsentPro 9.0.x verwendet werden.

Das Thieme Compliance Gateway kann auf aktuellen 64-bit Windows-Systemen mit x64-Prozessor installiert werden. Er ist nicht verwendbar auf Systemen mit ARM-Prozessoren.

Weitere Systemvoraussetzungen sind in der Hilfe für E-ConsentPro dokumentiert: https://support.thieme-compliance.de/de/ECP/Systemvoraussetzungen.html

Versionshinweise

Die folgenden Neuerungen in den letzten Versionen des Thieme Compliance Gateway benötigen möglicherweise spezielle Beachtung während der Aktualisierung:

Version 9.0.0

• Enable monitoring with Sentry

Das Thieme Compliance Gateway sendet Monitoring-Daten an den Server sentry.thieme.de, um Thieme Compliance wichtige Statistik-Informationen zum Betrieb zur Verfügung zu stellen. Es werden weder Patientendaten noch sicherheitsrelevante Betriebsdaten übermittelt.

Falls das Thieme Compliance Gateway bei Ihnen über einen Proxy auf Internet-Dienste zugreift, geben Sie gegebenenfalls im Proxy den Zugriff auf den Server sentry.thieme.de frei.

Die Übermittlung kann ohne Nachteile für den Betrieb des Thieme Compliance Gateways deaktiviert werden, indem in der Konfigurationsdatei config-application.properties die Sentry-Konfiguration auf sentry.dsn= (ohne Angabe eines DSN-Ziels) gesetzt wird.

• Switch customer config files from yaml to properties

Das Thieme Compliance Gateway verwendet properties-Dateien statt yaml-Dateien für die Konfiguration durch den Administrator. Weitere Hinweise dazu finden Sie im folgenden in dieser Update-Anleitung.

---

Die komplette Liste der Neuerungen in den letzten Versionen des Thieme Compliance Gateway finden Sie im Change Log Dokument.

Generelles Vorgehen bei der Aktualisierung

Wenn Sie von einer Version vor 9.0.0 aktualisieren, sind ein paar zusätzliche Schritte bei der Aktualisierung erforderlich, bei denen der Thieme Compliance Support Sie gerne unterstützt. Sprechen Sie frühzeitig den Update-Termin mit dem Thieme Compliance Support ab, damit ein Support-Mitarbeiter Sie beim Update unterstützen kann.

Verfahren Sie bei jeder Aktualisierung des Thieme Compliance Gateways nach Möglichkeit folgendermaßen:

• Stoppen Sie den Thieme Compliance Gateway Dienst und gegebenenfalls den Thieme Compliance Gateway Datenbank Dienst.
• Aktualisieren Sie E-ConsentPro gemäß der entsprechenden Update-Anleitung.
• Erstellen Sie eine Sicherungskopie des kompletten Thieme Compliance Gateway Verzeichnisses.
• Falls das Thieme Compliance Gateway mit einer externen PostgreSQL Datenbank verbunden ist, erstellen Sie eine Sicherungskopie der Datenbank.
• Aktualisieren Sie das Thieme Compliance Gateway gemäß unten stehender Anleitung.
• Prüfen Sie, ob der E-ConsentPro Patient Workflow weiterhin erwartungsgemäß funktioniert.

Download der Installationsdatei

Die Datei zur Installation der aktuellen Version des Thieme Compliance Gateways finden Sie im E-ConsentPro Downloadbereich der Thieme Compliance Webseite: https://support.thieme-compliance.de/de/Installationsdateien.htm

Start der Installation

Entpacken Sie gegebenenfalls das heruntergeladene Zip-Archiv. Starten Sie den enthaltenen Installer. Für die Installation braucht der Installer Administrator-Rechte. Falls nötig wird Ihnen ein Dialog zur Eingabe von Administrator-Zugangsdaten angezeigt.

Konfiguration der Anbindung an E-ConsentPro

Wenn Sie von einer Version vor 9.0.0 aktualisieren, werden in diesem Dialog nicht die bisherigen Konfigurationseinstellungen angezeigt, sondern Beispielwerte. Tragen Sie in diesem Fall die Einstellungen neu ein. Entnehmen Sie die Werte bei Bedarf - mit Ausnahme des Tokens - der Datei config-application.yml in Ihrem Gateway-Verzeichnis, Abschnitt econsentpro. Falls Sie den unverschlüsselten Token nicht zur Verfügung haben, lassen Sie das Feld leer.

Konfiguration für den E-Mail Versand

Wenn Sie von einer Version vor 9.0.0 aktualisieren, werden in diesem Dialog nicht die bisherigen Konfigurationseinstellungen angezeigt, sondern Beispielwerte. Tragen Sie in diesem Fall die Einstellungen neu ein. Entnehmen Sie die Werte bei Bedarf - mit Ausnahme des Passworts - der Datei config-application.yml in Ihrem Gateway-Verzeichnis, Abschnitt email. Falls Sie das unverschlüsselte Passwort nicht zur Verfügung haben, lassen Sie das Feld leer.

Zugangsdaten für den Video-Server

Wenn Sie von einer Version vor 9.0.0 aktualisieren, werden in diesem Dialog nicht die bisherigen Konfigurationseinstellungen angezeigt, sondern Beispielwerte. Tragen Sie in diesem Fall die Einstellungen neu ein. Entnehmen Sie die Werte bei Bedarf - mit Ausnahme des Passworts - der Datei config-application.yml in Ihrem Gateway-Verzeichnis, Abschnitt video. Falls Sie das unverschlüsselte Passwort nicht zur Verfügung haben, lassen Sie das Feld leer.

Zugangsdaten für den SMS Service

Wenn Sie von einer Version vor 9.0.0 aktualisieren, werden in diesem Dialog nicht die bisherigen Konfigurationseinstellungen angezeigt. Wenn Sie den unverschlüsselten Token nicht zur Verfügung haben, lassen Sie das Feld leer.

Zugangsdaten für die E-ConsentPro Patient Cloud

Wenn Sie von einer Version vor 9.0.0 aktualisieren, werden in diesem Dialog nicht die bisherigen Konfigurationseinstellungen angezeigt. Wenn Sie den unverschlüsselten API Key nicht zur Verfügung haben, lassen Sie das Feld leer.

HTTPS-Zertifikat des E-ConsentPro Servers

Falls die Verbindung zum E-ConsentPro Server über HTTPS (nicht HTTP) stattfindet und der E-ConsentPro Server ein Self Signed Certificate verwendet, benötigt das Thieme Compliance Gateway während des Updates das HTTPS-Zertifikat (TLS/SSL-Zertifikat) des E-ConsentPro Servers erneut.

Standardmäßig befindet sich die Zertifikatsdatei auf dem E-ConsentPro Server im Verzeichnis C:\E-Consent-Pro\ca\certs.

Wenn die Verbindung über HTTP hergestellt wird oder ein öffentliches Zertifikat verwendet wird, geben Sie hier kein Zertifikat an.

Anders als der Dialog beschreibt werden nicht alle Zertifikate im certs Ordner automatisch als vertrauenswürdig konfiguriert. Das entsprechende Feature mit der Referenz PAT-1300 wird erst in einem künftigen Releases umgesetzt.

Zusammenfassung und Installation

Abschluss der Installation

Wenn die Fortschrittsanzeige den Wert 100% erreicht hat, sind alle Dateien im Zielverzeichnis installiert. Dann werden die Dienste des Thieme Compliance Gateways gestartet. Deswegen kann es unter Umständen wenige Minuten dauern, bis der abschließende Informationsdialog angezeigt wird.

Weitere benötigte Anpassungen der Konfiguration

Wenn Sie von einer Version vor 9.0.0 aktualisieren, dann wurden Ihre bisherigen Konfigurationsdateien config-application.yml und config-text-outgoing.yml automatisch umbenannt zu config-application.yml.OUTDATED.txt und config-text-outgoing.yml.OUTDATED.txt. Vergleichen Sie in dem Fall die Einträge in den *.OUTDATED.txt Dateien mit den Einträgen in den aktuellen Konfigurationsdateien config-application.properties und config-text-outgoing.properties und passen Sie die aktuellen Konfigurationsdateien entsprechend an:

Übertragen Sie in die Datei config-application.properties insbesondere die Einstellung database.password (hier müssen Sie den bisherigen Wert ersetzen) sowie alle Einstellungen für Token, Passwörter und API Keys, die Sie bei der Update-Installation leer gelassen haben (und die in der Konfigurationsdatei auch leer sind). Token, Passwörter und API Keys sind in der alten Konfigurationsdatei config-application.yml.OUTDATED.txt verschlüsselt gespeichert in der Form ENC(yxz...abc). Übertragen Sie sie genauso (einschließlich ENC und Klammern) in die neue Konfigurationsdatei. Checkliste:

• database.password
• econsentpro.token
• cloud.api-key
• email.password
• sms.api-key
• Eventuell: proxy.password
• video.password

Beispiele:

Übertragen Sie in die Datei config-text-outgoing.properties alle Einstellungen für E-Mail- und SMS-Texte aus der alten Konfigurationsdatei config-text-outgoing.yml.OUTDATED.txt. Beachten Sie dabei, dass in der neuen Konfigurationsdatei die Texte ohne umschließende Anführungszeichen konfiguriert werden.

Beispiele:

Starten Sie nach Änderungen in den Konfigurationsdateien den Thieme Compliance Gateway Dienst neu.

Prüfung der Funktionsfähigkeit

Prüfen Sie, ob in den Logdateien im Gateway-Verzeichnis Fehlermeldungen (ERROR) stehen: ThiemeComplianceGateway.out.log, und bei Bedarf auch install.log und ThiemeComplianceGateway.err.log.

Korrigieren Sie gegebenenfalls die relevanten Einstellungen (siehe unten Korrektur von Einstellungen).

Erstellen Sie in E-ConsentPro für einen Testpatienten eine neue Zuweisung "nach Hause". Verwenden Sie dafür einen Bogen, der auch verknüpfte Videos enthält, beispielsweise "Anästhesiologie ... / Allgemeinanästhesie / D-An1E - Allgemeinanästhesie ...". Geben Sie für den Testpatienten bei E-Mail und Mobiltelefon eine Adresse / Nummer ein, auf die Sie Zugriff haben.

Nach Erstellung der Zuweisung in E-ConsentPro kann es 1-2 Minuten dauern, bis Sie eine SMS und eine E-Mail an die angegebene Nummer bzw. Adresse erhalten. Falls nicht, prüfen Sie bitte die Logdatei ThiemeComplianceGateway.out.log und gegebenenfalls Ihren E-Mail Spam-Filter oder Spam-Ordner.

Falls Sie nach einer Korrektur der Einstellungen erneut eine Testzuweisung vornehmen, verwenden Sie dafür einen neuen Testpatienten (z.B. mit geänderter Patienten-ID).

Wenn Sie E-Mail und SMS erhalten, spielen Sie den E-ConsentPro Patient Workflow durch und prüfen Sie, dass die Anamnesedaten nach Abschluss in E-ConsentPro zur Verfügung stehen.

Korrektur von Einstellungen / erweiterte Einstellungen

Nach der Installation des Thieme Compliance Gateways können Sie die Konfigurationsdatei config-application.properties mit einem Texteditor öffnen um Einstellungen zu korrigieren und erweiterte Einstellungen vorzunehmen.

Änderungen an Einstellungen werden erst wirksam, nachdem Sie die Konfigurationsdatei gespeichert und den Thieme Compliance Gateway Dienst neu gestartet haben. Thieme Compliance empfiehlt, dass Sie nach jeder Änderung von Einstellungen und Neustart des Dienstes die Log-Datei ThiemeComplianceGateway.out.log auf Fehlermeldungen (ERROR) und Warnungen (WARN) überprüfen.

Nachträgliche Konfiguration des SSL Zertifikats für HTTPS

Nach der Installation können Sie das Zertifikat mittels des im Gateway-Verzeichnis befindlichen Skripts add-certificate.bat hinzufügen. Rufen Sie das Skript dafür mit dem Pfad zur Zertifikatsdatei als Parameter auf und beachten Sie die ausgegebenen Hinweise und Fehlermeldungen.

Deaktivierung der Sentry-Integration

Das Thieme Compliance Gateway sendet standardmäßig Monitoring-Daten an den Server sentry.thieme.de, um Thieme Compliance wichtige Statistik-Informationen zum Betrieb zur Verfügung zu stellen. Es werden weder Patientendaten noch sicherheitsrelevante Betriebsdaten übermittelt. Die Übermittlung kann ohne Nachteile für den Betrieb des Thieme Compliance Gateway deaktiviert werden, indem in der Konfigurationsdatei config-application.properties die Sentry-Konfiguration auf sentry.dsn= (ohne Angabe eines DSN-Ziels) gesetzt wird.

Support-Anfragen

Für die Analyse von Problemen im Zusammenhang mit dem Thieme Compliance Gateway benötigt Thieme Compliance eine Beschreibung der auftretenden Probleme und die Logdateien Ihres Thieme Compliance Gateways.

Gehen Sie am besten wie folgt vor:

• Erzeugen Sie eine neue E-ConsentPro Patient Test-Zuweisung auf die Art, die bei Ihnen zu Problemen führt. Verwenden Sie dabei eine neue Patienten-ID und Ihre eigene E-Mail-Adresse und Mobilfunknummer. Notieren Sie die Uhrzeit, wann Sie die Zuweisung erstellt haben (z.B. 16:32 Uhr).
• Falls Sie die SMS mit der PIN bekommen, notieren Sie dafür ebenfalls die Uhrzeit.
• Falls Sie die Mail mit dem Link bekommen, notieren Sie dafür ebenfalls die Uhrzeit.
• Wenn die Probleme die Übertragung der Antworten nach E-ConsentPro betreffen, spielen Sie den E-ConsentPro Patient Workflow durch und schließen Sie die Befragung ab. Notieren Sie dafür ebenfalls die Uhrzeit.
• Warten Sie mindestens fünf Minuten. Dabei spielt es keine Rolle, ob Sie die SMS und die Mail bekommen haben oder nicht.

• Senden Sie eine Beschreibung des Problems, die notierten Uhrzeiten und die folgenden Logdateien an support@thieme-compliance.de:

  • ThiemeComplianceGateway.out.log
  • ThiemeComplianceGateway.err.log
  • install.log
  • Die Logdateien der letzten drei Tage aus dem logs/ Verzeichnis