Accesso a Servizi per i dati sanitari di Azure tramite l'estensione client REST in Visual Studio Code

Questo articolo illustra come accedere a Servizi per i dati sanitari di Azure usando l'estensione client REST in Visual Studio Code.

Installare l'estensione client REST

Selezionare l'icona Estensioni nel pannello a sinistra di Visual Studio Code e cercare "Client REST". Individuare e installare l'estensione client REST.

Creare un file .http e definire le variabili

Creare un nuovo file in Visual Studio Code. Immettere una riga di comando della richiesta GET nel file e salvarla come test.http. Il suffisso del file .http attiva automaticamente l'ambiente client REST. Selezionare Send Request per ottenere i metadati.

Ottenere i valori dell'applicazione client

Anche se è possibile usare valori come l'ID client direttamente nelle chiamate all'API REST, è consigliabile definire alcune variabili per questi valori e usare invece le variabili.

Nel file test.http, includere le informazioni seguenti ottenute dalla registrazione dell'applicazione.

### REST Client
@fhirurl =https://xxx.azurehealthcareapis.com
@clientid =xxx....
@clientsecret =xxx....
@tenantid =xxx....

Ottenere il token di accesso di Microsoft Entra

Dopo aver incluso le informazioni seguenti nel file test.http, premere Send Request. Verrà visualizzata una risposta HTTP che contiene il token di accesso.

La riga che inizia con @name contiene una variabile che acquisisce la risposta HTTP contenente il token di accesso. La variabile, @token, viene usata per archiviare il token di accesso.

### 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}}

Ottenere i dati dei pazienti FHIR

È ora possibile ottenere un elenco di pazienti o un paziente specifico con la richiesta GET. La riga con Authorization contiene le informazioni di intestazione per la richiesta GET. È anche possibile inviare le richieste PUT o POST per creare e aggiornare le risorse FHIR.

### GET Patient 
GET {{fhirurl}}/Patient/<patientid>
Authorization: Bearer {{token}}

Eseguire PowerShell o l'interfaccia della riga di comando

È possibile eseguire gli script di PowerShell o dell'interfaccia della riga di comando in Visual Studio Code. Premere CTRL e il tasto ~ e selezionare PowerShell o Bash. Per altre informazioni, vedere Terminale integrato.

PowerShell in Visual Studio Code

Interfaccia della riga di comando in Visual Studio Code

Risoluzione dei problemi

Se non è possibile ottenere i metadati (che non richiedono il token di accesso in base alla specifica HL7) verificare che il server FHIR sia in esecuzione correttamente.

Se non è possibile ottenere un token di accesso, assicurarsi che l'applicazione client sia registrata correttamente e che si usino i valori corretti del passaggio di registrazione dell'applicazione.

Se non è possibile ottenere dati dal server FHIR, assicurarsi che all'applicazione client (o all'entità servizio) siano state concesse le autorizzazioni di accesso, ad esempio "Collaboratore dati FHIR" al server FHIR.

Passaggi successivi

In questo articolo è stato illustrato come accedere ai dati di Servizi per i dati sanitari di Azure usando l'estensione client REST in Visual Studio Code.

Per informazioni su come convalidare le risorse FHIR per i profili in Servizi per i dati sanitari di Azure, vedere