Dataverse Healthcare API -ohjelmointirajapintojen takaisinkirjoituksen yleiskatsaus
Dataverse Healthcare upsert API -ohjelmointirajapinta mahdollistaa FHIR-tietojen käytön Dataversessa. 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:
- Käyttäjä päivittää tietueen Dataversessa.
- 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ä.
Käyttäjät voivat tarvittaessa määrittää vaihtoehtoisen takaisinkirjoitusmenetelmän laajennettavuutta varten.
- Dataverse lähettää FHIR-resurssipyynnön käyttäjän määrittämään päätepisteeseen.
- Käyttäjän määrittämä päätepiste vastaa julkaistun FHIR-resurssin käsittelystä ja lähettämisestä FHIR-ohjelmointirajapintaan.
- Käyttäjä on vastuussa toiminnallisten tulosten kirjaamisesta, jotta järjestelmänvalvoja voi tarkistaa mahdolliset virheet lähettäessään tietoja mukautettuun päätepisteeseen.
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. Tämä määritys on testattu ja vahvistettu Azure Health Data Services FHIR -palvelulla.
FHIR-lähtöisyys-tietue kirjataan myös FHIR-päätepisteeseen, kun palautustapahtuma käsitellään. Lähtöisyysresurssi seuraa tietoja aktiviteetista, joka loi, korjasi, poisti tai allekirjoitti resurssin version ja kuvasi siihen liittyvät entiteetit ja asiakaspalvelijat. 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
Takaisinkirjoituksen määrityksessä annetaan ensimmäisenä sen FHIR-päätepisteen liitettävyystiedot, joka vastaanottaa lähetetyt FHIR-resurssit. Nämä määritysarvot ovat tietojen integroinnin työkalupaketin Integrointiasetukset-osassa.
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 entiteettikartalle on otettu käyttöön palautus, Järjestelmänvalvoja voi valita, mitkä tapahtumat käynnistävät palautusprosessin tuettujen viestien lomakekentän osoittamalla tavalla. 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 lisämääritysasetuksen palautusta varten. Potilaat voivat suostua tietojen päivitykseen Dataverse-sovelluksesta tai kieltää tietojen päivityksen. Tämä hyväksyntä tallennetaan kullekin potilaalle Azure FHIR-synkronointiagentti otettu käyttöön -määritteeseen.
Jos Azure FHIR -synkronointi käytössä -määritteen arvoksi on määritetty Kyllä ja takaisinkirjoituksen Potilas-entiteetin yhdistämismäärite on määritetty, yhdistettyjen määritteiden mahdolliset muutokset lähetetään 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ävyysasetukset ovat virheelliset, takaisinkirjaukset kirjaavat poikkeuksen ja lopettavat käsittelyn. Esimerkiksi sovellus- tai asiakastunnuksen tai asiakasohjelman salasanan arvot voivat olla virheellisiä.
Varoitussanoma käsitelty
FHIR-päätepiste voi palauttaa joitakin varoituksia tai tietosanomia, vaikka palautuspyyntö olisi käsitelty onnistuneesti. Tämän varoitussanoman alilokit sisältävät lisätietoja järjestelmänvalvojien tarkistettavaksi.
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
Jos Dataversen yhteyshenkilötietueet ovat valmiina, yhteyshenkilötyyppi on määritettävä oikein, jotta palautus onnistuisi. Arvoksi on esimerkiksi määritettävä joko potilas- tai ammatinharjoittaja. 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: Palautusratkaisu tukee tällä hetkellä lähettämistä päätepisteille, jotka tukevat vain OAuth-todennusta.
Katso myös
Mikä on Microsoft Cloud for Healthcare?
Tietojen integroinnin työkalupaketin yleiskatsaus
Dataverse Healthcare API -ohjelmointirajapintojen yleiskatsaus
Dataverse Healthcare API -ohjelmointirajapintojen määrittäminen
Dataverse Healthcare API -ohjelmointirajapintojen lokien tarkasteleminen