Partnerintegrering för stöd för enhetsdata inom vårdhantering (förhandsgranskning)
[Denna artikel är en förhandsversion av dokumentationen och kan komma att ändras.]
Med funktionen stöd för enhetsdata i Vårdhantering (förhandsversion) definieras inbyggda och anpassade API:er för kunder och partner som ska integrera sina enhetshanteringstjänster. API aktiverar följande funktioner:
- Skapa en smidig Power Automate-lösning runt ditt HTTPS-anslutningsprogram och anpassade API:er för att utlösa dina Power Automate-flöden och mata in data i Dataverse.
- Använd inkommande anpassade API:er för bearbetning av Power Automate-flödessvar i Dataverse.
- Använd de utgående API:erna för Dataverse-utlösare.
- Konfigurera ett Power Automate-flöde för att utföra alla relevanta åtgärder i ett partnersystem med hjälp av Power Automate-anslutningsprogram. För att utlösa Power Automate-flödet, använd Dataverse åtgärdsutlösaren. Mer information finns i Utlöser flöden med åtgärder.
Kommentar
Om du vill filtrera anpassade API:er med en åtgärdsutlösning väljer du Enhetshantering för Katalog och Partnerintegration för enhetshantering – utgående för Kategori.
Följande API:er definierar utlösaren för varje process:
| Processnamn | Dataverse-utlösare | Anpassat utgående API | API-beskrivning |
|---|---|---|---|
| Registrera en patient | Välj Registrera nu | Skapa utgående enhetsregistrering | Utlöser Power Automate-flödet för att skapa en patientprofil i partnersystemet. |
| Slut på registrering för en patient | Välj Avsluta registrering | Ta bort utgående enhetsregistrering | Utlöser Power Automate-flödet för att ta bort en patientprofil i partnersystemet. |
| Synkronisera enheter med en enhetsleverantörs system | Välj Synkronisera enheter | Synkronisera utgående enheter | Utlöser Power Automate-flödet för hämtning av enhetsdata till partnersystemet. |
| Tilldela en enhet till en patient | Välj Tilldela enhet | Tilldela utgående enhet | Utlöser Power Automate-flödet för att tilldela en enhet till en patient. |
| Sluta tilldela en enhet från en patient | Välj Sluta tilldela enhet | Ta bort tilldelning av utgående enhet | Utlöser Power Automate-flödet för att avassociering av en enhet från en patient. |
När Power Automate-flödet har slutfört alla nödvändiga åtgärder skickas ett svar till ett inkommande anpassat API via Dataverse-anslutningsprogrammets inkommande åtgärd. Det inkommande anpassade API:et bearbetar svaret inom Dataverse.
I följande diagram illustreras hur flödet skickar svaret på en icke-bunden åtgärd i ett framgångsrikt scenario.
I följande tabell definieras inkommande API för varje process:
| Process name | Anpassat ingående API | API-beskrivning | Motsvarande utgående anpassat API |
|---|---|---|---|
| Registrera en patient | Skapa inkommande enhetsregistrering | Bearbetar svaret som genereras när en patientprofil skapas i partnersystemet. | Skapa utgående enhetsregistrering |
| Slut på registrering för en patient | Ta bort inkommande enhetsregistrering | Bearbetar svaret som genereras när en patientprofil tas bort i partnersystemet. | Ta bort utgående enhetsregistrering |
| Synkronisera enheter med en enhetsleverantörs system | Synkronisera inkommande enheter | Bearbetar svaret som genereras vid synkronisering av enheter från partnersystemet till Dataverse. | Synkronisera utgående enheter |
| Tilldela en enhet till en patient | Tilldela inkommande enhet | Bearbetar svaret som genereras när en enhet tilldelas en patient i partnersystemet. | Tilldela utgående enhet |
| Sluta tilldela en enhet från en patient | Ta bort tilldelning av inkommande enhet | Bearbetar svaret som genereras när en enhet tar bort tilldelning från en patient i partnersystemet. | Ta bort tilldelning av utgående enhet |
I följande API-parametrar anges det generiska datakontraktet för alla enhetsleverantörer:
| Parameter | Type | Beskrivning |
|---|---|---|
| Statuskod | Integer | Status för åtgärden |
| Error message | String | Felmeddelanden för en misslyckad åtgärd |
| Utgående begäran | String | Utgående begäran som skickas till Power Automate-flödet (för motsvarande API-begäransparameter) |
| Flödes-URL | Sträng | URL för körningshistorik för Power Automate-flöde |
Flödet Hämta enheter behöver ytterligare en parameter Innehåll förutom de fyra parametrarna i listan.
| Parameter | Type | Beskrivning |
|---|---|---|
| Innehåll | Sträng | Lista över enheter som anges i följande JSON-format |
Format:
{
"ResponseFormat": "<Format in which the responses are bundled>",
"Devices": [
{
"Name": "<Device name>",
"Model": "<Device model>",
"SerialNumber": "<Device's unique serial number>"
}
]
}
Exempel:
{
"ResponseFormat": "default",
"Devices": [
{
"Name": "Device 1",
"Model": "Thermometer",
"SerialNumber": "AutomatedTIP1"
},
{
"Name": "Device 2",
"Model": "Weighing machine",
"SerialNumber": "AutomatedTIP2"
}
]
}
I följande diagram illustreras hur flödet skickar svaret på en icke-bunden åtgärd i ett icke-framgångsrikt scenario.
För alla processer som visas i den här artikeln initierar användaren åtgärder från till Dataverse till enhetsleverantören och tillbaka. Du kan se meddelanden om lyckade eller misslyckade resultat i programmet. När du uppdaterar sidan kan du också se det uppdaterade användargränssnittet för att åtgärden ska lyckas.
Krav för integrering utan Microsoft-partner
För användare som saknar Microsoft-partner måste du ha följande konfiguration på plats:
Två privata slutpunkter för att upprätta en anslutning till din Azure-klientorganisation. Ena slutpunkten för Azure Key Vault och den andra är för tjänsten Azure Event Hubs. Vi rekommenderar att du distribuerar de privata slutpunkterna i ett virtuellt nätverk för bättre säkerhet.
En app för flera klientorganisationer för att skicka avgivna enhetsdata till din Azure-klientorganisation. Du måste ange motsvarande program-ID i din Azure-klientorganisation. Den här programregistreringen autentiserar även åtkomsten till nyckel vault från den privata slutpunkt.
De Power Automate-flöden som anges i avsnittet Partnerintegrering som använder de nämnda utlösarna. Använd de angivna anpassade API:erna för att bearbeta svaren i Dataverse.
Kommentar
Om du testar utan en enhetsleverantör konfigurerar du Power Automate-flödena utan partnerintegreringsstegen.