Systemweiter Admin
E-ConsentPro unterstützt verschiedene Integrationsszenarien.
Die nachfolgenden Teilprozesse werden durch die URL-Schnittstelle gegen die Endpunkte /ecp/redirect und /ecp/ecp unterstützt, wodurch die Applikation im Web-Browser mit den übergebenen Daten geöffnet wird.
Zusätzlich besteht die Möglichkeit die URL-Teilprozesse mit Teilprozessen der HL7-Schnittstelle zu kombinieren.
Hinweis
Bevor Sie mit der Konfiguration der URL-Schnittstelle Programmaufruf beginnen, beachten Sie bitte die allgemeinen Voraussetzungen unter URL-Schnittstelle konfigurieren.
|
Erläuterungen der URL-Bestandteile:
hostname_oder_ip
|
Hostname oder IP-Adresse des Server-Rechners, auf dem das E-ConsentPro Grundmodul installiert ist.
|
port
|
Port, unter dem das E-ConsentPro Grundmodul erreichbar ist. Der Port wird während der Installation von E-ConsentPro festgelegt. Die standardmäßig verwendeten Ports sind 8445 für HTTPS und 8082 für HTTP.
|
parameter
|
Liste von Parametern der Form parametername=wert. Die einzelnen Parameter werden mit dem Zeichen & voneinander getrennt.
|
Variante 1: POST-Request an /ecp/redirect (empfohlen)
Bei dieser Variante sind die übergebenen Parameter nicht in der Browser-Historie und nicht in der Adresszeile sichtbar. Aus diesem Grund empfehlen wir die Verwendung dieser Variante.
Bitte informieren Sie sich bei Ihrem PVS- bzw. KIS-Hersteller, ob POST-Requests unterstützt werden
Beispiel:
https://hostname_oder_ip:port/ecp/redirect?user=max.mustermann&password=qwertz
|
Der Beispielaufruf wird umgewandelt in einen anonymisierten Aufruf folgender Form:
https://hostname_oder_ip:port/ecp/ecp?pskey=4c50a36c-34fa-4727-9401-854972a3314f
|
Variante 2: GET-Request an /ecp/redirect
Bei dieser Variante sind die übergebenen Parameter in der Browser-Historie aber nicht in der Adresszeile sichtbar.
Wir empfehlen aus diesem Grund, die Historie des Web-Browsers zu deaktivieren.
Beispiel:
https://hostname_oder_ip:port/ecp/redirect?user=max.mustermann&password=qwertz
|
Der Beispielaufruf wird umgewandelt in einen anonymisierten Aufruf folgender Form:
https://hostname_oder_ip:port/ecp/ecp?pskey=4c50a36c-34fa-4727-9401-854972a3314f
|
Variante 3: GET Request an /ecp/ecp
Bei dieser Variante sind die übergebenen Parameter sowohl in der Browser-Historie als auch in der Adresszeile sichtbar.
Wir empfehlen diese Variante deshalb nicht für den Produktivbetrieb.
Beispiel:
https://hostname_oder_ip:port/ecp/ecp?user=max.mustermann&password=qwertz
|
Geänderte Patientendaten bei erneutem Programmaufruf
Hinweis:
Rufen Sie das Programm über die URL-Schnittstelle mit geänderten Patientendaten nach einer Bogenzuweisung erneut auf, so werden die Patientendaten des gewählten Patienten automatisch geändert.
Beispiel: Im Programmaufruf ist für den Patienten eine geänderte Adresse enthalten.
Im Programm erscheint eine Meldung, dass die Patientendaten aktualisiert wurden.
|
Das Nutzerprofil kann zusammen mit seinem Passwort für eine direkte Anmeldung an E-ConsentPro während des Aufrufs aus dem KIS übergeben werden.
Dadurch muss der Nutzer sich nicht in E-ConsentPro anmelden, sondern befindet sich direkt nach Aufruf in der Dokumentenübersicht.
Hinweis:
Bei der Verwendung der URL /ecp/ecp wird das Kennwort in der Adresszeile des Web-Browsers im Klartext angezeigt und in der Browser-Historie gespeichert.
Aus Datenschutzgründen empfehlen wir diese Variante nicht.
|
Folgende Informationen können in E-ConsentPro übernommen werden:
URL Query String
|
Verarbeitung der Information
|
user
|
Nutzername
|
password
|
Passwort zum Benutzer
|
Beispiel:
https://hostname_oder_ip:port/ecp/ecp?user=max.mustermann&password=qwertz
|
|
Ein noch nicht in E-ConsentPro vorhandener Nutzer kann während des Aufrufs aus dem KIS angelegt und direkt für eine Anmeldung verwendet werden.
Eine vorhandene Gruppe und ein vorhandener Mandant, denen der Nutzer zugeordnet werden soll, können ebenfalls übergeben werden.
Hierzu muss die Option Nicht existierende Nutzerprofile werden beim Aufruf über die URL-Schnittstelle automatisch angelegt unter Admin > Zugriffsverwaltung > Mandanten > Nutzerprofile aktiv sein.
Folgende Informationen können in E-ConsentPro übernommen werden:
URL Query String
|
Verarbeitung der Information
|
user
|
Nutzername
|
password
|
Passwort zum Benutzer
|
g
|
Gruppe des Benutzers in E-ConsentPro
|
m
|
Mandant des Benutzers in E-ConsentPro
|
Beispiel:
https://hostname_oder_ip:port/ecp/redirect?user=max.mustermann&password=qwertz&g=AN&m=Musterpraxis
|
|
Eine Bestellung dient als zusätzliches Gruppierungselement für Information, ähnlich wie ein Aufenthalt, um diese einem Patienten zuzuordnen.
Die Bestellung wird anhand einer Bestellnummer, in Form der Placer Order Number, aus dem KIS entgegengenommen und in der HL7-Kommunikation verwendet.
Bestellung per URL Query String anlegen
Ein Vorgang mit Bestellung kann direkt aus dem KIS bei Aufruf von E-ConsentPro angelegt werden. Patienten-, Fall und Bestellinformationen können im Aufruf per URL Query String übergeben werden.
Folgende Informationen können in E-ConsentPro übernommen werden:
•Patienteninformationen
•Fallinformationen
•Vertreterinformationen
•Nutzerinformationen
•Weitere Informationen
Bestellung per HL7 OMG_O19 anlegen
Ein Vorgang mit Bestellung kann aus dem KIS heraus per HL7 OMG_O19-Nachricht in E-ConsentPro angelegt werden.
Siehe hierzu die HL7 v2-Schnittstelle.
Dem Aufruf per URL Query String muss die vom KIS vergebene Bestellnummer übergeben werden, um die Session mit dem Bestellvorgang zu verknüpfen.
https://hostname_oder_ip:port/ecp/redirect?id=20190110P00156&ln=Musterfrau&fn=Erika&ti=Dr.&bd=01.01.1960&adr=Musterstraße%20456&cit=Musterstadt&plz=12345&cn=20190110F00067&orderID=20190110A00025&rln=Meyer&rfn=Anna&rbd=01.01.1970&rrl=Bevollmaechtigter&ident=DAn1E&costcategory=URO&opId=AMBCHIR
|
|
Ein Vorgang ohne Bestellung kann direkt bei Aufruf von E-ConsentPro aus dem KIS angelegt werden. Hierzu können Patienten-, Fall- und Bestellinformationen im Aufruf per URL Query String gesendet werden.
Weitere Informationen zu den unterstützten Parametern finden Sie unter Vorgang mit Bestellung anlegen.
|
Ein Dokument kann aus dem KIS heraus während der Anlage der Bestellung vorgeblendet und anschließend in E-ConsentPro zugewiesen werden. Hierzu wird das Dokumentenkürzel des gewünschten Dokuments entweder als Teil des URL Query String oder als Teil der HL7 OMG_O19-Nachricht übergeben.
Weitere Informationen zu den unterstützten Parametern finden Sie unter Vorgang mit Bestellung anlegen.
|
Siehe auch:
Beispielaufrufe
Wo sind die übergebenen Daten zu sehen?
Unterstützte Parameter
