Accesso a Servizi dati di integrità di Azure tramite l'estensione client REST in Visual Studio Code
Questo articolo illustra come accedere a Servizi dati di integrità 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". Trovare l'estensione e l'installazione del client REST.
Creare un .http file e definire le variabili
Creare un nuovo file in Visual Studio Code. Immettere una GET riga di comando della richiesta nel file e salvarla come test.http. Il suffisso .http del file attiva automaticamente l'ambiente client REST. Selezionare questa opzione Send Request per ottenere i metadati.
Ottenere i valori dell'applicazione client
Importante
Prima di chiamare l'API REST del server FHIR (oltre a ottenere i metadati), è necessario completare la registrazione dell'applicazione. Prendere nota dell'ID tenant di Azure, dell'ID client, del segreto client e dell'URL del servizio.
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.
test.http Nel file 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 test.http file, 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.
Nota
L'oggetto grant_type di viene usato per ottenere un token di client_credentials 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}}
### Extract access token from getAADToken request
@token = {{getAADToken.response.body.access_token}}
Nota
Negli scenari in cui il parametro del gruppo di destinatari del servizio FHIR non è mappato all'URL dell'endpoint del servizio FHIR. Il valore del parametro della risorsa deve essere mappato al valore Audience nel pannello Autenticazione del servizio FHIR.
GET Dati dei pazienti FHIR
È ora possibile ottenere un elenco di pazienti o un paziente specifico con la GET richiesta. La riga con Authorization è le informazioni di intestazione per la GET richiesta. È anche possibile inviare PUT o POST richiedere di creare/aggiornare le risorse FHIR.
### GET Patient
GET {{fhirurl}}/Patient/<patientid>
Authorization: Bearer {{token}}
Eseguire PowerShell o l'interfaccia della riga di comando
È possibile eseguire script di PowerShell o dell'interfaccia della riga di comando in Visual Studio Code. Premere CTRL e premere il ~ tasto e selezionare PowerShell o Bash. Per altri dettagli, vedere Terminale integrato.
PowerShell in Visual Studio Code
Interfaccia della riga di comando in Visual Studio Code
Risoluzione dei problemi
Se non si riesce a ottenere i metadati, che non richiede 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 autorizzazioni di accesso, ad esempio "Collaboratore dati FHIR" al server FHIR.
Passaggi successivi
In questo articolo si è appreso come accedere ai dati di Servizi dati di integrità di Azure usando l'estensione client REST in Visual Studio Code.
Per informazioni su come convalidare le risorse FHIR rispetto ai profili in Servizi dati di integrità di Azure, vedere
FHIR® è un marchio registrato di HL7 e viene usato con l'autorizzazione di HL7.