Dataverse Healthcare API ‑ohjelmointirajapintojen määrittäminen
Tässä artikkelissa on vaiheittainen opas Dataverse Healthcare API -ohjelmointirajapintojen määrittämiseen.
Myönnä Azure-sovellusten käyttöoikeudet Dataverse-ympäristöön
Ensimmäinen vaihe Dataverse Healthcare API -ohjelmointirajapintojen käyttämisessä on Azure-sovellusten käyttöoikeuksien myöntäminen Dataverse-ympäristöön. Nämä ohjeet opastavat Azuressa Sovellusrekisteröinnin määrityksessä ja sitten Dataverse-käyttöoikeuksien myöntämisessä kyseiselle sovellukselle määrittämällä sovelluksen käyttäjä.
Sovelluksen rekisteröinti Microsoftin käyttäjätietoympäristöön. Kun olet määrittänyt sovelluksen rekisteröinnin, varmista, että tallennat sovellus-/asiakastunnuksen.
Avaa Dataverse-ympäristö Power Platformin hallintakeskuksessa.
Valitse toimintoruudussa Asetukset.
Valitse Käyttäjät ja oikeudet -kohdassa Sovelluskäyttäjät.
Valitse toimintoruudussa Uusi sovelluskäyttäjä.
Valitse avautuvasta paneelista Lisää sovellus.
Hae käyttämällä sovellus- tai asiakastunnusta. Valitse sovellus ja valitse sitten Lisää.
Valitse oma liiketoimintayksikkö.
Valitse FHIR:n synkronointiagentin sovellusrekisteröinnin käyttäjän käyttöoikeusrooli ja valitse sitten Tallenna.
Valitse Luo.
Määritä integroinnin asetukset
Tietojen integroinnin työkalupaketin integrointiasetusten avulla voit käyttää Dataverse-ympäristön muuttujia, joita voit käyttää Dataverse Healthcare API -ohjelmointirajapintojen määrittämiseen.
Takaisinkirjoituksen tuen avulla voit määrittää Dataverse-tietueille entiteettikarttoja, jotka voidaan kirjoittaa takaisin etäpalvelimeen. Määrityksen jälkeen uudet Dataversessä luodut tietueet tai saapuvien Dataverse Healthcare API -ohjelmointirajapintojen avulla luodut tietueet voidaan päivittää ja lähettää etäpäätepisteeseen.
Määritysvaiheiden lisäksi seuraavassa osassa on kuvattu myös integrointiasetukset, joita tarvitaan yhteyden muodostamiseen etäpäätepisteeseen kirjoitustapahtumien yhteydessä. Voit käyttää tietojen integroinnin työkalupaketin integrointiasetuksia seuraavalla tavalla:
Kirjaudu Microsoft Power Apps.
Valitse Ympäristöt-ruudussa ympäristö, jossa olet ottanut tietojen integroinnin työkalupaketin käyttöön.
Valitse vasemmassa ruudussa Sovellukset ja valitse sitten Tietojen integroinnin työkalupaketti.
Valitse Sovelluksen määritys -kohdan alla Integrointiasetukset ja valitse sitten Dataverse Healthcare API - ohjelmointirajapinta.
Määritä muuttujia, joiden arvot ovat oman ympäristösi arvoja.
Dataverse Healthcare API -ohjelmointirajapintojen setukset on luokiteltu seuraaviin kahteen osaan:
- Yleiset asetukset: Kattaa lokiin kirjaamisen ja kuormituksen asetukset.
- Takaisinkirjoituksen määritys: kattaa yhteys- ja uudelleenyritysasetukset etäkirjoituspäätepisteelle.
Yleiset asetukset
Seuraavassa taulukossa on kuvattu yleiset ympäristömuuttujan asetukset:
| Name | Kuvaus | Arvo |
|---|---|---|
| Lokin kirjaustaso | Ohjaa Dataverseen kirjattujen tietojen tasoa sekä saapuvan Dataverse Healthcare API -ohjelmointirajapinnan että takaisinkirjoituksen tapahtumien osalta. Oletusarvoisesti arvoksi on määritetty Poistettu käytöstä. Lisätietoja on kohdassa Dataverse Healthcare API -lokien tarkasteleminen. |
Käytä seuraavia arvoja: Vain tiedoksi: Lokitiedot, jotka on merkitty vain tiedoksi. Vain varoitukset: Kirjaa varoituksiksi merkityt tiedot. Vain poikkeukset: Kirjaa virheeksi tai poikkeukseksi merkityt tiedot. Yksityiskohtaiset: Kirjaa kaikki tiedot. Pois käytöstä: Poista lokiin kirjaaminen käytöstä. |
| Upsertin FHIR-paketin kokorajoitus | Paketissa olevien resurssien enimmäismäärä. Oletusarvo on 100. | Voit hallita kelvollisen paketin sisältämien resurssien enimmäismäärää valitsemalla arvon välillä 1–500. Jos paketin koko ylittää määritetyn rajan, upsert-paketin ohjelmointirajapinta vastaa virheellä. |
Takaisinkirjoituksen määritys
Takaisinkirjoitusviestit voidaan lähettää vaihtoehtoiseen päätepisteeseen FHIR-palvelun sijaan, kuten Azuren logiikkasovellukseen tai Open Authorization (OAuth) -toimintoa tukevaan Azure-funktioon. Takaisinkirjoituksen asetusten avulla voit antaa yhteystiedot FHIR-päätepisteelle ja vaihtoehtoiselle lähtevälle päätepisteelle (jos saatavilla) lähetetyille viesteille. FHIR-palvelun arvot tarvitaan lähtevien FHIR-sanomien vahvistamiseen ja muodostamiseen. Nämä yhteysarvot ovat valinnaisia, ja jos ne annetaan, viestit lähetetään FHIR-pakettina tähän päätepisteeseen.
Seuraavissa osissa kuvataan takaisinkirjoitusratkaisun määrityksen ympäristömuuttujan asetuksia. Voit valita käyttöskenaarion mukaan määritettävät arvot.
FHIR-palveluasetukset
Nämä asetukset muodostavat FHIR-palveluun liittyvät asetukset, kuten Azure Health -tietopalveluiden FHIR-palvelu.
| Name | Kuvaus | Arvo |
|---|---|---|
| Sovelluksen tai asiakasohjelman tunnus | Sen FHIR-palvelun sovelluksen rekisteröinnin käyttäjätunnus, johon takaisinkirjoituspalvelu muodostaa yhteyden. | Sovelluksen rekisteröinnin käyttäjätunnus (GUID) |
| Asiakkaan salasana | Sovelluksen rekisteröinnin käyttäjätunnukseseen liittyvä asiakassalaisuus. Huomautus: Suojaussyistä et voi käyttää asiakasohjelman salasanan arvoa hallintatyökaluilla, kun olet tallentanut sen. |
Asiakasohjelman salasana (merkkijono) |
| Resurssi | Todentamistunnuksen hankkimisessa käytetyn FHIR-palvelun resurssi- tai vaikutusaluemerkkijono. Azure Health -tietopavelun FHIR-palvelussa tämä arvo on yleensä sama arvo kuin päätepisteen URL-osoitteessa. |
Merkkijono tai oikein muotoiltu URL-osoite |
| Päätepisteen URL-perusosoite | Sen FHIR-palvelun URL-osoite, johon takaisinkirjoituspalvelu yhdistää. | Oikein muotoiltu URL-osoite |
| Valtuuksien URL-osoite | OAuth-myöntäjän URL-osoite, vuokraajan tunnus mukaan lukien. Takaisinkirjoituspalvelu käyttää tätä URL-osoitetta hankkiakseen auth-tunnuksen annettua asiakastunnusta ja salaisuutta varten. | Oikein muotoiltu URL-osoite |
Vaihtoehtoisen lähtevän päätepisteen asetukset
Nämä asetukset ovat asetuksia, jotka liittyvät vaihtoehtoiseen päätepisteeseen, kuten Logic Apps -sovellukseen. Vaihtoehtoisen lähtevän päätepisteen on tuettava todennusta OAuth 2.0:n kautta käyttämällä asiakastunnusta ja asiakasohjelman salasanaa, ja sen pitäisi olla määritetty HTTP-käynnistimellä.
| Name | Description | Arvo |
|---|---|---|
| Sovelluksen tai asiakasohjelman tunnus | Sovelluksen rekisteröinnin käyttäjätunnus on määritetty etäpäätepisteelle, johon takaisinkirjoituspalvelu muodostaa yhteyden. | Sovelluksen rekisteröinnin käyttäjätunnus (GUID) |
| Asiakkaan salasana | Sovelluksen rekisteröinnin käyttäjätunnukseseen liittyvä asiakassalaisuus. Huomautus: Suojaussyistä et voi käyttää asiakasohjelman salasanan arvoa hallintatyökaluilla, kun olet tallentanut sen. |
Asiakasohjelman salasana (merkkijono) |
| Resurssi | Todentamistunnuksen hankkimisessa käytetyn etäpäätepisteen resurssi- tai vaikutusaluemerkkijono. Azure Health -tietopavelun FHIR-palvelussa tämä arvo on yleensä sama arvo kuin päätepisteen URL-osoitteessa. | Merkkijono tai oikein muotoiltu URL-osoite |
| Päätepisteen URL-perusosoite | Sen etäpäätepisteen URL-osoite, johon takaisinkirjoituspalvelu muodostaa yhteyden. | Oikein muotoiltu URL-osoite |
| Valtuuksien URL-osoite | OAuth-myöntäjän URL-osoite, vuokraajan tunnus mukaan lukien. Takaisinkirjoituspalvelu käyttää tätä URL-osoitetta hankkiakseen auth-tunnuksen annettua asiakastunnusta ja salaisuutta varten. | Oikein muotoiltu URL-osoite |
Tärkeää
Kun käytät vaihtoehtoista päätepistettä, kuten Azure-funktiota tai logiikkasovellusta, muista määrittää päätepiste HTTP-käynnistimellä. Kun takaisinkirjoituspalvelu julkaisee tähän sijaintiin, se myös lähettää FHIR-paketi, joka sisältää luodun tai päivitetyn FHIR-resurssin sekä FHIR-alkuperäsanoman.
Takaisinkirjoituspalvelu odottaa palautuspakettia, joka sisältää FHIR-etäpalvelun vastauksen. Vastaus tarvitaan Dataverse-tietueen päivittämiseen uudella FHIR-versiotunnuksella sekä viimeksi muokatuilla arvoilla. Esimerkkejä odotetuista vastauksista: Takaisinkirjoitus vaihtoehtoiseen päätepisteeseen.
Yleiset takaisinkirjoitusasetukset
| Name | Description | Arvo |
|---|---|---|
| Uudelleenyritysten enimmäismäärän aikakatkaisu | Automaattisten uudelleenyritysten välinen minuuttien enimmäismäärä ennen sanoman epäonnistumista. | Uudelleenyrityksen aikakatkaisu (minuutteina) Oletusarvo: 5 |
| Uudelleenyritysten enimmäismäärä | Automaattisten uudelleenyritysten enimmäismäärä ennen sanoman epäonnistumista. | Uudelleenyritysten määrä (määrä) Oletusarvo: 3 |
| FHIR-sovelluksen rekisteröinnin käyttäjätunnus | Sovelluksen rekisteröinnin käyttäjätunnus, joka on määritetty saapuvien viestien käsittelyä varten. Tämä muuttaa antaa takaisinkirjoituksen suorittajalle mahdollisuuden suodattaa saapuvia sanomia ja välttää kehäkäsittely. | Sovelluksen rekisteröinnin käyttäjätunnus (GUID) |
Tietojen käsittelyn määrittäminen
Kun olet päivittänyt integrointiasetukset, voit julkaista FHIR-paketteja suoraan mukautettuun ohjelmointirajapinnan päätepisteeseen. Tai voit ottaa käyttöön Logic-sovelluksen auttamaan tietojen välittämisessä Dataversen ja Azure Health -tietopalveluiden FHIR-palvelun välillä. Lisätietoja:
- Tietojen lähettäminen suoraan Dataverse Healthcare API -ohjelmointirajapinnoille.
- Luo logiikkasovellus manuaalisen määrityksen avulla, jos haluat synkronoida tiedot Dataverse Healthcare API -ohjelmointirajapintojen ja Azure Health -tietopalveluiden välillä.
- Ota käyttöön Logic Apps -ryhmä mallin avulla, jos haluat hallita FHIR-pakettien käyttöä Dataverse Healthcare API -ohjelmointirajapinnoissa ja Azure Health -tietopalveluissa.