Määritteiden yhdistämismääritysten määrittäminen
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 hakutoiminto. |
| 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ääritteen arvoyhdistämismäärityksen tyyppi. Tuetut toimintotyypin arvot: Kopioi tiedot: Tietojen suora kopio ilman muunnoksia. Tätä toimintotyyppiä käytetään ensisijaisesti silloin, kun järjestelmien tietotyypit vastaavat toisiaan. Määritä oletusarvo: Määritä aina oletusarvo Dataversessä. Tämä toimintotyyppi on kätevä, kun määritettä tarvitaan mutta sitä ei ole lähdejärjestelmässä. Yhdistetty arvo: Suorita tiedoille muunnoksia ja yhdistämismäärityksiä. 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 Dataversessä. 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 valitset Toiminnon tyyppi -arvoksi Laajenna, tämä arvo on hakutoiminto tyypin Laajennus liittyvässä entiteetin yhdistämismäärityksessä. 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 yhdistämismäärityksen määritykset Dataversessä sisältävät FHIR-elementin yhdistämismääritys -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": [
""
]
}
Missä
- "s" = kelvollinen JSONPath-lauseke, jolla valitaan FHIR-resurssin aiemmin luotu JSON-ominaisuus arvojen noutamiseen tai määrittämiseen Dataversestä tai Dataversessä.
- "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ä
FHIR JSON -sanomien alimatriisit eivät sisällä yksilöllisiä tunnuksia, kuten juuritason FHIR-resurssit. Tämän ominaisuuden vuoksi Dataverse Healthcare API -ohjelmointirajapinnat, takaisinkirjoitusprosessi ja virtuaaliset terveystietotaulukot tarvitsevat muita kriteerejä sen varmistamiseksi, 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ä kenttä on tärkeä laajennusyhdistämismääritysten sekä tietojen eheyden säilyttämisen kannalta, kun Dataverse-tietueita päivitetään.
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
Avaa entiteettikartta.
Valitse Yleiset-välilehden Liittyvien määritekarttojen kohdasta Uusi päivityspalvelun määritekartta.
Määritekartan poistaminen käytöstä
Jos et tarvitse määritteen yhdistämismääritystä oletusarvoisiin tietojen integroinnin työkalupakettiin sisältyvälle entiteetille, voit poistaa sen käytöstä. Sinun ei esimerkiksi välttämättä tarvitse synkronoida ja tallentaa puolesta-määritettä EMR-järjestelmään kohtaaminen-entiteetin osalta.
Valitse Yhdistämismääritykset-kohdassa Määritekartat.
Valitse msemr_encounter-entiteetti ja valitse sitten Muokkaa.
Valitse Liittyvät määritteenkartat -kohdassa msemr_onbehalfof ja valitse sitten Muokkaa.
Määritä Pois käytöstä -kentän arvoksi Kyllä.
Valitse Tallenna.
Määritekartan arkistoiminen
Voit poistaa käytöstä minkä tahansa määritteen yhdistämismäärityksen. Ne näkyvät siitä huolimatta 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.
Avaa entiteettikartta.
Valitse Yleiset-välilehden Liittyvien määritekarttojen kohdasta määritekartta.
Valitse Aktiiviset päivityspalvelumääritekartat -näkymän otsikosta Arkistoi.
Tarkastele arkistoituja määritekarttoja
Avaa entiteettikartta.
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. Määritteiden yhdistämismäärityksiä lisätään tähän entiteetin yhdistämismääritykseen seuraavasti:
Valitse Kartan määritykset-kohdassa Entiteettikartat.
Valitse entiteettiluettelosta Yhteyshenkilö-entiteetti, joka on yhdistetty FHIR-resurssiin Potilas, ja valitse sitten Muokkaa.
Valitse Liittyvät määritteiden tietokartat -kohdassa Uusi päivityspalvelumäärityskartta.
Määritä Vaaditun FHIR-määritteen arvoksi Ei.
Tämä asetus ilmaisee, miten tiedot virtaavat takaisin määritettyyn FHIR-päätepisteeseen. Kun Dataversessä tapahtuu muutos tämän potilaan osalta ja FHIR vaaditaan -määritteen arvona on Kyllä, määrite on täytettävä. Jos et täytä määritettä, muutos tallennetaan Dataverseen, mutta sitä ei julkaista FHIR-päätepisteeseen. Tapahtuma kirjoitetaan lokeihin.
Valitse Määritteen nimeksi Etunimi (etunimi).
Valitse Toimintotyypiksi Kopioi tiedot. Tämä arvo tarkoittaa, että yhden järjestelmän merkkijonotiedot kopioidaan toiseen järjestelmään.
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.
Valitse Tallenna. Arvokartat-osa näkyy nyt samassa ikkunassa+ Uusi määritteiden arvokartta -vaihtoehdon kanssa. Yhteyshenkilöentiteetti ei tarvitse arvokarttaa, koska se on merkkijono.
Yhteyshenkilön entiteettikartassa Liittyvien määritteiden kartassa etunimen määritekartta näkyy luettelomääritekartoilla.
