Questa pagina spiega come creare, modificare, visualizzare, elencare ed eliminare gli archivi di risorse Fast Healthcare Interoperability (FHIR). Gli archivi FHIR contengono risorse FHIR, come risorse richieste, risorse per i pazienti, risorse mediche e altro ancora.
L'API Cloud Healthcare supporta le seguenti versioni FHIR:
Creazione di un datastore FHIR
Prima di poter creare un archivio FHIR, devi creare un set di dati.
I seguenti esempi mostrano come creare un datastore FHIR utilizzando il metodo projects.locations.datasets.fhirStores.create
.
Console
Per creare un datastore FHIR, completa i seguenti passaggi:
- Nella console Google Cloud, vai alla pagina Set di dati.
- Seleziona il set di dati in cui vuoi creare un datastore FHIR.
- Fai clic su Crea datastore.
- Seleziona FHIR come tipo di datastore.
- Inserisci un nome univoco nel set di dati. Se il nome non è univoco, la creazione del datastore FHIR non riesce.
- Tocca Avanti.
- Per configurare il datastore FHIR, segui questi passaggi:
- Scegli la versione FHIR per il datastore FHIR, una tra DSTU2, STU3 o R4.
- Seleziona le impostazioni avanzate applicabili tra le seguenti opzioni:
- Consenti creazione aggiornamento: seleziona questa opzione per consentire la creazione di una nuova risorsa utilizzando un'operazione di aggiornamento con un ID specificato dall'utente.
- Controlli di integrità referenziali: seleziona questa opzione per attivare l'integrità referenziale in questo datastore. Questa opzione non può essere modificata dopo aver creato lo store.
- Controllo delle versioni delle risorse: seleziona questa opzione per registrare automaticamente le versioni cronologiche delle risorse. Questa opzione non può essere modificata dopo aver creato lo store.
- Seleziona le impostazioni applicabili di convalida del profilo dai campi seguenti. Per maggiori informazioni,
consulta ValidationConfig:
- Attiva convalida profilo: seleziona questa opzione per attivare la convalida del profilo. Per applicare una guida all'implementazione abilitata nel tuo datastore FHIR, devi abilitare la convalida del profilo.
- Abilita la convalida dei campi obbligatori: seleziona questa opzione per abilitare la convalida dei campi delle risorse in base alle definizioni della struttura nel tuo profilo FHIR.
- Abilita la convalida dei tipi di riferimento: seleziona questa opzione per attivare la convalida dei tipi di riferimento.
- Abilita la convalida di FHIRPath: seleziona questa opzione per abilitare il controllo della compatibilità di FHIRPath.
- Tocca Avanti.
- (Facoltativo) Per abilitare le guide all'implementazione nel tuo datastore FHIR, segui questi passaggi:
- Fai clic su Abilita le guide all'implementazione.
- Fai clic ed espandi l'elenco Guide all'implementazione.
- Seleziona nell'elenco le guide all'implementazione applicabili.
Ogni guida all'implementazione supporta una versione specifica di FHIR. L'elenco mostra solo le guide all'implementazione compatibili con la versione selezionata dell'archivio FHIR.
- Fai clic su Importa IG personalizzata da Cloud Storage per importare qualsiasi bundle di convalida del profilo personalizzato da una località di Cloud Storage.
- Nel riquadro Seleziona oggetto, seleziona una risorsa bundle di convalida del profilo da una località di Cloud Storage. Per maggiori informazioni, consulta Utilizzare la console Google Cloud per abilitare le guide all'implementazione.
- Fai clic su Seleziona.
- Le guide all'implementazione selezionate sono elencate in una tabella con la relativa versione, l'URL e lo stato.
- Se hai abilitato le guide all'implementazione, ma non hai abilitato la convalida del profilo, la guida all'implementazione non diventerà effettiva.
- Tocca Avanti.
- (Facoltativo) Per esportare le modifiche alle risorse in BigQuery ogni volta che le risorse FHIR nel tuo datastore vengono create, aggiornate, applicate con patch o eliminate:
- Fai clic su Trasferisci flussi di modifiche alle risorse in BigQuery.
- Fai clic su Aggiungi una configurazione di flussi di dati. Per maggiori informazioni sui flussi di dati BigQuery, consulta Streaming delle modifiche delle risorse FHIR in BigQuery.
- Seleziona il livello di profondità nel cursore Profondità di struttura ricorsiva per impostare la profondità di tutte le strutture ricorsive nello schema di output. Per impostazione predefinita, il valore della profondità ricorsiva è 2.
- Fai clic su Fine per salvare la configurazione di flussi di dati.
- Tocca Avanti.
- (Facoltativo) Per configurare un argomento Pub/Sub per il datastore FHIR, segui questi passaggi:
- Fai clic su Ricevi notifiche Cloud Pub/Sub.
- Fai clic su Aggiungi un argomento Cloud Pub/Sub e seleziona il nome dell'argomento.
Quando specifichi un argomento Pub/Sub, inserisci l'URI qualificato dell'argomento, come mostrato nell'esempio seguente:
projects/PROJECT_ID/topics/PUBSUB_TOPIC
- Tocca Avanti.
- (Facoltativo) Per aggiungere etichette allo store:
- Fai clic su Aggiungi etichette per organizzare i datastore.
- Inserisci la chiave e il valore dell'etichetta. Per maggiori informazioni sulle etichette delle risorse, consulta Utilizzo delle etichette delle risorse.
- Fai clic su Crea.
Il nuovo datastore FHIR viene visualizzato nell'elenco.
gcloud
Per creare un datastore FHIR nel set di dati, esegui il comando gcloud healthcare fhir-stores create
.
Prima di utilizzare uno qualsiasi dei dati di comando riportati di seguito, effettua le seguenti sostituzioni:
- LOCATION: la posizione del set di dati
- DATASET_ID: il set di dati padre del datastore FHIR
- FHIR_STORE_ID:
un identificatore per il datastore FHIR. L'ID datastore FHIR deve avere quanto segue:
- Un ID univoco nel proprio set di dati
- Una stringa Unicode di 1-256 caratteri costituita da quanto segue:
- Numeri
- Lettere
- Trattini bassi
- Trattini
- Punti
- FHIR_STORE_VERSION: la versione FHIR del datastore FHIR. Le opzioni disponibili sono DSTU2, STU3 o R4.
Esegui questo comando:
Linux, macOS o Cloud Shell
gcloud healthcare fhir-stores create FHIR_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --version=FHIR_STORE_VERSION
Windows (PowerShell)
gcloud healthcare fhir-stores create FHIR_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION ` --version=FHIR_STORE_VERSION
Windows (cmd.exe)
gcloud healthcare fhir-stores create FHIR_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION ^ --version=FHIR_STORE_VERSION
Dovresti ricevere una risposta simile alla seguente:
Risposta
Created fhirStore [FHIR_STORE_ID].
REST
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- PROJECT_ID: l'ID del tuo progetto Google Cloud
- LOCATION: la posizione del set di dati
- DATASET_ID: il set di dati padre del datastore FHIR
- FHIR_STORE_ID:
un identificatore per il datastore FHIR. L'ID datastore FHIR deve avere quanto segue:
- Un ID univoco nel proprio set di dati
- Una stringa Unicode di 1-256 caratteri costituita da quanto segue:
- Numeri
- Lettere
- Trattini bassi
- Trattini
- Punti
- FHIR_STORE_VERSION: la versione FHIR del datastore FHIR. Le opzioni disponibili sono DSTU2, STU3 o R4.
Corpo JSON della richiesta:
{ "version": "FHIR_STORE_VERSION" }
Per inviare la richiesta, scegli una delle seguenti opzioni:
arricciatura
Salva il corpo della richiesta in un file denominato request.json
.
Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory attuale:
cat > request.json << 'EOF' { "version": "FHIR_STORE_VERSION" } EOF
Quindi esegui questo comando per inviare la richiesta REST:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores?fhirStoreId=FHIR_STORE_ID"
PowerShell
Salva il corpo della richiesta in un file denominato request.json
.
Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory attuale:
@' { "version": "FHIR_STORE_VERSION" } '@ | Out-File -FilePath request.json -Encoding utf8
Quindi esegui questo comando per inviare la richiesta REST:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores?fhirStoreId=FHIR_STORE_ID" | Select-Object -Expand Content
Explorer API
Copia il corpo della richiesta e apri la pagina di riferimento del metodo. Il riquadro Explorer API si apre sul lato destro della pagina. Puoi interagire con questo strumento per inviare richieste. Incolla il corpo della richiesta in questo strumento, compila gli altri campi obbligatori e fai clic su Esegui.
Dovresti ricevere una risposta JSON simile alla seguente:
Go
Java
Node.js
Python
Modifica di un datastore FHIR
I seguenti esempi mostrano come modificare un datastore FHIR. Puoi modificare un datastore FHIR per modificare proprietà come le seguenti:
- L'argomento Pub/Sub a cui l'API Cloud Healthcare invia notifiche sulle modifiche all'archivio FHIR.
- Le etichette del datastore FHIR. Le etichette sono coppie chiave-valore che consentono di organizzare le risorse Google Cloud.
projects/PROJECT_ID/topics/PUBSUB_TOPICAffinché le notifiche funzionino, devi concedere autorizzazioni aggiuntive all'account di servizio dell'agente di servizio Cloud Healthcare. Per ulteriori informazioni, consulta Autorizzazioni Pub/Sub per archivi DICOM, FHIR e HL7v2.
Console
Per modificare un datastore FHIR, completa i seguenti passaggi:
Nella console Google Cloud, vai alla pagina Set di dati.
Vai a Set di datiSeleziona il set di dati contenente il datastore FHIR che vuoi modificare.
Nell'elenco Datastore, seleziona il datastore FHIR che vuoi modificare.
Per modificare la configurazione del negozio, fai clic su
Configurazione del negozio FHIR.Per saperne di più sulle opzioni di configurazione del datastore FHIR, consulta Creazione di un datastore FHIR.
Per modificare le guide all'implementazione del datastore, fai clic su Utilizzare la console Google Cloud per abilitare le guide all'implementazione.
Guide all'implementazione e seleziona le guide all'implementazione applicabili oppure importa una guida all'implementazione personalizzata da Cloud Storage. Per maggiori informazioni, consultaPer modificare le guide all'implementazione o applicare le guide all'implementazione abilitate, devi attivare la convalida del profilo nella sezione Configurazione del datastore FHIR.
Per esportare le modifiche alle risorse in BigQuery ogni volta che le risorse FHIR nel tuo datastore vengono create, aggiornate, con patch o eliminate, fai clic su Aggiungi nuova configurazione di flussi di dati nel campo Set di dati.
Seleziona un set di dati BigQuery in cui verranno trasmesse le modifiche alle risorse. Per maggiori informazioni sui flussi di dati BigQuery, consulta Streaming delle modifiche delle risorse FHIR in BigQuery.
Per impostare la profondità di tutte le strutture ricorsive nello schema di output, fai clic sulla profondità pertinente nel cursore Profondità della struttura ricorsiva. Per impostazione predefinita, la profondità ricorsiva è 2.
Per esportare le modifiche alle risorse solo per tipi di risorse specifici, seleziona i tipi di risorsa dall'elenco Seleziona i tipi di risorse FHIR.
Per configurare un argomento Pub/Sub per il datastore, seleziona il nome di un argomento nella sezione Notifiche Cloud Pub/Sub. Quando specifichi un argomento Pub/Sub, inserisci l'URI qualificato dell'argomento, come mostrato nell'esempio seguente:
projects/PROJECT_ID/topics/PUBSUB_TOPIC
Per aggiungere una o più etichette allo store, fai clic su Utilizzo delle etichette delle risorse.
Etichette, poi su Aggiungi etichetta e inserisci l'etichetta della chiave/valore. Per saperne di più sulle etichette delle risorse, consultaFai clic su Salva.
gcloud
Per modificare un datastore FHIR, esegui il comando gcloud healthcare fhir-stores update
.
Prima di utilizzare uno qualsiasi dei dati di comando riportati di seguito, effettua le seguenti sostituzioni:
- LOCATION: la posizione del set di dati
- DATASET_ID: il set di dati padre del datastore FHIR
- FHIR_STORE_ID: l'ID datastore FHIR
- PUBSUB_TOPIC_ID: un argomento Pub/Sub in cui vengono pubblicati i messaggi quando si verifica un evento in un datastore
Esegui questo comando:
Linux, macOS o Cloud Shell
gcloud healthcare fhir-stores update FHIR_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID
Windows (PowerShell)
gcloud healthcare fhir-stores update FHIR_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION ` --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID
Windows (cmd.exe)
gcloud healthcare fhir-stores update FHIR_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION ^ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID
Dovresti ricevere una risposta simile alla seguente:
Risposta
Updated fhirStore [FHIR_STORE_ID]. name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID notificationConfig: pubsubTopic: projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID version: FHIR_STORE_VERSION
REST
Per modificare un datastore FHIR, utilizza il metodo projects.locations.datasets.fhirStores.patch
.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- PROJECT_ID: l'ID del tuo progetto Google Cloud
- LOCATION: la posizione del set di dati
- DATASET_ID: il set di dati padre del datastore FHIR
- FHIR_STORE_ID: l'ID datastore FHIR
- PUBSUB_TOPIC_ID: l'ID dell'argomento Pub/Sub. Per determinare quali dati includere nelle notifiche Pub/Sub, consulta Notifiche Pub/Sub FHIR.
- KEY1: la prima chiave di etichetta
- VALUE1: il primo valore dell'etichetta
- KEY2: la seconda chiave di etichetta
- VALUE2: il secondo valore dell'etichetta
Corpo JSON della richiesta:
{ "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID" }, "labels": { "KEY1": "VALUE1", "KEY2": "VALUE2" } }
Per inviare la richiesta, scegli una delle seguenti opzioni:
arricciatura
Salva il corpo della richiesta in un file denominato request.json
.
Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory attuale:
cat > request.json << 'EOF' { "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID" }, "labels": { "KEY1": "VALUE1", "KEY2": "VALUE2" } } EOF
Quindi esegui questo comando per inviare la richiesta REST:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID?updateMask=notificationConfig,labels"
PowerShell
Salva il corpo della richiesta in un file denominato request.json
.
Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory attuale:
@' { "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID" }, "labels": { "KEY1": "VALUE1", "KEY2": "VALUE2" } } '@ | Out-File -FilePath request.json -Encoding utf8
Quindi esegui questo comando per inviare la richiesta REST:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID?updateMask=notificationConfig,labels" | Select-Object -Expand Content
Explorer API
Copia il corpo della richiesta e apri la pagina di riferimento del metodo. Il riquadro Explorer API si apre sul lato destro della pagina. Puoi interagire con questo strumento per inviare richieste. Incolla il corpo della richiesta in questo strumento, compila gli altri campi obbligatori e fai clic su Esegui.
Dovresti ricevere una risposta JSON simile alla seguente:
Go
Java
Node.js
Python
Recupero dei dettagli di un archivio FHIR
Gli esempi riportati di seguito mostrano come recuperare i dettagli di un archivio FHIR.
Console
Per visualizzare i dettagli di un datastore FHIR:
- Nella console Google Cloud, vai alla pagina Set di dati.
- Seleziona il set di dati contenente il datastore FHIR.
- Fai clic sul nome del datastore FHIR.
gcloud
Per ottenere dettagli su un datastore FHIR, esegui il comando gcloud healthcare fhir-stores describe
.
Prima di utilizzare uno qualsiasi dei dati di comando riportati di seguito, effettua le seguenti sostituzioni:
- LOCATION: la posizione del set di dati
- DATASET_ID: il set di dati padre del datastore FHIR
- FHIR_STORE_ID: l'ID datastore FHIR
Esegui questo comando:
Linux, macOS o Cloud Shell
gcloud healthcare fhir-stores describe FHIR_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare fhir-stores describe FHIR_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare fhir-stores describe FHIR_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Dovresti ricevere una risposta simile alla seguente.
Se nella risorsa FhirStore
hai configurato dei campi, questi vengono visualizzati anche nella risposta.
Risposta
... name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID ... version: FHIR_STORE_VERSION
REST
Per ottenere dettagli su un datastore FHIR, utilizza il metodo projects.locations.datasets.fhirStores.get
.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- PROJECT_ID: l'ID del tuo progetto Google Cloud
- LOCATION: la posizione del set di dati
- DATASET_ID: il set di dati padre del datastore FHIR
- FHIR_STORE_ID: l'ID datastore FHIR
Per inviare la richiesta, scegli una delle seguenti opzioni:
arricciatura
Esegui questo comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID"
PowerShell
Esegui questo comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID" | Select-Object -Expand Content
Explorer API
Apri la pagina di riferimento del metodo. Il riquadro Explorer API si apre sul lato destro della pagina. Puoi interagire con questo strumento per inviare richieste. Compila tutti i campi obbligatori e fai clic su Esegui.
Dovresti ricevere una risposta simile alla seguente.
Se nella risorsa FhirStore
hai configurato dei campi, questi vengono visualizzati anche nella risposta.
Go
Java
Node.js
Python
Elenco dei datastore FHIR in un set di dati
Gli esempi riportati di seguito mostrano come elencare gli archivi FHIR in un set di dati.
Console
Per visualizzare i datastore in un set di dati:
- Nella console Google Cloud, vai alla pagina Set di dati.
- Seleziona il set di dati contenente il datastore da visualizzare.
gcloud
Per visualizzare i dettagli di un datastore FHIR, esegui il comando gcloud healthcare fhir-stores list
.
Prima di utilizzare uno qualsiasi dei dati di comando riportati di seguito, effettua le seguenti sostituzioni:
- DATASET_ID: il set di dati padre del datastore FHIR
- LOCATION: la posizione del set di dati
Esegui questo comando:
Linux, macOS o Cloud Shell
gcloud healthcare fhir-stores list --dataset=DATASET_ID --location=LOCATION
Windows (PowerShell)
gcloud healthcare fhir-stores list --dataset=DATASET_ID --location=LOCATION
Windows (cmd.exe)
gcloud healthcare fhir-stores list --dataset=DATASET_ID --location=LOCATION
Dovresti ricevere una risposta simile alla seguente.
Se nella risorsa FhirStore
hai configurato dei campi, questi vengono visualizzati anche nella risposta.
ID LOCATION REF_INT RES_VER UPDATE_CREATE TOPIC FHIR_STORE_ID LOCATION PUBSUB_TOPIC ...
REST
Per elencare i datastore FHIR in un set di dati, utilizza il metodo projects.locations.datasets.fhirStores.list
.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- PROJECT_ID: l'ID del tuo progetto Google Cloud
- DATASET_ID: il set di dati padre del datastore FHIR
- LOCATION: la posizione del set di dati
Per inviare la richiesta, scegli una delle seguenti opzioni:
arricciatura
Esegui questo comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores"
PowerShell
Esegui questo comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores" | Select-Object -Expand Content
Explorer API
Apri la pagina di riferimento del metodo. Il riquadro Explorer API si apre sul lato destro della pagina. Puoi interagire con questo strumento per inviare richieste. Compila tutti i campi obbligatori e fai clic su Esegui.
Dovresti ricevere una risposta simile alla seguente.
Se nella risorsa FhirStore
hai configurato dei campi, questi vengono visualizzati anche nella risposta.
Go
Java
Node.js
Python
Recupero delle capacità o della dichiarazione di conformità per un datastore FHIR
Gli esempi riportati di seguito mostrano come recuperare l'istruzione delle funzionalità (STU3 o R4) o di conformità (DSTU2) per un datastore FHIR.
Le informazioni nelle funzionalità o nella dichiarazione di conformità riflettono le impostazioni nell'archivio FHIR. Ad esempio, se FhirStore.enableUpdateCreate
è impostato su true
, questo si riflette nel campo CapabilityStatement.rest.resource.updateCreate
dell'istruzione di funzionalità.
La tabella seguente mostra il metodo dell'API Cloud Healthcare per ottenere la dichiarazione di capacità o conformità per un datastore FHIR e l'interazione equivalente della specifica FHIR:
Metodo API Cloud Healthcare | Interazione della specifica FHIR |
---|---|
projects.locations.datasets.fhirStores.fhir.capabilities |
(STU3 o R4) o conformance (DSTU2) |
Console
La console Google Cloud e gcloud CLI non supportano questa azione. Utilizza invece curl
, PowerShell o il tuo linguaggio preferito.
gcloud
La console Google Cloud e gcloud CLI non supportano questa azione. Utilizza invece curl
, PowerShell o il tuo linguaggio preferito.
REST
Per ottenere le capacità o la dichiarazione di conformità per un datastore FHIR, utilizza il metodo projects.locations.datasets.fhirStores.fhir.capabilities
.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- PROJECT_ID: l'ID del tuo progetto Google Cloud
- LOCATION: la posizione del set di dati
- DATASET_ID: il set di dati padre del datastore FHIR
- FHIR_STORE_ID: l'ID datastore FHIR
Per inviare la richiesta, scegli una delle seguenti opzioni:
arricciatura
Esegui questo comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/metadata"
PowerShell
Esegui questo comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/metadata" | Select-Object -Expand Content
Explorer API
Apri la pagina di riferimento del metodo. Il riquadro Explorer API si apre sul lato destro della pagina. Puoi interagire con questo strumento per inviare richieste. Compila tutti i campi obbligatori e fai clic su Esegui.
Dovresti ricevere una risposta JSON simile alla seguente:
Go
Java
Node.js
Python
Impostazione del livello di convalida delle risorse di base
Per impostazione predefinita, a tutte le risorse nel datastore FHIR viene applicata la convalida di base delle risorse. Questa convalida garantisce che le seguenti condizioni siano vere al momento della creazione della risorsa:
- Tutti i campi obbligatori sono definiti.
- Tutti i tipi di risorse di riferimento sono validi.
- La risorsa soddisfa tutti i vincoli FHIRPath.
Puoi rendere meno rigorosa la convalida delle risorse di base disabilitando uno o più di questi tipi di convalida delle risorse di base per il datastore FHIR.
Console
La console Google Cloud e gcloud CLI non supportano questa azione. Utilizza invece curl
, PowerShell o il tuo linguaggio preferito.
gcloud
La console Google Cloud e gcloud CLI non supportano questa azione. Utilizza invece curl
, PowerShell o il tuo linguaggio preferito.
REST
Per disabilitare la convalida delle risorse di base in un datastore FHIR esistente, utilizza il metodo projects.locations.datasets.fhirStores.patch
.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- PROJECT_ID: l'ID del tuo progetto Google Cloud
- DATASET_ID: il set di dati padre del datastore FHIR
- LOCATION: la posizione del set di dati
- BASE_RESOURCE_VALIDATION_TYPE: il tipo di convalida delle risorse di base che vuoi disabilitare. Per disabilitare la convalida, imposta uno dei seguenti campi su
true
:disableRequiredFieldValidation
disableReferenceTypeValidation
disableFhirpathValidation
Corpo JSON della richiesta:
{ "validationConfig": { "BASE_RESOURCE_VALIDATION_TYPE": true } }
Per inviare la richiesta, scegli una delle seguenti opzioni:
arricciatura
Salva il corpo della richiesta in un file denominato request.json
.
Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory attuale:
cat > request.json << 'EOF' { "validationConfig": { "BASE_RESOURCE_VALIDATION_TYPE": true } } EOF
Quindi esegui questo comando per inviare la richiesta REST:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID?updateMask=validationConfig"
PowerShell
Salva il corpo della richiesta in un file denominato request.json
.
Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory attuale:
@' { "validationConfig": { "BASE_RESOURCE_VALIDATION_TYPE": true } } '@ | Out-File -FilePath request.json -Encoding utf8
Quindi esegui questo comando per inviare la richiesta REST:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID?updateMask=validationConfig" | Select-Object -Expand Content
Explorer API
Copia il corpo della richiesta e apri la pagina di riferimento del metodo. Il riquadro Explorer API si apre sul lato destro della pagina. Puoi interagire con questo strumento per inviare richieste. Incolla il corpo della richiesta in questo strumento, compila gli altri campi obbligatori e fai clic su Esegui.
Dovresti ricevere una risposta simile alla seguente.
Se nella risorsa FhirStore
hai configurato dei campi, questi vengono visualizzati anche nella risposta.
Eliminazione di un archivio FHIR
Gli esempi riportati di seguito mostrano come eliminare un archivio FHIR.
Console
Per eliminare un datastore:
- Nella console Google Cloud, vai alla pagina Set di dati.
- Seleziona il set di dati contenente il datastore da eliminare.
- Scegli Elimina dall'elenco a discesa Azioni per il datastore da eliminare.
- Per confermare, digita il nome del datastore e fai clic su Elimina.
gcloud
Per eliminare un datastore FHIR, esegui il comando gcloud healthcare fhir-stores delete
.
Prima di utilizzare uno qualsiasi dei dati di comando riportati di seguito, effettua le seguenti sostituzioni:
- LOCATION: la posizione del set di dati
- DATASET_ID: il set di dati padre del datastore FHIR
- FHIR_STORE_ID: l'ID datastore FHIR
Esegui questo comando:
Linux, macOS o Cloud Shell
gcloud healthcare fhir-stores delete FHIR_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare fhir-stores delete FHIR_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare fhir-stores delete FHIR_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Dovresti ricevere una risposta simile alla seguente:
Deleted fhirStore [FHIR_STORE_ID].
REST
Per eliminare un datastore FHIR, utilizza il metodo projects.locations.datasets.fhirStores.delete
.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- PROJECT_ID: l'ID del tuo progetto Google Cloud
- LOCATION: la posizione del set di dati
- DATASET_ID: il set di dati padre del datastore FHIR
- FHIR_STORE_ID: l'ID datastore FHIR
Per inviare la richiesta, scegli una delle seguenti opzioni:
arricciatura
Esegui questo comando:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID"
PowerShell
Esegui questo comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID" | Select-Object -Expand Content
Explorer API
Apri la pagina di riferimento del metodo. Il riquadro Explorer API si apre sul lato destro della pagina. Puoi interagire con questo strumento per inviare richieste. Compila tutti i campi obbligatori e fai clic su Esegui.
Dovresti ricevere una risposta JSON simile alla seguente:
Go
Java
Node.js
Python
Passaggi successivi
Scopri come creare e utilizzare le risorse FHIR.