Översikt över tillbakaskrivning för Dataverse Healthcare APIs
Dataverse healthcare upsert API underlättar insamling av FHIR-data (Fast Healthcare Interoperability Resources) i Dataverse. När data finns tillgängliga i Dataverse kan användarna uppdatera de nya posterna, till exempel uppdatera den demografiska informationen för patienter. Med Dataverse Healthcare APIs kommer bakåtskrivningslösningen låta ändringarna läggas upp på den ursprungliga FHIR-servern.
Lösningsmetoden innebär viss utökning av tillbakaskrivningsprocessen. Tillbakaskrivningskonfigurationen kan även vara en alternativ slutpunkt om användare måste mata in anpassad logik i den här processen. En anpassad Azure Logic App kan exempelvis användas för det utgående meddelande som ger ytterligare bearbetning eller vidarebefordran. Denna alternativa utgående slutpunkt måste stödja autentisering via OAuth 2.0 med ett klient-ID och klienthemlighet.
Följande diagram beskriver den övergripande tillbakaskrivningsprocessen:
Standardbearbetningsstegen är som följer:
- Du uppdaterar en post i Dataverse.
- Dataverse utvärderar ändringen och skriver en ny FHIR-resurs som har lagts upp i FHIR API slutpunkt.
- FHIR-slutpunkt bearbetar FHIR-resursen och returnerar åtgärdens resultatsvar till Dataverse.
- Dataverse loggar de operativa resultaten till loggarna för verktygslådan för dataintegrering. Administratören kan granska eventuella fel här.
För utbyggbarhet kan du ange en alternativ metod för tillbakaskrivning om det behövs.
- Dataverse skickar FHIR-resursbegäran till den definierade slutpunkten.
- Den definierade slutpunkten ansvarar för att bearbeta den upplagda FHIR-resursen och skicka den till FHIR API.
- Du ansvarar för att logga verksamhetsuppgifterna så att administratören kan granska eventuella fel medan du skickar data till den anpassade slutpunkten.
Kommentar
I den aktuella versionen av Dataverse Healthcare APIs samt tillbakaskrivningsprocessen förutsätts att en FHIR-tjänst kan skapas och valideras för den befintliga FHIR-resursen. Den här konfigurationen krävs för att både skriva direkt till FHIR-tjänsten eller till en alternativ utgående slutpunkt. Den säkerställer integriteten för den utgående FHIR-resursen när en tillbakaskrivningshändelse inträffar. Vi har testat och validerat den här konfigurationen mot en FHIR-tjänst för Azure Health Data Services.
En post för FHIR Provenance läggs också upp i FHIR slutpunkt när tillbakaskrivningshändelsen bearbetas. Här finns information om aktiviteten som skapat, reviderats, raderats eller signerat en version av en resurs. Den beskriver också de entiteter och handläggare som är inblandade. Med hjälp av den här informationen kan du skapa information om företagets kvalitet, tillförlitlighet och förtroende. Den innehåller också tips om var resursen kommer att undersökas närmare och vilken information den innehåller.
För mer information om FHIR-proveniens, gå till FHIR-resursproveniens.
Aktivera tillbakaskrivning
När du aktiverar tillbakaskrivningsprocessen ingår följande tre primära steg:
Ange anslutningsinformation
Tillhandahåll anslutningsinformationen för FHIR-slutpunkten som tar emot de upplagda FHIR-resurserna. Dessa konfigurationsvärden finns i verktygslåda för dataintegrering, avsnitt integreringsinställningar.
Mer information om dessa inställningar finns i Konfigurera integrationsinställningar.
Uppdatera entitetsmappningar
När du har tillhandahållit anslutningsinformation är nästa steg att uppdatera de entitetsmappningar som styr vilka FHIR-resurser som ska delta i tillbakaskrivningsprocessen.
Plugin-program för tillbakaskrivning använder samma entitetsmappningar som konfigurerats för upsert API. Varje entitetsmappning kan innehålla attributet Aktivera tillbakaskrivning till FHIR. När attributet har värdet Ja uppdateras plugin-program för inskrivning för den valda Dataverse-tabellen till FHIR-slutpunkt. Denna process möjliggör granulär, tabell-till-tabell-kontroll över vilka data som ska skrivas tillbaka till FHIR-slutpunkten.
När du har aktiverat återställning av entitetsmappningen kan administratören Välj vilka händelser som utlöser tillbakaskrivningsprocessen som visas i fältet Meddelanden som stöds. Tillbakaskrivningslösningen stöder för närvarande meddelandena Skapa och Uppdatera.
Information om hur du konfigurerar entitetsmappning finns i Konfigurera entitetsmappning.
Tillämpa patientens samtycke
Patientresurser innehåller en extra konfigurationsinställning för tillbakaskrivning. Patienterna kan välja att godkänna eller neka att deras data uppdateras i Dataverse-programmet. Attributet Azure FHIR-synkronisering aktiverad sparar detta samtycke för varje patient.
När värdet för attributet Azure FHIR-synkronisering aktiverad anges till Ja och entitetsmappningen Patient är konfigurerad för återskrivning, postas alla ändringar av de mappade attributen till FHIR-slutpunkten. I annat fall ignoreras ändringar i patientposten i plugin-program för tillbakaskrivning.
Vanliga varningar och felscenarier
Varningar och undantag som kan komma att inträffa under tillbakaskrivningsprocessen loggas i loggarna för verktygslådan för dataintegrering. Mer information om loggar finns i Granska loggar för Dataverse Healthcare API.
Ogiltiga konfigurationsinställningar
Om anslutningsinformationen i avsnittet integreringsinställningar felaktiga loggar tillbakaskrivningsprocessen ett undantag och stoppar behandlingen. Till exempel värden för Program/Klient-ID eller Klienthemlighet kan vara felaktiga.
Meddelande som bearbetas med varningar
FHIR-slutpunkten kan returnera vissa varningar eller informationsmeddelanden även om tillbakaskrivningsbegäran bearbetas korrekt. De underordnade loggarna för det här varningsmeddelandet innehåller mer information för administratörer som ska granskas.
Fel i FHIR-proveniens
Alla undantag relaterade till skapandet av FHIR-proveniensposten loggas med ett allmänt undantag tillsammans med informationen som returneras av FHIR-slutpunkt.
Saknade obligatoriska attribut
För bearbetning av tillbakaskrivning för utökningsmappningar krävs en referens till den överordnade posten. Om värdet för det överordnade länkattributet saknas loggas ett undantag och bearbetningen stoppas i tillbakaskrivningsprocessen.
Ogiltig kontakttyp
För kontaktposter i Dataverse måste du ange symbolen för Kontakttyp korrekt för att det ska gå att skriva tillbaka. Du måste till exempel ange den som Patient eller Vårdutövare. Om detta värde inte finns saknas loggar tillbakaskrivningsprocessen ett undantag och stoppar behandlingen.
Begränsningar
Tillbakaskrivningslösningen har för närvarande följande begränsningar:
- Utgående formatering: Tillbakaskrivningslösningen stöder inte utgående formatering. Processen lägger för närvarande upp FHIR-resursen som representerar ändringarna för den uppdaterade FHIR-resursen i Dataverse.
- Autentisering: Lösningen för tillbakaskrivning stöder för närvarande endast inlägg till slutpunkter som använder OAuth-autentisering.