Hantera FHIR-data med hjälp av verktygslådan för dataintegrering

Artikel
06/19/2023

Kommentar

Synkroniseringsadministrationen for FHIR har nu döpts om till Verktygslåda för dataintegrering.

Med verktygslådan för dataintegrering kan du synkronisera patientens skyddade vårdinformation (PHI) mellan EHR-system och Dataverse. Integreringen ger vårdteam snabb och säker åtkomst till sina data i miljön Microsoft Cloud for Healthcare.

FHIR-systemet är fristående men är snabbt tillgängligt via Dataverse. Dataverse Healthcare APIs tillhandahåller ingångspunkter för att både mata in och hämta FHIR-data till Microsoft Cloud for Healthcare Dataverse-databasen. Vårdgivare kan fokusera på patientbehov och administratörer kan fokusera på att hantera personer, platser och kliniska resurser.

Funktioner som förenklar arbetet med FHIR-data

Följande tabell beskriver hur verktygslådan för dataintegrering kan förenkla arbetet med skyddade patientdata.

Egenskap	Vad funktionen gör	Så här hjälper det dig att hantera
Entitetsmappningar	Entitetsmappningar associerar FHIR-resurser med Dataverse-entiteter. FHIR-resursen "Patient" motsvarar till exempel Dataverse-entiteten "kontakt". Båda två handlar om samma sak: patienter. När någon vill läsa eller ändra data visar kartan datakällan och hjälper tillDataverse Healthcare APIs omvandla data mellan Dataverse entitetsposter och FHIR-resurser.	I stället för att skapa varje entitetsmappning själv aktiverar du de mappningar du behöver. Om en mappning behöver en liten förändring, justera den eller kopiera den och lägg till en tagg. Om du inte vill se en mappning kan du arkivera den. Och för speciella ändamål, skapa en ny mappning.
Attributmappningar	Attributmappningar associerar FHIR-element med Dataverse-attribut. För inmatning innehåller dessa mappningar information om hur du hittar dataelementet och dess motsvarande datatyp i Dataverse. För hämtning beskrivs hur Dataverse-dataelementet omvandlas till en FHIR-resursnod. Dessa mappningar är till en början aktiverade, men de påverkar inte synkroniseringen såvida inte den överordnade entitetsmappningen har aktiverats.	Standardattributmappningar ger en grundläggande uppsättning information som styrs av HL7-specifikationen för den överordnade FHIR-resursen. Ofta behöver du inte göra något annat än att aktivera den överordnade entitetsmappningen, men du kan även konfigurera attributmappningar på samma sätt som entitetsmappningar. Du kan inaktivera mappningarna om datan inte är relevant för entiteten. Du kan också byta från platsen där datan hämtas om systemet skiljer sig från FHIR-specifikationen. Attributmappningar ärver taggen för sina överordnade entitetsmappningar så att du ska kunna hålla dem åtskilda.
Utökningsmappning	Utvidgningsmappningar innehåller regler för hur du omvandlar JSON-dokumentbaserade hierarkiska data till Dataverse relationsdatamodell.	Expansionsmappningar låter administratörer mappa komplexa JSON-attribut på flera, relaterade Dataverse-attribut. Med utökningsmappning kan du ange överordnade länkattribut som avgör relationen mellan överordnade och underordnade poster.
Loggar	Verktygslådan för dataintegrering samlar in information om Dataverse Healthcare API-aktiviteter och låter dig visa, sortera och transaktionsloggarna. Loggposter innehåller inte EMR-data: de säger vad API-anropen har försökt göra och resultatet. Varje post innehåller en beskrivning och ytterligare information som gör det möjligt att felsöka för administratörer och utvecklare.	Loggar är hur du verifierar dina mappningar och övervakar Dataverse Healthcare API-åtgärder och felsöker problem. En loggpost med beskrivningen "Saknade obligatoriska fält" innebär att dataändringen har försökt skriva till en FHIR-resursinstans, men inte ett värde för ett element som behövs. Datainmatningsformuläret kanske inte hade något fält för att ange värdet, eller hade fältet men du kan skicka ändringen med det fältet tomt. Loggposten innehåller en lista över saknade fält så att du snabbt kan hitta och åtgärda problemet.
Azure FHIR-resurser	Azure FHIR-resursposten definierar de FHIR-resurser som för närvarande stöds i Microsoft Cloud for Healthcare Dataverse-lösningen. Informationen används också av Dataverse Healthcare APIs när data omvandlas mellan de två systemen.	När Dataverse-datamodellen expanderas uppdateras den här listan för att ange vilka FHIR-resurser som är tillgängliga för integrering.
Integrationsinställningar	Dataintegreringsverktyg innehåller komponentspecifika verktyg för hantering av konfigurationsalternativ. De här inställningarna visar Dataverse hur FHIR-dataändringar känns igen och var FHIR-datatransaktioner ska skickas. De låter dig också växla synkronisering på eller av och ange loggningsnivån för varje komponent.	Tillåter hantering av komponenter enskilt för både nya installationer och befintliga körningsinstanser.
Vårddata	När patienter ger sitt godkännande att dela sin hälso- och sjukvårdsdata kan administratörer se denna i verktygslådan för dataintegrering.	Genom att visa dessa data kan du hantera dataflödena och få en bättre förståelse av loggartikeln och du kan verifiera dina datamappningar.

