Zugreifen auf Azure Health Data Services mithilfe der REST-Clienterweiterung in Visual Studio Code.
In diesem Artikel erfahren Sie, wie Sie auf Azure Health Data Services-Daten mithilfe der REST-Clienterweiterung in Visual Studio Code zugreifen.
Installieren der REST-Clienterweiterung
Wählen Sie im linken Bereich ihres Visual Studio Code das Symbol „Erweiterungen“ aus, und suchen Sie nach „REST-Client“. Suchen Sie die REST-Clienterweiterung und installieren Sie sie.
Erstellen einer .http-Datei und Definieren von Variablen
Erstellen Sie eine neue Datei in Visual Studio Code. Geben Sie eine GET-Anforderungsbefehlszeile in die Datei ein, und speichern Sie sie als test.http. Das Dateisuffix .http aktiviert die REST-Clientumgebung automatisch. Wählen Sie Send Request aus, um die Metadaten abzurufen.
Abrufen von Clientanwendungswerten
Wichtig
Bevor Sie die REST-API des FHIR®-Servers aufrufen (abgesehen von der Abfrage der Metadaten), müssen Sie die Registrierung der Anwendung abschließen. Notieren Sie sich Ihre Azure Mandanten-ID, Client-ID, den geheimen Clientschlüssel und die Dienst-URL.
Sie können zwar Werte wie die Client-ID direkt in Aufrufen der REST-API verwenden, aber es empfiehlt sich, einige Variablen für diese Werte zu definieren und stattdessen die Variablen zu verwenden.
Fügen Sie in der Datei test.http die folgenden Informationen ein, die sie bei der Registrierung Ihrer Anwendung erhalten haben.
### REST Client
@fhirurl =https://xxx.azurehealthcareapis.com
@clientid =xxx....
@clientsecret =xxx....
@tenantid =xxx....
Erhalten eines Microsoft Entra-Zugriffstokens
Nachdem Sie die folgenden Informationen in Ihre test.http-Datei eingeschlossen haben, drücken Sie Send Request. Es wird eine HTTP-Antwort angezeigt, die Ihr Zugriffstoken enthält.
Die Zeile, die mit @name beginnt, enthält eine Variable, die die HTTP-Antwort erfasst, die das Zugriffstoken enthält. Die Variable @token wird verwendet, um das neue Schlüsselobjekt zu speichern.
Hinweis
Die grant_type von client_credentials wird verwendet, um ein Zugriffstoken abzurufen.
### Get access token
# @name getAADToken
POST https://login.microsoftonline.com/{{tenantid}}/oauth2/token
Content-Type: application/x-www-form-urlencoded
grant_type=client_credentials
&resource={{fhirurl}}
&client_id={{clientid}}
&client_secret={{clientsecret}}
&scope={{fhirurl}}/.default
### Extract access token from getAADToken request
@token = {{getAADToken.response.body.access_token}}
Hinweis
Wenn der Parameter für die Benutzergruppengruppe des FHIR-Diensts nicht der FHIR-Dienstendpunkt-URL zugeordnet ist, sollte der Wert des Ressourcenparameters dem Zielgruppenwert im Blatt „Authentifizierung“ des FHIR-Diensts zugeordnet werden.
Abrufen von FHIR-Patientendaten
Sie können jetzt eine Liste der Patienten oder eines bestimmten Patienten mit der GET-Abfrage erhalten. Die Zeile mit Authorization enthält die Header-Informationen für die GET-Abfrage. Sie können auch PUT- oder POST-Abfragen senden, um FHIR-Ressourcen zu erstellen und zu aktualisieren.
### GET Patient
GET {{fhirurl}}/Patient/<patientid>
Authorization: Bearer {{token}}
PowerShell oder CLI ausführen
Sie können PowerShell- oder CLI-Skripts in Visual Studio Code ausführen. Drücken Sie CTRL und die ~-Taste, und wählen Sie PowerShell oder Bash aus. Weitere Details zum integrierten Terminal.
PowerShell in Visual Studio Code
CLI in Visual Studio Code
Problembehandlung
Wenn Sie die Metadaten nicht abrufen können (für die gemäß der HL7-Spezifikation kein Zugriffstoken erforderlich ist), überprüfen Sie, ob Ihr FHIR-Server ordnungsgemäß ausgeführt wird.
Wenn Sie kein Zugriffstoken erhalten können, vergewissern Sie sich, dass die Clientanwendung ordnungsgemäß registriert ist und Sie die richtigen Werte aus dem Schritt der Anwendungsregistrierung verwenden.
Wenn Sie keine Daten vom FHIR-Server abrufen können, stellen Sie sicher, dass der Clientanwendung (oder dem Dienstprinzipal) Zugriffsrechte wie „FHIR Data Contributor“ auf den FHIR-Server gewährt wurden.
Nächste Schritte
In diesem Artikel haben Sie erfahren, wie Sie auf Azure Health Data Services-Daten mithilfe der REST-Clienterweiterung in Visual Studio Code zugreifen.
Wie Sie FHIR-Ressourcen gegen Profile in Azure Health Data Services validieren können, erfahren Sie unter
Hinweis
FHIR® ist eine eingetragene Marke von HL7 und wird mit Genehmigung von HL7 verwendet.