Questa pagina descrive come esportare i messaggi HL7v2 da un archivio HL7v2 a Cloud Storage. Puoi esportare in blocco i messaggi HL7v2 in Cloud Storage per l'elaborazione downstream.
Prima di iniziare
Consulta l'argomento Esportazione di messaggi HL7v2 da Cloud Storage per i ruoli che devi concedere all'account di servizio dell'agente di servizio Cloud Healthcare.
Esportazione di messaggi HL7v2 in Cloud Storage
L'API Cloud Healthcare esporta ciascun messaggio HL7v2 come riga in un file .ndjson
NDJSON. I messaggi HL7v2 sono ordinati cronologicamente in base al relativo valore sendTime
.
Esporta in un bucket o in una cartella Cloud Storage, anziché in un oggetto, poiché l'API Cloud Healthcare potrebbe creare più file NDJSON quando sono presenti molti messaggi HL7v2.
Se esporti in una cartella Cloud Storage che non esiste, viene creata la cartella.
Console
Per esportare i messaggi HL7v2 in Cloud Storage, completa i seguenti passaggi:
Nella console Google Cloud, vai alla pagina Set di dati.
Fai clic sul set di dati che contiene l'archivio HL7v2 da cui stai esportando i messaggi HL7v2.
Nell'elenco dei datastore, scegli Esporta dall'elenco Azioni per l'archivio HL7v2.
Viene visualizzata la pagina Esporta messaggi HL7v2.
Nell'elenco Progetto, seleziona un progetto Cloud Storage.
Nell'elenco Località, seleziona un bucket Cloud Storage.
Fai clic su Esporta per esportare le istanze HL7v2 nella posizione definita in Cloud Storage.
- Per monitorare lo stato dell'operazione, fai clic sulla scheda Operazioni. Al termine dell'operazione, vengono visualizzate le seguenti indicazioni:
- La sezione Stato operazione a lunga esecuzione ha un segno di spunta verde sotto l'intestazione OK.
- La sezione Panoramica contiene un segno di spunta verde e un indicatore OK nella stessa riga dell'ID operazione.
Esporta messaggi HL7v2 in Cloud Storage utilizzando i filtri
Per impostazione predefinita, l'esportazione di messaggi HL7v2 in Cloud Storage include tutti i messaggi HL7v2 in un archivio HL7v2 e tutti i campi in ogni oggetto Message
.
Puoi filtrare i messaggi HL7v2 esportati come segue:
- Utilizza i filtri per esportare un sottoinsieme di messaggi HL7v2 che corrispondono a un criterio di filtro. Per ulteriori informazioni, vedi Esportare un sottoinsieme di messaggi HL7v2 utilizzando un filtro.
- Utilizza l'oggetto
MessageView
per selezionare i campi in ogniMessage
da esportare. Per ulteriori informazioni, vedi Esportare i messaggi HL7v2 tramiteMessage
.
Esporta un sottoinsieme di messaggi HL7v2 utilizzando un filtro
Nei criteri di filtro puoi utilizzare i seguenti campi:
Puoi specificare i seguenti parametri di filtro come criteri di filtro nel campo filter
. Per apprendere la sintassi dei filtri e creare le query, consulta Stringhe di query.
message_type
: dal campo MSH.9.1. Ad esempio,NOT message_type = "ADT"
.send_date
: la dataYYYY-MM-DD
in cui il messaggio è stato inviato dal segmento MSH.7, specificata nel fuso orario del set di dati. Ad esempio:send_date < "2017-01-02"
.send_time
: il timestamp di invio del messaggio. Questo parametro proviene dal segmento MSH.7 del messaggio. Questo parametro utilizza il formato orario RFC 3339 per i confronti. Ad esempio:send_time < "2017-01-02T00:00:00-05:00"
.create_time
: il timestamp in cui il messaggio è stato creato nell'API Cloud Healthcare, utilizzando il formato orario RFC 3339 per i confronti. Ad esempio:create_time < "2017-01-02T00:00:00-05:00"
.send_facility
: il centro assistenza da cui proviene il messaggio, dal segmento MSH.4. Ad esempio,send_facility = "ABC"
.
I seguenti esempi mostrano come specificare un filtro per esportare solo i messaggi HL7v2 di tipo ADT
.
REST
Utilizza il metodo
hl7V2Stores.export
per esportare i messaggi HL7v2: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 dell'archivio HL7v2HL7V2_STORE_ID
: l'ID store HL7v2CLOUD_STORAGE_LOCATION
: nome di un bucket o di una cartella Cloud Storage in cui vengono scritti i messaggi HL7v2 esportati
Corpo JSON della richiesta:
{ "gcsDestination": { "uriPrefix": "gs://CLOUD_STORAGE_LOCATION" }, "filter": "message_type = \"ADT\"" }
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' { "gcsDestination": { "uriPrefix": "gs://CLOUD_STORAGE_LOCATION" }, "filter": "message_type = \"ADT\"" } EOF
Quindi esegui questo comando per inviare la richiesta REST:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID:export"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:@' { "gcsDestination": { "uriPrefix": "gs://CLOUD_STORAGE_LOCATION" }, "filter": "message_type = \"ADT\"" } '@ | Out-File -FilePath request.json -Encoding utf8
Quindi esegui questo comando per inviare la richiesta REST:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID:export" | Select-Object -Expand ContentOPERATION_ID
. Questo valore ti servirà nel passaggio successivo.Utilizza il metodo
projects.locations.datasets.operations.get
per ottenere lo stato dell'operazione a lunga esecuzione.Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_ID
: l'ID del tuo progetto Google CloudDATASET_ID
: l'ID del set di datiLOCATION
: la posizione del set di datiOPERATION_ID
: l'ID restituito dall'operazione a lunga esecuzione
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/operations/OPERATION_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/operations/OPERATION_ID" | Select-Object -Expand ContentExplorer 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.
"done": true
, l'operazione a lunga esecuzione è terminata.
Esporta messaggi HL7v2 per campo Message
Nell'API Cloud Healthcare, i messaggi HL7v2 vengono archiviati in risorse Message
. Puoi utilizzare l'enum MessageView
per determinare quali campi nella risorsa Message
sono inclusi in ciascun messaggio HL7v2 esportato.
I seguenti esempi mostrano come utilizzare il valore BASIC
in MessageView
per includere solo il campo name
nei messaggi HL7v2 esportati.
REST
Utilizza il metodo
hl7V2Stores.export
per esportare i messaggi HL7v2: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 dell'archivio HL7v2HL7V2_STORE_ID
: l'ID store HL7v2CLOUD_STORAGE_LOCATION
: nome di un bucket o di una cartella Cloud Storage in cui vengono scritti i messaggi HL7v2 esportati
Corpo JSON della richiesta:
{ "gcsDestination": { "uriPrefix": "gs://CLOUD_STORAGE_LOCATION", "messageView": "BASIC" } }
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' { "gcsDestination": { "uriPrefix": "gs://CLOUD_STORAGE_LOCATION", "messageView": "BASIC" } } EOF
Quindi esegui questo comando per inviare la richiesta REST:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID:export"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:@' { "gcsDestination": { "uriPrefix": "gs://CLOUD_STORAGE_LOCATION", "messageView": "BASIC" } } '@ | Out-File -FilePath request.json -Encoding utf8
Quindi esegui questo comando per inviare la richiesta REST:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID:export" | Select-Object -Expand ContentOPERATION_ID
. Questo valore ti servirà nel passaggio successivo.Utilizza il metodo
projects.locations.datasets.operations.get
per ottenere lo stato dell'operazione a lunga esecuzione.Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_ID
: l'ID del tuo progetto Google CloudDATASET_ID
: l'ID del set di datiLOCATION
: la posizione del set di datiOPERATION_ID
: l'ID restituito dall'operazione a lunga esecuzione
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/operations/OPERATION_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/operations/OPERATION_ID" | Select-Object -Expand ContentExplorer 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.
"done": true
, l'operazione a lunga esecuzione è terminata.
Risolvere i problemi relativi alle richieste di esportazione HL7v2
Se si verificano errori durante l'esportazione dei messaggi HL7v2, vengono registrati in Cloud Logging. Per maggiori informazioni, consulta Visualizzazione dei log degli errori in Cloud Logging.
Se un'operazione a lunga esecuzione restituisce un errore, consulta la sezione Risoluzione dei problemi relativi alle operazioni a lunga esecuzione.