Entitetsmappningar

Entitetsmappningar är den högsta nivån i mappningsprocessen. De mappar FHIR-resurser till sina motsvarande Dataverse-entiteter (kallas även Dataverse-tabeller). Du kan mappa ett entitetskoncept till flera FHIR-resurser. Entitetsmappningar hjälper Dataverse Healthcare APIs och virtuell hälsa-datatabeller att omvandla data mellan FHIR-meddelanden och Dataverse-entiteter. De hjälper också Dataverse att publicera rätt FHIR-resurser tillbaka till fjärranslutpunkter for FHIR.

För att se en lista över alla entitetsmappningar, i appen verktygslåda för dataintegrering, välj Administration av agent navigering i avsnittet Ändra område och välj Entitetsmappningar under Mappa konfiguration.

Expansionsmappningar ingår i verktygslådan för dataintegrering

Verktygslåda för dataintegrering innehåller många inbyggda entitetsmappningar, attributmappningar och FHIR-elementmappningar för vanliga FHIR-resurser som du förmodligen behöver. Eftersom allas system är olika aktiveras inte entitetsmappningar under distributionen.

Om du vill aktivera den entitetsmappning du behöver, behöver du bara ändra en specifik inställning.
Verktygslåda för dataintegrering kan ändras för att modifiera mappningar så att de passar dina specifika EMR-system.
Och om du inte hittar en specifik mappning som passar dina behov är det enkelt att skapa egna mappningar.

Information om hur du konfigurerar entitetsmappning finns i Konfigurera entitetsmappning.

I följande tabell visas entitetsmappningar som ingår i verktygslådan för dataintegrering. Den här tabellen inkluderar FHIR-resurserna på rotnivån, men inte expansionsmappningarna som beskrivs i detalj i Konfigurera expansionsmappningar.

