Jaa


Määritteiden yhdistämismääritysten määrittäminen

Huomautus

FHIR:n synkronointiagentti on nyt uudelleenbrändätty tietojen integroinnin työkalupaketiksi.

Tietojen integroinnin työkalupaketin mukana toimitetaan laaja kokoelma oletusyhdistämismäärityksiä, jotka on muodostettu noudattamaan HL7 FHIR -määritystä. Kuitenkin sekä entiteettien yhdistämismääritykset että määritteiden yhdistämismääritykset otetaan käyttöön Dataverse-tietueina, ja niitä voidaan määrittää monipuolisesti ratkaisun erilaisia tarpeita varten.

Lisätietoja määritteiden yhdistämismäärityksistä on kohdassa Määritteiden yhdistämismääritysten yleiskatsaus.

Vihje

Yhdistämistiedot voidaan viedä Excel-tiedostoon komentopalkin Vie Exceliin -vaihtoehdon avulla. Lisätietoja tietojen viennistä sovelluksesta Excel-tiedostoon on kohdassa Tietojen vienti Exceliin.

Määritteen yhdistämismäärityksen kentät

Määritteiden yhdistämismääritykset muodostavat FHIR-solmun Dataversen kenttätason yhdistämismääritykseen. Määritysten on otettava huomioon erilaiset tietotyypit.

Kentän nimi Kuvaus
Disable Merkintä ilmaisee, onko määritteen yhdistämismääritys poistettu käytöstä. Jos arvoksi on määritetty True, Dataverse Healthcare API ohittaa määritteen yhdistämismäärityksen, kun liittyvän entiteetin yhdistämismäärityksen FHIR-resurssia käsitellään.
FHIR:n pakollinen määrite Jos takaisinkirjoitus on otettu käyttöön, tämä merkintä ilmaisee, onko määrite pakollinen, kun tietojen lähetetään FHIR-palvelimeen.
Päivityspalvelun entiteetin yhdistämismääritys Määritteen yhdistämismäärityksen pääentiteetin yhdistämismäärityksen haku.
Entiteetin nimi Pääentiteetin yhdistämismäärityksen Dataverse-taulukon rakenteen nimi.
Määritteen nimi Sen Dataverse-sarakkeen rakenteen nimi, johon FHIR-arvot yhdistetään. Tämä luettelo vaihtelee entiteetin yhdistämismäärityksen valinnan mukaan.
Toiminnon tyyppi Määritteessä tapahtuman arvoyhdistämismäärityksen tyyppi. Seuraavassa on luettelo erilaisten toimintotyyppien arvoista:

Kopioi tiedot: Tietojen suora kopiointi ilman minkäänlaista muuntamista. Tätä toimintotyyppiä käytetään ensisijaisesti silloin, kun järjestelmien tietotyypit vastaavat toisiaan.
Määritä oletusarvo: CDS:ssä on aina määritettävä oletusarvo. Tämä toimintotyyppi on kätevä, kun määritettä tarvitaan mutta sitä ei ole lähdejärjestelmässä.
Yhdistetty arvo: Tietojen muuntaminen ja yhdistäminen. Tämä toimintotyyppi toimii parhaiten, kun tietotyypit eivät vastaan toisiaan, kuten verrattaessa Dataversen valintoja tai Kyllä- tai Ei-vaihtoehtoja.
Haku: yhdistää FHIR-viitteet Dataverse-hakuarvoihin.
Codeable Concept: yhdistää FHIR-koodaussolmun Codeable Concept -hakuun Dataversessa.
Laajenna: yhdistää matriisityyppisen FHIR-solmun liittyvään laajennustaulukkoon.
FHIR-elementin tyyppi Elementin tietotyypin FHIR JSON -sanomassa ilmaiseva arvo.
FHIR-elementtikartta Tietyn FHIR-solmun JSONPath-kyselyn sisältävä kenttä. Se sisältää ohjeet saapuvan arvon noutamisesta ja lähtevän arvon rakenteesta takaisinkirjoitusta varten. Lisätietoja tästä kentästä on kohdassa FHIR-elementtikartta.
Laajennusentiteetin yhdistämismääritys Kun Laajenna valitaan toimintotyypiksi, tämä arvo on liittyvän Laajennus-tyypin entiteetin yhdistämismäärityksen haku. Lisätietoja laajennuskartoista on kohdassa Laajennuskarttojen määrittäminen.
Käytetään tietueen vastineen etsinnässä Tämä kenttä ilmaiseen laajennusentiteettien yhdistämismäärityksiin liittyvissä määritteen yhdistämismäärityksissä, onko Dataverse-kenttä avain vai sellaisen yhdistelmäavaimen osa, joka tunnistaa yksilöivästi Dataverseen lähetetyn tietueen. Lisätietoja on kohdassa Käytetään tietueen vastineen etsinnässä.

