Partnerintegratie voor ondersteuning van apparaatgegevens in zorgbeheer (preview)
[Dit artikel maakt deel uit van de voorlopige documentatie en kan nog veranderen.]
De ondersteuning van apparaatgegevens in zorgbeheer (preview) definieert inkomende en uitgaande aangepaste API's voor klanten en partners om hun apparaatbeheerservices te integreren. Met de API´s worden de volgende functies ingeschakeld:
- Bouw een slanke Power Automate-oplossing rondom uw HTTPS-connector en gebruik de aangepaste API's om uw Power Automate-stromen te activeren en gegevens op te nemen in Dataverse.
- Gebruik de inkomende aangepaste API's voor het verwerken van Power Automate-stroomresponsen in Dataverse.
- Gebruik de uitgaande aangepaste API's voor Dataverse-activeringen.
- Configureer een Power Automate-stroom om alle relevante bewerkingen in een partnersysteem uit te voeren met behulp van Power Automate-connectoren. Gebruik de Power Automate-actietrigger om de Dataverse-stroom te activeren. Ga voor meer informatie naar Triggerstromen met acties.
Notitie
Als u de aangepaste API's wilt filteren terwijl u een actietrigger gebruikt, selecteert u Apparaatbeheer voor Catalogus en Beheer van uitgaande apparaten voor partnerintegratie voor Categorie.
Met de volgende uitgaande API's wordt de trigger voor elk proces gedefinieerd:
| Procesnaam | Dataverse-trigger | Uitgaande aangepaste API | API-omschrijving |
|---|---|---|---|
| Een patiënt inschrijven | Selecteer Nu inschrijven | Uitgaande apparaatregistratie maken | Activeert de Power Automate-stroom voor het maken van een patiëntprofiel in het partnersysteem. |
| De inschrijving voor een patiënt beëindigen | Selecteer Inschrijving beëindigen | Uitgaande apparaatregistratie verwijderen | Activeert de Power Automate-stroom voor het verwijderen van een patiëntprofiel in het partnersysteem. |
| Apparaten met het systeem van een apparaatleverancier synchroniseren | Selecteer Apparaten synchroniseren | Uitgaande apparaten synchroniseren | Activeert de Power Automate-stroom voor het ophalen van de apparaatgegevens in het partnersysteem. |
| Een apparaat toewijzen aan een patiënt | Selecteer Apparaat toewijzen | Uitgaand apparaat toewijzen | Activeert de Power Automate-stroom voor het toewijzen van een apparaat aan een patiënt. |
| De toewijzing van een apparaat voor een patiënt annuleren | Selecteer Apparaattoewijzing annuleren | Uitgaand apparaat niet toewijzen | Activeert de Power Automate-stroom voor het ontkoppelen van een apparaat van een patiënt. |
Nadat de Power Automate-stroom alle benodigde bewerkingen heeft voltooid, wordt er een respons verzonden naar een inkomende aangepaste API via de Dataverse niet-gebonden actie van de connector. De inkomende aangepaste API verwerkt de respons binnen Dataverse.
In het volgende diagram wordt getoond hoe de stroom de respons op een niet-gebonden actie verzendt in een succesvol scenario.
De volgende tabel definieert de inkomende API voor elk proces:
| Process name | Inkomende aangepaste API | API-omschrijving | Overeenkomstige uitgaande aangepaste API |
|---|---|---|---|
| Een patiënt inschrijven | Binnenkomende apparaatregistratie maken | Verwerkt de respons die wordt gegenereerd wanneer een patiëntprofiel wordt gemaakt in het partnersysteem. | Uitgaande apparaatregistratie maken |
| De inschrijving voor een patiënt beëindigen | Binnenkomende apparaatregistratie verwijderen | Verwerkt de respons die wordt gegenereerd wanneer een patiëntprofiel wordt verwijderd in het partnersysteem. | Uitgaande apparaatregistratie verwijderen |
| Apparaten met het systeem van een apparaatleverancier synchroniseren | Binnenkomende apparaten synchroniseren | Verwerkt de respons die wordt gegenereerd bij het synchroniseren van apparaten van het partnersysteem naar Dataverse. | Uitgaande apparaten synchroniseren |
| Een apparaat toewijzen aan een patiënt | Binnenkomend apparaat toewijzen | Verwerkt de respons die wordt gegenereerd wanneer een apparaat aan een patiënt in het partnersysteem wordt toegewezen. | Uitgaand apparaat toewijzen |
| De toewijzing van een apparaat voor een patiënt annuleren | Binnenkomend apparaat niet toewijzen | Verwerkt de respons die wordt gegenereerd wanneer een apparaattoewijzing aan een patiënt in het partnersysteem wordt geannuleerd. | Uitgaand apparaat niet toewijzen |
De volgende API-parameters specificeren het generieke datacontract voor alle apparaatleveranciers:
| Parameter | Type | Omschrijving |
|---|---|---|
| Statuscode | Integer | Status van de bewerking |
| Foutmelding | String | Foutmeldingen voor een mislukte bewerking |
| Uitgaande aanvraag | String | Uitgaande aanvraag verzonden naar de Power Automate-stroom (voor de bijbehorende uitgaande API-aanvraagparameter) |
| Stroom-URL | Tekenreeks | URL van de uitvoeringsgeschiedenis van de Power Automate-stroom |
De stroom Apparaten ophalen heeft naast de vier vermelde parameters nog een parameter Inhoud nodig.
| Parameter | Type | Omschrijving |
|---|---|---|
| Inhoud | Tekenreeks | Lijst met apparaten opgegeven in de volgende JSON-indeling |
Indeling:
{
"ResponseFormat": "<Format in which the responses are bundled>",
"Devices": [
{
"Name": "<Device name>",
"Model": "<Device model>",
"SerialNumber": "<Device's unique serial number>"
}
]
}
Voorbeeld:
{
"ResponseFormat": "default",
"Devices": [
{
"Name": "Device 1",
"Model": "Thermometer",
"SerialNumber": "AutomatedTIP1"
},
{
"Name": "Device 2",
"Model": "Weighing machine",
"SerialNumber": "AutomatedTIP2"
}
]
}
In het volgende diagram wordt getoond hoe de stroom de respons op een niet-gebonden actie verzendt in een niet-succesvol scenario.
Voor alle processen die in dit artikel worden genoemd, initieert de gebruikerstrigger de reeks acties van Dataverse naar de apparaatleverancier en terug. U kunt meldingen van succes of mislukking in de toepassing zien. Na het vernieuwen van de pagina kunt u ook de bijgewerkte gebruikersinterface zien voor een succesvolle bewerking.
Vereisten voor integratie zonder Microsoft-partners
Voor gebruikers die de mogelijkheid integreren zonder Microsoft-partners moet u de volgende instellingen hebben:
Twee privé-eindpunten om een verbinding tot stand te brengen met uw Azure-tenant. Eén eindpunt is voor Azure Key Vault en het andere eindpunt is voor de Azure Event Hubs-service. Voor verbeterde beveiliging raden we u aan de privé-eindpunten in een virtueel netwerk te implementeren.
Een multitenant-app voor het verzenden van de verzonden apparaatgegevens naar uw Azure-tenant. U moet de bijbehorende toepassings-id opgeven in uw Azure-tenant. Met deze toepassingsregistratie wordt ook de toegang geverifieerd tot de sleutelkluis van het privé-eindpunt.
De Power Automate-stromen die zijn gespecificeerd in de sectie Partnerintegratie en die de genoemde triggers gebruiken. Gebruik de opgegeven inkomende aangepaste API's om de responsen te verwerken in Dataverse.
Notitie
Als u test zonder een apparaatleverancier, configureert u de Power Automate-stromen zonder de partnerintegratiestappen.