Azure FHIR-resurs	Dataverse-entitet	Beskrivning
Organisation	konto	En formellt eller informellt erkänd gruppering av personer eller organisationer som bildats i syfte att uppnå någon form av kollektiv åtgärd. Den här grupperingen omfattar grupper som företag, organisationer, företag, avdelningar, communitygrupper och grupper med hälso- och sjukvårdsenheter.
Patient	kontakta	Demografisk och annan administrativ information om en person eller ett djur som erhåller vård eller andra hälsorelaterade tjänster.
Vårdutövare	kontakta	En person som direkt eller indirekt är engagerad i tillhandahållandet av vård.
AllergyIntolerance	msemr_allergyintolerance	Risk för skadlig eller oönskad fysiologisk respons som är unik för en individ och som är associerad med exponeringen för ett ämne.
Avtalad tid	msemr_appointmentemr	En schemalagd händelse för en patient och/eller vårdutövare där en tjänst kan äga rum vid ett visst datum eller tid.
CarePlan	msemr_careplan	Beskriver avsikten för hur en eller flera vårdutförare tänker leverera vård till en viss patient under en viss tidsperiod, möjligen begränsat till vård för ett specifikt tillstånd eller uppsättning tillstånd.
CareTeam	msemr_careteam	Vårdteamet omfattar alla personer och organisationer som planerar att delta i samordningen och leveransen av vård.
Anspråk	msemr_claim	En lista utfärdad av en leverantör över professionella tjänster och produkter som har tillhandahållits eller som ska tillhandahållas en patient och som skickas till en försäkringsgivare för återbetalning.
ClaimResponse	msemr_claimresponse	Den här resursen tillhandahåller prövningsinformation från bearbetningen av en anspråksresurs.
Villkor	msemr_condition	Används för att registrera detaljerad information om villkor, problem eller diagnostisera sjukdomar som identifierats av en läkare.
Enhet	msemr_device	Den här resursen identifierar en instans av en tillverkad artikel som används för att tillhandahålla vård utan att ändras väsentligt via den aktiviteten. Enheten kan vara en dator, ett infogande, en dator eller ett program. Detta omfattar utrustning som används för diagnostik, behandling och forskning för hälso- och sjukvård och offentlig hälsa.
DiagnosticReport	msemr_diagnosticreport	De diagnostiktester som utförts på olika grupper, utrustningar och platser samt de resultat de ger. Rapporten innehåller kliniska sammanhang som information om förfrågningsförfrågningar och leverantörer, samt en blandning av resultat, bilder, textbaserad och kodad återgivning och formaterad representation av diagnostikrapporter.
Kontakttillfälle	msemr_encounter	En interaktion mellan en patient och vårdgivare i syfte att tillhandahålla vårdtjänster eller bedöma en patients hälsostatus.
EpisodeOfCare	msemr_episodeofcare	En association mellan en patient och en organisation eller vårdgivare under vilken ett kontakttillfälle kan inträffa. Den handläggande organisationen tar ett ansvar för patienten under denna tid.
Mål	msemr_goal	Beskriver de avsedda målen för vården.
Grupp	msemr_group	Representerar en definierad samling av entiteter som kan diskuteras eller ageras utifrån kollektivt, men som inte förväntas agera kollektivt och inte är formellt eller juridiskt erkända
Plats	msemr_location	Detaljer och placeringsinformation för en fysisk plats där tjänster tillhandahålls och resurser och deltagare kan lagras, hittas, bevaras eller tillgodoses.
Medicinering	msemr_medication	Används primärt för identifiering och definition av läkemedel, men omfattar även ingredienser och förpackning.
MedicationRequest	msemr_medicationrequest	En order eller begäran om både tillhandahållandet av medicin och instruktioner för administrering av medicin till en patient. Resursen kallas "MedicationRequest" i stället för "MedicationPrescription" eller "MedicationOrder" för att göra användningen allmän för både sjukhuspatientmiljöer och öppenvårdspatientmiljöer, inklusive vårdplaner osv., för att harmoniera med arbetsflödesmönster.
Observation	msemr_observation	Mått och enkla försäkringar som gjorts för en patient, enhet eller annat subjekt.
Procedur	msemr_procedure	En åtgärd som har utförts på eller för en patient. Denna åtgärd kan vara en fysisk aktivitet som en operation, eller mindre invasiv som rådgivning eller hypnoterapi.
RelatedPerson	msemr_relatedperson	Information om en person som är engagerad i vården av en patient, men som inte är målet för sjukvården, och inte heller har något formellt ansvar för vårdprocessen.
RiskAssessment	msemr_riskassessment	En bedömning av de sannolika resultaten för en patient eller ett annat subjekt, samt sannolikheten för varje resultat.
Schema	msemr_schedule	En behållare för tidsluckor i ett schema som kan vara tillgänglig för bokning av avtalade tider.
Tid	msemr_slot	En tidslucka i ett schema som kan vara tillgänglig för bokning av avtalade tider.

Attributmappningar

Entitetsmappningar har en eller flera relaterade attributmappningar som mappar de enskilda elementen i FHIR-resursen.

