Questa pagina spiega come creare, aggiornare, applicare patch, visualizzare, elencare, recuperare ed eliminare le risorse FHIR.
Una risorsa FHIR può contenere i dati su un paziente, un dispositivo, un'osservazione e altro ancora. Per un elenco completo delle risorse FHIR, consulta l'indice delle risorse FHIR (DSTU2, STU3 o R4).
Gli esempi curl
e PowerShell in questa pagina funzionano con un datastore FHIR R4 e non è garantito che funzionino se utilizzi un datastore FHIR DSTU2 o STU3.
Se utilizzi un datastore FHIR DSTU2 o STU3, consulta la documentazione ufficiale FHIR
per informazioni su come convertire gli esempi nella versione FHIR che stai utilizzando.
Gli esempi Go, Java, Node.js e Python funzionano con un datastore FHIR STU3.
Creazione di una risorsa FHIR
Prima di poter creare risorse FHIR, devi creare un datastore FHIR.
Gli esempi curl
, PowerShell e Python mostrano come creare le seguenti risorse FHIR:
- Una risorsa paziente (DSTU2, STU3 e R4)
- una risorsa Encounter (DSTU2, STU3 e R4) per il paziente
- Una risorsa Observation (DSTU2, STU3 e R4) per l'Encounter
Gli esempi per tutti gli altri linguaggi mostrano come creare una risorsa FHIR generica.
Per maggiori informazioni, vedi
projects.locations.datasets.fhirStores.fhir.create
.
I seguenti esempi di curl
e PowerShell funzionano con gli archivi FHIR R4. Gli esempi Go, Java, Node.js e Python funzionano con gli archivi FHIR STU3.
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: l'ID del datastore FHIR
Corpo JSON della richiesta:
{ "name": [ { "use": "official", "family": "Smith", "given": [ "Darcy" ] } ], "gender": "female", "birthDate": "1970-01-01", "resourceType": "Patient" }
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
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' { "name": [ { "use": "official", "family": "Smith", "given": [ "Darcy" ] } ], "gender": "female", "birthDate": "1970-01-01", "resourceType": "Patient" } 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/fhir+json" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient"
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:
@' { "name": [ { "use": "official", "family": "Smith", "given": [ "Darcy" ] } ], "gender": "female", "birthDate": "1970-01-01", "resourceType": "Patient" } '@ | 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/fhir+json" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient" | Select-Object -Expand Content
Dovresti ricevere una risposta JSON simile alla seguente:
Go
Java
Node.js
Python
Dopo aver creato la risorsa Patient, crea una risorsa Encounter per descrivere un'interazione tra il paziente e il medico.
Nel campo PATIENT_ID, sostituisci l'ID della risposta restituita dal server al momento della creazione della risorsa Patient.
I seguenti esempi di curl
e PowerShell funzionano con gli archivi FHIR R4. L'esempio Python funziona con gli archivi FHIR STU3.
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: l'ID del datastore FHIR
- PATIENT_ID: la risposta restituita dal server durante la creazione della risorsa Patient
Corpo JSON della richiesta:
{ "status": "finished", "class": { "system": "http://hl7.org/fhir/v3/ActCode", "code": "IMP", "display": "inpatient encounter" }, "reasonCode": [ { "text": "The patient had an abnormal heart rate. She was concerned about this." } ], "subject": { "reference": "Patient/PATIENT_ID" }, "resourceType": "Encounter" }
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
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' { "status": "finished", "class": { "system": "http://hl7.org/fhir/v3/ActCode", "code": "IMP", "display": "inpatient encounter" }, "reasonCode": [ { "text": "The patient had an abnormal heart rate. She was concerned about this." } ], "subject": { "reference": "Patient/PATIENT_ID" }, "resourceType": "Encounter" } 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/fhir+json" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Encounter"
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:
@' { "status": "finished", "class": { "system": "http://hl7.org/fhir/v3/ActCode", "code": "IMP", "display": "inpatient encounter" }, "reasonCode": [ { "text": "The patient had an abnormal heart rate. She was concerned about this." } ], "subject": { "reference": "Patient/PATIENT_ID" }, "resourceType": "Encounter" } '@ | 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/fhir+json" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Encounter" | Select-Object -Expand Content
Dovresti ricevere una risposta JSON simile alla seguente:
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Dopo aver creato la risorsa Encounter, crea una risorsa Observation associata alla risorsa Encounter. La risorsa Osservazione fornisce una misurazione della frequenza cardiaca del paziente in battiti al minuto (B/M) (80
in bpm
).
I seguenti esempi di curl
e PowerShell funzionano con gli archivi FHIR R4. L'esempio Python funziona con gli archivi FHIR STU3.
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: l'ID del datastore FHIR
- PATIENT_ID: l'ID nella risposta restituita dal server al momento della creazione della risorsa Patient
- ENCOUNTER_ID: l'ID nella risposta restituita dal server al momento della creazione della risorsa Encounter
Corpo JSON della richiesta:
{ "resourceType": "Observation", "status": "final", "subject": { "reference": "Patient/PATIENT_ID" }, "effectiveDateTime": "2020-01-01T00:00:00+00:00", "identifier": [ { "system": "my-code-system", "value": "ABC-12345" } ], "code": { "coding": [ { "system": "http://loinc.org", "code": "8867-4", "display": "Heart rate" } ] }, "valueQuantity": { "value": 80, "unit": "bpm" }, "encounter": { "reference": "Encounter/ENCOUNTER_ID" } }
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
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' { "resourceType": "Observation", "status": "final", "subject": { "reference": "Patient/PATIENT_ID" }, "effectiveDateTime": "2020-01-01T00:00:00+00:00", "identifier": [ { "system": "my-code-system", "value": "ABC-12345" } ], "code": { "coding": [ { "system": "http://loinc.org", "code": "8867-4", "display": "Heart rate" } ] }, "valueQuantity": { "value": 80, "unit": "bpm" }, "encounter": { "reference": "Encounter/ENCOUNTER_ID" } } 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/fhir+json" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Observation"
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:
@' { "resourceType": "Observation", "status": "final", "subject": { "reference": "Patient/PATIENT_ID" }, "effectiveDateTime": "2020-01-01T00:00:00+00:00", "identifier": [ { "system": "my-code-system", "value": "ABC-12345" } ], "code": { "coding": [ { "system": "http://loinc.org", "code": "8867-4", "display": "Heart rate" } ] }, "valueQuantity": { "value": 80, "unit": "bpm" }, "encounter": { "reference": "Encounter/ENCOUNTER_ID" } } '@ | 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/fhir+json" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Observation" | Select-Object -Expand Content
Dovresti ricevere una risposta JSON simile alla seguente:
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Cloud Healthcare.
Per eseguire l'autenticazione nell'API Cloud Healthcare, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Crea in modo condizionale una risorsa FHIR
Il seguente esempio curl
mostra come utilizzare il metodo projects.locations.datasets.fhirStores.fhir.create
per creare in modo condizionale una risorsa FHIR. Il metodo implementa
l'interazione create
condizionale FHIR (DSTU2, STU3, R4).
Utilizza la creazione condizionale per evitare di creare risorse FHIR duplicate. Ad esempio, ogni risorsa Pazient in un server FHIR ha un identificatore univoco, come un numero di cartelle cliniche (MRN). Per creare una nuova risorsa Paziente e verificare che non esista già nessuna risorsa Paziente con lo stesso MRN, crea la nuova risorsa in modo condizionale. L'API Cloud Healthcare crea la nuova risorsa solo se non ci sono corrispondenze per la query di ricerca.
La risposta del server dipende dalla quantità di risorse corrispondenti alla query di ricerca:
Corrisponde a | Codice di risposta HTTP | Comportamento |
---|---|---|
Zero | 200 OK |
Crea la nuova risorsa. |
Uno | 200 OK |
Non crea una nuova risorsa. |
Più di uno | 412 Precondition Failed |
Non crea una nuova risorsa e restituisce un errore "search criteria are not selective enough" . |
Per utilizzare l'interazione condizionale create
anziché l'interazione create
,
specifica un'intestazione HTTP If-None-Exist
contenente una query di ricerca FHIR
nella richiesta:
If-None-Exist: FHIR_SEARCH_QUERY
Nell'API Cloud Healthcare v1, le operazioni condizionali utilizzano esclusivamente il parametro di ricerca identifier
, se esistente per il tipo di risorsa FHIR, al fine di determinare quali risorse FHIR corrispondono a una query di ricerca condizionale.
REST
L'esempio seguente mostra come creare una risorsa Observation utilizzando un'intestazione HTTP If-None-Exist: identifier=my-code-system|ABC-12345
. L'API Cloud Healthcare
crea la risorsa se e solo se nessuna risorsa Observation esistente corrisponde alla
query identifier=my-code-system|ABC-12345
.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/fhir+json" \ -H "If-None-Exist: identifier=my-code-system|ABC-12345" \ -d @request.json \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Observation"
Il seguente output di esempio mostra intenzionalmente una richiesta failed. Per visualizzare la risposta di una richiesta riuscita, consulta Creazione di una risorsa FHIR.
Se più risorse di osservazione corrispondono alla query, l'API Cloud Healthcare restituisce la seguente risposta e la richiesta di creazione condizionale ha esito negativo:
{
"issue": [
{
"code": "conflict",
"details": {
"text": "ambiguous_query"
},
"diagnostics": "search criteria are not selective enough",
"severity": "error"
}
],
"resourceType": "OperationOutcome"
}
Aggiornamento di una risorsa FHIR
Gli esempi riportati di seguito mostrano come utilizzare il metodo projects.locations.datasets.fhirStores.fhir.update
per aggiornare una risorsa FHIR. Il metodo implementa l'interazione di aggiornamento standard FHIR (DSTU2, STU3 e R4).
Quando aggiorni una risorsa, ne aggiorni l'intero contenuto. Ciò è in contrasto con l'applicazione di patch a una risorsa, che si aggiorna solo in parte.
Se nel datastore FHIR è stato impostato enableUpdateCreate
, la richiesta viene trattata come un upsert (aggiornamento o inserimento) che aggiorna la risorsa se esiste oppure la inserisce utilizzando l'ID specificato nella richiesta se non esiste.
Il corpo della richiesta deve contenere una risorsa FHIR con codifica JSON e le intestazioni della richiesta devono contenere Content-Type: application/fhir+json
. La risorsa deve contenere un elemento id
avente un valore identico all'ID nel percorso REST della richiesta.
I seguenti esempi di curl
e PowerShell funzionano con gli archivi FHIR R4. Gli esempi Go, Java, Node.js e Python funzionano con gli archivi FHIR STU3.
REST
Gli esempi riportati di seguito mostrano come aggiornare i battiti al minuto (BPM) in una risorsa Observation.
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 del datastore FHIR
- OBSERVATION_ID: ID risorsa di osservazione
- PATIENT_ID: l'ID risorsa Paziente
- ENCOUNTER_ID: l'ID risorsa di Encounter
- BPM_VALUE: valore dei battiti al minuto (B/M) nella risorsa Osservazione aggiornata
Corpo JSON della richiesta:
{ "resourceType": "Observation", "id": "OBSERVATION_ID", "status": "final", "subject": { "reference": "Patient/PATIENT_ID" }, "effectiveDateTime": "2020-01-01T00:00:00+00:00", "identifier": [ { "system": "my-code-system", "value": "ABC-12345" } ], "code": { "coding": [ { "system": "http://loinc.org", "code": "8867-4", "display": "Heart rate" } ] }, "valueQuantity": { "value": BPM_VALUE, "unit": "bpm" }, "encounter": { "reference": "Encounter/ENCOUNTER_ID" } }
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
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' { "resourceType": "Observation", "id": "OBSERVATION_ID", "status": "final", "subject": { "reference": "Patient/PATIENT_ID" }, "effectiveDateTime": "2020-01-01T00:00:00+00:00", "identifier": [ { "system": "my-code-system", "value": "ABC-12345" } ], "code": { "coding": [ { "system": "http://loinc.org", "code": "8867-4", "display": "Heart rate" } ] }, "valueQuantity": { "value": BPM_VALUE, "unit": "bpm" }, "encounter": { "reference": "Encounter/ENCOUNTER_ID" } } EOF
Quindi, esegui questo comando per inviare la richiesta REST:
curl -X PUT \
-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/fhir/Observation/OBSERVATION_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:
@' { "resourceType": "Observation", "id": "OBSERVATION_ID", "status": "final", "subject": { "reference": "Patient/PATIENT_ID" }, "effectiveDateTime": "2020-01-01T00:00:00+00:00", "identifier": [ { "system": "my-code-system", "value": "ABC-12345" } ], "code": { "coding": [ { "system": "http://loinc.org", "code": "8867-4", "display": "Heart rate" } ] }, "valueQuantity": { "value": BPM_VALUE, "unit": "bpm" }, "encounter": { "reference": "Encounter/ENCOUNTER_ID" } } '@ | 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 PUT `
-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/fhir/Observation/OBSERVATION_ID" | Select-Object -Expand Content
Explorer API
Copia il corpo della richiesta e apri la pagina di riferimento del metodo. Sul lato destro della pagina si apre il riquadro Explorer API. Puoi interagire con questo strumento per inviare richieste. Incolla il corpo della richiesta in questo strumento, compila tutti gli altri campi obbligatori e fai clic su Esegui.
Dovresti ricevere una risposta JSON simile alla seguente:
Go
Node.js
Python
Aggiornamento condizionale di una risorsa FHIR
Gli esempi riportati di seguito mostrano come chiamare il metodo projects.locations.datasets.fhirStores.fhir.conditionalUpdate
per aggiornare una risorsa FHIR che corrisponde a una query di ricerca, anziché identificare la risorsa in base al suo ID. Il metodo implementa
l'interazione di aggiornamento condizionale standard FHIR
(DSTU2,
STU3
e R4).
Un aggiornamento condizionale può essere applicato a una sola risorsa FHIR alla volta.
La risposta restituita dal server dipende dal numero di corrispondenze che si verificano in base ai criteri di ricerca:
- Una corrispondenza: la risorsa è stata aggiornata correttamente o viene restituito un errore.
- Più di una corrispondenza: la richiesta restituisce un errore
412 Precondition Failed
. - Zero corrispondenze con
id
: se i criteri di ricerca non identificano corrispondenze, il corpo della richiesta fornito contiene unid
e l'archivio FHIR haenableUpdateCreate
impostato sutrue
, la risorsa FHIR viene creata con ilid
nel corpo della richiesta. - Zero corrispondenze senza
id
: se i criteri di ricerca identificano zero corrispondenze e il corpo della richiesta fornito non contieneid
, la risorsa FHIR viene creata con un ID assegnato dal server, come se la risorsa fosse stata creata utilizzandoprojects.locations.datasets.fhirStores.fhir.create
.
Il corpo della richiesta deve contenere una risorsa FHIR con codifica JSON e le intestazioni della richiesta devono contenere Content-Type: application/fhir+json
.
Nell'API Cloud Healthcare v1, le operazioni condizionali utilizzano esclusivamente il parametro di ricerca identifier
, se esistente per il tipo di risorsa FHIR, al fine di determinare quali risorse FHIR corrispondono a una query di ricerca condizionale.
REST
L'esempio seguente mostra come inviare una richiesta PUT
utilizzando curl
e PowerShell per modificare una risorsa di osservazione utilizzando l'identificatore di osservazione (ABC-12345
in my-code-system
). Questa risorsa fornisce una misurazione dei battiti cardiaci al minuto (B/M) di un paziente.
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 del datastore FHIR
- PATIENT_ID: l'ID risorsa Paziente
- ENCOUNTER_ID: l'ID risorsa di Encounter
- BPM_VALUE: valore dei battiti al minuto (B/M) nella risorsa Osservazione
Corpo JSON della richiesta:
{ "resourceType": "Observation", "status": "final", "subject": { "reference": "Patient/PATIENT_ID" }, "effectiveDateTime": "2020-01-01T00:00:00+00:00", "identifier": [ { "system": "my-code-system", "value": "ABC-12345" } ], "code": { "coding": [ { "system": "http://loinc.org", "code": "8867-4", "display": "Heart rate" } ] }, "valueQuantity": { "value": BPM_VALUE, "unit": "bpm" }, "encounter": { "reference": "Encounter/ENCOUNTER_ID" } }
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
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' { "resourceType": "Observation", "status": "final", "subject": { "reference": "Patient/PATIENT_ID" }, "effectiveDateTime": "2020-01-01T00:00:00+00:00", "identifier": [ { "system": "my-code-system", "value": "ABC-12345" } ], "code": { "coding": [ { "system": "http://loinc.org", "code": "8867-4", "display": "Heart rate" } ] }, "valueQuantity": { "value": BPM_VALUE, "unit": "bpm" }, "encounter": { "reference": "Encounter/ENCOUNTER_ID" } } EOF
Quindi, esegui questo comando per inviare la richiesta REST:
curl -X PUT \
-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/fhir/Observation?identifier=my-code-system|ABC-12345"
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:
@' { "resourceType": "Observation", "status": "final", "subject": { "reference": "Patient/PATIENT_ID" }, "effectiveDateTime": "2020-01-01T00:00:00+00:00", "identifier": [ { "system": "my-code-system", "value": "ABC-12345" } ], "code": { "coding": [ { "system": "http://loinc.org", "code": "8867-4", "display": "Heart rate" } ] }, "valueQuantity": { "value": BPM_VALUE, "unit": "bpm" }, "encounter": { "reference": "Encounter/ENCOUNTER_ID" } } '@ | 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 PUT `
-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/fhir/Observation?identifier=my-code-system|ABC-12345" | Select-Object -Expand Content
Explorer API
Copia il corpo della richiesta e apri la pagina di riferimento del metodo. Sul lato destro della pagina si apre il riquadro Explorer API. Puoi interagire con questo strumento per inviare richieste. Incolla il corpo della richiesta in questo strumento, compila tutti gli altri campi obbligatori e fai clic su Esegui.
Dovresti ricevere una risposta JSON simile alla seguente:
Applicazione di patch a una risorsa FHIR
Gli esempi riportati di seguito mostrano come chiamare il metodo projects.locations.datasets.fhirStores.fhir.patch
per applicare la patch a una risorsa FHIR. Il metodo implementa l'interazione con le patch standard FHIR
(DSTU2,
STU3
e R4).
Quando applichi la patch a una risorsa, ne aggiorni parte applicando le operazioni specificate in un documento di patch JSON.
La richiesta deve contenere un documento di patch JSON e le intestazioni della richiesta devono contenere Content-Type: application/json-patch+json
.
Gli esempi riportati di seguito mostrano
come applicare una patch a una risorsa Observation. L'osservazione dei battiti cardiaci al minuto (BPM) di un paziente viene aggiornata mediante l'operazione di applicazione patch replace
.
I seguenti esempi di curl
e PowerShell funzionano con gli archivi FHIR R4. Gli esempi Go, Java, Node.js e Python funzionano con gli archivi FHIR STU3.
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: l'ID del datastore FHIR
- OBSERVATION_ID: ID risorsa di osservazione
- BPM_VALUE: valore dei battiti al minuto (B/M) nella risorsa Osservazione con patch
Corpo JSON della richiesta:
[ { "op": "replace", "path": "/valueQuantity/value", "value": BPM_VALUE } ]
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
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' [ { "op": "replace", "path": "/valueQuantity/value", "value": BPM_VALUE } ] 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-patch+json" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Observation/OBSERVATION_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:
@' [ { "op": "replace", "path": "/valueQuantity/value", "value": BPM_VALUE } ] '@ | 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-patch+json" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Observation/OBSERVATION_ID" | Select-Object -Expand Content
Dovresti ricevere una risposta JSON simile alla seguente:
Go
Java
Node.js
Python
Esecuzione di una richiesta PATCH
in un bundle FHIR
Puoi specificare una richiesta PATCH
in un bundle FHIR (solo FHIR R4).
L'esecuzione di una richiesta PATCH
in un bundle FHIR ti consente di applicare patch a molte risorse FHIR contemporaneamente, anziché dover effettuare singole richieste di patch per ogni risorsa FHIR.
Per effettuare una richiesta PATCH
in un bundle, specifica le seguenti informazioni in un
oggetto resource
della richiesta:
- Un campo
resourceType
impostato suBinary
- Un campo
contentType
impostato suapplication/json-patch+json
- Il corpo della patch codificato in base64
Assicurati che l'oggetto resource
abbia il seguente aspetto:
"resource": {
"resourceType": "Binary",
"contentType": "application/json-patch+json",
"data": "WyB7ICJvcCI6ICJyZXBsYWNlIiwgInBhdGgiOiAiL2JpcnRoRGF0ZSIsICJ2YWx1ZSI6ICIxOTkwLTAxLTAxIiB9IF0K"
}
Di seguito viene mostrato il corpo della patch codificato in base64 nel campo data
:
[
{
"op": "replace",
"path": "/birthdate",
"value": "1990-01-01"
}
]
Gli esempi riportati di seguito mostrano come utilizzare una richiesta PATCH
in un bundle per applicare una patch alla risorsa Patient che hai creato nella sezione Creazione di una risorsa FHIR per avere un valore birthDate
pari a 1990-01-01
:
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 padre
- DATASET_ID: il set di dati padre del datastore FHIR
- FHIR_STORE_ID: l'ID del datastore FHIR
- PATIENT_ID: l'ID di una risorsa Patient esistente
Corpo JSON della richiesta:
{ "type": "transaction", "resourceType": "Bundle", "entry": [ { "request": { "method": "PATCH", "url": "Patient/PATIENT_ID" }, "resource": { "resourceType": "Binary", "contentType": "application/json-patch+json", "data": "WyB7ICJvcCI6ICJyZXBsYWNlIiwgInBhdGgiOiAiL2JpcnRoRGF0ZSIsICJ2YWx1ZSI6ICIxOTkwLTAxLTAxIiB9IF0K" } } ] }
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
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' { "type": "transaction", "resourceType": "Bundle", "entry": [ { "request": { "method": "PATCH", "url": "Patient/PATIENT_ID" }, "resource": { "resourceType": "Binary", "contentType": "application/json-patch+json", "data": "WyB7ICJvcCI6ICJyZXBsYWNlIiwgInBhdGgiOiAiL2JpcnRoRGF0ZSIsICJ2YWx1ZSI6ICIxOTkwLTAxLTAxIiB9IF0K" } } ] } 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/fhir+json" \
-d @request.json \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir"
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:
@' { "type": "transaction", "resourceType": "Bundle", "entry": [ { "request": { "method": "PATCH", "url": "Patient/PATIENT_ID" }, "resource": { "resourceType": "Binary", "contentType": "application/json-patch+json", "data": "WyB7ICJvcCI6ICJyZXBsYWNlIiwgInBhdGgiOiAiL2JpcnRoRGF0ZSIsICJ2YWx1ZSI6ICIxOTkwLTAxLTAxIiB9IF0K" } } ] } '@ | 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/fhir+json" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir" | Select-Object -Expand Content
Dovresti ricevere una risposta JSON simile alla seguente:
Applicazione di patch a una risorsa FHIR in modo condizionale
Gli esempi riportati di seguito mostrano come chiamare il metodo projects.locations.datasets.fhirStores.fhir.conditionalPatch
per applicare una patch a una risorsa FHIR che corrisponde a una query di ricerca, anziché identificare la risorsa in base al relativo ID. Il metodo implementa l'interazione con la patch condizionale standard FHIR
(DSTU2,
STU3
e R4).
Una patch condizionale può essere applicata a una sola risorsa alla volta. Se i criteri di ricerca identificano più di una corrispondenza, la richiesta restituisce un errore 412 Precondition Failed
.
Nell'API Cloud Healthcare v1, le operazioni condizionali utilizzano esclusivamente il parametro di ricerca identifier
, se esistente per il tipo di risorsa FHIR, al fine di determinare quali risorse FHIR corrispondono a una query di ricerca condizionale.
REST
L'esempio seguente mostra come inviare una richiesta PATCH
utilizzando curl
e PowerShell per modificare una risorsa Observation se l'identificatore di osservazione è ABC-12345
in my-code-system
.
L'osservazione dei battiti cardiaci al minuto (BPM) di un paziente viene aggiornata utilizzando l'operazione di applicazione patch replace
.
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 del datastore FHIR
- BPM_VALUE: valore dei battiti al minuto (B/M) nella risorsa Osservazione
Corpo JSON della richiesta:
[ { "op": "replace", "path": "/valueQuantity/value", "value": BPM_VALUE } ]
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
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' [ { "op": "replace", "path": "/valueQuantity/value", "value": BPM_VALUE } ] 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-patch+json" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Observation?identifier=my-code-system|ABC-12345"
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:
@' [ { "op": "replace", "path": "/valueQuantity/value", "value": BPM_VALUE } ] '@ | 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-patch+json" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Observation?identifier=my-code-system|ABC-12345" | Select-Object -Expand Content
Explorer API
Copia il corpo della richiesta e apri la pagina di riferimento del metodo. Sul lato destro della pagina si apre il riquadro Explorer API. Puoi interagire con questo strumento per inviare richieste. Incolla il corpo della richiesta in questo strumento, compila tutti gli altri campi obbligatori e fai clic su Esegui.
Dovresti ricevere una risposta JSON simile alla seguente:
Recupero di una risorsa FHIR
Gli esempi riportati di seguito mostrano come utilizzare il metodo projects.locations.datasets.fhirStores.fhir.read
per recuperare i contenuti di una risorsa FHIR.
I seguenti esempi di curl
e PowerShell funzionano con gli archivi FHIR R4.
Gli esempi Go, Java, Node.js e Python funzionano con gli archivi FHIR STU3.
Console
Per recuperare i contenuti di una risorsa FHIR, segui questi passaggi:
Nella console Google Cloud, vai alla pagina del visualizzatore FHIR.
Nell'elenco a discesa FHIR Store, seleziona un set di dati, quindi seleziona un datastore FHIR nel set di dati.
Per filtrare l'elenco dei tipi di risorse, cerca quelli che vuoi visualizzare.
Fai clic sul campo Tipo di risorsa.
Nell'elenco a discesa Proprietà che viene visualizzato, seleziona Tipo di risorsa.
Inserisci un tipo di risorsa.
Per cercare un altro tipo di risorsa, seleziona OR dall'elenco a discesa Operatori visualizzato, quindi inserisci un altro tipo di risorsa.
Nell'elenco dei tipi di risorsa, seleziona quello della risorsa di cui vuoi recuperare i contenuti.
Nella tabella delle risorse visualizzata, seleziona o cerca una risorsa.
REST
Gli esempi riportati di seguito mostrano come ottenere i dettagli della risorsa osservazione creata in una sezione precedente.
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 del datastore FHIR
- OBSERVATION_ID: ID risorsa di osservazione
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
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/Observation/OBSERVATION_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/fhir/Observation/OBSERVATION_ID" | Select-Object -Expand Content
Explorer API
Apri la pagina di riferimento del metodo. Sul lato destro della pagina si apre il riquadro Explorer API. 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
Visualizzazione di tutte le risorse di un alloggiamento del paziente
Gli esempi riportati di seguito mostrano come recuperare tutte le risorse associate a un determinato compartimento paziente (DSTU2, STU3 e R4).
Per maggiori informazioni, vedi
projects.locations.datasets.fhirStores.fhir.Patient-everything
.
I seguenti esempi di curl
e PowerShell funzionano con gli archivi FHIR R4. Gli esempi Go, Java, Node.js e Python funzionano con gli archivi FHIR STU3.
curl
Per recuperare le risorse in un vano del paziente, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome del set di dati padre
- Il nome del datastore FHIR
- ID del paziente
- Un token di accesso
L'esempio seguente mostra una richiesta GET
utilizzando curl
:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient/PATIENT_ID/\$everything"
Se la richiesta riesce, il server restituisce una risposta simile al seguente esempio in formato JSON:
{ "entry": [ { "resource": { "birthDate": "1970-01-01", "gender": "female", "id": "PATIENT_ID", "name": [ { "family": "Smith", "given": [ "Darcy" ], "use": "official" } ], "resourceType": "Patient" } }, { "resource": { "class": { "code": "IMP", "display": "inpatient encounter", "system": "http://hl7.org/fhir/v3/ActCode" }, "id": "ENCOUNTER_ID", "reasonCode": [ { "text": "The patient had an abnormal heart rate. She was concerned about this." } ], "resourceType": "Encounter", "status": "finished", "subject": { "reference": "Patient/PATIENT_ID" } } }, { "resource": { "encounter": { "reference": "Encounter/ENCOUNTER_ID" }, "effectiveDateTime": "2020-01-01T00:00:00+00:00", "id": "OBSERVATION_ID", "resourceType": "Observation", "status": "final", "subject": { "reference": "Patient/PATIENT_ID" }, "valueQuantity": { "unit": "bpm", "value": BPM_VALUE } } } ], "resourceType": "Bundle", "type": "searchset" }
PowerShell
Per recuperare le risorse in un vano del paziente, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome del set di dati padre
- Il nome del datastore FHIR
- ID del paziente
- Un token di accesso
L'esempio seguente mostra una richiesta GET
mediante PowerShell:
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-RestMethod ` -Method Get ` -Headers $headers ` -Uri 'https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient/RESOURCE_ID/$everything' | ConvertTo-Json
Se la richiesta riesce, il server restituisce una risposta simile al seguente esempio in formato JSON:
{ "entry": [ { "resource": { "birthDate": "1970-01-01", "gender": "female", "id": "PATIENT_ID", "name": [ { "family": "Smith", "given": [ "Darcy" ], "use": "official" } ], "resourceType": "Patient" } }, { "resource": { "class": { "code": "IMP", "display": "inpatient encounter", "system": "http://hl7.org/fhir/v3/ActCode" }, "id": "ENCOUNTER_ID", "reasonCode": [ { "text": "The patient had an abnormal heart rate. She was concerned about this." } ], "resourceType": "Encounter", "status": "finished", "subject": { "reference": "Patient/PATIENT_ID" } } }, { "resource": { "encounter": { "reference": "Encounter/ENCOUNTER_ID" }, "effectiveDateTime": "2020-01-01T00:00:00+00:00", "id": "OBSERVATION_ID", "resourceType": "Observation", "status": "final", "subject": { "reference": "Patient/PATIENT_ID" }, "valueQuantity": { "unit": "bpm", "value": BPM_VALUE } } } ], "resourceType": "Bundle", "type": "searchset" }
Go
Java
Node.js
Python
Recupero delle risorse del compartimento paziente filtrato per tipo o data
Gli esempi riportati di seguito mostrano come ottenere tutte le risorse associate a un
determinato
alloggiamento del paziente (R4)
filtrate in base a un elenco di tipi e a partire da una data e un'ora specificate.
Per maggiori informazioni, vedi
projects.locations.datasets.fhirStores.fhir.Patient-everything
.
I seguenti esempi di curl
e PowerShell funzionano con gli archivi FHIR R4.
curl
Per ottenere le risorse in un compartimento paziente di un tipo specificato e a partire da una data specificata, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome del set di dati padre
- Il nome del datastore FHIR
- ID del paziente
- Una stringa di query contenente un elenco di tipi di risorsa separati da virgole e la data di inizio
- Un token di accesso
L'esempio seguente mostra una richiesta GET
utilizzando curl
:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient/PATIENT_ID/\$everything?_type=RESOURCE_TYPES&_since=DATE"
Se la richiesta riesce, il server restituisce tutte le risorse che soddisfano i criteri specificati in formato JSON.
PowerShell
Per ottenere le risorse in un compartimento paziente di un tipo specificato e a partire da una data specificata, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome del set di dati padre
- Il nome del datastore FHIR
- ID del paziente
- Una stringa di query contenente un elenco di tipi di risorsa separati da virgole e la data di inizio
- Un token di accesso
L'esempio seguente mostra una richiesta GET
mediante PowerShell:
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-RestMethod ` -Method Get ` -Headers $headers ` -Uri 'https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient/RESOURCE_ID/$everything?_type=RESOURCE_TYPES&_since=DATE' | ConvertTo-Json
Se la richiesta riesce, il server restituisce tutte le risorse che soddisfano i criteri specificati in formato JSON.
Elenco delle versioni delle risorse FHIR
Gli esempi riportati di seguito mostrano come elencare tutte le versioni cronologiche di una risorsa FHIR. Per maggiori informazioni, vedi
projects.locations.datasets.fhirStores.fhir.history
.
Gli esempi utilizzano le risorse create nella sezione Creazione di una risorsa FHIR e mostrano come elencare le versioni di una risorsa Observation.
I seguenti esempi di curl
e PowerShell funzionano con gli archivi FHIR R4. Gli esempi Go, Java, Node.js e Python funzionano con gli archivi FHIR STU3.
curl
L'esempio riportato di seguito mostra come elencare tutte le versioni di una risorsa Observation. Questa risorsa è stata aggiornata una sola volta dopo la creazione originale per modificare i battiti cardiaci al minuto (BPM) del paziente.
Per elencare tutte le versioni di una risorsa FHIR, inclusa quella corrente e le eventuali versioni eliminate, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome del set di dati padre
- Il nome del datastore FHIR
- Il tipo e l'ID della risorsa
- Un token di accesso
L'esempio seguente mostra una richiesta GET
che utilizza curl
.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/RESOURCE_TYPE/RESOURCE_ID/_history"
Se la richiesta ha esito positivo, il server restituisce la risposta in formato JSON. In questo esempio, vengono restituite due versioni della risorsa Observation. Nella prima versione, la frequenza cardiaca del paziente era di 75 b/m. Nella seconda versione, la frequenza cardiaca del paziente era di 85 b/m.
{ "entry": [ { "resource": { "effectiveDateTime": "2020-01-01T00:00:00+00:00", "id": "OBSERVATION_ID", "meta": { "lastUpdated": "2020-01-02T00:00:00+00:00", "versionId": "MTU0MTE5MDk5Mzk2ODcyODAwMA" }, "resourceType": "Observation", "status": "final", "subject": { "reference": "Patient/PATIENT_ID" }, "valueQuantity": { "unit": "bpm", "value": 85 } } }, { "resource": { "encounter": { "reference": "Encounter/ENCOUNTER_ID" }, "effectiveDateTime": "2020-01-01T00:00:00+00:00", "id": "OBSERVATION_ID", "meta": { "lastUpdated": "2020-01-01T00:00:00+00:00", "versionId": "MTU0MTE5MDg4MTY0MzQ3MjAwMA" }, "resourceType": "Observation", "status": "final", "subject": { "reference": "Patient/PATIENT_ID" }, "valueQuantity": { "unit": "bpm", "value": 75 } } } ], "resourceType": "Bundle", "type": "history" }
PowerShell
L'esempio riportato di seguito mostra come elencare tutte le versioni di una risorsa Observation. Questa risorsa è stata aggiornata una sola volta dopo la creazione originale per modificare i battiti cardiaci al minuto (BPM) del paziente.
Per elencare tutte le versioni di una risorsa FHIR, inclusa quella corrente e le eventuali versioni eliminate, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome del set di dati padre
- Il nome del datastore FHIR
- Il tipo e l'ID della risorsa
- Un token di accesso
L'esempio seguente mostra una richiesta GET
mediante PowerShell.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-RestMethod ` -Method Get ` -Headers $headers ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/RESOURCE_TYPE/RESOURCE_ID/_history" | Select-Object -Expand Content
Se la richiesta ha esito positivo, il server restituisce la risposta in formato JSON. In questo esempio, vengono restituite due versioni della risorsa Observation. Nella prima versione, la frequenza cardiaca del paziente era di 75 b/m. Nella seconda versione, la frequenza cardiaca del paziente era di 85 b/m.
{ "entry": [ { "resource": { "effectiveDateTime": "2020-01-01T00:00:00+00:00", "id": "OBSERVATION_ID", "meta": { "lastUpdated": "2020-01-02T00:00:00+00:00", "versionId": "MTU0MTE5MDk5Mzk2ODcyODAwMA" }, "resourceType": "Observation", "status": "final", "subject": { "reference": "Patient/PATIENT_ID" }, "valueQuantity": { "unit": "bpm", "value": 85 } } }, { "resource": { "encounter": { "reference": "Encounter/ENCOUNTER_ID" }, "effectiveDateTime": "2020-01-01T00:00:00+00:00", "id": "OBSERVATION_ID", "meta": { "lastUpdated": "2020-01-01T00:00:00+00:00", "versionId": "MTU0MTE5MDg4MTY0MzQ3MjAwMA" }, "resourceType": "Observation", "status": "final", "subject": { "reference": "Patient/PATIENT_ID" }, "valueQuantity": { "unit": "bpm", "value": 75 } } } ], "resourceType": "Bundle", "type": "history" }
Go
Java
Node.js
Python
Recupero di una versione della risorsa FHIR
Gli esempi riportati di seguito mostrano come recuperare una versione specifica di una risorsa.
Per maggiori informazioni, vedi
projects.locations.datasets.fhirStores.fhir.vread
.
Di seguito sono evidenziati gli ID versione per la risorsa Observation di Elenco delle versioni delle risorse FHIR:
{ "entry": [ { "resource": { "effectiveDateTime": "2020-01-01T00:00:00+00:00", "id": "OBSERVATION_ID", "meta": { "lastUpdated": "2020-01-02T00:00:00+00:00", "versionId": "MTU0MTE5MDk5Mzk2ODcyODAwMA" }, ... { "resource": { "encounter": { "reference": "Encounter/ENCOUNTER_ID" }, "effectiveDateTime": "2020-01-01T00:00:00+00:00", "id": "OBSERVATION_ID", "meta": { "lastUpdated": "2020-01-01T00:00:00+00:00", "versionId": "MTU0MTE5MDg4MTY0MzQ3MjAwMA" }, ... }
Gli esempi seguenti utilizzano le risorse create nella sezione Creazione di una risorsa FHIR e mostrano come visualizzare una risorsa Observation.
I seguenti esempi di curl
e PowerShell funzionano con gli archivi FHIR R4. Gli esempi Go, Node.js e Python funzionano con gli archivi FHIR STU3.
curl
Per ottenere una versione specifica di una risorsa FHIR, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome del set di dati padre
- Il nome del datastore FHIR
- Il tipo e l'ID della risorsa
- La versione della risorsa
- Un token di accesso
L'esempio seguente mostra una richiesta GET
che utilizza curl
.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/RESOURCE_TYPE/RESOURCE_ID/_history/RESOURCE_VERSION"
Se la richiesta ha esito positivo, il server restituisce la risposta in formato JSON. In questo esempio, viene restituita la prima versione dell'osservazione, in cui la frequenza cardiaca del paziente era pari a 75 b/m.
{ "encounter": { "reference": "Encounter/ENCOUNTER_ID" }, "effectiveDateTime": "2020-01-01T00:00:00+00:00", "id": "OBSERVATION_ID", "meta": { "lastUpdated": "2020-01-01T00:00:00+00:00", "versionId": "MTU0MTE5MDg4MTY0MzQ3MjAwMA" }, "resourceType": "Observation", "status": "final", "subject": { "reference": "Patient/PATIENT_ID" }, "valueQuantity": { "unit": "bpm", "value": 75 } }
PowerShell
Per ottenere una versione specifica di una risorsa FHIR, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome del set di dati padre
- Il nome del datastore FHIR
- Il tipo e l'ID della risorsa
- La versione della risorsa
- Un token di accesso
L'esempio seguente mostra una richiesta GET
che utilizza curl
.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-RestMethod ` -Method Get ` -Headers $headers ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/RESOURCE_TYPE/RESOURCE_ID/RESOURCE_VERSION/_history" | Select-Object -Expand Content
Se la richiesta ha esito positivo, il server restituisce la risposta in formato JSON. In questo esempio, viene restituita la prima versione dell'osservazione, in cui la frequenza cardiaca del paziente era pari a 75 b/m.
{ "encounter": { "reference": "Encounter/ENCOUNTER_ID" }, "effectiveDateTime": "2020-01-01T00:00:00+00:00", "id": "OBSERVATION_ID", "meta": { "lastUpdated": "2020-01-01T00:00:00+00:00", "versionId": "MTU0MTE5MDg4MTY0MzQ3MjAwMA" }, "resourceType": "Observation", "status": "final", "subject": { "reference": "Patient/PATIENT_ID" }, "valueQuantity": { "unit": "bpm", "value": 75 } }
Go
Java
Node.js
Python
Eliminazione di una risorsa FHIR
Gli esempi riportati di seguito mostrano come chiamare il metodo projects.locations.datasets.fhirStores.fhir.delete
per eliminare una risorsa FHIR di osservazione.
Indipendentemente dall'esito positivo o negativo dell'operazione, il server restituisce un codice di stato HTTP 200 OK
. Per verificare che la risorsa sia stata eliminata, cerca o recupera la risorsa e verifica se esiste.
I seguenti esempi di curl
e PowerShell funzionano con gli archivi FHIR R4. Gli esempi Go, Java, Node.js e Python funzionano con gli archivi FHIR STU3.
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: l'ID del datastore FHIR
- OBSERVATION_ID: ID risorsa di osservazione
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
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/fhir/Observation/OBSERVATION_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/fhir/Observation/OBSERVATION_ID" | Select-Object -Expand Content
Explorer API
Apri la pagina di riferimento del metodo. Sul lato destro della pagina si apre il riquadro Explorer API. 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
Elimina in modo condizionale una risorsa FHIR
Nell'API Cloud Healthcare v1, le operazioni condizionali utilizzano esclusivamente il parametro di ricerca identifier
, se esistente per il tipo di risorsa FHIR, al fine di determinare quali risorse FHIR corrispondono a una query di ricerca condizionale.
Una risorsa FHIR corrisponde alla query ?identifier=my-code-system|ABC-12345
se e solo se il valore identifier.system
della risorsa è my-code-system
e il relativo identifier.value
è ABC-12345
. Se una risorsa FHIR corrisponde alla query, l'API Cloud Healthcare elimina la risorsa.
Se la query utilizza il parametro di ricerca identifier
e
corrisponde a più risorse FHIR, l'API Cloud Healthcare restituisce un
errore "412 - Condition not selective enough"
.
Per eliminare le risorse singolarmente:
- Cerca ogni risorsa per ottenere l'ID univoco assegnato dal server.
- Elimina singolarmente ogni risorsa utilizzando l'ID.
Gli esempi riportati di seguito mostrano come eliminare in modo condizionale una risorsa FHIR che corrisponde a una query di ricerca, anziché identificare la risorsa FHIR in base al relativo ID.
La query di ricerca corrisponde ed elimina una risorsa Observation utilizzando l'identificatore di osservazione (ABC-12345
in my-code-system
).
REST
Utilizza il metodo projects.locations.datasets.fhirStores.fhir.conditionalDelete
.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_ID
: l'ID del tuo progetto Google CloudLOCATION
: la posizione del set di datiDATASET_ID
: il set di dati padre del datastore FHIRFHIR_STORE_ID
: l'ID del datastore FHIR
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
Esegui questo comando:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Observation?identifier=my-code-system|ABC-12345"
PowerShell
Esegui questo comando:
$cred = gcloud auth application-default 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/fhir/Observation?identifier=my-code-system|ABC-12345" | Select-Object -Expand Content
Explorer API
Apri la pagina di riferimento del metodo. Sul lato destro della pagina si apre il riquadro Explorer API. Puoi interagire con questo strumento per inviare richieste. Compila tutti i campi obbligatori e fai clic su Esegui.
Dovresti ricevere un codice di stato di operazione riuscita (2xx) e una risposta vuota.
Eliminazione delle versioni cronologiche di una risorsa FHIR
Gli esempi riportati di seguito mostrano come eliminare tutte le versioni cronologiche di una risorsa FHIR. Per maggiori informazioni, vedi
projects.locations.datasets.fhirStores.fhir.Resource-purge
.
La chiamata del metodo projects.locations.datasets.fhirStores.fhir.Resource-purge
è limitata agli utenti (chiamanti) con il ruolo roles/healthcare.fhirStoreAdmin
; gli utenti con il ruolo roles/healthcare.fhirResourceEditor
non possono chiamare il metodo. Per consentire a un chiamante di eliminare le versioni cronologiche di una risorsa FHIR, in uno dei seguenti modi:
- Assicurati che il chiamante abbia il ruolo
roles/healthcare.fhirStoreAdmin
. - Crea un ruolo IAM personalizzato con l'autorizzazione
healthcare.fhirResources.purge
e assegna il ruolo al chiamante.
Gli esempi utilizzano le risorse create nella sezione Creazione di una risorsa FHIR e mostrano come eliminare le versioni cronologiche di una risorsa Observation.
I seguenti esempi di curl
e PowerShell funzionano con gli archivi FHIR R4. Gli esempi Go, Java, Node.js e Python funzionano con gli archivi FHIR STU3.
curl
Per eliminare tutte le versioni cronologiche di una risorsa FHIR, effettua una richiesta DELETE
e specifica le seguenti informazioni:
- Il nome del set di dati padre
- Il nome del datastore FHIR
- Il tipo e l'ID della risorsa
- Un token di accesso
L'esempio seguente mostra una richiesta DELETE
che utilizza curl
.
curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/fhir+json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/RESOURCE_TYPE/RESOURCE_ID/\$purge"
Se la richiesta ha esito positivo, il server restituisce il corpo della risposta vuoto in formato JSON:
{}
PowerShell
Per eliminare tutte le versioni cronologiche di una risorsa FHIR, effettua una richiesta DELETE
e specifica le seguenti informazioni:
- Il nome del set di dati padre
- Il nome del datastore FHIR
- Il tipo e l'ID della risorsa
- Un token di accesso
L'esempio seguente mostra una richiesta DELETE
mediante PowerShell.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-RestMethod ` -Method Delete ` -Headers $headers ` -ContentType: "application/fhir+json; charset=utf-8" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/RESOURCE_TYPE/RESOURCE_ID/$purge" | ConvertTo-Json
Se la richiesta ha esito positivo, il server restituisce il corpo della risposta vuoto in formato JSON:
{}