Az Azure Health Data Services elérése a REST-ügyfélbővítmény használatával a Visual Studio Code-ban
Ebben a cikkben megtudhatja, hogyan érheti el az Azure Health Data Servicest REST-ügyfélbővítménnyel a Visual Studio Code-ban.
REST-ügyfélbővítmény telepítése
Válassza a Visual Studio Code bal oldali panelén a Bővítmények ikont, és keressen rá a "REST Client" kifejezésre. Keresse meg a REST-ügyfél bővítményt , és telepítse.
.http
Fájl létrehozása és változók definiálása
Hozzon létre egy új fájlt a Visual Studio Code-ban. Írja be a GET
kérelem parancssorát a fájlba, és mentse a fájlba test.http
. A fájl utótagja .http
automatikusan aktiválja a REST-ügyfélkörnyezetet. Válassza ki Send Request
a metaadatok lekéréséhez.
Ügyfélalkalmazás értékeinek lekérése
Fontos
Az FHIR-kiszolgáló® REST API-jának meghívása előtt (a metaadatok lekérésétől eltérően) be kell fejeznie az alkalmazásregisztrációt. Jegyezze fel az Azure-bérlő azonosítóját, az ügyfél-azonosítót, az ügyfél titkos kódját és a szolgáltatás URL-címét.
Bár az olyan értékeket, mint az ügyfélazonosító, közvetlenül a REST API-ra irányuló hívásokban is használhatja, célszerű néhány változót definiálni ezekhez az értékekhez, és ehelyett a változókat használni.
test.http
A fájlban adja meg az alábbi adatokat, amelyeket az alkalmazás regisztrálása során kapott.
### REST Client
@fhirurl =https://xxx.azurehealthcareapis.com
@clientid =xxx....
@clientsecret =xxx....
@tenantid =xxx....
Microsoft Entra hozzáférési jogkivonat beszerzése
Miután a fájlba beszedte a következő adatokat, nyomja le a test.http
következőt Send Request
: . Megjelenik egy HTTP-válasz, amely tartalmazza a hozzáférési jogkivonatot.
A sor egy változót @name
tartalmaz, amely rögzíti a hozzáférési jogkivonatot tartalmazó HTTP-választ. A változó a @token
hozzáférési jogkivonat tárolására szolgál.
Feljegyzés
Az grant_type
egyiket client_credentials
hozzáférési jogkivonat beszerzésére használják.
### 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}}
Feljegyzés
Ha az FHIR szolgáltatás célközönségparamétere nincs megfeleltetve az FHIR szolgáltatásvégpont URL-címéhez, az erőforrásparaméter értékét az FHIR szolgáltatáshitelesítés panel Célközönség értékére kell leképezni.
FHIR-betegadatok lekérése
Most már lekérheti a kéréssel rendelkező GET
betegek vagy egy adott beteg listáját. A sor a Authorization
kérelem fejléc-információja GET
. FHIR-erőforrások létrehozására és POST
frissítésére vonatkozó kéréseket is küldhet PUT
vagy kérhet.
### GET Patient
GET {{fhirurl}}/Patient/<patientid>
Authorization: Bearer {{token}}
A PowerShell vagy a parancssori felület futtatása
PowerShell- vagy CLI-szkripteket futtathat a Visual Studio Code-on belül. Nyomja le CTRL
és nyomja le a billentyűt, és válassza a ~
PowerShell vagy a Bash lehetőséget. További részleteket az integrált terminálon talál.
PowerShell a Visual Studio Code-ban
Parancssori felület a Visual Studio Code-ban
Hibaelhárítás
Ha nem tudja lekérni a metaadatokat (amely nem igényel hozzáférési jogkivonatot a HL7 specifikációja alapján), ellenőrizze, hogy az FHIR-kiszolgáló megfelelően működik-e.
Ha nem tud hozzáférési jogkivonatot beszerezni, győződjön meg arról, hogy az ügyfélalkalmazás megfelelően van regisztrálva, és az alkalmazásregisztrációs lépés helyes értékeit használja.
Ha nem tud adatokat lekérni az FHIR-kiszolgálóról, győződjön meg arról, hogy az ügyfélalkalmazás (vagy a szolgáltatásnév) hozzáférési engedélyeket kapott, például "FHIR adatszolgáltató" az FHIR-kiszolgálóhoz.
Következő lépések
Ebben a cikkben megtanulta, hogyan férhet hozzá az Azure Health Data Services-adatokhoz a Visual Studio Code REST-ügyfélbővítményével.
Az FHIR-erőforrások Azure Health Data Services-profilokkal való érvényesítéséről további információt az
Feljegyzés
Az FHIR® a HL7 bejegyzett védjegye, amelyet a HL7 engedélyével használnak.