För att se en lista över alla attributemappningar, i appen verktygslåda för dataintegrering, välj Administration av agent navigering i avsnittet Ändra område och välj Attributemappningar under Mappa konfiguration.

Dessa relaterade mappningar ger detaljerad information för fältet som FHIR-värdena mappar till vilka Dataverse kolumnvärden. Varje attributmappning innehåller konfigurationsvärden för datatypmappning och anpassade JSONPath-trängar för att välja rätt värde från inkerna i FHIR JSON-meddelandena.

Information om hur du konfigurerar attributemappning finns i Konfigurera attributmappning.

Hantera mappningsposter

Mappa poster är lösningsmedvetna komponenter vilket innebär att en komponent i en lösning vet att den är en del av lösningen. Våra mappningar vet att de är en del av verktygslådan för dataintegrering. Eftersom de finns i Dataverse kan du använda Programlivscykelhantering (ALM) för att säkert hantera ändringar du gör i dina mappningstabeller. Värdet det tillhandahåller är att du kan uppdatera dina mappningar i en utvecklingsmiljö, där du kan testa och validera dina kartändringar utan att riskera dina EHR/EMR-datasystem för produktion.

För att överföra mappningsändringar mellan miljöer var du tidigare tvungen att kopiera dina data manuellt. Verktyg som konfigurationsmigreringsverktyget kan vara till hjälp, men det gick att göra manuella fel. När du har försäkrat dig om att uppdateringarna är klara kan du distribuera dem i produktionsmiljön som ett enda paket. ALM sparar tid och hjälper dig att skydda ditt företag när det utvecklas och växer. Mer information finns i ALM lösningskoncept.
Du kan alltid ta bort alla eventuella mappningar du skapar från grunden. Du kan inte ta bort vissa Microsoft Cloud for Healthcare standardmappningar och behålla andra. Du kan ta bort alla Microsoft Cloud for Healthcare-standardmappningar genom att ta bort den hanterade lösning som installeras.
Mappningsposter har en hierarki med entitetsmappningar överst (entitetsmappningar > attributmappning > attributvärdesmappningar). Dataverse låter dig inte ta bort en post som har underordnade poster (relaterade poster på lägre nivåer). Om du vill ta bort en entitetsmappning måste du först söka efter och ta bort alla dess underordnade mappningar och sedan ta bort entitetsmappningen.
Om du inte vill använda en standardmappning kan du dölja mappningar i miljön genom att arkivera dem. Du kan arkivera en entitetsmappning genom att välja posten i rutnätet och sedan klicka på knappen Arkiv i kommandofältet. När du arkiverar en mappning inaktiveras och inaktiveras entitetsmappningen automatiskt. Det arkiverar också entitetens attributmappningar och attributvärdesmappningar.

Du når arkiverade mappningar genom att ändra vyn till Arkiverade entitetsmappningar för uppdateringstjänst.

Du kan återställa arkiverade mappningar med hjälp av kommandot Återställ. Välj den arkiverade entitetsmappningen i rutnätet och välj Återställ i åtgärdsfönstret.
Du kan ångra ändringar i standardmappningar genom att ta bort det aktiva lagret med ändringar i mappningslösningen. Standardmappningar levereras som en hanterad lösning. När du gör ändringar i dessa mappningar görs de i det aktiva lagret (ohanterat). Du kan när som helst använda lösningslagren för att granska lagren och ta bort det aktiva lagret. Om du tar bort det aktiva lagret återställs kartan till det senaste hanterade lagret för den komponenten. Mer information finns i ALM-lösningslager. Steg för att visa lösningslagren finns i Visa lösningslager.
Den senaste tjänsteversionen tillhandahåller entitetsmappningstaggar för att hjälpa dig att unikt identifiera de mappningar du lägger till i lösningar. Taggen visas i början av entitetsmappningens namn och namnen på alla attributmappningar och attributvärden. Redigera taggattributet i Tagg attribut i entitetsmappningshuvudet.

Varje mappning kan bara ha en tagg tilldelad åt gången.

Loggar

