FHIRlink-yhdistimen määrittäminen
Terveydenhuoltoala on nopeasti siirtymässä uuteen HL7 FHIR® -standardiin. FHIR (Fast Healthcare Interoperability Resources) -standardi määrittelee laajennettavan tietomallin, jossa on standardoitu semantiikka ja tiedonvaihto, joka mahdollistaa yhteiskäytön ja nopean tiedonvaihdon sovelluksissa. Microsoft Healthin ja Life Sciencen FHIRlink-yhdistin on ensimmäisen osapuolen Power Platform -FHIR-yhdistin, jonka avulla Power App -sovelluskehittäjät voivat rakentaa vähäkoodisia, koodittomia -sovelluksia, jotka ovat suoraan yhteydessä FHIR-tietoihin. Yhdistin tukee useita todentamismenetelmiä turvallisuuden parantamiseksi. Se yksinkertaistaa FHIR-palvelutodennuksia, kyselyjä ja FHIR-tietojen käsittelyä. Näin mukautettuja kertakäyttöratkaisuja ei tarvita.
Toimintoon kuuluvat seuraavat avainedut:
- Tarjoaa mukautetun yhdistimen, joka on suunniteltu käytettäväksi Power Platformin pohjaan perustuvien sovellusten, Power Automaten työnkulkujen ja Azure Logic Appsin kanssa.
- Mahdollistaa suoran pääsyn FHIR-palveluihin Power Platformista ja Azuresta.
- Tukee Azure Health -tietopalvelun FHIR-palvelun ja Google™ FHIR -palveluiden todennusta.
- Vähentää FHIR-palvelun sovellusrajapintojen ja tuloksena olevien FHIR-tietojen kanssa työskentelyn monimutkaisuutta.
Tässä artikkelissa on yleiskatsaus ja ohjeet FHIRlink-yhteyksien käyttöön ja asetusten määrittämiseen. Lisätietoja muista ensimmäisen osapuolen yhdistimistä, joita voit käyttää FHIRlink-sovelluksella monimutkaisten terveydenhuollon sovellusten rakentamisessa Power Platformissa, on kohdassa Yhdistinviitteiden yleiskatsaus.
edellytykset
Varmista, että seuraavat edellytykset täyttyvät:
- Aktiivinen Power Apps -käyttöoikeus.
- Aktiivinen Power Automate Premium -käyttöoikeus.
- Aktiivinen FHIR-palvelinasennus, jossa on näytetietoja, kuten aktiivinen Azure Health -tietopalveluiden FHIR-palvelu -asennus.
- Oikeudet luoda ja päivittää tietoja FHIR-palvelussasi.
Luo yhteys
Yhdistin tukee seuraavia todentamismenetelmiä:
- Käytä jaettua Azure-oletussovellusta
- Ota mukaan oma Google™-sovellus
- Ota mukaan oma EPIC™ on FHIR®-sovellus
Kun olet luonut yhteyden, voit käyttää sitä yhdessä tai useassa pohjaan perustuvassasovelluksessa, Power Automate -työnkuluissa tai Azure Logic Appsissa.
Muistiinpano
FHIR® (jonka omistaa Health Level Seven International), Google™ (jonka omistaa Google LLC) ja EPIC® (jonka omistaa Epic Systems Corporation) ovat rekisteröityjä tavaramerkkejä Näiden tuotemerkkien käyttö tällä sivulla ei merkitse Health Level Seven Internationalin, Googlen tai Epic Systemsin hyväksyntää.
Käytä jaettua Azure-oletussovellusta
Tätä vaihtoehtoa voidaan käyttää, kun muodostat yhteyden Azure Health -tietopalveluun Azure API for FHIR. Todentamismenetelmä tarvitsee seuraavat kaksi arvoa:
- Azure FHIR -palvelun päätepisteen URL-osoite: Azure FHIR -palvelun päätepisteen URL-osoite. Esimerkki:
https://{{fhirservicename}}.fhir.azurehealthcareapis.com. - Azure FHIR -palvelun resurssin URI: Microsoft Entra ID:ssä käytetty tunniste kohde-FHIR-palveluresurssin tunnistamiseksi. Azure FHIR -palveluissa URI noudattaa yleensä muotoa
https://{{fhirservicename}}.fhir.azurehealthcareapis.com.
Tämä yhteysasetus edellyttää yhteyttä seuraavaa määritystä:
Microsoft Entra-käyttäjätili.
Azure Health tietopalvelun FHIR-palvelun käyttäjätilille myönnetyt asianmukaiset käyttöoikeudet. Esimerkiksi FHIR-tietojen lukijarooli.
Lisätietoja käyttöoikeusmäärityksistä on ohjeaiheessa Azure TRBAC:n määrittäminen FHIR:tä varten.
Muistiinpano
Seuraavissa FHIRlink-yhdistinversioissa voidaan muodostaa yhteys Azure Health -tietopalvelun FHIR-palveluun käyttämällä jaettua yhteyttä tukevia rekisteröidyn palvelun asiakasohjelmasovelluksia ja OAuth-ratkaisua.
Oman Google™-sovelluksen tuominen
Tätä vaihtoehtoa voi käyttää, kun yhteys muodostetaan Google™ Cloud Healthcaren ohjelmointirajapintaan. Todentaminen tarvitsee seuraavat kolme arvoa:
- Google™ FHIR -palvelun päätepisteen URL-osoite: Google™ FHIR -palvelun päätepisteen URL-osoite. Esimerkki:
https://healthcare.googleapis.com/{{fhirservicepath}}/fhir. - Asiakasohjelman tunnus: Google™-sovelluksen asiakasohjelman tai sovelluksen tunnus.
- Asiakasohjelman salasana: Google™-sovelluksen asiakasohjelman salasana.
Lisätietoja OAuthin määrittämisestä Google™ Healthcare Cloudissa on kohdassa OAuth-asiakassovelluksen luominen Googlessa™.
Ota mukaan oma EPIC™ on FHIR®-sovellus
Tätä vaihtoehtoa voi käyttää, kun muodostat yhteyden EPIC® on FHIR® -ohjelmointirajapintaan. Todennukseen tarvitaan seuraavat arvot:
- Epic on FHIR -palvelun päätepisteen URL-osoite: FHIR-palvelun päätepisteen URL-osoite sovelluksen rekisteröintiin. Esimerkki:
https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4. - Asiakkaan tunnus: Epic-sovelluksesi rekisteröinnin asiakasohjelman tai sovelluksen tunnus.
- Asiakasohjelman salasana: Epic-sovelluksesi rekisteröinnin asiakasohjelman salasana.
- Käyttöoikeuksien myöntämisen URL-osoite: Epic-sovelluksesi rekisteröinnin käyttöoikeuksien myöntämisen URL-osoite.
- Tunnuksen URL-osoite: Epic-sovelluksesi rekisteröinnin tunnuksen URL-osoite.
- Päivityksen URL-osoite: Epic-sovelluksesi päivityksen URL-osoite.
Muistiinpano
Nykyinen FHIRlink-yhdistimen julkaisu tukee EPIC® on FHIR® -sovelluksen rekisteröintiä, joka on määritetty käyttäjäryhmälle, joka on tyyppiä Potilas-, klinikkatyöntekijä- tai hallintokäyttäjä. Taustajärjestelmä-tyyppisten sovellusten käyttäjäryhmiä ei ole vielä otettu käyttöön.
EPIC® on FHIR® -ohjelmointirajapinnat tukevat FHIR-resurssien joukon valintaa. Kukin FHIR-resurssi voi kuitenkin tukea eri toimintoja ja FHIR-versioita. Jotkin FHIR-resurssit voivat esimerkiksi tukea luku- ja hakutoimintoja, kun taas toiset taas tukevat luku-, haku- ja luontitoimintoja.
Ei-tuettujen toimintojen kutsuminen aiheuttaa virheitä EPIC® on FHIR® -palveluissa, jolloin palautetaan asianmukaiset OperationOutcome-arvot, jotka kutsuja voi käsitellä.
Jos tarvitset täydellisen luettelon tuetuista FHIR-resursseista, versioista ja toiminnoista, tutustu kohtaan EPIC® on FHIR®.
Kun luot EPIC® on FHIR® -sovelluksen rekisteröinnin, sisällytä siihen seuraava Uudelleenohjauksen URI merkintä:
https://global.consent.azure-apim.net/redirect/fhirlinkTarkat ohjeet EPIC® on FHIR® -sovelluksen rekisteröintiin ja määrittämiseen sekä tiedot käytettävissä olevista mahdollisuuksista ovat kohdassa Sovellusten luonti ja pyyntöprosessi.
Seuraavissa FHIRlink-yhdistimen julkaisuissa on laajennettu EPIC® on FHIR® -yhteyksien tuki.
Yhdistimen toiminnot
Lisätietoja yhdistinviittauksesta ja sen käytöstä on kohdassa FHIRlink-yhdistin. Luettelo toiminnoista kohdassa FHIRlink-yhdistintoiminnot.
Näytteet
FHIRlink-yhdistimen julkaisu sisältää esimerkkejä yhdistimen käytöstä yksinkertaisessa Power Platformin pohjaan perustuvassa sovelluksessa. Nämä vaiheittain selostetut esimerkit on tarkoitettu perustumaan jokaiseen edelliseen näytteeseen. Voit kuitenkin käyttää niitä myös yksittäin tarpeen mukaan.
Jokainen näyte tarjoaa ladattavan valmiin ratkaisun. Voit tarkastella esimerkkejä kohdassa:
- Esimerkki 1: FHIRlinkin määrittäminen ja siihen yhdistäminen
- Esimerkki 2: FHIR-tietojen sitominen pohjaan perustuvassa sovelluksessa
- Esimerkki 3: Menetelmien yhdistäminen FHIR-tietojen näyttämistä varten
Oletukset esimerkin käytöstä
Toimitetut esimerkit edellyttävät, että seuraavat vaiheet on suoritettu:
- Tarkista Yleiskatsaus- ja Edellytykset-osiot oikean kokoonpanon määrittämiseksi.
- Varmista, että kaikki tarvittavat Power Platform -käyttöoikeudet ovat saatavilla tarvittaessa.
- Ota käyttöön ympäristö, joka sisältää kaikki vaaditut käyttöoikeudet.
- Luo yhteys Luo yhteys -kohdan ohjeiden avulla.