Hantera FHIR-data med hjälp av verktygslådan 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 du vill läsa eller ändra data visar kartan datakällan och hjälper Dataverse Healthcare APIs omvandlar 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 användningsfall kan du skapa en ny karta. |
| Attributmappningar | Attributmappningar associerar FHIR-element med Dataverse-attribut. För inmatning innehåller dessa kartor detaljer om hur man hittar dataelementet och dess motsvarande datatyp i Dataverse. För hämtning beskriver kartorna hur man omvandlar Dataverse dataelement i FHIR-resursnod. Dessa mappningar är aktiverade som standard, men påverkar inte synkroniseringen om du inte aktiverar deras överordnade entitetsmappning. |
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 konfigurera attributmappningar för, 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 de överordnade entitetsmappningarna 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. Loggposterna innehåller inte EMR-data; de visar bara vad API-anropen försökte göra och resultatet. Varje post innehåller en beskrivning och mer information för att aktivera felsökning 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" anger att dataändringen försökte skriva till en FHIR-resursinstans, men inte tog med ett värde för ett obligatoriskt element. Du kan se denna post om dataregistreringsformuläret antingen saknar ett fält för att ange värdet eller har ett fält som tillåter inskickning även när det lämnas tomt. Loggposten innehåller även 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 | Dataintegreringsverktyget 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 samtycke till att dela sina hälsodata kan administratörer se det i verktyget för dataintegrering. | 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å att Dataverse-inlägg rätt FHIR-resurser tillbaka till fjärranslutpunkter för 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
Dataintegrationsverktyget 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.
- För att aktivera de nödvändiga entitetsmappningen behöver du bara ändra en specifik inställning.
- För att modifiera kartorna så att de passar dina specifika EMR-system är kartorna för dataintegreringsverktygen mycket konfigurerbara.
- Om du inte hittar en specifik karta som passar dina behov kan du enkelt skapa din egen karta.
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 | Inkluderar 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 | Om du inte hittar en specifik karta som passar dina behov kan du enkelt skapa din egen karta. |
| 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 sak som används för att tillhandahålla vård utan att ändras väsentligt via den aktiviteten. Enheten kan vara en maskin, en insats, en dator eller ett program. Det inkluderar hållbar (återanvändbar) medicinsk utrustning och engångsutrustning som används för diagnostik, behandling och forskning för hälso- och sjukvård och folkhä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 såsom information om begäranden och leverantören. Det inkluderar också en blandning av atomära resultat, bilder, textuell och kodad tolkning samt formaterad representation av diagnostiska rapporter. |
| Kontakttillfälle | msemr_encounter | En interaktion mellan en patient och sjukvårdsleverantörer i syfte att tillhandahålla sjukvårdstjänster eller att bedöma en patients hälsostatus. |
| EpisodeOfCare | msemr_episodeofcare | En association mellan en patient och en organisation eller sjukvårdsleverantör 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 entiteter som kan diskuteras eller behandlas gemensamt. De här entiteterna förväntas inte agera tillsammans och identifieras inte eller känns igen. |
| 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 för att identifiera och definiera medicin, men täcker även ingredienser och förpackningar. |
| 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 "MedicationsRequest" snarare än "MedicationRecept" eller "MedicationsOrder". Vi använder denna term för att generalisera användningen inom både slutenvård och öppenvård, inklusive vårdplaner och för att harmonisera 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 utförs på 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 inblandad i vården för en patient. Denna person är inte målet för vården och har inte heller något formellt ansvar i vårdprocessen. |
| RiskAssessment | msemr_riskassessment | En bedömning av de sannolika resultaten för en patient eller ett annat ämne, 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 kartor ger specifika detaljer fält-för-fält om vilka FHIR-värden som 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 du kan använda programlivscykelhantering (ALM) för att säkert hantera ändringar du gör i dina mappningstabeller. Denna funktion låter dig är att du kan uppdatera dina mappningar i en utvecklingsmiljö, där du kan testa och validera dina kartändringar utan att riskera dina produktions EHR/EMR-datasystem.
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. Nu, efter att du säkerställt 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 standardmappningar genom att ta bort den hanterade lösning som installeras.
Mappningsposter har en hierarki med entitetsmappningar överst (entitetsmappningar > Attributmappar > 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 kartan i miljön genom att arkivera den. För att arkivera en enhetskarta, välj posten från rutnätet och välj sedan 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 kartor gäller ändringarna i det aktiva lagret (ohanterat). Du kan använda lösningslagren för att granska de olika lagren och ta bort det aktiva lagret när som helst. 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 versionen tillhandahåller entitetskarttaggar som hjälper dig att unikt identifiera de kartor 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 karta kan bara ha en tagg tilldelad åt gången.
Loggar
Välj Loggar för att se de transaktioner som sker i Dataverse. Loggarna hjälper dig att förstå hur dataflödena, varför något skickas till Dataverse healthcare API till 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 visualisera FHIR-entiteterna direkt för att se alla resurser innehåller verktygen för dataintegrering en lista ö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
Med modulen Hälso- och sjukvårdsdata kan mappa administratörerna för att visa och interagera med de användardata som strömmas in i systemet. Denna funktion hjälper mappningsadministratörerna förstå och felsöka data.
Mappningsadministratörer kan använda modulen för hälso- och sjukvårdsdata för att.
- Visa datan.
- Förstå vad som händer när de bygger kartorna.
- 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 alla patientdata som flödar in i Microsoft Cloud for Healthcare, t.ex. FHIR-ID för en patient, den senaste synkroniseringen av patienten, om synkronisering är aktiverad för den posten och Azure FHIR-versionen av posten.
Exempel 1: 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.
Exempel 2: Kontakt saknas Azure FHIR-information
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.
Exempel 3: Loggposter för återskrivning
När en kontaktpost har ett FHIR ID och du ändrar posten kan du se två loggmeddelanden. Det första meddelandet anger att återställningsprocessen har startat. Posten med namnet Händelsehanteraren för tillbakaskrivning har bearbetats indikerar att ändringarna står i kö för att skickas tillbaka till FHIR-slutpunkten.
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 specificerar det ändrade attributet och anger vad det skickade till FHIR-slutpunkten.
Ett sista loggmeddelande med namnet Tillbakaskrivning av FHIR-proveniens anger ett slutgiltigt granskningsmeddelande som publicerats till FHIR-slutpunkten om de nyligen publicerade uppdateringarna.
Den här kombinationen av meddelanden tyder på en lyckad uppdatering till FHIR-slutpunkten via återställningsprocessen.
Exempel 4: Godkännandeflöde
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. En stor mängd patientdata 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 på Patientåtkomstportalen, godkänner att få sin information förd in i systemet, anges värdet Azure FHIR-synkronisering aktiverad till Ja. Då börjar den patientens data flödar 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. Inställning Azure FHIR-synkronisering aktiverad till Nej förhindrar att data strömmas till FHIR. Det förhindrar också att FHIR kan få tillbaka data till Dataverse för den här patienten.
Samtyckesflödet är unikt endast för patienter som kontakter. Ingen annan postentitet i Dataverse har detta samtyckesflöde inbyggt i den.
Utökningsmappning
Expansionskartor i verktygssatsen för dataintegrering tillåter administratörer att 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:
- Se även
- Ersätter
- Utbytt mot
Mer information om dessa länkar finns i FHIR-länktypen. Med utökningsmappning kan du ange överordnade länkattribut som avgör relationen mellan överordnade och underordnade poster.
Mer information om expansionsmappningar finns i Konfigurera expansionsmappningar.