Välj Loggar för att visa de transaktioner som sker inuti Dataverse. Eftersom merparten av aktiviteten i verktygslådan för dataintegrering inte är synliga interagerar du inte med den, och administratören kanske inte ser den.

Loggar hjälper dig att förstå hur data flödar, varför något skickas till Dataverse Healthcare API och varför något inte skickas. Dessa tillhandahåller en vy över komponenternas aktiviteter i verktygslådan för dataintegrering.

Avsnittet loggar innehåller information om varje tjänst, inklusive det anpassade API:et.

Azure FHIR-resurser

Området Azure FHIR-resurser definierar universum av FHIR-resurser. Eftersom du inte kan se inuti FHIR-entiteter direkt för att se alla resurser, tillhandahåller verktygslåda för dataintegrering listan över resurser som är mappade till en Dataverse-entitet. FHIR-resurserna används primärt i entitetsmappningar.

Integrationsinställningar

Området Integrationsinställningar ger dig åtkomst till de Dataverse-miljövariabler som definierar och kontrollerar integreringen av Azure FHIR och Dataverse. Du måste ange dessa variabler som Initiera verktygslåda för dataintegrering eller göra justeringar om något i din Microsoft Cloud for Healthcare-miljö förändras.

För mer information om integrationsinställningarna, gå till Konfigurera integrationsinställningar för Dataverse Healthcare APIs och Konfigurera integrationsinställningar för virtuell hälsa-datatabeller.

Vårddata

Mappa administratörer måste visa informationen i lösningen för hälso- och sjukvård. Med modulen Hälso- och sjukvårdsdata kan mappningsadministratörerna visa och interagera med den användardata som strömmar in i systemet. Denna funktion hjälper mappningsadministratörerna att förstå och felsöka datan.

Mappningsadministratörer kan använda modulen för hälso- och sjukvårdsdata för att.

Visa datan.
Att förstå vad som händer när de skapar mappningarna.
Kontrollera att datan anländer korrekt och till rätt fält.

Om du till exempel vill visa patientinformation:

Välj Vårddata.
Under Administration, välj Personer.
Ändra vyn till FHIR-vy för patienter.

Mappningsadministratören kan se all patientinformation som strömmar in i Microsoft Cloud for Healthcare som en patients FHIR-ID, den sista synkroniseringen av en patient, om synkronisering är aktiverad för den posten samt Azure FHIR-versionen av journalen.

Kontakten är inte synkroniserad

I det här exemplet visas hur du kan ha en entitet för kontakt som inte synkroniseras när du försöker synkronisera en patientjournal som inte är tillgänglig för synkronisering.

Välj Vårddata.
I FHIR-vy för patienter, som ett exempel, kan du hitta en patient som inte har ett Azure FHIR ID.
Markera patientjournalen och välj Redigera. Observera att värdet Azure FHIR-synkronisering aktiverad har inställningen Nej.
Ändra telefonnumret till patienteb och välj Spara.
I avsnittet Loggar,
- För kolumnen Beskrivning för den posten väljer du Händelsehanteraren för tillbakaskrivning har bearbetats.
- För Källa, välj Tillbakaskrivning.
- För Entitetstyp, välj Kontakt.
Observera att posten inte har ett ID för FHIR-resurs-ID.

Kontakt saknar information om Azure FHIR

I ett annat exempel kan du försöka synkronisera befintlig patient som inte har ett FHIR-ID.

Välj Vårddata.
I FHIR-vy för patienter, som ett exempel, kan du hitta en patient som inte har ett Azure FHIR ID.
Markera patientjournalen och välj Redigera. Observera att värdet Azure FHIR-synkronisering aktiverad har inställningen Nej.
Uppdatera värdet Azure FHIR-synkronisering aktiverad och ange till ja.
Ändra telefonnumret till patienteb och välj Spara.
I avsnittet Loggar,
- För kolumnen Beskrivning för den posten väljer du Tillbakaskrivningen misslyckades.
- För Källa, välj Tillbakaskrivning.
- För Entitetstyp, välj Kontakt.
I meddelandet står det att kontakten inte kan synkroniseras till FHIR-slutpunkten. Det här beteendet beror på att informationen om Azure FHIR ID eller annan FHIR-version saknas för en befintlig post som uppdateras. Ett Azure FHIR-ID som är "null" anger att kontakten inte har sitt ursprung i FHIR-servern, som är ett scenario som saknar stöd för tillbakaskrivningsprocessen.

