Sobald Ihre NABIDH-Verbindung konfiguriert, zugeordnet und aktiviert ist, behandelt dieser Leitfaden die operative Seite: das Senden von Testereignissen, das Lesen des Übermittlungsprotokolls, das Verständnis von Wiederholungsversuchen und die Behebung der Fehler, denen Sie am wahrscheinlichsten begegnen.
Dieser Artikel ist Teil der NABIDH-Leitfadenserie:
- Teil 1: Was ist NABIDH und wie verbindet sich Pabau damit
- Teil 2: Pabau mit NABIDH verbinden
- Teil 3: Ihre Daten für NABIDH zuordnen
- Teil 4: Auswählen, welche Ereignisse an NABIDH gesendet werden
- Teil 5: NABIDH-Übermittlungen testen, überwachen und Probleme beheben (Sie befinden sich hier)
- Teil 6: NABIDH-Fehlercodes und Übermittlungsstatus
- Teil 7: Referenz der NABIDH-Codetabellen
Schritt 1: Ein Testereignis senden
Die Schaltfläche Testereignis senden befindet sich auf der Registerkarte 3. Zuordnung der Verbindung. Sie wählt einen zufälligen passenden Datensatz aus Ihrem Konto aus und sendet ihn durch die Live-Pipeline — genau das, was das echte Ereignis senden würde — und kennzeichnet die Übermittlung im Protokoll als Test.
- Klicken Sie auf Testereignis senden, wählen Sie das zu testende Ereignis aus (z. B. client.create → Patient hinzufügen (ADT^A28)) und klicken Sie auf Test senden.
- Öffnen Sie Protokolle und deaktivieren Sie Tests ausblenden, um die eingehende Übermittlung zu sehen.
- Öffnen Sie die Übermittlung, um die genaue gesendete HL7-Nachricht und die Antwort von NABIDH zu prüfen.
HINWEIS: Tests verwenden echte Datensätze und werden tatsächlich an den konfigurierten Endpunkt übermittelt. Wenn für das gewählte Ereignis kein geeigneter Datensatz vorhanden ist (z. B. ein Besuchstest ohne geeigneten Termin), teilt Ihnen Pabau genau mit, was zuerst angelegt werden muss. Destruktive Tests — Patient löschen und zusammenführen — sind nur bei Verbindungen mit Dummy-Umgebung zulässig, sodass ein Test niemals einen echten Patienten aus dem Austausch löschen kann.
Schritt 2: Das Übermittlungsprotokoll lesen
Klicken Sie im Verbindungskopf auf Protokolle. Jede Übermittlung wird mit Auslöser, Aktion, Datensatz, Status und Anzahl der Versuche aufgeführt, und ein Rückstandsbalken oben zeigt an, was gerade in der Warteschlange steht, verarbeitet, erneut versucht oder als unzustellbar markiert wird.
Sie können nach Status, Objekt und Auslöser filtern, nach Datensatz oder Korrelations-ID suchen, den Datumsbereich einschränken, neue Übermittlungen mit Live live verfolgen und alles mit CSV exportieren herunterladen. Übermittlungsstatus:
- In Warteschlange / Wird verarbeitet — wartet auf oder befindet sich gerade in einem Sendeversuch.
- Erfolgreich — NABIDH hat die Nachricht akzeptiert.
- Wiederholung geplant — ein vorübergehender Fehler; Pabau versucht es automatisch erneut.
- Fehlgeschlagen — ein dauerhafter Fehler (meist Validierung); es wird nicht automatisch wiederholt.
- Unzustellbar — nach Ausschöpfen aller automatischen Wiederholungsversuche aufgegeben; kann dennoch manuell erneut ausgeführt werden.
Schritt 3: Eine Übermittlung prüfen
Klicken Sie auf eine beliebige Zeile, um die Detailansicht der Übermittlung zu öffnen. Für jeden Versuch können Sie die genaue Anfrage (die rohe HL7-Nachricht) und Antwort (die Bestätigung von NABIDH) einsehen, beides kopieren und die Korrelations-ID für Support-Gespräche einsehen. Ein Bereich Spezifikationskonformität prüft jeden Versuch anhand der DHA-NABIDH-HL7-v2.5.1-Spezifikation und listet alle Feststellungen mit dem Verweis auf die Spezifikation sowie einer Erklärung „So beheben Sie das Problem" auf — dies ist der schnellste Weg, eine Ablehnung zu verstehen.
HINWEIS: NABIDH beantwortet jede Nachricht mit einer HL7-Bestätigung: AA bedeutet akzeptiert, während AE/AR bedeuten, dass die Nachricht durch die eigene Validierung von NABIDH abgelehnt wurde — der von NABIDH zurückgegebene Diagnosetext wird beim jeweiligen Versuch angezeigt.
Schritt 4: Eine Übermittlung wiederholen
Vorübergehende Fehler (Netzwerkprobleme, kurzzeitige Nichtverfügbarkeit von NABIDH, Ratenbegrenzung) werden automatisch mit zunehmenden Verzögerungen wiederholt — beginnend bei 30 Sekunden und sich verdoppelnd bis zu einer Obergrenze von 6 Stunden, für bis zu 8 Versuche, bevor die Übermittlung als unzustellbar markiert wird. Dauerhafte Fehler (Validierung, Ablehnungen) werden nicht automatisch wiederholt. Über die Detailansicht der Übermittlung stehen Ihnen zwei manuelle Optionen zur Verfügung:
- Ursprüngliche Nutzlast erneut senden — sendet die exakte ursprüngliche Nachricht erneut, Byte für Byte. Verwenden Sie dies, wenn das Problem auf der Empfängerseite lag.
- Neueste Daten synchronisieren — liest den Datensatz erneut ein, erstellt die Nachricht mit den aktuellen Daten und der aktuellen Zuordnung neu und sendet diese. Verwenden Sie dies, nachdem Sie den Datensatz oder die Zuordnung korrigiert haben.
Schritt 5: Häufige Fehler beheben
- Validierung — dem Datensatz fehlt etwas, das NABIDH benötigt. Die Nachricht nennt das Feld: am häufigsten eine fehlende Emirates-ID bei einem Einwohner von Dubai, ein fehlendes Geburtsdatum oder fehlende Kontaktdaten, eine Leistung ohne NABIDH-Fachrichtung oder ein Behandler ohne Sheryan-Lizenz. Korrigieren Sie den Datensatz (oder die Zuordnung aus Teil 3) und wählen Sie dann Neueste Daten synchronisieren.
- Abgelehnt — die eigene Validierung von NABIDH hat die Nachricht abgelehnt (eine AE/AR-Bestätigung oder eine 4xx-Antwort). Öffnen Sie den Bereich Spezifikationskonformität und die Antwortdiagnose, um den Grund zu erfahren.
- Authentifizierung — NABIDH akzeptiert Ihren Anwendungsschlüssel nicht mehr. Ersetzen Sie ihn in der Karte „Anmeldedaten" auf der Registerkarte Einstellungen.
- Konfiguration — der Endpunkt oder die Verbindungseinstellungen sind falsch. Überprüfen Sie diese erneut auf der Registerkarte Einstellungen und verwenden Sie Verbindung testen.
- Netzwerk / Zielfehler / Ratenbegrenzung — vorübergehende Probleme auf dem Weg zu NABIDH; diese werden automatisch wiederholt und lösen sich normalerweise von selbst.
Schritt 6: Einen unbekannten Code nachschlagen
Die beiden Referenzartikel am Ende dieser Serie sind für die Momente gedacht, in denen das Protokoll Ihnen etwas Unbekanntes anzeigt:
- Teil 6: NABIDH-Fehlercodes und Übermittlungsstatus — jeder Übermittlungsstatus und jedes Fehlersymbol, der genaue Wiederholungsplan, wie man eine AA/AE/AR-Bestätigung und eine Antwort des DHA-Testtools liest, sowie eine feldweise Liste dessen, was in Pabau für jede mögliche Feststellung zu korrigieren ist.
- Teil 7: Referenz der NABIDH-Codetabellen — alle 25 NABIDH-Codetabellen im vollen Umfang. Wenn eine Ablehnung besagt, dass ein Wert „invalid against NAB002" ist, finden Sie hier heraus, dass NAB002 den Familienstand betrifft und welche Werte NABIDH akzeptiert.
TIPP: Behalten Sie gelegentlich den Rückstandsbalken oben im Protokoll im Auge — „Nichts in der Warteschlange — Übermittlungen laufen." ist der gesunde Zustand. Eine wachsende Anzahl von Wiederholungen oder unzustellbaren Nachrichten ist Ihr Signal, den jüngsten Fehler zu öffnen und dessen Konformitätsfeststellungen zu lesen.