Delen via

Overzicht van terugschrijfoplossing voor Dataverse Healthcare APIs

  • Artikel

De Dataverse Healthcare upsert-API vergemakkelijkt de opname van FHIR-gegevens (Fast Healthcare Interoperability Resources) in Dataverse. Zodra gegevens beschikbaar zijn in Dataverse, kunnen gebruikers de nieuwe records bijwerken, bijvoorbeeld demografische gegevens van patiënten. Met de terugschrijfoplossing van Dataverse Healthcare APIs kunnen deze wijzigingen worden teruggeplaatst naar de oorspronkelijke FHIR-server.

De oplossingsbenadering biedt enige uitbreidbaarheid van het terugschrijfproces. De terugschrijfconfiguratie kan zich ook richten op een alternatieve eindpunt als gebruikers aangepaste logica in dit proces moeten opnemen. Een aangepaste Azure Logic App kan bijvoorbeeld worden gebruikt voor het uitgaande bericht dat verdere verwerking of routering uitvoert. Het alternatieve uitgaande eindpunt moet verificatie via OAuth 2.0 ondersteunen met behulp van een client-id en -geheim.

Het volgende diagram toont de het algehele terugschrijfproces:

Een diagram met het overzicht van het terugschrijfproces.

De standaardverwerkingsstappen zijn als volgt:

  1. U werkt een record bij in Dataverse​.
  2. Dataverse evalueert de wijziging en stelt een nieuwe FHIR-resource samen die naar het FHIR-API-eindpunt wordt gepost.
  3. Het FHIR-eindpunt verwerkt de FHIR-resource en retourneert de resultaatrespons van de bewerking naar Dataverse​.
  4. Dataverse registreert de operationele resultaten in de logboeken van de gegevensintegratietoolkit. De Beheerder kan hier eventuele fouten bekijken.

Voor uitbreidbaarheid kunt u indien nodig een alternatieve terugschrijfbenadering opgeven.

  1. Dataverse stuurt de FHIR-resourceaanvraag naar het gedefinieerde eindpunt.
  2. Het gedefinieerde eindpunt is verantwoordelijk voor het verwerken van de geposte FHIR-resource en het verzenden ervan naar de FHIR API.
  3. U bent verantwoordelijk voor het vastleggen van de operationele resultaten, zodat de beheerder eventuele fouten kan beoordelen tijdens het verzenden van gegevens naar het aangepaste eindpunt.

Notitie

Bij de huidige versie van Dataverse-API's voor de gezondheidszorg en het terugschrijfproces wordt ervan uitgegaan dat er een FHIR-service beschikbaar is voor het maken en valideren van de uitgaande FHIR-resource. Deze configuratie is vereist voor rechtstreeks schrijven naar de FHIR-service of een alternatief uitgaand eindpunt. Zo wordt de integriteit van de uitgaande FHIR-resource gewaarborgd wanneer een terugschrijfgebeurtenis plaatsvindt. We hebben deze configuratie getest en gevalideerd met een FHIR-service voor Azure Health Data Services.

Een FHIR-herkomst-record wordt ook naar het FHIR-eindpunt gepost wanneer de terugschrijfgebeurtenis wordt verwerkt. De herkomstresource houdt informatie bij over de activiteit waarmee een versie van een resource is gemaakt, herzien, verwijderd of ondertekend. Ook worden de betrokken entiteiten en agents beschreven. U kunt deze informatie gebruiken om beoordelingen te vormen over de kwaliteit of betrouwbaarheid. De herkomstresource biedt ook aanwijzingen voor waar u heen moet om de oorsprong van de resource en de informatie erin verder te onderzoeken.

Ga naar Herkomst van de FHIR-resource voor meer informatie over de FHIR-herkomst.

Terugschrijven inschakelen

Het inschakelen van het terugschrijfproces omvat de volgende drie primaire stappen:

  1. Details over de connectiviteit bieden
  2. Entiteitstoewijzingen bijwerken
  3. Toestemming van de patiënt toepassen

Details over de connectiviteit bieden

Geef de connectiviteitsgegevens op voor het FHIR-eindpunt dat de geposte FHIR-resources ontvangt. U vindt deze configuratie-instellingen in de sectie Integratie-instellingen van de gegevensintegratietoolkit.

Ga voor meer informatie over deze instellingen naar Integratie-instellingen configureren.

Entiteitstoewijzingen bijwerken

