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 alkalmazás regisztrálása során beszerzett alábbi információkat:
### REST Client
@fhirurl =https://xxx.azurehealthcareapis.com
@clientid =xxx....
@clientsecret =xxx....
@tenantid =xxx....
Microsoft Entra hozzáférési jogkivonat beszerzése
Miután beleérte az alábbi adatokat a test.http fájlba, nyomja le a 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 @tokenhozzáférési jogkivonat tárolására szolgál.
Megjegyzé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}}
### Extract access token from getAADToken request
@token = {{getAADToken.response.body.access_token}}
Megjegyzés:
Azokban az esetekben, amikor az FHIR szolgáltatás célközönségparamétere nincs leképezve az FHIR szolgáltatásvégpont URL-címére. 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 képezni.
GET FHIR betegadatok
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/frissítésére vonatkozó kéréseket is küldhet PUT vagy POST 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 azokat a metaadatokat, amelyek nem igényelnek hozzáférési jogkivonatot a HL7-specifikáció 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
Az FHIR® a HL7 bejegyzett védjegye, amelyet a HL7 engedélyével használnak.