FHIR-elementtikartta

Entiteetin määritteen yhdistelmämäärityksen määritelmät sisältävät Microsoft Dataversessa FHIR-elementtikartta-kentän. Tämä kenttä määrittää, miten arvoja noudetaan ja lähetetään Azure Health -tietopalvelujen FHIR-palvelun ja FHIR-yhteensopivien päätepisteiden välillä.

Nämä yhdistämismäärityksen määritelmät sisältyvät sarjoitettuun JSON-objektiin. Siinä olevat merkinnät tukevat JSONPath-valintaa, jolla noudetaan ja päivitetään olemassa olevia ominaisuusarvoja. Se sisältää myös määritelmiä, joilla voi lisätä uusia ominaisuusarvoja, joita ei ole vielä vastaanottavassa ympäristössä.

JSON-objektin määritelmä

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

jossa

  • "s" = kelvollinen JSONPath-lauseke, jolla valitaan FHIR-resurssin aiemmin luotu JSON-ominaisuus arvojen noutamiseen tai määrittämiseen Dataversesta tai Dataversessa.
  • "c" = JSON-ominaisuuden kentät, joita käytetään JSON-ominaisuuksien lisäämiseen ja luomiseen, kun valittua polkua ei ole resurssin JSON-objektissa.
  • "p" = Luotava JSON-pääominaisuuden nimi.
  • "a" = Valitulle JSON-ominaisuudelle määritettävien määritteiden taulukko.

Lisätietoja ja esimerkkejä määritteen yhdistämismäärityksen määrittämisestä on kohdassa Määritteen yhdistämismääritysesimerkkejä.

Käytetään tietueen vastineen etsinnässä

Koska FHIR JSON -sanomien alimatriisit eivät sisällä yksilöiviä tunnisteita, kuten juuritason FHIR-resursseja, Dataverse Healthcare API -ohjelmointirajapinnat, takaisinkirjoitusprosessi ja virtuaaliset terveystietotaulukot tarvitsevat muita ehtoja varmistamaan, että oikeat arvot luodaan ja päivitetään. Käytetään tietueen vastineen etsinnässä -kenttä mahdollistaa sen määrittämisen, mitä laajennuskartan määritettä on käytettävä yksilöinnin osoituksena. Tämä on tärkeää laajennuskartoissa ja tietojen eheyden ylläpitämisessä Dataverse-tietueita päivitettäessä.

Käytetään tietueen vastineen etsinnässä -arvojoukon True-määritys edellyttää, että käytössä on ainakin yksi laajennusentiteetin yhdistämismäärityksen määritteen yhdistämismääritys. Jos tässä kentässä usean määritteen yhdistämismäärityksen arvoksi on merkitty True, määritteiden yhdistämismääritteiden yhdistelmäluettelo muodostaa yhdistelmäavaimen uusia laajennustason tietueita luotaessa ja päivitettäessä.

Huomautus

Tämän arvon muokkaaminen sen jälkeen, kun järjestelmä on otettu käyttöön tuotantoympäristössä, saattaa aiheuttaa tietojen vioittumista aiemmin luotuja tietoja muokattaessa. Yhteentoimivuustiimin on tämän vuoksi arvioitava tämä ennen muutosten tekemistä.

Määritteen yhdistämismääritystietueiden hallinta

Seuraavassa osassa luettelo joistakin yleisistä vaiheista määritteiden yhdistämismääritysten määrittämisestä ja hallinnasta. Yksityiskohtaisia esimerkkejä on kohdassa Määritteen yhdistämismääritysesimerkkejä.

Määritekartan lisääminen entiteettikarttaan

  1. Avaa entiteettikartta.

  2. Valitse Yleiset-välilehden Liittyvien määritekarttojen kohdasta Uusi päivityspalvelun määritekartta.

Määritekartan poistaminen käytöstä

