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äissä vaiheissa ohjataan ensin sovelluksen rekisteröimisen määrittäminen Azuressa ja Dataversen käyttöoikeuden myöntäminen sovellukselle määrittämällä sovelluksen käyttäjä.
Rekisteröi Azure-sovellus. Kun olet määrittänyt sovelluksen rekisteröinnin, varmista, että sovellus- tai asiakastunnus siepataan alla mainituissa vaiheissa.
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 integrointiasetuksissa voidaan käyttää Dataverse-ympäristön muuttujia, joiden avulla voidaan määrittää Dataverse Healthcare API -ohjelmointirajapinnat.
Takaisinkirjoituksen tuen avulla voit määrittää Dataverse-tietueille entiteettikarttoja, jotka voidaan kirjoittaa takaisin etäpalvelimeen. Määrityksen jälkeen uudet Dataversessa 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.
Dataversen terveydenhuollon ohjelmointirajapintojen käytettävissä olevat asetukset 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ä jotakin seuraavista arvoista: Vain tiedot: Lokitiedot, jotka on merkitty tiedoiksi. Vain varoitus: Lokitiedot, jotka on merkitty varoituksiksi. Vain poikkeus: Lokitiedot, jotka on merkitty virheiksi tai poikkeuksiksi. Yksityiskohtainen: Kaikki lokitiedot. Poistettu käytöstä: Poista lokimerkinnät 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
Tämän asetuskokoelman avulla voit antaa yhteystiedot FHIR-päätepisteelle ja vaihtoehtoiselle lähtevälle päätepisteelle (jos saatavilla) lähetetyille viesteille.
FHIR-palvelun arvot ovat pakollisia vahvistuksessa ja lähtevien FHIR-viestien muodostamisessa. Jos annat vain nämä yhteysarvot, viestit lähetetään myös tähän päätepisteeseen.
Takaisinkirjoitusviestit voidaan lähettää vaihtoehtoiseen päätepisteeseen FHIR-palvelun sijaan, kuten Azure Logic -sovellukseen tai Open Authorization (OAuth) -toimintoa tukevaan Azure Functioniin. Nämä arvot ovat valinnaisia, ja jos ne annetaan, viestit lähetetään FHIR-pakettina.
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ä asiakas ei voi käyttää salaista arvoa hallintatyökaluilla tallentamisen jälkeen. |
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.
| Name | Kuvaus | 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ä asiakas ei voi käyttää salaista arvoa hallintatyökaluilla tallentamisen jälkeen. |
Asiakasohjelman salasana (merkkijono) |
| Resurssi | Todennustunnuksen hankkimisessa käytetty etäpäätepisteen resurssin tai vaikutusalueen merkkijono. 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 |
Yleiset takaisinkirjoitusasetukset
| Name | Kuvaus | 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.
Katso myös
Mikä on Microsoft Cloud for Healthcare?
Tietojen integroinnin työkalupaketin yleiskatsaus
Dataverse Healthcare API -ohjelmointirajapintojen yleiskatsaus
Dataverse healthcare API --ohjelmointirajapintojen takaisinkirjoituksen yleiskatsaus
Dataverse Healthcare API -ohjelmointirajapintojen käyttö