Del via


Konfigurere attributtilknytninger

Værktøjssættet til dataintegration leverer standardkort, der er designet til at være i overensstemmelse med HL7 FHIR-specifikation. Både objekt- og attributkort installeres dog som Dataverse-poster og kan konfigureres i høj grad for at imødekomme de forskellige løsningskrav.

Du kan få mere at vide om attributtilknytninger ved at gå til Oversigt over attributtilknytninger.

Tip

Du kan bruge indstillingen Eksportér til Excel på kommandolinjen til at eksportere tilknytningsoplysningerne til en excel-fil. Du kan finde flere oplysninger om eksport af data fra din app til en excel-fil ved at gå til Eksportere data til Excel.

felter til attributtilknytninger

Attributtilknytninger leverer noden FHIR til tilknytning af Dataverse på feltniveau. Der skal tages højde for forskellige datatyper.

Feltnavn Beskrivelse
Deaktivér Mærke, der angiver, om attributtilknytningen er deaktiveret. Hvis værdien er angivet til True, springer Dataverse healthcare API-attributtilknytningen over, når der behandles en FHIR-ressource for den relaterede objekttilknytning.
Påkrævet FHIR-attribut Når tilbageførsel er aktiveret, angiver dette mærke, om attributten er påkrævet, når der sendes data til FHIR-serveren.
Objekttilknytning af opdateringsservice En opslagshandling til den overordnet objekttilknytning for attributtilknytningen.
Objektnavn Skemanavnet på tabellen i Dataverse for den overordnede objekttilknytning.
Attributnavn Skemanavnet på den Dataverse-kolonne, som FHIR-værdierne skal knyttes til. Denne liste ændres, afhængigt af valget af objekttilknytning.
Handlingstype Angiver typen af værditilknytning for attributten. Følgende værdier for de understøttede handlingstyper:

Kopiér data: Direkte kopi af dataene uden nogen form for transformation. Denne handlingstype bruges primært, når datatypen i begge systemer stemmer overens.
Angiv standardværdi: Angiv altid en standardværdi i Dataverse. Denne handlingstype er nyttig, når attributten er nødvendig, men ikke findes i kildesystemet.
Tilknyttet værdi: Transformering og tilknytning på dataene. Denne handlingstype bruges bedst, når datatyper ikke stemmer overens, f.eks. med Dataverse-valgmuligheder eller Ja eller Nej-indstillinger .
Opslag: Knytter FHIR-referencer til Dataverse-opslagsværdier.
Kodebart koncept: Knytter en FHIR-kodenode til et kodebart konceptopslag i Dataverse.
Udvid: Knytter en FHIR-node af typen matrix til en relateret udvidelsestabel.
FHIR-elementtype Værdi, der angiver datatypen for elementet i FHIR JSON-meddelelsen.
FHIR-elementtilknytning Det felt, der indeholder JSONPath-forespørgslen for den specifikke FHIR-node. Den indeholder instruktioner til, hvordan den indgående værdi hentes, og hvordan den udgående værdi struktureres til tilbageskrivning. Du kan finde flere oplysninger i dette felt ved at gå til FHIR-elementtilknytningen.
Udvidelsesobjekttilknytning Når du vælger Udvid som Handlingstype, er denne værdi en opslagshandling til den relaterede objekttilknytning af typen Udvidelse. Du kan finde flere oplysninger om udvidelseskort ved at gå til Konfiguration af udvidelseskort.
Bruges i matchning af poster I forbindelse med attributtilknytninger, der er relateret til tilknytninger af udvidelsesobjekt, angiver dette felt, om feltet Dataverse er en nøgle eller en del af en sammensat nøgle, der entydigt identificerer den post, der sendes til Dataverse. Du kan få flere oplysninger i Anvendt i matching af post.

FHIR-elementtilknytning

Attributtilknytningsdefinitionerne for objektet i Dataverse indeholder et FHIR-elementtilknytning-felt. I dette felt defineres, hvordan du kan hente og sende værdier mellem Azure Health Data Services FHIR-tjenesten og FHIR-aktiverede slutpunkter.

Disse tilknytningsdefinitioner findes i et serialiseret JSON-objekt med poster, som understøtter valg af JSONPath til hentning og opdatering af eksisterende egenskabsværdier. Det indeholder også definitioner for indsættelse af nye egenskabsværdier, der ikke allerede findes på modtagerplatformen.

JSON-objektdefinition