Jos määritteen yhdistämismääritystä ei tarvita entiteetille, joka sisältyy tietojen integroinnin työkalupaketin oletusyhdistämismäärityksiin, se voidaan poistaa käytöstä. Esimerkiksi kohtaamis-entiteettiä varten attribuuttia puolesta ei välttämättä tarvitse synkronoida ja tallentaa EMR-järjestelmään.

  1. Valitse Yhdistämismääritykset-kohdassa Määritekartat.

  2. Valitse msemr_encounter-entiteetti ja valitse sitten Muokkaa.

  3. Valitse Liittyvät määritteenkartat -kohdassa msemr_onbehalfof ja valitse sitten Muokkaa.

  4. Aseta kohteen poissa käytöstä arvoksi Kyllä.

    Näyttökuva siitä, miten määritekartta poistetaan käytöstä.

  5. Valitse Tallenna.

Määritekartan arkistoiminen

Vaikka mikä tahansa määritteen yhdistämismääritys voidaan poistaa käytöstä, se näkyy edelleen Aktiiviset päivityspalvelun määritteen yhdistämismääritykset -näkymässä. Määritteen yhdistämismääritys voidaan poistaa tästä näkymästä arkistoimalla se.

  1. Avaa entiteettikartta.

  2. Valitse Yleiset-välilehden Liittyvien määritekarttojen kohdasta määritekartta.

  3. Valitse Aktiiviset päivityspalvelumääritekartat -näkymän otsikosta Arkistoi.

Tarkastele arkistoituja määritekarttoja

  1. Avaa entiteettikartta.

  2. Valitse Yleiset-välilehden Liittyvien määritekarttojen kohdasta Aktiiviset päivityspalvelumääritekartat ja valitse sitten Arkistoidut päivityspalvelumääritekartat.

Palvelumääritekartan päivittäminen

Dataversen Yhteyshenkilö-entiteetti on yhdistetty Azure FHIR:n potilasresurssiin. Voit lisätä määritekarttoja entiteettikarttaan.

  1. Valitse Kartan määritykset-kohdassa Entiteettikartat.

  2. Valitse entiteettiluettelosta yhteyshenkilö, joka on yhdistetty FHIR-resurssin potilas-tietueen kanssa, ja valitse sitten Muokkaa.

  3. Valitse Liittyvät määritteiden tietokartat -kohdassa Uusi päivityspalvelumäärityskartta.

  4. Määritä Vaaditun FHIR-määritteen arvoksi Ei.

    Tämä asetus ilmaisee, miten tiedot virtaavat takaisin määritettyyn FHIR-päätepisteeseen. Kun Dataversen sisällä tapahtuu muutos tälle potilaalle ja FHIR:n vaadittu attribuutti on asetettu arvoon Kyllä, jos käyttäjä ei ole täyttänyt attribuuttia, Dataverse-muutos tallentuu Dataverseen, mutta sitä ei palauteta takaisin FHIR-päätepisteeseen. Tapahtuma kirjoitetaan lokeihin.

  5. Valitse Määritteen nimeksi Etunimi (etunimi).

  6. Valitse Toimintotyypiksi Kopioi tiedot. Tämä arvo tarkoittaa sitä, että toisen järjestelmän merkkijonotiedot kopioidaan toiseen järjestelmään.

  7. Lisää FHIR-elementtikartalle JSON-hakumerkkijono, joka toimii FHIR-ohjelmointirajapinnan kanssa. Voit esimerkiksi lisätä JSON-hakumerkkijonon, jonka avulla pääset FHIR-elementtiin, joka on Etunimi.

    Näyttökuva, jossa näkyy FHIR-näyte-elementin kartan arvo.

  8. Valitse Tallenna. Arvokartat-osa näkyy nyt samassa ikkunassa+ Uusi määritteiden arvokartta -vaihtoehdon kanssa. Yhteyshenkilöentiteetti ei tarvitse arvokarttaa, koska se on merkkijono.

  9. Yhteyshenkilön entiteettikartassa Liittyvien määritteiden kartassa etunimen määritekartta näkyy luettelomääritekartoilla.

Katso myös

Mikä on Microsoft Cloud for Healthcare?
Tietojen integroinnin työkalupaketin yleiskatsaus
FHIR-tietojen hallinta tietojen integroinnin työkalupaketti
Entiteettien yhdistämismääritysten määrittäminen
Laajennuskarttojen määrittäminen
Tietojen integroinnin työkalupaketin yhdistämismääritykset: esimerkkejä ja käyttötapauksia