Überblick über Zurückschreiben für Dataverse Healthcare APIs
Die Dataverse Healthcare-Upsert-API erleichtert die Erfassung von FHIR-Daten (Fast Healthcare Interoperability Resources) in Dataverse. FalschinformationenSobald die Daten in Dataverse verfügbar sind, können Benutzer die neuen Datensätze aktualisieren, beispielsweise die demografischen Patienteninformationen. 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. Beispielsweise kann eine benutzerdefinierte Azure Logic App als Ziel für die ausgehende Nachricht verwendet werden, die die weitere Verarbeitung oder Weiterleitung durchführt. Dieser alternative ausgehende Endpunkt muss die Authentifizierung über OAuth 2.0 mithilfe einer Client-ID und eines geheimen Clientschlüssels unterstützen.
Das folgende Diagramm zeigt den gesamten Rückschreibeprozess:
Die Standardprozessschritte lauten wie folgt:
- Sie aktualisieren einen Datensatz in Dataverse.
- Dataverse wertet die Änderung aus und erstellt eine neue FHIR-Ressource, die an die FHIR-API Endpunkt gesendet wird.
- Der FHIR Endpunkt verarbeitet die FHIR-Ressource und gibt die Ergebnisantwort des Vorgangs zurück an Dataverse.
- Dataverse protokolliert die Betriebsergebnisse in den Datenintegrations-Toolkit-Protokollen. Der Administrator kann hier alle Fehler überprüfen.
Aus Gründen der Erweiterbarkeit können Sie bei Bedarf einen alternativen Rückschreibeansatz angeben.
- Dataverse sendet die FHIR-Ressourcenanforderung an den festgelegten Endpunkt.
- Der festgelegte Endpunkt ist für die Verarbeitung der bereitgestellten FHIR-Ressource und das Senden an die FHIR-API verantwortlich.
- Sie sind für die Protokollierung der Betriebsergebnisse verantwortlich, sodass die Administrierenden etwaige Fehler beim Senden von Daten an den benutzerdefinierten Endpunkt überprüfen können.
Anmerkung
Die aktuelle Version der Dataverse Healthcare APIs und des Rückschreibprozesses setzen voraus, dass ein FHIR-Dienst zum Erstellen und Validieren der ausgehenden FHIR-Ressource verfügbar ist. Diese Einrichtung ist sowohl für das direkte Schreiben an den FHIR-Dienst als auch an einen alternativen ausgehenden Endpunkt erforderlich. Es stellt die Integrität der ausgehenden FHIR-Ressource sicher, wenn ein Rückschreibereignis auftritt. Wir haben diese Konfiguration wurde mit einem FHIR-Dienst von Azure Health Data Services getestet und validiert.
Ein FHIR Herkunfts-Datensatz wird auch an den FHIR Endpunkt gesendet, wenn das Rückschreibe-Ereignis verarbeitet wird. Die Herkunftsressource verfolgt Informationen zu der Aktivität, die eine Version einer Ressource erstellt, überarbeitet, gelöscht oder signiert hat. Darüber hinaus werden die beteiligten Entitäten und Agenten beschrieben. 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:
Verbindungsdetails angeben
Geben Sie die Konnektivitätsdetails für den FHIR-Endpunkt an, der die bereitgestellten FHIR-Ressourcen empfängt. Sie finden diese Konfigurationseinstellungen im Abschnitt Integrationseinstellungen des Datenintegrations-Toolkits.
Weitere Informationen zu diesen Einstellungen finden Sie unter Integrationseinstellungen konfigurieren.
Entitätszuordnungen aktualisieren
Nachdem Sie die Konnektivitätsdetails angegeben haben, besteht der nächste Schritt darin, die Entitätszuordnung zu aktualisieren, die steuern, welche FHIR-Ressourcen am Rückschreibprozess 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 Sie das Rückschreiben für die Entitätszuordnung aktiviert haben, können die Administrierenden auswählen, welche Ereignisse den Rückschreibprozess auslösen, was durch das Feld Unterstützte Nachrichten angezeigt 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.
Zustimmung des Patienten anwenden
Zu den Patientenressourcen gehört eine zusätzliche Konfigurationseinstellung für das Rückschreiben. Patienten können der Aktualisierung ihrer Daten in der Dataverse-Anwendung zustimmen oder sie ablehnen. Das Attribut Azure-FHIR-Synchronisierung aktiviert speichert diese Einwilligung für jeden Patienten ab.
Wenn der Wert des Attributs Azure-FHIR-Synchronisierung aktiviert auf Ja gesetzt ist und die Entitätszuordnung Patient für das Rückschreiben konfiguriert ist, werden alle Änderungen an den zugeordneten Attributen an den FHIR-Endpunkt bereitgestellt. 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 im Abschnitt Integrationseinstellungen angegebenen Konnektivitätsdetails falsch sind, protokolliert der Rückschreibprozess eine Ausnahme und stoppt die Verarbeitung. Beispielsweise könnten die Werte für die Werte Anwendungs-/Client-ID oder das Geheimer Kundenschlüssel falsch sein.
Nachricht mit Warnungen verarbeitet
Der FHIR-Endpunkt gibt möglicherweise einige Warnungen oder Informationsmeldungen zurück, selbst wenn die Rückschreibanforderung erfolgreich verarbeitet wurde. Die untergeordneten Protokolle für diese Warnmeldung enthalten weitere Details, die Administrierende überprüfen sollten.
FHIR-Herkunftsfehler
Jede Ausnahme im Zusammenhang mit der Erstellung des FHIR-Herkunftsdatensatzes wird mit einer allgemeinen Ausnahmen 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 müssen Sie den Indikator des Kontakttyps richtig festlegen, damit das Rückschreiben erfolgreich ist. Sie müssen ihn entweder auf Patient oder Praktizierender Arzt festlegen. 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ückschreibelösung unterstützt derzeit nur die Bereitstellung an Endpunkte, welche die OAuth-Authentifizierung verwenden.