Überblick über Zurückschreiben für Dataverse Healthcare APIs

  • Artikel

Die Dataverse Healthcare API erleichtert das Einbinden von FHIR-Daten in Dataverse. Nachdem die Daten in Dataverse verfügbar sind, können die Benutzer die neuen Datensätze aktualisieren, z.B. einige der demografischen Informationen des Patienten. Mit der Rückschreiblösung für Dataverse Healthcare APIs können diese Änderungen an den ursprünglichen FHIR-Server zurückgesendet werden.

Der Lösungsansatz bietet eine gewisse Erweiterbarkeit des Rückschreibprozesses. Die Writeback-Konfiguration kann auch auf einen alternativen Endpunkt abzielen, wenn Benutzer eine angepasste Logik in diesen Prozess einfügen müssen. Zum Beispiel kann eine angepasste Azure Logic-App für die ausgehende Nachricht vorgesehen werden, die eine zusätzliche Verarbeitung oder Weiterleitung durchführt.

Das folgende Diagramm zeigt den gesamten Rückschreibeprozess:

Ein Diagramm, das die Übersicht über den Rückschreibprozess zeigt.

Die Standardprozessschritte lauten wie folgt:

  1. Der Benutzer aktualisiert einen Datensatz in Dataverse​.
  2. Dataverse wertet die Änderung aus und erstellt eine neue FHIR-Ressource, die an die FHIR-API Endpunkt gesendet wird.
  3. Der FHIR Endpunkt verarbeitet die FHIR-Ressource und gibt die Ergebnisantwort des Vorgangs zurück an Dataverse​.
  4. Dataverse protokolliert die Betriebsergebnisse in den Datenintegrations-Toolkit-Protokollen. Der Administrator kann hier alle Fehler überprüfen.

Um die Erweiterbarkeit zu gewährleisten, können Benutzer bei Bedarf einen alternativen Rückschreibansatz angeben.

  1. Dataverse sendet die FHIR-Ressourcenanforderung an den benutzerdefinierten Endpunkt​.
  2. Der benutzerdefinierte Endpunkt ist für die Verarbeitung der geposteten FHIR-Ressource und das Senden an die FHIR-API verantwortlich.
  3. Der Benutzer ist für die Protokollierung der Betriebsergebnisse verantwortlich, sodass der Administrator alle Fehler überprüfen kann, während Daten an den benutzerdefinierte Endpunkt gesendet werden.

Ein FHIR Herkunfts-Datensatz wird auch an den FHIR Endpunkt gesendet, wenn das Rückschreibe-Ereignis verarbeitet wird. Die Herkunftsressource verfolgt Informationen über die Aktivität, die eine Version einer Ressource erstellt, überarbeitet, gelöscht oder signiert hat, und beschreibt die beteiligten Entitäten und Agenten. Anhand dieser Informationen können Sie Aussagen über deren Qualität, Zuverlässigkeit oder Vertrauenswürdigkeit treffen. Es enthält auch Hinweise, wohin Sie gehen können, um die Ursprünge der Ressource und der darin enthaltenen Informationen weiter zu untersuchen.

Weitere Informationen zur FHIR-Herkunft finden Sie unter FHIR-Ressourcenherkunft.

Rückschreiben aktivieren

Das Aktivieren des Rückschreibevorgangs umfasst die folgenden drei Hauptschritte:

  1. Verbindungsdetails angeben
  2. Entitätszuordnungen aktualisieren
  3. Zustimmung des Patienten anwenden

Verbindungsdetails angeben

Der erste Schritt zum Konfigurieren des Rückschreibens besteht darin, die Konnektivitätsdetails für den FHIR-Endpunkt bereitzustellen, der die veröffentlichten FHIR-Ressourcen empfängt. Sie finden diese Konfigurationswerte im Abschnitt Datenintegrations-Toolkit Integrationseinstellungen .

Weitere Informationen zu diesen Einstellungen finden Sie unter Integrationseinstellungen für Dataverse Healthcare APIs.

Entitätszuordnungen aktualisieren

Nachdem die Konnektivitätsdetails bereitgestellt wurden, besteht der nächste Schritt darin, die Entitätszuordnungen zu aktualisieren, die steuern, welche FHIR-Ressourcen am Rückschreibeprozess teilnehmen sollen.

