Kumppanien integrointi ja laitetietojen tuki hoidon hallinnassa (esiversio)
[Tämä artikkeli sisältää julkaisua edeltävää materiaalia ja voi muuttua.]
Laitetietojen tuki hoidon hallinnassa (esiversio) -ominaisuus määrittää saapuvia ja lähteviä mukautettuja ohjelmointirajapintoja asiakkaille ja kumppaneille, jotta he voivat integroida laitehallintapalveluitaan. Ohjelmointirajapinnat mahdollistavat seuraavat ominaisuudet:
- Luo HTTPS-yhdistimen ympärille kevyt Power Automate -ratkaisu ja käytä mukautettuja ohjelmointirajapintoja, jotka käynnistävät Power Automate -työnkulut ja käsittelevät tiedot Dataverseen.
- Käytä saapuvia mukautettuja ohjelmointirajapintoja käsittelemään Power Automate -työnkulkujen vastauksia Dataversessa.
- Käytä lähteviä mukautettuja ohjelmointirajapintoja Dataverse-käynnistimiä varten.
- Määritä Power Automate -työnkulku suorittamaan kaikki asiaankuuluvat toiminnot kumppanijärjestelmässä Power Automate -yhdistimien avulla. Power Automate -työnkulku voidaan käynnistää Dataverse-toiminnon käynnistimellä. Lisätietoja on kohdassa Työnkulkujen käynnistäminen toimintojen avulla.
Huomautus
Mukautetut ohjelmointirajapinnat voidaan suodattaa toimintokäynnistimiä käytettäessä valitsemalla Laitehallinta Luettelo-asetukseksi ja Lähtevä laitehallinnan kumppanin integrointi Luokka-asetukseksi.
Seuraavat lähtevät ohjelmointirajapinnat määrittää kunkin prosessin käynnistimen:
| Prosessin nimi | Dataverse -käynnistin | Lähtevä mukautettu ohjelmointirajapinta | Ohjelmointirajapinnan kuvaus |
|---|---|---|---|
| Potilaan rekisteröinti | Valitse Rekisteröi nyt | Lähtevä laiterekisteröinnin luonti | Käynnistää potilaan profiilin kumppanijärjestelmässä luovan Power Automate -työnkulun. |
| Potilaan rekisteröinnin lopetus | Valitse Peruuta rekisteröinti | Lähtevä laiterekisteröinnin poisto | Käynnistää potilaan profiilin kumppanijärjestelmässä poistavan Power Automate -työnkulun. |
| Laitteiden synkronointi laitetoimittajan järjestelmän kanssa | Valitse Synkronoi laitteet | Lähtevä laitteiden synkronointi | Käynnistää laitetiedot kumppanijärjestelmään noutavan Power Automate -työnkulun. |
| Laitteen määritys potilaalle | Valitse Määritä laite | Lähtevä laitteen määritys | Käynnistää laitteen potilaalle määrittävän Power Automate -työnkulun. |
| Laitteen potilaalle määrittämisen poistaminen | Valitse Poista laitteen määritys | Lähtevä laitteen määrityksen poisto | Käynnistää laitteen ja potilaan liitoksen poistavan Power Automate -työnkulun. |
Kun Power Automate -työnkulku on suorittanut kaikki tarvittavat toiminnot, se lähettää vastauksen mukautettuun ohjelmointirajapintaan Dataverse-yhdistimen ei-sidotun toiminnon kautta. Saapuva mukautettu ohjelmointirajapinta käsittelee vastauksen Dataversessa.
Seuraavassa kaaviossa on kuvattu, miten työnkulku lähettää vastauksen ei-sidottuun toimintoon onnistuneessa skenaariossa.
Seuraava taulukko määrittää kunkin prosessin saapuvan ohjelmointirajapinnan:
| Process name | Saapuva mukautettu ohjelmointirajapinta | Ohjelmointirajapinnan kuvaus | Vastaava lähtevä mukautettu ohjelmointirajapinta |
|---|---|---|---|
| Potilaan rekisteröinti | Saapuva laiterekisteröinnin luonti | Käsittelee potilasprofiilia kumppanijärjestelmässä luotaessa luodun vastauksen. | Lähtevä laiterekisteröinnin luonti |
| Potilaan rekisteröinnin lopetus | Saapuva laiterekisteröinnin poisto | Käsittelee potilasprofiilia kumppanijärjestelmässä poistettaessa luodun vastauksen. | Lähtevä laiterekisteröinnin poisto |
| Laitteiden synkronointi laitetoimittajan järjestelmän kanssa | Saapuva laitteiden synkronointi | Käsittelee vastauksen, joka luotiin synkronoitaessa laitteita kumppanijärjestelmästä Dataverseen. | Lähtevä laitteiden synkronointi |
| Laitteen määritys potilaalle | Saapuva laitteen määritys | Käsittelee vastauksen, joka luotiin määritettäessä laitetta potilaalle kumppanijärjestelmässä. | Lähtevä laitteen määritys |
| Laitteen potilaalle määrittämisen poistaminen | Saapuva laitteen määrityksen poisto | Käsittelee vastauksen, joka luotiin poistettaessa potilaalle tehtyä laitteen määritystä kumppanijärjestelmässä. | Lähtevä laitteen määrityksen poisto |
Seuraavat ohjelmointirajapintaparametrit määrittävät yleisen tietosopimuksen kaikille laitetoimittajille:
| Parametri | Type | Kuvaus |
|---|---|---|
| Tilakoodi | Integer | Toiminnon tila |
| Error message | String | Epäonnistuneen toiminnon virhesanomat |
| Lähtevä pyyntö | String | Power Automate -työnkulkuun lähetetty lähtevä pyyntö (joka vastaa lähtevän ohjelmointirajapintapyynnön parametria) |
| Työnkulun URL-osoite | Merkkijono | Power Automate -työnkulun suoritushistorian URL-osoite |
Hae laitteet -työnkulkuun tarvitaan yksi Sisältö-parametri neljän luettelossa olevan parametrin lisäksi.
| Parametri | Type | Kuvaus |
|---|---|---|
| Content | Merkkijono | Seuraavassa JSON-muodossa määritetty laiteluettelo |
Muoto:
{
"ResponseFormat": "<Format in which the responses are bundled>",
"Devices": [
{
"Name": "<Device name>",
"Model": "<Device model>",
"SerialNumber": "<Device's unique serial number>"
}
]
}
Esimerkki:
{
"ResponseFormat": "default",
"Devices": [
{
"Name": "Device 1",
"Model": "Thermometer",
"SerialNumber": "AutomatedTIP1"
},
{
"Name": "Device 2",
"Model": "Weighing machine",
"SerialNumber": "AutomatedTIP2"
}
]
}
Seuraavassa kaaviossa on kuvattu, miten työnkulku lähettää vastauksen ei-sidottuun toimintoon epäonnistuneessa skenaariossa.
Kaikissa tässä artikkelissa mainituissa prosesseissa käyttäjän käynnistin käynnistää toimintoketjun Dataversesta laitetoimittajaan ja takaisin. Onnistumis- ja epäonnistumisilmoitukset näkyvät sovelluksessa. Sivun päivittämisen jälkeen näkyvissä on myös onnistuneen toiminnon päivitetty käyttöliittymä.
Edellytykset ilman Microsoftin kumppaneita tehtävälle integroinnille
Ilman Microsoftin kumppaneita ominaisuuden integroivilla käyttäjillä on oltava seuraavat määritykset tehtyinä:
Kaksi yksityistä päätepistettä, joilla voidaan muodostaa yhteys Azure-vuokraajaan. Toinen päätepiste Azure Key Vaultille ja toinen Azure Tapahtumatoiminnot -palvelulle. On suositeltavaa ottaa yksityiset päätepisteet käyttöön näennäisverkossa suojauksen tehostamiseksi.
Palveluna tarjottava sovellus, joka lähettää tuotetut laitetiedot Azure-vuokraajaasi. Azure-vuokraajassa on annettava vastaava sovellustunnus. Sovelluksen rekisteröinti todentaa myös avainsäilön käytön yksityisestä päätepisteestä.
Kumppanin integrointi-osiossa määritetyt Power Automate -työnkulut, jotka käyttävät mainittuja käynnistimiä. Vastausten käsittely Dataversessa käyttämällä määritettyjä saapuvia mukautettuja ohjelmointirajapintoja.
Huomautus
Jos testaus tehdään ilman laitetoimittajaa, Power Automate -työnkulut määritetään ilman kumppanin integrointivaiheita.