Konfigurieren der Dataverse Healthcare APIs
Dieser Artikel enthält eine Schritt-für-Schritt-Anleitung für die Konfiguration der Dataverse Healthcare APIs.
Gewähren Sie einer Azure-Anwendung Zugriff auf die Dataverse-Umgebung
Der erste Schritt, um den Zugriff auf die Dataverse Healthcare APIs zu ermöglichen, besteht darin, einer Azure-Anwendung die Berechtigung für die Dataverse-Umgebung zu erteilen. Diese Schritte führen Sie durch das Einrichten einer App-Registrierung in Azure und erklären, wie Sie dieser Anwendung dann Zugriff auf Dataverse gewähren, indem Sie einen Anwendungsbenutzenden einrichten.
Eine Anwendung bei der Microsoft Identity Platform registrieren. Stellen Sie nach der Konfiguration der App-Registrierung sicher, dass Sie die Anwendungs-/Client-ID erfassen.
Öffnen Sie im Power Platform Admin Center Ihre Dataverse Umgebung.
Wählen Sie im Aktionsbereich Einstellungen aus.
Wählen Sie unter Benutzer + Berechtigungen Anwendungsbenutzer.
Wählen Sie im Aktivitätsbereich Neuer App-Benutzer aus.
Wählen Sie im sich öffnenden Fenster Eine App hinzufügen.
Suchen Sie mit Hilfe Ihrer Anwendungs-/Client-ID, wählen Sie Ihre App aus und wählen Sie dann Hinzufügen.
Wählen Sie Ihre Unternehmenseinheit aus.
Wählen Sie die Sicherheitsrolle Synchronisierungs-Agent für FHIR App Reg User, und wählen Sie dann Speichern.
Wählen Sie Erstellen aus.
Integrationseinstellungen konfigurieren
Über die Integrationseinstellungen des Datenintegrations-Toolkits erhalten Sie Zugriff auf Dataverse Umgebungsvariablen, die Sie zum Konfigurieren der Dataverse Healthcare APIs verwenden können.
Mit Rückschreiben-Unterstützung können Sie Entitätszuordnungen für Dataverse Datensätze konfigurieren, die auf den Remote-Server zurückgeschrieben werden sollen. Nach der Konfiguration werden neue Datensätze in Dataverse erstellt oder Datensätze, die mit den eingehenden Dataverse Healthcare APIs erstellt wurden können aktualisiert und an den Remote-Endpunkt gesendet werden.
Neben den Konfigurationsschritten werden im folgenden Abschnitt auch die Integrationseinstellungen beschrieben, die zum Herstellen einer Verbindung mit dem Remote-Endpunkt für Rückschreibenereignisse erforderlich sind. So greifen Sie auf die Integrationseinstellungen im Datenintegrations-Toolkit zu:
Melden Sie sich bei Microsoft Power Apps an.
Wählen Sie im Bereich Umgebungen die Umgebung aus, in dem Sie das Datenintegrations-Toolkit bereitgestellt haben.
Wählen Sie auf der linken Seite Apps und dann Datenintegrations-Toolkit aus.
Wählen Sie im linken Bereich unter Anwendungskonfiguration die Option Integrationseinstellungen und anschließend Dataverse Healthcare API.
Legen Sie die Variablen mit Werten für Ihre Umgebung fest.
Die Einstellungen für Dataverse Healthcare APIs werden in die folgenden zwei Abschnitte unterteilt:
- Allgemeine Einstellungen: Deckt Protokollierungs- und Aufnahmeeinstellungen ab.
- Rückschreibungs-Konfiguration: Deckt Konnektivitäts- und Wiederholungseinstellungen für den Remote-Rückschreiben-Endpunkt ab.
Allgemeine Einstellungen
Die folgende Tabelle beschreibt die allgemeinen Einstellungen der Umgebungsvariablen:
| Name des Dataflows | Beschreibung | Wert |
|---|---|---|
| Protokollierungsebene | Steuert die Ebene der in Dataverse protokollierten Informationen sowohl für die eingehende Dataverse Healthcare API als auch für Rückschreibenereignisse. Der Wert ist standardmäßig auf Deaktiviert festgelegt. Weitere Informationen finden Sie unter Dataverse Healthcare API-Protokolle prüfen. |
Verwenden Sie einen der folgenden Werte: Nur Informationen: Als Informationen markierte Details protokollieren Nur Warnung: Details protokollieren, die als Warnung gekennzeichnet sind. Nur Ausnahme: Logdetails, die als Fehler oder Ausnahme gekennzeichnet sind. Verbal: Alle Details protokollieren. Deaktiviert: Deaktivieren Sie die Protokollierung. |
| Begrenzung der FHIR-Paketgröße für Upsert | Die maximale Anzahl der Ressourcen in einem Bundle. Standardmäßig ist der Wert 100. | Verwenden Sie einen Wert von 1 bis 500, um die maximale Anzahl der Ressourcen in einem gültigen Bundle zu steuern. Wenn die Größe des Paketw die konfigurierte Grenze überschreitet, antwortet die Upsert Paket API mit einem Fehler. |
Konfiguration von Rückschreiben
Rückschreibungsnachrichten können anstelle des FHIR-Dienstes an einen alternativen Endpunkt bereitgestellt werden, z. B. an eine Azure Logic App oder eine Azure-Funktion, die Open Authorization (OAuth) unterstützt. Mit den Rückschreibeinstellungen können Sie Verbindungsdetails für den FHIR Endpunkt und einen alternativen ausgehenden Endpunkt (sofern verfügbar) für bereitgestellte Nachrichten angeben. Sie brauchen die FHIR-Dienstwerte zur Validierung und zum Erstellen der ausgehenden FHIR-Nachrichten. Diese Verbindungswerte sind optional. Wenn sie angegeben werden, werden die Nachrichten als FHIR-Paket an diesen Endpunkt bereitgestellt.
In den folgenden Abschnitten werden die Umgebungsvariableneinstellungen für die Rückschreibungs-Lösungskonfiguration beschrieben. Sie können basierend auf Ihrem Nutzungsszenario auswählen, welche Werte konfiguriert werden sollen.
FHIR-Serviceeinstellungen
Diese Einstellungen stellen die für einen FHIR-Dienst spezifischen Einstellungen dar, z. B. einen Azure Health Data Services FHIR-Dienst.
| Name des Dataflows | Beschreibung | Wert |
|---|---|---|
| Anwendungs-/Client-ID | Die für den FHIR-Dienst konfigurierte Benutzer-ID zur Anwendungsregistrierung, mit der der Rückschreib-Dienst eine Verbindung herstellt. | Benutzer-ID für die Anwendungsregistrierung (GUID) |
| Clientgeheimnis | Der geheime Clientschlüssel, der mit der Benutzer-ID für die Anwendungsregistrierung verbunden ist. Hinweis: Aus Sicherheitsgründen können Sie nach dem Speichern nicht mehr mit den Verwaltungstools auf den Wert des geheimen Clientschlüssels zugreifen. |
Geheimer Clientschlüssel (Zeichenfolge) |
| Ressource | Die Ressourcen- oder Umfangszeichenfolge des FHIR-Dienstes, der zum Abrufen des Authentifizierungstokens verwendet wurde. Für den Azure Health Data Services FHIR-Dienst ist dieser Wert normalerweise derselbe Wert wie der URL Endpunkt. |
String oder richtig formatierte URL |
| Endpunkt-Basis-URL | Die URL des FHIR-Dienstes, mit dem der Rückschreib-Dienst eine Verbindung herstellt. | Korrekt formatierte URL |
| URL der autoritativen Stelle | Die URL des OAuth-Autorisierungsanbieters, einschließlich der Mandanten-ID. Der Rückschreib-Dienst verwendet diese URL, um das Authentifizierungstoken für die angegebene Client-ID und den angegebenen Clientschlüssel abzurufen. | Korrekt formatierte URL |
Alternative ausgehender Endpunkteinstellungen
Diese Einstellungen stellen die spezifischen Einstellungen für einen alternativen Rückschreiben Endpunkt dar, beispielsweise eine Logik-App. Der alternative ausgehende Endpunkt muss die Authentifizierung über OAuth 2.0 mithilfe einer Client-ID und eines geheimen Clientschlüssels unterstützen und sollte mit einem HTTP-Trigger konfiguriert werden.
| Name des Dataflows | Beschreibung | Wert |
|---|---|---|
| Anwendungs-/Client-ID | Die Benutzer-ID für die Anwendungsregistrierung, die für das Remote-Gerät Endpunkt konfiguriert ist, mit dem der Rückschreibdienst eine Verbindung herstellt. | Benutzer-ID für die Anwendungsregistrierung (GUID) |
| Clientgeheimnis | Der geheime Clientschlüssel, der mit der Benutzer-ID für die Anwendungsregistrierung verbunden ist. Hinweis: Aus Sicherheitsgründen können Sie nach dem Speichern nicht mehr mit den Verwaltungstools auf den Wert des geheimen Clientschlüssels zugreifen. |
Geheimer Clientschlüssel (Zeichenfolge) |
| Ressource | Die Ressourcen- oder Umfangszeichenfolge des Remote-Endpunkts, der zum Abrufen des Authentifizierungstokens verwendet wurde. Für den Azure Health Data Services FHIR-Dienst ist dieser Wert normalerweise derselbe Wert wie der URL Endpunkt. | String oder richtig formatierte URL |
| Endpunkt-Basis-URL | Die URL des Remote-Servers Endpunkt, zu dem der Rückschreibdienst eine Verbindung herstellt. | Korrekt formatierte URL |
| URL der autoritativen Stelle | Die URL des OAuth-Autorisierungsanbieters, einschließlich der Mandanten-ID. Der Rückschreib-Dienst verwendet diese URL, um das Authentifizierungstoken für die angegebene Client-ID und den angegebenen Clientschlüssel abzurufen. | Korrekt formatierte URL |
Wichtig
Wenn Sie einen alternativen Endpunkt wie eine Azure-Funktion oder Logik-App verwenden, stellen Sie sicher, dass Sie den Endpunkt mit einem HTTP-Trigger konfigurieren. Wenn der Rückschreibdienst an diesen Speicherort bereitstellt, sendet er auch ein FHIR-Paket, das die erstellte oder aktualisierte FHIR-Ressource und eine FHIR-Herkunftsnachricht enthält.
Der Rückschreibedienst erwartet als Antwort vom Remote-FHIR-Endpunkt ein Paket mit Antwort vom Remote-FHIR-Dienst. Dieser Antwort wird benötigt, um den Dataverse-Datensatz mit der neuen FHIR-Versions-ID und den zuletzt geänderten Werten zu aktualisieren. Beispiele für erwartete Antworten finden Sie unter An einen alternativen Endpunkt zurückschreiben.
Allgemeine Rückschreib-Einstellungen
| Name des Dataflows | Beschreibung | Wert |
|---|---|---|
| Max. Zeitüberschreitung für Wiederholungsversuche | Die maximale Minutenzahl zwischen automatischen Wiederholungsversuchen, bevor eine Nachricht fehlschlägt. | Wiederholungs-Timeout (Minuten) Standardwert: 5 |
| Max. Anzahl der Versuche | Die maximale Anzahl von Wiederholungen, bevor eine Nachricht fehlschlägt. | Anzahl der Wiederholungen (Anzahl) Standardwert: 3 |
| Benutzer-ID für die FHIR-Anwendungsregistrierung | Die für die Verarbeitung eingehender Nachrichten konfigurierte Benutzer-ID für die Anwendungsregistrierung. Diese Variable ermöglicht es dem Rückschreibeprozessor, die eingehenden Nachrichten zu filtern und eine zirkuläre Verarbeitung zu vermeiden. | Benutzer-ID für die Anwendungsregistrierung (GUID) |
Datenerfassungeb konfigurieren
Nachdem Sie die Integrationseinstellungen aktualisiert haben, können Sie FHIR-Pakete direkt im benutzerdefiniertne API Endpunkt posten. Oder Sie können eine Logik-App bereitstellen, die die Weiterleitung der Daten zwischen Dataverse und dem Azure Health Data Services FHIR-Dienst unterstützt. Weitere Informationen finden Sie unter
- Daten direkt an Dataverse Healthcare APIs posten.
- Erstellen Sie eine Logic-App durch manuelle Konfiguration, um Daten zwischen Dataverse Healthcare APIs und Azure Health Data Services zu synchronisieren.
- Bereitstellen einer Gruppe von Logic-Apps unter Verwendung einer Vorlage, um das Einbinden von FHIR-Bündeln in Dataverse Healthcare APIs und Azure Health Data Services zu orchestrieren.