Loggposter för tillbakaskrivning

När en kontaktpost har ett FHIR ID och en ändring görs i posten kan du se två loggmeddelanden. Det första meddelandet anger att tillbakaskrivningsprocessen har påbörjats. Posten med namnet Händelsehanteraren för tillbakaskrivning har bearbetats anger att ändringarna har köat för att skicka tillbaka till FHIR slutpunkt.

När uppdateringen har publiceras i FHIR slutpunkt kan du se posten Processen för att skriva tillbaka har lyckats. Om du väljer denna beskrivning visas meddelandet i loggposten. Meddelandet anger attributet som har ändrats och vad det skickade till FHIR-slutpunkt.

Ett sista loggmeddelande med namnet Tillbakaskrivning av FHIR-proveniens anger ett slutgiltigt granskningsmeddelande som skickats till FHIR slutpunkt om de senaste uppdateringarna.

Den här kombinationen av meddelanden indikerar en lyckad uppdatering till FHIR-slutpunkt via bearbetningen av tillbakaskrivningen.

I hälso- och sjukvårdsdata kan du hitta en patientjournal med ett FHIR-ID och värdet Azure FHIR ID-synkronisering aktiverad inställt på Nej. Dataverse Healthcare APIs har ett samtyckesflöde. Samtyckesflödet mellan FHIR och Dataverse säkerställer att inte hela FHIR hamnar i Dataverse. Det finns en hel del patientdata som finns i FHIR och du vill bara ha dessa data i Dataverse när du arbetar med den patient.

När FHIR-synkroniseringen är aktiverad kommer Dataverse Healthcare API synkronisera patienterna till Dataverse. Däremot synkroniseras inte hela patientdatan till Dataverse såvida inte alternativet Azure FHIR-synkronisering aktiverad har inställningen Ja.

Denna funktion kallas för medgivandeflöde eftersom en patient vanligtvis måste godkänna att de vill att deras information förs in i ett system. När en patient, till exempel i Patientåtkomst-portalen, godkänner att få sin information införd i systemet, anges värdet för Azure FHIR-synkronisering aktiverad som Ja, och den patientens data kommer att börja strömma in i systemet.

Om värdet Azure FHIR-synkronisering aktiverad anges till Nej och du gör en ändring i patientjournalen ser du en loggpost med ett meddelande som säger Data kan inte skickas till Azure FHIR-server, vilket indikerar att entitetsuppdateringarna för kontakt inte kan skickas till FHIR-slutpunkt. Om du ställer in Azure FHIR-synkroniseringen aktiverad som Nej hindras data från att strömma till FHIR. Det hindrar också FHIR från att återföra data till Dataverse för denna patient.

Samtyckesflödet är unikt endast för Patienter som kontakter. Ingen annan postentitet i Dataverse har detta samtyckesflöde inbyggt i den.

Utökningsmappning

Utökningsmappningar i verktygslådan för dataintegrering gör att administratörer kan omvandla FHIR-data till Dataverse-tabeller genom att expandera komplexa JSON-attribut till flera, relaterade Dataverse-poster.

Du kan till exempel använda expansionsmappningar för att ta med patientidentifierare och patientlänkar i Dataverse. När det gäller patientlänkar tillåter utökningsmappningar administratörer att integrera förfrågningar om patientkoppling med följande länktyper:

Med utökningsmappning kan du ange överordnade länkattribut som avgör relationen mellan överordnade och underordnade poster.

En skärmbild visar ett exempel på överordnat länkattribut.

Mer information om expansionsmappningar finns i Konfigurera expansionsmappningar.

Se även

Vad är Microsoft Cloud for Healthcare?
Översikt över Verktygslåda för dataintegrering
Konfigurera entitetsmappningar
Konfigurera attributmappningar
Konfigurera expansionsmappningar
Dataintegrationsverktygskartor: Exempel och användningsfall

Dela via