{
    "s": "",
    "c": { 
            "p": "",
            "a": [
                   ""
                 ]
}

Hvor

  • "s" = Et gyldigt JSONPath-udtryk, der bruges til at vælge en eksisterende JSON-egenskab for FHIR-ressourcen for at udtrække eller angive værdier fra og til Dataverse.
  • "c" = JSON-egenskabsfelter, der bruges til at indsætte eller oprette JSON-egenskaber, når den markerede sti ikke findes i ressourcens JSON-objekt.
  • "p" = Navnet på den overordnede JSON-egenskab, der skal oprettes.
  • "a" = Matrix med attributter, der skal angives for den valgte JSON-egenskab.

Du kan finde flere oplysninger om og eksempler på konfiguration af attributtilknytning ved at gå til eksempler på attributtilknytning.

Bruges i matchning af poster

Underordnede matrixer i FHIR JSON-meddelelser indeholder ikke entydige id'er som f.eks. FHIR-ressourcer på rodniveau. På grund af denne egenskab kræver Dataverse Healthcare-API'er, tilbageskrivningsproces og virtuelle tilstandsdatatabeller andre kriterier for at sikre, at de korrekte værdier oprettes og opdateres. Feltet Bruges i Postmatch-feltet giver dig mulighed for at identificere, hvilken attribut for udvidelseskort der skal bruges til at bruge den. Dette felt er vigtigt for udvidelseskort og for at bevare dataintegritet under opdatering af Dataverse poster.

Hvis værdien Brugt i Postmatch skal angives til True, skal du have mindst én attributtilknytning for en udvidelsesobjekttilknytning. Hvis mere end én attributtilknytning, har dette felt markeret som True, indeholder den samlede liste over attributtilknytninger en sammensat nøgle, når du opretter og opdaterer nye poster på udvidelsesniveau.

Bemærk

Hvis du ændrer feltværdien, når et system er live i produktion, kan det medføre problemer med at udnytte data, når eksisterende poster ændres. Sørg for, at dit interoperabilitet-team gennemgår dette, inden de foretager ændringer.

Administrere attributtilknytningsposter

I følgende afsnit vises nogle almindelige trin til konfiguration og administration af attributtilknytninger. Hvis du vil have detaljerede eksempler, skal du gå til eksempler på attributtilknytning.

Føje en attributtilknytning til en objekttilknytning

  1. Åbn objekttilknytningen.

  2. Vælg + Ny attributtilknytning af opdateringsservice under Relaterede attributtilknytninger under fanen Generelt.

Deaktivere en attributtilknytning

Hvis du ikke har brug for en attributtilknytning for et objekt, der er inkluderet i standarddataintegrations-værktøjssættet, kan du deaktivere den. Du behøver for eksempel ikke at synkronisere og gemme attributten på vegne af i EMR-systemet for en konsultationspost.

  1. Vælg Attributtilknytninger under Opsætning af tilknytning.

  2. Vælg objektet msemr_encounter, og vælg derefter Rediger.

  3. Vælg msemr_onbehalfof, og vælg derefter Rediger i Relaterede attributtilknytninger.

  4. Angiv værdien på feltet Deaktiveret til Ja.

    Et skærmbillede, der viser, hvordan du deaktiverer en attributtilknytning.

  5. Vælg Gem.

Arkivere en attributtilknytning

Du kan deaktivere en attributtilknytning. Men den kan vises i visningen Opdater aktive tilknytninger af serviceattribut. Hvis du vil fjerne en attributtilknytning fra denne visning, kan du arkivere attributtilknytningen.

  1. Åbn objekttilknytningen.

  2. Vælg attributtilknytningen under Relaterede attributtilknytninger under fanen Generelt.

  3. Vælg Arkivér i overskriften for visningen Opdater aktive tilknytninger af serviceattribut.

Få vist arkiverede attributtilknytninger

  1. Åbn objekttilknytningen.

  2. Vælg Opdater aktive tilknytninger af serviceattribut under Relaterede attributtilknytninger under fanen Generelt, og vælg derefter Arkivere opdaterede serviceattributtilknytninger.

Oprette en tilknytning til serviceattribut

Objektet Kontakt i Dataverse knyttes til patientressourcen i Azure FHIR. Her kan du tilføje attributtilknytninger til denne objekttilknytning:

  1. Vælg Objekttilknytninger under Opsætning af tilknytning.

  2. På listen over objekter skal du vælge Kontakt, der er knyttet til FHIR-ressourcen Patient, og derefter vælge Rediger.

  3. I Relaterede attributtilknytninger skal du vælge + Ny attributtilknytning af opdateringsservice.

  4. Angiv værdien Påkrævet FHIR-attribut til Nej.

    Denne indstilling angiver, hvordan data strømmer tilbage til det konfigureret FHIR-slutpunkt. Når der indtræffer en ændring i Dataverse for denne patient, og den påkrævede FHIR-attribut er angivet til Ja, skal du udfylde attributten. Hvis du ikke udfylder attributten, gemmes ændringen i Dataverse, men den ville ikke blive udgivet i FHIR-slutpunktet. Hændelsen skrives til logfilerne.

  5. Vælg Fornavn (firstname) for Attributnavn.

  6. Vælg Kopiér data for Handlingstype. Denne værdi betyder, at strengdata på det ene system kopieres til det andet system.

  7. Tilføj den JSON-søgestreng, der fungerer sammen med FHIR-API'en, for FHIR-elementtilknytning. Du kan for eksempel tilføje en JSON-søgestreng, der giver dig mulighed for at få adgang til FHIR-elementet fornavn.

    Et skærmbillede, hvor der vises en eksempelværdi for FHIR-elementtilknytning.

  8. Vælg Gem. Sektionen Værditilknytninger vises nu i det samme vindue med indstillingen + Ny attributværditilknytning. Kontaktobjektet kræver ikke en værditilknytning, da det er en streng.

  9. I objekttilknytningen for Kontakt under Relaterede attributtilknytninger kan du nu se attributtilknytningen med navnet firstname.