Zugreifen auf Azure Health Data Services mithilfe der REST-Clienterweiterung in Visual Studio Code
In diesem Artikel erfahren Sie, wie Sie mithilfe der REST-Clienterweiterung in Visual Studio Code auf Azure Health Data Services 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 Anforderungs-Befehlszeile in die Datei ein, und speichern Sie sie unter test.http. Das Dateisuffix .http aktiviert automatisch die REST-Clientumgebung. Wählen Sie diese Option Send Request aus, um die Metadaten abzurufen.
Abrufen von Clientanwendungswerten
Wichtig
Vor dem Aufrufen der FHIR-Server-REST-API (außer dem Abrufen der Metadaten) müssen Sie die Anwendungsregistrierung abschließen. Notieren Sie sich Ihre Azure-Mandanten-ID, Die 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, es empfiehlt sich jedoch, einige Variablen für diese Werte zu definieren und stattdessen die Variablen zu verwenden.
Geben Sie in Ihrer test.http Datei die folgenden Informationen an, die sie bei der Registrierung Ihrer Anwendung erhalten haben:
### REST Client
@fhirurl =https://xxx.azurehealthcareapis.com
@clientid =xxx....
@clientsecret =xxx....
@tenantid =xxx....
Microsoft Entra-Zugriffstoken abrufen
Nachdem Sie die nachstehenden 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 beginnt mit @name einer Variablen, die die HTTP-Antwort erfasst, die das Zugriffstoken enthält. Die Variable wird verwendet, @tokenum das Zugriffstoken zu speichern.
Hinweis
Der 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}}
### Extract access token from getAADToken request
@token = {{getAADToken.response.body.access_token}}
Hinweis
In den Szenarien, in denen der FHIR-Dienstgruppenparameter nicht der FHIR-Dienstendpunkt-URL zugeordnet ist. Der Ressourcenparameterwert sollte dem Zielgruppenwert unter dem Blatt "FHIR-Dienstauthentifizierung" zugeordnet werden.
GET FHIR Patientendaten
Sie können jetzt eine Liste der Patienten oder eines bestimmten Patienten mit der GET Anfrage erhalten. Die Zeile mit Authorization der Kopfzeile enthält die Kopfzeileninformationen für die GET Anforderung. Sie können auch FHIR-Ressourcen senden PUT oder POST anfragen, um FHIR-Ressourcen zu erstellen/zu aktualisieren.
### GET Patient
GET {{fhirurl}}/Patient/<patientid>
Authorization: Bearer {{token}}
Ausführen von PowerShell oder CLI
Sie können PowerShell- oder CLI-Skripts in Visual Studio Code ausführen. Drücken CTRL Sie die ~ TASTE, und wählen Sie PowerShell oder Bash aus. Weitere Details zum integrierten Terminal finden Sie.
PowerShell in Visual Studio Code
CLI in Visual Studio Code
Problembehandlung
Wenn Sie die Metadaten nicht abrufen können, für die kein Zugriffstoken basierend auf der HL7-Spezifikation erforderlich ist, überprüfen Sie, ob der FHIR-Server ordnungsgemäß ausgeführt wird.
Wenn Sie kein Zugriffstoken abrufen können, stellen Sie sicher, dass die Clientanwendung ordnungsgemäß registriert ist und Sie die richtigen Werte aus dem Anwendungsregistrierungsschritt verwenden.
Wenn Sie keine Daten vom FHIR-Server abrufen können, stellen Sie sicher, dass die Clientanwendung (oder der Dienstprinzipal) Zugriffsberechtigungen wie "FHIR Data Contributor" für den FHIR-Server gewährt wurde.
Nächste Schritte
In diesem Artikel haben Sie erfahren, wie Sie mithilfe der REST-Clienterweiterung in Visual Studio Code auf Azure Health Data Services-Daten zugreifen.
Informationen zum Überprüfen von FHIR-Ressourcen anhand von Profilen in Azure Health Data Services finden Sie unter
FHIR® ist eine eingetragene Marke von HL7 und wird mit Genehmigung von HL7 verwendet.