Die Rückschreiben-Plug-Ins verwenden dieselben Entitätszuordnungen, die für die Upsert-API konfiguriert sind. Jede Entitätszuordnung kann ein Attribut mit dem Titel Rückschreiben zu FHIR aktivieren enthalten. Wenn dieser Attributwert auf Ja gesetzt ist, veröffentlichen die Rückschreibe-Plug-Ins Aktualisierungen für die ausgewählte Dataverse-Tabelle im FHIR-Endpunkt. Dieser Prozess ermöglicht eine granulare, tabellenweise Kontrolle darüber, welche Daten in den FHIR Endpunkt zurückgeschrieben werden sollen.

Nachdem das Rückschreiben für die Entitätszuordnung aktiviert wurde, kann der Administrator auswählen, welche Ereignisse den Rückschreibprozess auslösen, was durch das Formularfeld Unterstützte Nachrichten angegeben wird. Die Rückschreiblösung unterstützt derzeit Erstellen und Aktualisieren Nachrichten.

Weitere Informationen zum Konfigurieren von den Entitätszuordnungen finden Sie unter Entitätszuordnungen konfigurieren.

Patientenressourcen enthalten eine zusätzliche Konfigurationseinstellung für das Zurückschreiben. Patienten können der Aktualisierung ihrer Daten in der Dataverse-Anwendung zustimmen oder sie ablehnen. Diese Einwilligung wird für jeden Patienten im Attribut Azure FHIR Sync Aktiviert gespeichert.

Ein Screenshot, der das Zurückschreiben-Zustimmungsattribut für einen Beispielpatienten zeigt.

Wenn der Wert des Attributs Azure FHIR-Synchronisierung aktiviert auf Ja festgelegt ist, und wenn die Entitätszuordnung Patient für das Zurückschreiben konfiguriert ist, werden alle Änderungen für zugeordnete Attribute im FHIR Endpunkt veröffentlicht. Andernfalls ignorieren die Rückschreibe-Plug-Ins die Änderungen der Patientendatensätze.

Allgemeine Warnungen und Fehlerszenarien

Warnungen und Ausnahmen, die während des Rückschreibprozesses auftreten können, werden in den Protokollen des Datenintegrations-Toolkits protokolliert. Weitere Informationen zu den Protokollen finden Sie unter Überprüfen von Dataverse Healthcare API-Protokollen.

Ungültige Konfigurationseinstellungen

Wenn die Konnektivitätseinstellungen im Abschnitt Integrationseinstellungen falsch sind, protokolliert der Rückschreibeprozess eine Ausnahme und stoppt die Verarbeitung. Zum Beispiel könnten die Anwendung/Client ID oder die Client Secret Werte falsch sein.

Nachricht mit Warnungen verarbeitet

Der FHIR Endpunkt könnte einige Warnungen oder Informationsmeldungen zurückgeben, selbst wenn die Rückschreibe-Anfrage erfolgreich verarbeitet wurde. Die untergeordneten Protokolle für diese Warnmeldung enthalten weitere Details, die Administratoren überprüfen können.

FHIR-Herkunftsfehler

Jede Ausnahme im Zusammenhang mit der Erstellung des FHIR-Herkunftsdatensatzes wird mit einer allgemeinen Ausnahme zusammen mit den vom FHIR Endpunkt zurückgegebenen Details protokolliert.

Fehlende erforderliche Attribute

Die Rückschreibe-Verarbeitung für Erweiterungskarten erfordert einen Verweis auf den übergeordneten Datensatz. Wenn der Attributwert der übergeordneten Verknüpfung fehlt, protokolliert der Rückschreibe-Prozess eine Ausnahme und stoppt die Verarbeitung.

Ungültiger Kontakttyp

Für Kontaktdatensätze in Dataverse muss der Indikator für die Kontaktart richtig eingestellt sein, damit das Zurückschreiben erfolgreich ist. Beispielsweise müssen sie entweder auf Patient oder Praktiker festgelegt sein. Wenn dieser Werte nicht vorhanden ist, protokolliert der Rückschreibe-Prozess eine Ausnahme und stoppt die Verarbeitung.

Einschränkungen

Die Rückschreibe-Lösung hat derzeit die folgenden Einschränkungen:

  • Ausgehende Formatierung: Die Rückschreibe-Lösung unterstützt keine ausgehende Formatierung. Der Prozess sendet derzeit die FHIR-Ressource, die die Änderungen für die aktualisierte FHIR-Ressource in Dataverse darstellt.
  • Authentifizierung: Die Rückschreibe-Lösung unterstützt derzeit das Posten an Endpunkte, die nur die OAuth-Authentifizierung unterstützen.

Siehe auch

Was ist Microsoft Cloud for Healthcare?
Überblick über das Datenintegrations-Toolkit
Überblick über Dataverse Healthcare APIs
Dataverse Healthcare APIs konfigurieren
Dataverse Healthcare API-Logs überprüfen