Navigation: Administration > Schnittstellen > HL7v2-Schnittstelle Unterstützte Teilprozesse und deren Konfiguration |
Scroll Zurück Haupt Vor Mehr |
Admin
E-ConsentPro unterstützt verschiedene Integrationsszenarien. Die nachfolgenden Teilprozesse werden durch die HL7-Schnittstelle unterstützt.
Zusätzlich besteht die Möglichkeit, die HL7-Teilprozesse mit Teilprozessen der URL-Schnittstelle zu kombinieren.
Dieser Abschnitt enthält eine Beschreibung der erweiterten ecp.config-Parameter, die für die HL7- Schnittstelle relevant sind.
Eine Bestellung dient als zusätzliches Gruppierungselement für Informationen, ä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 HL7 OMG_O19 anlegen Ein Vorgang mit Bestellung kann aus dem KIS heraus in E-ConsentPro angelegt werden. Hierzu können Patienten-, Fall- und Bestellinformationen vom KIS per HL7 OMG_O19-Nachricht an E-ConsentPro gesendet werden. E-ConsentPro kann vor oder nach dem Senden der HL7 OMG_O19-Nachricht geöffnet werden. Dem Aufruf per URL Query String muss die vom KIS vergebene Bestellnummer übergeben werden, um die Session mit dem Bestellvorgang zu verknüpfen.
Bestellung per URL Query String anlegen Wenn keine OMG_O19-Anbindung gewünscht ist, kann ein Vorgang mit Bestellung 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. Patienteninformationen Für Patienteninformationen wird das PID-Segment der OMG_O19-Nachricht ausgewertet. Alternativ können die Patienteninformationen per URL Query String übergeben werden. Folgende Informationen können in E-ConsentPro übernommen werden:
Fallinformationen Für Fallinformationen wird das PV1-Segment der OMG_O19 Nachricht ausgewertet. Alternativ können Fallinformationen per URL Query String übergeben werden. Folgende Information können in E-ConsentPro übernommen werden:
Auftragsinformationen Für Auftragsinformationen wird das ORC-Segment der OMG_O19-Nachricht ausgewertet. Alternativ werden Auftragsinformationen per URL Query String übergeben. Folgende Informationen können in E-ConsentPro übernommen werden:
|
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. |
Eine Statusnachricht zu der erfolgreichen Anlage des Patientendatensatz kann per HL7 OMG_O19- oder ORU_R01-Nachricht an das KIS kommuniziert werden. Konfiguration Senden einer OMG_O19-Nachricht nach Anlage eines neuen Vorgangs in E-ConsentPro:
Senden einer ORU_R01-Nachricht nach Anlage eines neuen Vorgangs in E-ConsentPro:
Die Werte der Felder Receiving Application und Receiving Facility im MSH-Segment ausgehender HL7-Nachrichten stammen aus den Feldern Sending Application und Sending Facility der für die Bestellung erhaltenen OMG_O19-Nachricht. Wenn für den aktuellen Vorgang keine OMG_O19-Nachricht erhalten wurde, kann die im MSH-Segment zu verwendende Receiving Application und Receiving Facility konfiguriert werden.
|
Eine in E-ConsentPro angelegte Bestellung kann aus dem KIS heraus storniert werden. Hierzu wird eine HL7 OMG_O19-Nachricht zu der vom KIS erstellten Bestellnummer an E-ConsentPro gesendet. Alle der Bestellung zugewiesenen Dokumente werden storniert und der Patientendatensatz in E-ConsentPro gelöscht. |
Ein Dokument kann aus dem KIS heraus während der Anlage der Bestellung vorgeblendet werden. Hierzu wird das Dokumentenkürzel des Dokuments entweder als Teil der HL7 OMG_O19-Nachricht oder als URL Query String im Aufruf übergeben. Pro Dokument kann eine eindeutige Dokumentennummer durch E-ConsentPro generiert werden. Dadurch kann auf ein in E-ConsentPro erstelltes Dokument aus dem KIS heraus referenziert werden. Die Dokumentennummer wird in Form der Filler Order Number an das KIS übergeben und in der HL7-Kommunikation verwendet. Konfiguration Aktiviert oder deaktiviert die Erzeugung einer Dokumentennummer:
Das Format der Dokumentennummer legen folgende Parameter fest: ▪Muster, nach dem die Dokumentennummer erzeugt wird. Das Muster muss genau einen zusammenhängenden Ziffernblock der Form ###### enthalten. Der Ziffernblock steht für den erzeugten numerischen Wert. Die Anzahl der Nummernzeichen # bestimmt, wie viele führende Nullen gegebenenfalls eingefügt werden. Optional können dem Ziffernblock beliebige alphanumerische Zeichen vorangestellt und angehängt werden. Die Bestellnummer kann ebenfalls Teil des Musters sein.
▪Startwert der erzeugten Dokumentnummer. E-ConsentPro beginnt mit dem angegebenen Wert und erhöht diesen jeweils um 1.
▪Höchstwert der erzeugten Dokumentnummer. Wenn der Höchstwert erreicht ist, können keine neuen Dokumentnummern erzeugt werden. E-ConsentPro gibt eine entsprechende Fehlermeldung aus.
|
Ein Dokument kann aus dem KIS heraus während der Anlage des Vorgangs vorgeblendet und anschließend in E-ConsentPro zugewiesen werden. Mit der Zuweisung kann eine Statusnachricht per HL7 OMG_O19 oder ORU_R01 an das KIS kommuniziert werden. Konfiguration Senden einer OMG_O19-Nachricht nach Zuweisung eines Dokuments:
Senden einer ORU_R01-Nachricht nach Zuweisung eines Dokuments:
Wenn für den aktuellen Vorgang keine OMG_O19-Nachricht erhalten wurde, kann die im MSH-Segment zu verwendende Receiving Application und Receiving Facility konfiguriert werden:
|
Ein Dokument kann aus dem KIS heraus storniert werden. Hierzu wird eine HL7 OMG_O19-Nachricht zu der von E-ConsentPro erstellten Dokumentennummer an E-ConsentPro gesendet. |
Ein Dokument kann aus dem KIS heraus storniert werden. Mit dem Storno kann eine Statusnachricht per HL7 OMG_O19 oder ORU_R01 an das KIS kommuniziert werden. Konfiguration Senden einer OMG_O19-Nachricht nach Storno des zugewiesenen Dokuments per OMG_O19:
Senden einer ORU_R01-Nachricht nach Storno des zugewiesenen Dokuments per OMG_O19:
Wenn für den aktuellen Vorgang keine OMG_O19-Nachricht erhalten wurde, kann die im MSH-Segment zu verwendende Receiving Application und Receiving Facility konfiguriert werden:
|
Beispiel: Statusnachricht "Dokument in E-ConsentPro storniert" |
Ein Dokument kann in E-ConsentPro manuell storniert werden. Mit dem Storno kann eine Statusnachricht per HL7 OMG_O19 oder ORU_R01 an das KIS kommuniziert werden. Konfiguration Senden einer OMG_O19-Nachricht nach manuellem Storno des zugewiesenen Dokuments in E-ConsentPro:
Senden einer ORU_R01-Nachricht nach manuellem Storno des zugewiesenen Dokuments in E-ConsentPro:
Wenn für den aktuellen Vorgang keine OMG_O19-Nachricht erhalten wurde, kann die im MSH-Segment zu verwendende Receiving Application und Receiving Facility konfiguriert werden:
|
Wenn ein Dokument einen Fragenkatalog enthält, kann dieser in der App "Anamnese mobil“ mit E-ConsentPro ausgefüllt werden. Mit dem Ausfüllen des Fragenkatalogs kann eine Statusnachricht per HL7 OMG_O19 oder ORU_R01 an das KIS gesendet werden. Konfiguration Senden einer OMG_O19-Nachricht nach Abschließen des Fragenkatalogs in der App "Anamnese mobil“ mit E-ConsentPro:
Senden einer ORU_R01-Nachricht nach Abschließen des Fragenkatalogs in der App "Anamnese mobil“ mit E-ConsentPro:
Wenn für den aktuellen Vorgang keine OMG_O19-Nachricht erhalten wurde, kann die im MSH-Segment zu verwendende Receiving Application und Receiving Facility konfiguriert werden:
|
Ein Dokument kann in der App "Aufklärung mobil“ mit E-ConsentPro zur Wiedervorlage geplant werden. Mit dem Planen zur Wiedervorlage kann eine Statusnachricht per HL7 OMG_O19 oder ORU_R01 an das KIS gesendet werden. Konfiguration Senden einer OMG_O19-Nachricht nach Setzen eines Dokuments zur Wiedervorlage in der App "Aufklärung mobil“ mit E-ConsentPro:
Senden einer ORU_R01-Nachricht nach Setzen eines Dokuments zur Wiedervorlage in der App "Aufklärung mobil“ mit E-ConsentPro:
Wenn für den aktuellen Vorgang keine OMG_O19-Nachricht erhalten wurde, kann die im MSH-Segment zu verwendende Receiving Application und Receiving Facility konfiguriert werden:
|
Ein Dokument kann in der App "Aufklärung mobil“ mit E-ConsentPro und in der App "E-DocumentPro“ zur Einwilligung unterschrieben werden. Mit der Unterschrift zur Einwilligung kann eine Statusnachricht per HL7 OMG_O19, oder ORU_R01 ans das KIS gesendet werden. Konfiguration Senden einer OMG_O19-Nachricht nach Unterschrift der Einwilligung auf dem PDF-Dokument für das unterschriebene Dokument:
Senden einer ORU_R01-Nachricht nach Unterschrift der Einwilligung auf dem PDF-Dokument für das unterschriebene Dokument:
Wenn für den aktuellen Vorgang keine OMG_O19-Nachricht erhalten wurde, kann die im MSH-Segment zu verwendende Receiving Application und Receiving Facility konfiguriert werden:
|
Alternativ kann dem Dokument in der Arbeitsliste Patient manuell der Zustand Vorgang abgeschlossen (Ausdruck und Unterschrift auf Papier erfasst) zugewiesen werden. Mit der Unterschrift zur Einwilligung kann eine Statusnachricht per HL7 OMG_O19 oder ORU_R01 an das KIS gesendet werden. Konfiguration Senden einer OMG_O19-Nachricht nach manuellem Abschließen des zugewiesenen Dokuments in E-ConsentPro:
Senden einer ORU_R01 Nachricht nach manuellem Abschließen des zugewiesenen Dokuments in E-ConsentPro:
Wenn für den aktuellen Vorgang keine OMG_O19-Nachricht erhalten wurde, kann die im MSH-Segment zu verwendende Receiving Application und Receiving Facility konfiguriert werden:
|
Ein Dokument kann in der App "Aufklärung mobil“ mit E-ConsentPro und in der App "E-DocumentPro“ zur Ablehnung unterschrieben werden. Alternativ kann dem Dokument in der Arbeitsliste Patient manuell der Zustand Vorgang abgeschlossen (Ausdruck und Unterschrift auf Papier erfasst) zugewiesen werden. Mit der Unterschrift zur Ablehnung kann eine Statusnachricht per HL7 OMG_O19 oder ORU_R01 an das KIS gesendet werden. Konfiguration Senden einer OMG_O19-Nachricht nach Unterschrift zur Ablehnung auf dem PDF-Dokument für das unterschriebene Dokument:
Senden einer ORU_R01-Nachricht nach Unterschrift zur Ablehnung auf dem PDF-Dokument für das unterschriebene Dokument:
Wenn für den aktuellen Vorgang keine OMG_O19-Nachricht erhalten wurde, kann die im MSH-Segment zu verwendende Receiving Application und Receiving Facility konfiguriert werden:
|
Ein Dokument kann nach erfolgter Unterschrift an das KIS per MDM_T01-Nachricht übertragen werden. Hierzu wird das Dokument als PDF-Datei im Dateisystem abgelegt und vom KIS abgeholt. Konfiguration Für das Feld TXA.3 Document Content Presentation können Sie generell einen eigenen Wert konfigurieren:
Für das Feld und die Komponente TXA.5.1 Primary Activity Provide Code.Person Identifier können Sie generell einen eigenen Wert konfigurieren:
Für das Feld TXA.13 Parent Document Number können Sie generell einen eigenen Wert konfigurieren:
Senden einer MDM_T01-Nachricht mit dem Dokument nach Unterschrift zur Einwilligung auf dem Dokument:
Senden einer MDM_T01-Nachricht mit dem Protokoll zum Dokument nach Unterschrift zur Einwilligung auf dem Dokument:
Senden einer MDM_T01-Nachricht mit dem Dokument nach Unterschrift zur Ablehnung auf dem Dokument:
Senden einer MDM_T01-Nachricht mit dem Protokoll zum Dokument nach Unterschrift zur Ablehnung auf dem Dokument:
Senden einer MDM_T01-Nachricht mit der separaten Empfangsbestätigung einer Patientenkopie des Dokuments nach Unterschrift der separaten Empfangsbestätigung:
Senden einer MDM_T01-Nachricht mit einem separaten Anmerkungsdokument zu dem ursprünglichen, bereits ans KIS gesendeten Dokument nach Unterschrift der Anmerkung:
Für das Feld und die Komponente TXA.2.1 Document Type.Identifier können Sie pro Ereignis einen eigenen Wert konfigurieren:
Wenn für den aktuellen Vorgang keine OMG_O19-Nachricht erhalten wurde, kann die im MSH-Segment zu verwendende Receiving Application und Receiving Facility konfiguriert werden:
|
Ein Dokument kann nach erfolgter Unterschrift an das KIS per MDM_T02-Nachricht als PDF-Datei in Netzwerkfreigabe übertragen werden. Das Dokument kann als PDF-Datei im Dateisystem abgelegt und vom KIS abgeholt werden. Konfiguration Für das Feld TXA.3 Document Content Presentation können Sie generell einen eigenen Wert konfigurieren:
Für das Feld und die Komponente TXA.5.1 Primary Activity Provide Code.Person Identifier können Sie generell einen eigenen Wert konfigurieren:
Für das Feld TXA.13 Parent Document Number können Sie generell einen eigenen Wert konfigurieren:
Senden einer MDM_T02-Nachricht mit dem Dokument nach Unterschrift zur Einwilligung auf dem Dokument:
Senden einer MDM_T02-Nachricht mit dem Protokoll zum Dokument nach Unterschrift zur Einwilligung auf dem Dokument:
Senden einer MDM_T02-Nachricht mit dem Dokument nach Unterschrift zur Ablehnung auf dem Dokument:
Senden einer MDM_T02-Nachricht mit dem Protokoll zum Dokument nach Unterschrift zur Ablehnung auf dem Dokument:
Senden einer MDM_T02-Nachricht mit der separaten Empfangsbestätigung einer Patientenkopie des Dokuments nach Unterschrift der separaten Empfangsbestätigung:
Senden einer MDM_T02-Nachricht mit einem separaten Anmerkungsdokument zu dem ursprünglichen, bereits ans KIS gesendeten Dokument nach Unterschrift der Anmerkung:
Senden einer MDM_T02-Nachricht nachdem ein für "E-ConsentPro Patient" zugewiesener Bogen vom Patienten ausgefüllt und abgeschlossen wurde. Der Bogen besitzt den Status "Archiviert". Ein PDF kann erstellt werden:
Für das Feld und die Komponente TXA.2.1 Document Type.Identifier können Sie pro Ereignis einen eigenen Wert konfigurieren:
Wenn für den aktuellen Vorgang keine OMG_O19-Nachricht erhalten wurde, kann die im MSH-Segment zu verwendende Receiving Application und Receiving Facility konfiguriert werden:
|
Das Dokument kann Base64-kodiert in der HL7-Nachricht eingebettet werden. Konfiguration Die grundlegende Konfiguration für eine Base64-Übertragung ist analog zur Übertragung als PDF-Datei in Netzwerkfreigabe. Einbetten des Dokuments Base64-kodiert in der MDM_T02-Nachricht:
|
Pro abgeschlossenem Dokument kann eine Abrechnungsinformation per HL7 DFT_P03 ans KIS gesendet werden. Konfiguration Senden einer DFT_P03-Nachricht nach Unterschrift zur Einwilligung auf dem PDF-Dokument:
Senden einer DFT_P03-Nachricht nach Unterschrift zur Ablehnung auf dem PDF-Dokument:
Senden einer DFT_P03-Nachricht nach manuellem Abschließen des zugewiesenen Dokuments in E-ConsentPro:
Wenn für den aktuellen Vorgang keine OMG_O19-Nachricht erhalten wurde, kann die im MSH-Segment zu verwendende Receiving Application und Receiving Facility konfiguriert werden:
|
Ungelöschte OMG_O19-Aufträge belegen in der Datenbank im Laufe der Zeit immer mehr Speicherplatz. Die Folge davon ist, dass der Speicherplatz vom Administrator regelmäßig vergrößert werden muss. Abhilfe für dieses Anhäufen von OMG_O19-Aufträgen besteht in Form zweier Bereinigungsaufträge: •cleanup.oldOMGOrders.cron •cleanup.oldOMGOrders.maxAge Mit Hilfe dieser Bereinigungsaufträge können in der ecp.config ungelöschte OMG_O19-Aufträge eines frei definierbaren Alters gelöscht werden. Beispiel:
|
HL7-Nachrichten werden vom empfangenden System mit einer Rücknachricht quittiert, dem sogenannten "Acknowledgement". Diese Nachricht enthält einen Quittierungswert (Acknowledgement Code), der anzeigt, ob das empfangende System die Nachricht erfolgreich verarbeiten konnte. Laut HL7-Standard sind folgende Quittierungswerte erlaubt:
Abhängig vom Quittierungswert reagiert "E-ConsentPro" unterschiedlich auf den Empfang des Acknowledgements: •Bei AA und CA gilt die Nachricht als erfolgreich verarbeitet und der Versand ist für "E-ConsentPro" damit abgeschlossen. •Bei allen anderen Codes gilt die Nachricht als nicht erfolgreich verarbeitet. Die Nachricht wird in eine Warteschleife gestellt und regelmäßig neu versendet, bis eine positive Rückmeldung zurückkommt. Wenn Sie möchten, dass "E-ConsentPro" die Quittierungswerte anders interpretiert, können Sie dazu den Parameter hl7.msa.1.successcodes verwenden. Hier können Sie kommasepariert alle Quittierungswerte aufzählen, die von "E-ConsentPro" als Erfolg gewertet werden sollen. Alle anderen Werte gelten dann als gescheiterter Versand. Beispiel: Sie möchten, dass neben den Werten AA und CA auch die Werte AE und CE als positiv angesehen werden.
Mit dieser Einstellung werden nur noch Rückmeldungen mit den Werten AR und CR in die Warteschleife gestellt. |
Für die Übertragung der Basisanamnese müssen folgende Parameter in die ecp.config eingefügt werden:
Dateiübertragung per MDM T01:
Dateiübertragung per MDM T02:
|
Für die Aktivierung einer automatischen Archivierung unvollständiger Bögen sind folgende Tätigkeiten notwendig: 1.Aktivieren Sie in der Zugriffsverwaltung des Mandanten die Option Unvollständige Bögen archivieren. Diese Option finden Sie auf dem Reiter Digitaler Workflow/Arbeitsliste Patient. 2.Ergänzen Sie die ecp.config um folgenden Parameter:
3.Starten Sie in der Windows-Diensteverwaltung den Dienst E-ConsentPro-Server neu, damit die neuen Einstellungen übernommen werden. Ab dem Zeitpunkt werden alle unvollständigen Bögen vor der Löschung aus der Arbeitsliste Patient archiviert. |
Impressum | Datenschutz | Kontakt | © Thieme Compliance GmbH 2024