Partnerintegration für die Gerätedatenunterstützung in der Pflegeverwaltung (Vorschau)
[Dieser Artikel ist Teil der Dokumentation zur Vorabversion und kann geändert werden.]
Die Funktion „Gerätedatenunterstützung in der Pflegeverwaltung“ (Vorschauversion) definiert eingehende und ausgehende benutzerdefinierte APIs für Kunden bzw. Kundinnen und Partner bzw. Partnerinnen, um ihre Geräteverwaltungsdienste zu integrieren. Die APIs aktivieren Sie die folgenden Funktionen:
- Erstellen Sie eine schlanke Power Automate-Lösung rund um Ihren HTTPS-Konnektor und nutzen Sie die benutzerdefinierten APIs, um Ihre Power Automate-Flows auszulösen und Daten in Dataverse aufzunehmen.
- Nutzen Sie die eingehenden benutzerdefinierten APIs zur Verarbeitung von Power Automate-Flow-Antworten in Dataverse.
- Nutzen Sie die ausgehenden benutzerdefinierten APIs für Dataverse-Auslöser.
- Konfigurieren Sie einen Power Automate-Flow, um alle relevanten Vorgänge in einem Partnersystem mithilfe von Power Automate-Konnektoren auszuführen. Um den Power Automate Flow auszulösen, verwenden Sie den Dataverse Aktionstrigger. Weitere Informationen zum Umfang finden Sie unter Flows mit Aktionen auslösen.
Anmerkung
Um die benutzerdefinierten APIs zu filtern, während Sie einen Aktionstrigger verwenden, wählen Sie Geräteverwaltung für Katalog und Ausgehende Geräteverwaltung-Partnerintegration für Kategorie aus.
Die folgenden ausgehenden APIs definieren den Trigger für jeden Prozess:
| Prozessname | Dataverse-Trigger | Ausgehende benutzerdefinierte API | API Beschreibung |
|---|---|---|---|
| Einen Patienten registrieren | Wählen Sie Jetzt registrieren aus. | Ausgehende Geräteregistrierung erstellen | Löst den Power Automate-Flow zum Erstellen eines Patientenprofils im Partnersystem aus. |
| Registrierung für einen Patienten beenden | Wählen Sie Registrierung beenden aus | Ausgehende Geräteregistrierung löschen | Löst den Power Automate-Flow zum Löschen eines Patientenprofils im Partnersystem aus. |
| Geräte mit dem System eines Geräteanbieters synchronisieren | Wählen Sie Geräte synchronisieren aus. | Ausgehende Synchronisierungsgeräte | Löst den Power Automate-Flow zum Abrufen der Gerätedaten in das Partnersystem aus. |
| Einem Patienten ein Gerät zuweisen | Wählen Sie Gerät zuweisen aus. | Ausgehendes Gerät zuweisen | Löst den Power Automate-Flow zum Zuweisen eines Geräts zu einem Patienten aus. |
| Zuweisung eines Patienten zu einem Gerät aufheben | Wählen Sie Zuweisung zum Gerät aufheben aus. | Zuweisung des ausgehenden Geräts aufheben | Löst den Power Automate-Flow zum Aufheben der Zuweisung eines Geräts von einem Patienten aus. |
Nachdem der Power Automate-Flow alle notwendigen Vorgänge abgeschlossen hat, sendet er über die ungebundene Aktion des Dataverse-Konnektors eine Antwort an eine eingehende benutzerdefinierte API. Die eingehende benutzerdefinierte API verarbeitet die Antwort innerhalb von Dataverse.
Das folgende Diagramm veranschaulicht, wie der Ablauf in einem erfolgreichen Szenario die Antwort auf eine ungebundene Aktion sendet.
Die folgende Tabelle definiert die eingehende API für jeden Prozess:
| Prozessname | Eingehende benutzerdefinierte API | API Beschreibung | Entsprechende ausgehende benutzerdefinierte API |
|---|---|---|---|
| Einen Patienten registrieren | Eingehende Geräteregistrierung erstellen | Verarbeitet die Antwort, die generiert wird, wenn ein Patientenprofil im Partnersystem erstellt wird. | Ausgehende Geräteregistrierung erstellen |
| Registrierung für einen Patienten beenden | Eingehende Geräteregistrierung löschen | Verarbeitet die Antwort, die generiert wird, wenn ein Patientenprofil im Partnersystem gelöscht wird. | Ausgehende Geräteregistrierung löschen |
| Geräte mit dem System eines Geräteanbieters synchronisieren | Eingehende Synchronisierungsgeräte | Verarbeitet die Antwort, die beim Synchronisieren von Geräten vom Partnersystem nach Dataverse generiert wird. | Ausgehende Synchronisierungsgeräte |
| Einem Patienten ein Gerät zuweisen | Eingehendes Gerät zuweisen | Verarbeitet die Antwort, die generiert wird, wenn ein Gerät einem Patient in einem Partnersystem zugewiesen wird. | Ausgehendes Gerät zuweisen |
| Zuweisung eines Patienten zu einem Gerät aufheben | Zuweisung für eingehendes Gerät aufheben | Verarbeitet die Antwort, die generiert wird, wenn die Zuweisung eines Geräts einem Patient in einem Partnersystem aufgehoben wird. | Zuweisung des ausgehenden Geräts aufheben |
Die folgenden API-Parameter geben den allgemeinen Datenvertrag für alle Geräteanbieter an:
| Parameter | typ | Beschreibung |
|---|---|---|
| Statuscode | Ganzzahl | Status von Vorgang |
| Fehlermeldung | Zeichenfolge | Fehlermeldungen bei einem fehlgeschlagenen Vorgang |
| Ausgehende Anforderung | Zeichenfolge | An den Power Automate-Flow gesendete ausgehende Anfrage (für den entsprechenden ausgehenden API-Anfrageparameter) |
| Flow-URL | Zeichenfolge | URL des Power Automate-Flow-Ausführungsverlaufs |
Der Flow Geräte abrufen benötigt neben den vier aufgelisteten Parametern noch einen weiteren Parameter: Inhalt.
| Parameter | typ | Beschreibung |
|---|---|---|
| Inhalt | Zeichenfolge | Liste der im folgenden JSON-Format angegebenen Geräte |
Format:
{
"ResponseFormat": "<Format in which the responses are bundled>",
"Devices": [
{
"Name": "<Device name>",
"Model": "<Device model>",
"SerialNumber": "<Device's unique serial number>"
}
]
}
Beispiel:
{
"ResponseFormat": "default",
"Devices": [
{
"Name": "Device 1",
"Model": "Thermometer",
"SerialNumber": "AutomatedTIP1"
},
{
"Name": "Device 2",
"Model": "Weighing machine",
"SerialNumber": "AutomatedTIP2"
}
]
}
Das folgende Diagramm veranschaulicht, wie der Ablauf in einem erfolglosen Szenario die Antwort auf eine ungebundene Aktion sendet.
Für alle in diesem Artikel aufgeführten Prozesse initiiert der Benutzerauslöser die Aktionskette von Dataverse zum Geräteanbieter und zurück. Sie können Erfolgs- oder Fehlerbenachrichtigungen innerhalb der Anwendung sehen. Nach dem Aktualisieren der Seite können Sie auch die aktualisierte Benutzeroberfläche für einen erfolgreichen Vorgang sehen.
Voraussetzungen für die Integration ohne Microsoft Partner
Für Benutzer, die die Funktion ohne Microsoft Partner integrieren, müssen Sie über die folgende Einrichtung verfügen:
Zwei private Endpunkte zum Herstellen einer Verbindung mit Ihrem Azure-Mandanten. Ein Endpunkt ist für Azure Key Vault und der andere für den Azure Event Hubs-Service. Wir empfehlen, dass Sie die privaten Endpunkte in einem virtuellen Netzwerk bereitstellen, um die Sicherheit zu erhöhen.
Eine mehrinstanzenfähige App zum Senden der gesendeten Gerätedaten an Ihren Azure-Mandanten. Sie müssen die entsprechende Anwendungs-ID in Ihrem Azure-Mandanten angeben. Diese Anwendungsregistrierung authentifiziert auch den Zugriff auf den Schlüsseltresor von der privaten Endpunkt.
Die Power Automate Flows, die im Abschnitt Partnerintegration angegeben sind und die genannten Auslöser verwenden. Verwenden Sie die angegebenen eingehenden benutzerdefinierten APIs, um die eingehenden Antworten in Dataverse zu verarbeiten.
Anmerkung
Wenn Sie ohne Geräteanbieter testen, konfigurieren Sie die Power Automate-Flows ohne die Partnerintegrationsschritte.