Dataverse Healthcare API -ohjelmointirajapintojen takaisinkirjoituksen yleiskatsaus
Dataverse Healtcare upsert API -ohjelmointirajapinta avustaa FHIR (Fast Healthcare Interoperability Resources) -tietojen Dataverse-käsittelyssä. Kun tiedot ovat käytettävissä Dataversessä, käyttäjät voivat päivittää uudet tietueet, kuten päivittää potilasdemografiatiedot. Dataverse Healthcare API -ohjelmointirajapintojen takaisinkirjoitusratkaisu mahdollistaa näiden muutosten lähettämisen takaisin alkuperäiseen FHIR-palvelimeen.
Ratkaisu tarjoaa hieman laajennettavuutta takaisinpalautusta varten. Takaisinkirjoituksen määritys voi kohdistua myös vaihtoehtoiseen päätepisteeseen, jos käyttäjien on lisättävä prosessiin mukautettua logiikkaa. Esimerkiksi mukautettu Azure Logic -sovellus voidaan kohdistaa lähtevään viestiin, joka suorittaa jatkokäsittelyä tai reititystä. Tämän vaihtoehtoisen lähtevän päätepisteen on tuettava todennusta OAuth 2.0:n kautta käyttämällä asiakastunnusta ja asiakasohjelman salasanaa.
Seuraavassa kaaviossa on takaisinkirjoitusprosessin yleiskuva:
Yleiset käsittelyvaiheet ovat seuraavat:
- Päivität tietueen Dataversessä.
- Dataverse arvioi muutoksen ja koostaa uuden FHIR-resurssin, joka lähetetään FHIR API -päätepisteeseen.
- FHIR:n päätepiste käsittelee FHIR-resurssin ja palauttaa toiminnon tuloksen vastauksen Dataverseen.
- Dataverse kirjaa operatiiviset tulokset tietojen integroinnin työkalupaketin lokeihin. Järjestelmänvalvoja voi tarkastella virheitä täällä.
Laajennettavuutta varten voit tarvittaessa määrittää vaihtoehtoisen takaisinkirjoitustavan.
- Dataverse lähettää FHIR-resurssipyynnön määritettyyn päätepisteeseen.
- Määritetty päätepiste vastaa julkaistun FHIR-resurssin käsittelystä ja lähettämisestä FHIR-ohjelmointirajapinnalle.
- Olet vastuussa toiminnallisten tulosten kirjaamisesta, jotta järjestelmänvalvoja voi arvioida virheet ja lähettää tietoja mukautetulle päätepisteelle.
Muistiinpano
Dataversen terveydenhuollon ohjelmointirajapintojen nykyisessä versiossa ja takaisinkirjoitusprosessissa oletetaan, että FHIR-palvelu on käytettävissä lähtevän FHIR-resurssin luonnissa ja tarkistamisessa. Tämä asetus on pakollinen, jos molemmat kirjoitetaan suoraan FHIR-palveluun tai vaihtoehtoiseen lähtevään päätepisteeseen. Se varmistaa lähtevän FHIR-resurssin yhtenäisyyden, kun takaisinkirjoitustapahtuma ilmenee. Olemme testanneet ja vahvistaneet tämän määrityksen Azure Health Data Services FHIR -palvelulla.
FHIR-lähtöisyys-tietue kirjataan myös FHIR-päätepisteeseen, kun palautustapahtuma käsitellään. Alkuperäresurssi jäljittää sen aktiviteetin tietoja, joka on luonut, tarkistanut, poistanut tai allekirjoittanut resurssin version. Se myös kuvailee asiaan liittyvät entiteetit ja agentit. Näiden tietojen perusteella voidaan muodostaa arvioita sen laadusta, vakaudesta ja luotettavuudesta. Se tarjoaa myös viitteitä siitä, minne mennä resurssin ja siinä olevien tietojen alkuperän tutkimiseksi.
Lisätietoja FHIR-alkuperästä on kohdassa FHIR-resurssien alkuperä.
Takaisinkirjoituksen ottaminen käyttöön
Palautusprosessin käyttöönotto sisältää seuraavat kolme ensisijaista vaihetta:
Anna yhteyden tiedot
Anna julkaistut FHIR-resurssit vastaanottavan FHIR-päätepisteen liitettävyystiedot. Löydät nämä määritysarvot tietojen integroinnin työkalupaketin Integrointiasetukset-osasta.
Lisätietoja näistä asetuksista on kohdassa Integrointiasetusten määrittäminen.
Päivitä entiteettien yhdistämismääritykset
Yhteyksien tietojen antamisen jälkeen seuraava vaihe on päivittää entiteettikartat, jotka ohjaavat sitä, mihin FHIR-resursseihin tulisi osallistua takaisinkirjoitusprosessissa.
Takaisinkirjoituslaajennukset käyttävät samoja entiteettien yhdistämismäärityksiä, jotka on määritetty upsert-ohjelmointirajapintaa varten. Kussakin entiteettikartassa voi olla Määrite, jonka nimi on Ota palautus käyttöön FHIR:ssä. Jos tämän määritteen arvo on Kyllä, takaisinkirjoituksen laajennukset lähettävät valitun Dataverse-taulun päivitykset FHIR-päätepisteeseen. Tämä prosessi sallii rakeisen taulukko-taulukolta-ohjausobjektin siitä, mitä tietoja tulisi kirjoittaa takaisin FHIR-päätepisteeseen.
Kun otat takaisinkirjoituksen käyttöön entiteetin yhdistämismäärityksen osalta, järjestelmänvalvoja voi valita, mitkä tapahtumat käynnistävät takaisinkirjoitusprosessin (esitetään Tuetut sanomat -kentässä). Palautusratkaisu tukee tällä hetkellä Luo ja päivitä-viestejä.
Lisätietoja entiteettien yhdistämismääritysten määrittämisestä on kohdassa Entiteettien yhdistämismääritysten määrittäminen.
Potilaskäytön hyväksyntä
Potilasresurssit sisältävät ylimääräisen määritysasetuksen takaisinkirjoitusta varten. Potilaat voivat suostua tietojen päivitykseen Dataverse-sovelluksesta tai kieltää tietojen päivityksen. Azure FHIR -synkronointi käytössä -määrite tallentaa tämän suostumuksen kunkin potilaan osalta.
Kun Azure FHIR -synkronointi käytössä -määritteen arvona on Kyllä ja entiteetin yhdistämismääritys Potilas on määritetty takaisinkirjoitusta varten, kaikki yhdistettyjen määritteiden muutokset julkaistaan FHIR-päätepisteeseen. Muussa tapauksessa takaisinkirjoituksen laajennukset ohittavat potilastietueessa tehdyt muutokset.
Yleiset varoitukset ja virheskenaariot
Takaisinkirjoituksen aikana mahdollisesti esiintyvät varoitukset ja poikkeukset kirjataan tietojen integroinnin työkalupaketin lokeihin. Lisätietoja lokeista on kohdassa Dataverse Healthcare API -ohjelmointirajapinnan lokien tarkasteleminen.
Virheelliset määritysasetukset
Jos Integrointiasetukset-osassa annetut liitettävyystiedot ovat virheelliset, takaisinkirjoitusprosessi kirjaa poikkeuksen ja keskeyttää käsittelyn. Esimerkiksi arvo Sovellus-/asiakastunnus tai Asiakasohjelman salasana voi olla virheellinen.
Varoitussanoma käsitelty
FHIR-päätepiste saattaa palauttaa varoituksia tai tietosanomia, vaikka takaisinkirjoituspyyntö olisi käsitelty onnistuneesti. Tämän varoitussanoman alilokit sisältävät tarkempia tietoja järjestelmänvalvojien tarkastettavaksi.
FHIR-alkuperävirheet
Kaikki FHIR-alkuperätietueen luomiseen liittyvät poikkeukset kirjataan yleisenä poikkeuksena, minkä lisäksi kirjataan FHIR-päätepisteen palauttamat tiedot.
Pakollisia määritteitä puuttuu
Laajennuskarttojen palautuskäsittely edellyttää viittausta ylätason tietueeseen. Jos päälinkkimääritteen arvo puuttuu, takaisinkirjausprosessi kirjaa poikkeuksen ja keskeyttää käsittelyn.
Virheellinen yhteyshenkilötyyppi
Dataversen yhteyshenkilötietueiden osalta Yhteyshenkilötyyppi-ilmaisin on määritettävä oikein, jotta takaisinkirjoitus onnistuu. Sinun on määritettävä sen arvoksi esimerkiksi Potilas tai Ammattilainen. Jos arvo puuttuu, takaisinkirjausprosessi kirjaa poikkeuksen ja keskeyttää käsittelyn.
Rajoitukset
Palautusratkaisulla on tällä hetkellä seuraavat rajoitukset:
- Lähtevä muotoilu: palautusratkaisu ei tue lähtevää muotoilua. Prosessi kirjaa tällä hetkellä FHIR-resurssin, joka vastaa päivitetyn FHIR-resurssin muutoksia Dataversessä.
- Todennus: Takaisinkirjoitusratkaisu tukee tällä hetkellä julkaisemista vain päätepisteisiin, joissa käytetään OAuth-todennusta.