Nadat u connectiviteitsgegevens hebt opgegeven, is de volgende stap het bijwerken van de entiteitstoewijzingen die bepalen welke FHIR-resources moeten deelnemen aan het terugschrijfproces.

De invoegtoepassingen voor terugschrijven gebruiken dezelfde entiteitstoewijzingen die zijn geconfigureerd voor de upsert-API. Elke entiteitstoewijzing kan een kenmerk bevatten met de titel Terugschrijven naar FHIR inschakelen. Als deze kenmerkwaarde is ingesteld op Ja, posten de invoegtoepassingen voor terugschrijven updates voor de geselecteerde Dataverse-tabel naar het FHIR-eindpunt. Dit proces maakt het mogelijk om heel precies per tabel te bepalen welke gegevens moeten worden teruggeschreven naar het FHIR-eindpunt.

Nadat u terugschrijven voor de entiteitstoewijzing hebt ingeschakeld, kan de beheerder selecteren welke gebeurtenissen het terugschrijfproces activeren, aangegeven door het veld Ondersteunde berichten . De terugschrijfoplossing ondersteunt momenteel berichten voor Maken en Bijwerken.

Ga voor meer informatie over het configureren van de entiteitstoewijzingen naar Entiteitstoewijzingen configureren.

Patiëntresources bevatten een extra configuratie-instelling voor terugschrijven. Patiënten kunnen ervoor kiezen om toestemming te geven of te weigeren dat hun gegevens worden bijgewerkt via de toepassing Dataverse. Met het kenmerk Azure FHIR-synchronisatie ingeschakeld wordt deze toestemming voor elke patiënt opgeslagen.

Een schermopname waarin het kenmerk met de toestemming voor terugschrijven voor een voorbeeldpatiënt wordt weergegeven.

Wanneer de waarde van het kenmerk Azure FHIR-synchronisatie ingeschakeld is ingesteld op Ja en de entiteitstoewijzing Patiënt voor terugschrijven is geconfigureerd, worden alle wijzigingen in de toegewezen kenmerken naar het FHIR-eindpunt gepost. Anders negeren de invoegtoepassingen voor terugschrijven de wijzigingen in het patiëntendossier.

Veelvoorkomende waarschuwingen en foutscenario's

Waarschuwingen en uitzonderingen die tijdens het terugschrijven kunnen optreden, worden vastgelegd in de logboeken van de gegevensintegratietoolkit. Ga voor meer informatie over de logboeken naar Dataverse Healthcare API-logboeken controleren.

Ongeldige configuratie-instellingen

Als de connectiviteitsgegevens in de sectie integratie-instellingen onjuist zijn, registreert het terugschrijfproces een uitzondering en stopt de verwerking. De waarden voor de Toepassings-/client-id of voor Clientgeheim zijn bijvoorbeeld mogelijk onjuist.

Bericht verwerkt met waarschuwingen

Het FHIR-eindpunt kan waarschuwingen of informatieberichten retourneren, zelfs als de terugschrijfaanvraag succesvol is verwerkt. De onderliggende logboeken voor dit waarschuwingsbericht bevatten meer details die beheerders kunnen bekijken.

Fouten in de FHIR-herkomst

Elke uitzondering met betrekking tot het maken van de FHIR-herkomstrecord wordt in een logboek vastgelegd met een algemene uitzondering, samen met de details die worden geretourneerd door het FHIR-eindpunt.

Ontbrekende vereiste kenmerken

De terugschrijfverwerking voor uitbreidingstoewijzingen vereist een verwijzing naar de bovenliggende record. Als de waarde van het kenmerk van de bovenliggende koppeling ontbreekt, registreert het terugschrijfproces een uitzondering in het logboek en wordt de verwerking gestopt.

Ongeldig contacttype

Voor contactgegevens in Dataverse moet u de indicator van het Contacttype correct instellen, anders slaagt het terugschrijven niet. U moet het bijvoorbeeld instellen op Patiënt of Behandelaar. Als deze waarde niet aanwezig is, registreert het terugschrijfproces een uitzondering in het logboek en wordt de verwerking gestopt.

Beperkingen

De terugschrijfoplossing heeft momenteel de volgende beperkingen:

  • Uitgaande opmaak : de terugschrijfoplossing ondersteunt geen uitgaande opmaak. Het proces post momenteel de FHIR-resource die de wijzigingen voor de bijgewerkte FHIR-resource vertegenwoordigt in Dataverse.
  • Verificatie: de terugschrijfoplossing ondersteunt momenteel alleen het posten naar eindpunten die OAuth-verificatie gebruiken.