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 di 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 i campioni 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 di curl
, PowerShell e Python mostrano come creare le seguenti risorse FHIR:
- Una risorsa Paziente (DSTU2, STU3 e R4)
- Una risorsa incontro (DSTU2, STU3 e R4) per il paziente
- Una risorsa di osservazione (DSTU2, STU3 e R4) per l'incontro
Gli esempi per tutti gli altri linguaggi mostrano come creare una risorsa FHIR generica.
Per maggiori informazioni, consulta
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 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:
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' { "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 datastore FHIR
- PATIENT_ID: la risposta restituita dal server al momento della 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:
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' { "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 di configurazione di Python riportate nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per eseguire l'autenticazione all'API Cloud Healthcare, configura le 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 di osservazione 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 datastore FHIR
- PATIENT_ID: l'ID nella risposta restituito 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:
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' { "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 di configurazione di Python riportate nella guida rapida dell'API Cloud Healthcare utilizzando le librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Healthcare Python.
Per eseguire l'autenticazione all'API Cloud Healthcare, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Crea una risorsa FHIR in modo condizionale
Il seguente esempio di curl
mostra come utilizzare il metodo projects.locations.datasets.fhirStores.fhir.create
per creare una risorsa FHIR in modo condizionale. Il metodo implementa
l'interazione condizionale create
di FHIR (DSTU2, STU3, R4).
Utilizza la creazione condizionale per evitare di creare risorse FHIR duplicate. Ad esempio, ogni risorsa Patient 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à alcuna risorsa Paziente con lo stesso MRN, crea la nuova risorsa in modo condizionale. L'API Cloud Healthcare crea la nuova risorsa solo se non esistono corrispondenze per la query di ricerca.
La risposta del server dipende dal numero 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 una | 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, per determinare quali risorse FHIR corrispondono a una query di ricerca condizionale.
REST
Il seguente esempio mostra come creare una risorsa di osservazione utilizzando un'intestazione HTTP If-None-Exist: identifier=my-code-system|ABC-12345
. L'API Cloud Healthcare
crea la risorsa solo se nessuna risorsa di osservazione 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 non riuscita. Per visualizzare la risposta di una richiesta riuscita, consulta la pagina 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 dello standard FHIR (DSTU2, STU3 e R4).
Quando aggiorni una risorsa, aggiorni l'intero contenuto della risorsa. A differenza dell'applicazione di patch a una risorsa, che aggiorna solo parte di una risorsa.
Se nel datastore FHIR è impostato enableUpdateCreate
, la richiesta viene trattata come un upsert (aggiornamento o inserimento) che aggiorna la risorsa, se esistente, o la inserisce utilizzando l'ID specificato per la 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
con 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
I seguenti esempi mostrano come aggiornare i battiti al minuto (B/M) in una risorsa di osservazione.
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
- OBSERVATION_ID: l'ID risorsa di osservazione
- PATIENT_ID: l'ID risorsa del paziente
- ENCOUNTER_ID: l'ID risorsa dell'incontro
- 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:
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' { "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. 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
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 identificano zero corrispondenze, il corpo della richiesta fornito contiene unid
e il datastore 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 fornita non contiene un valoreid
, 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, per 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
). L'osservazione fornisce una misurazione dei battiti cardiaci al minuto (BPM) 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 datastore FHIR
- PATIENT_ID: l'ID risorsa del paziente
- ENCOUNTER_ID: l'ID risorsa dell'incontro
- BPM_VALUE: il 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:
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' { "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. 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:
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 della patch standard FHIR (DSTU2, STU3 e R4).
Quando applichi la patch a una risorsa, aggiorni parte di quest'ultima applicando le operazioni specificate in un documento JSON Patch.
La richiesta deve contenere un documento patch JSON e le intestazioni della richiesta devono contenere Content-Type: application/json-patch+json
.
Gli esempi riportati di seguito mostrano come applicare la patch a una risorsa di osservazione. L'osservazione dei battiti cardiaci al minuto (B/M) di un paziente viene aggiornata utilizzando l'operazione di 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 datastore FHIR
- OBSERVATION_ID: l'ID risorsa di osservazione
- BPM_VALUE: valore di battiti al minuto (BPM) nella risorsa di osservazione con patch
Corpo JSON della richiesta:
[ { "op": "replace", "path": "/valueQuantity/value", "value": BPM_VALUE } ]
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' [ { "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 della 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
nella 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 creata nella sezione Creazione di una risorsa FHIR in modo che abbia 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 datastore FHIR
- PATIENT_ID: l'ID di una risorsa Paziente 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:
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' { "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 condizionale di patch a una risorsa FHIR
Gli esempi riportati di seguito mostrano come chiamare il metodo projects.locations.datasets.fhirStores.fhir.conditionalPatch
per applicare la 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 della patch condizionale dello 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ù corrispondenze, 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, per 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 di osservazione se l'identificatore dell'osservazione è ABC-12345
in my-code-system
.
L'osservazione dei battiti cardiaci al minuto (B/M) di un paziente viene aggiornata utilizzando l'operazione di 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 datastore FHIR
- BPM_VALUE: il 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:
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' [ { "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. 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:
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 Visualizzatore FHIR.
Nell'elenco a discesa Archivio FHIR, 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 O dall'elenco a discesa Operatori visualizzato, quindi inserisci un altro tipo di risorsa.
Nell'elenco dei tipi di risorse, seleziona il tipo di risorsa di cui vuoi visualizzare 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 datastore FHIR
- OBSERVATION_ID: l'ID risorsa di osservazione
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/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. 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
Visualizzazione di tutte le risorse di un alloggiamento del paziente
I seguenti esempi mostrano come recuperare tutte le risorse associate a un determinato alloggiamento del paziente (DSTU2, STU3 e R4).
Per maggiori informazioni, consulta
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 ottenere le risorse in un compartimento del paziente, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome del set di dati padre
- Il nome del datastore FHIR
- L'ID del paziente
- Un token di accesso
Il seguente esempio 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/Patient/PATIENT_ID/\$everything"
Se la richiesta ha esito positivo, il server restituisce una risposta simile alla 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 ottenere le risorse in un compartimento del paziente, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome del set di dati padre
- Il nome del datastore FHIR
- L'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 ha esito positivo, il server restituisce una risposta simile alla 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
Filtraggio delle risorse dell'alloggiamento paziente per tipo o data
Gli esempi riportati di seguito mostrano come filtrare tutte le risorse associate a un determinato compartimento paziente (R4) in base a un elenco di tipi e a partire da una data e un'ora specificate.
Per maggiori informazioni, consulta
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 alloggiamento del paziente di un tipo specificato e dopo una data specificata, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome del set di dati padre
- Il nome del datastore FHIR
- L'ID del paziente
- Una stringa di query contenente un elenco dei tipi di risorse separati da virgole e una data di inizio
- Un token di accesso
Il seguente esempio 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/Patient/PATIENT_ID/\$everything?_type=RESOURCE_TYPES&_since=DATE"
Se la richiesta ha esito positivo, il server restituisce tutte le risorse che corrispondono ai criteri specificati in formato JSON.
PowerShell
Per ottenere le risorse in un alloggiamento del paziente di un tipo specificato e dopo una data specificata, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome del set di dati padre
- Il nome del datastore FHIR
- L'ID del paziente
- Una stringa di query contenente un elenco dei tipi di risorse separati da virgole e una 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 ha esito positivo, il server restituisce tutte le risorse che corrispondono ai criteri specificati in formato JSON.
Elenco delle versioni delle risorse FHIR
I seguenti esempi mostrano come elencare tutte le versioni cronologiche di una risorsa FHIR. Per maggiori informazioni, consulta
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 di osservazione.
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 la versione 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 di risorsa e l'ID
- Un token di accesso
Il seguente esempio 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, restituisce 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 la versione 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 di risorsa e l'ID
- 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, restituisce 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, consulta
projects.locations.datasets.fhirStores.fhir.vread
.
Gli ID versione per la risorsa Observation nell'elenco delle versioni delle risorse FHIR sono evidenziati di seguito:
{ "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 di risorsa e l'ID
- La versione della risorsa
- Un token di accesso
Il seguente esempio 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 di 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 di risorsa e l'ID
- La versione della risorsa
- Un token di accesso
Il seguente esempio 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 di 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
I seguenti esempi mostrano come chiamare il metodo projects.locations.datasets.fhirStores.fhir.delete
per eliminare una risorsa FHIR di osservazione.
Indipendentemente dal fatto che l'operazione abbia esito positivo o negativo, il server restituisce un codice di stato HTTP 200 OK
. Per verificare che la risorsa sia stata eliminata correttamente, 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 datastore FHIR
- OBSERVATION_ID: l'ID risorsa di osservazione
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/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. 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
Elimina una risorsa FHIR in modo condizionale
Nell'API Cloud Healthcare v1, le operazioni condizionali utilizzano esclusivamente il parametro di ricerca identifier
, se esistente per il tipo di risorsa FHIR, per 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 valore identifier.value
è ABC-12345
. Se una risorsa FHIR corrisponde alla query, l'API Cloud Healthcare la elimina.
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 di osservazione utilizzando l'identificatore dell'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 datastore FHIR
Per inviare la richiesta, scegli una delle seguenti opzioni:
arricciatura
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. 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 un codice di stato riuscito (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, consulta
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, procedi 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 di risorsa e l'ID
- Un token di accesso
Il seguente esempio 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 di risorsa e l'ID
- 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:
{}