In questa pagina viene spiegato come importare, creare, etichettare, elencare, visualizzare ed eliminare i messaggi HL7v2. I messaggi HL7v2 vengono utilizzati per trasmettere dati clinici tra i sistemi. Un messaggio HL7v2 può contenere informazioni su un risultato di osservazione, una prescrizione da inviare a una farmacia, una transazione finanziaria o altri eventi clinici.
Panoramica sulla creazione e l'importazione di messaggi HL7v2
Utilizza uno dei seguenti metodi per archiviare un messaggio HL7v2 nell'API Cloud Healthcare:
Quando utilizzi messages.ingest
, il metodo genera una risposta contenente
uno dei seguenti elementi:
- Un messaggio di riconoscimento HL7v2 (
ACK
) in caso di esito positivo - Un messaggio di riconoscimento negativo (
NACK
) in caso di errore
I messaggi ACK
e NACK
vengono utilizzati per rispondere ai sistemi di interfaccia HL7v2
che si aspettano queste conferme.
Importazione e creazione di messaggi con un adattatore MLLP
I messaggi HL7v2 vengono inviati tra i sistemi sanitari e l'API Cloud Healthcare utilizzando il protocollo MLLP (Minimal Lower Layer Protocol). Per ulteriori informazioni, consulta MLLP e l'adattatore MLLP di Google Cloud Platform. Per istruzioni su come configurare un adattatore MLLP per comunicare in modo sicuro con l'API Cloud Healthcare, consulta Trasmissione di messaggi HL7v2 su connessioni TCP/IP.
Importazione di messaggi HL7v2
Dopo che l'API Cloud Healthcare importa il messaggio da un sistema sanitario, genera una risposta contenente un campo hl7ack
che contiene un messaggio HL7v2 codificato in base64 con le seguenti caratteristiche:
- Il tipo di messaggio è
ACK
. - La struttura che invia il messaggio e quella che lo riceve sono invertite, così come l'applicazione di invio e quella di ricezione.
- L'ora di invio del messaggio è l'ora attuale e viene generato un nuovo ID controllo.
- Il valore del campo
MSH-9.1
definisce il tipo di messaggio. - Il valore del campo
MSA.1
definisce un tipo di risposta. Una risposta di tipoAA
indicaApplication Accept
, ovvero che il messaggio è stato convalidato e importato in modo corretto. - Il valore
MSA.2
contiene l'ID di controllo del messaggio originale.
Gli esempi riportati di seguito mostrano come importare un messaggio HL7v2 utilizzando il metodo
projects.locations.datasets.hl7V2Stores.messages.ingest
.
curl
Per importare un messaggio HL7v2, esegui una richiesta POST
e specifica le seguenti
informazioni:
- Il nome e la posizione del set di dati principale
- Il nome dell'archivio HL7v2
- Un
Message
Il seguente esempio mostra una richiesta POST
mediante curl
e un file JSON di esempio denominato hl7v2-sample.json
.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data-binary @hl7v2-sample.json \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages:ingest"
La seguente risposta di esempio mostra hl7Ack
e i dettagli del messaggio.
{ "hl7Ack": "TVNIfF5+XCZ8QXxBfEF8U0VORF9GQUNJTElUWXwyMDIwMDIxNDIxMjAwNXx8QUNLfDFmMmQ1MjQzLTFhOWEtNGE4My05ZmI5LWNlNTIzMTVmZjk2M3xUfDAuMA1NU0F8QUF8MjAxODAxMDEwMDAwMDA=", "message": { "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "data": "TVNIfF5+XCZ8QXxTRU5EX0ZBQ0lMSVRZfEF8QXwyMDE4MDEwMTAwMDAwMHx8VFlQRV5BfDIwMTgwMTAxMDAwMDAwfFR8MC4wfHx8QUF8fDAwfEFTQ0lJDUVWTnxBMDB8MjAxODAxMDEwNDAwMDANUElEfHwxNAExMTFeXl5eTVJOfDExMTExMTExXl5eXk1STn4xMTExMTExMTExXl5eXk9SR05NQlI=", "sendFacility": "SEND_FACILITY", "sendTime": "2018-01-01T00:00:00Z", "messageType": "TYPE", "createTime": "CREATE_TIME", "patientIds": [ { "value": "14\u0001111", "type": "MRN" }, { "value": "11111111", "type": "MRN" }, { "value": "1111111111", "type": "ORGNMBR" } ] } }
PowerShell
Per importare un messaggio HL7v2, esegui una richiesta POST
e specifica le seguenti
informazioni:
- Il nome e la posizione del set di dati principale
- Il nome dell'archivio HL7v2
- Un
Message
Il seguente esempio mostra una richiesta POST
mediante PowerShell e un file JSON di esempio denominato hl7v2-sample.json
.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Post ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -InFile hl7v2-sample.json ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages:ingest" | Select-Object -Expand Content
La seguente risposta di esempio mostra hl7Ack
e i dettagli del messaggio.
{ "hl7Ack": "TVNIfF5+XCZ8QXxBfEF8U0VORF9GQUNJTElUWXwyMDIwMDIxNDIxMjAwNXx8QUNLfDFmMmQ1MjQzLTFhOWEtNGE4My05ZmI5LWNlNTIzMTVmZjk2M3xUfDAuMA1NU0F8QUF8MjAxODAxMDEwMDAwMDA=", "message": { "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "data": "TVNIfF5+XCZ8QXxTRU5EX0ZBQ0lMSVRZfEF8QXwyMDE4MDEwMTAwMDAwMHx8VFlQRV5BfDIwMTgwMTAxMDAwMDAwfFR8MC4wfHx8QUF8fDAwfEFTQ0lJDUVWTnxBMDB8MjAxODAxMDEwNDAwMDANUElEfHwxNAExMTFeXl5eTVJOfDExMTExMTExXl5eXk1STn4xMTExMTExMTExXl5eXk9SR05NQlI=", "sendFacility": "SEND_FACILITY", "sendTime": "2018-01-01T00:00:00Z", "messageType": "TYPE", "createTime": "CREATE_TIME", "patientIds": [ { "value": "14\u0001111", "type": "MRN" }, { "value": "11111111", "type": "MRN" }, { "value": "1111111111", "type": "ORGNMBR" } ] } }
Go
Java
Node.js
Python
Creazione di messaggi HL7v2
Gli esempi riportati di seguito mostrano come creare un messaggio HL7v2 utilizzando il metodo
projects.locations.datasets.hl7V2Stores.messages.create
.
REST
Per creare un messaggio HL7v2, utilizza il metodo projects.locations.datasets.hl7V2Stores.messages.create
.
Se hai bisogno di un file di messaggi HL7v2 da utilizzare con i comandi di esempio, puoi scaricare il file JSON hl7v2-sample.json
.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- PROJECT_ID: l'ID del tuo Google Cloud progetto
- LOCATION: la posizione del set di dati
- DATASET_ID: il set di dati padre dell'archivio HL7v2
- HL7V2_STORE_ID: l'ID dell'archivio HL7v2
- HL7V2_MESSAGE_FILE: il percorso di un file in formato JSON contenente un messaggio HL7v2 sulla macchina locale
Per inviare la richiesta, scegli una di queste opzioni:
curl
Esegui questo comando:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
--data-binary @HL7V2_MESSAGE_FILE \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages"
PowerShell
Esegui questo comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-InFile HL7V2_MESSAGE_FILE `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages" | 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. Completa i campi obbligatori e fai clic su Esegui.
hl7v2-sample.json
:
Go
Java
Node.js
Python
Separatori di segmenti e codifica dei messaggi HL7v2
Il separatore di segmenti predefinito in HL7v2 è un ritorno a capo (\r
). La maggior parte degli editor di testo utilizza i caratteri di nuova riga (\n
) come separatori di segmenti. In questo modo vengono generati messaggi HL7v2 che non possono essere importati nell'API Cloud Healthcare utilizzando la configurazione predefinita. Per consentire a un archivio HL7v2 di importare messaggi che utilizzano caratteri di nuova riga come separatori di segmenti, consulta Impostazione del carattere di terminazione dei segmenti.
Per convertire i caratteri di nuova riga in un file in ritorni a capo, esegui il comando seguente in una shell Linux:
sed -z 's/\n/\r/g' INPUT_FILENAME > OUTPUT_FILENAME
I metodi di importazione e creazione prevedono che i messaggi HL7v2 siano stringhe con codifica base64. Per convertire una stringa nella codifica base64, esegui questo comando in una shell Linux:
openssl base64 -A -in ./INPUT_FILENAME -out ./OUTPUT_FILENAME
Impostazione del carattere di terminazione dei segmenti
Quando crei o importi dati, il
formato dei messaggi HL7v2
richiede che i segmenti vengano terminati con il carattere di ritorno a capo, \r
. Puoi configurare un datastore HL7v2 in modo che accetti messaggi HL7v2
con un carattere di terminazione non standard, ad esempio \n
.
Considera il seguente messaggio HL7v2 che utilizza \r
predefinito come carattere di terminazione del segmento. Questo messaggio viene accettato per impostazione predefinita quando crei un archivio HL7v2.
MSH|^~\\&|FROM_APP|FROM_FACILITY|TO_APP|TO_FACILITY|20150503223000||ADT^A01|20150503223000|P|2.5|\r EVN|A01|20110613083617|\r PID|1||21004053^^^^MRN||SULLY^BRIAN||19611209|M|||123 MAIN ST^^MOUNTAIN SPRINGS^CO^80439|\r PV1||I|H73 RM1^1^^HIGHWAY 73 CLINIC||||5148^MARY QUINN|||||||||Y||||||||||||||||||||||||||||20150503223000|\r
Il seguente messaggio è identico al precedente, tranne per il fatto che
utilizza \n
come terminatore di segmento:
MSH|^~\\&|FROM_APP|FROM_FACILITY|TO_APP|TO_FACILITY|20150503223000||ADT^A01|20150503223000|P|2.5|\n EVN|A01|20110613083617|\n PID|1||21004053^^^^MRN||SULLY^BRIAN||19611209|M|||123 MAIN ST^^MOUNTAIN SPRINGS^CO^80439|\n PV1||I|H73 RM1^1^^HIGHWAY 73 CLINIC||||5148^MARY QUINN|||||||||Y||||||||||||||||||||||||||||20150503223000|\n
Per archiviare il messaggio con il carattere di terminazione non standard, configura l'oggetto ParserConfig
nell'archivio HL7v2 e imposta il campo segmentTerminator
sulla codifica Base64 di \n
.
Gli esempi riportati di seguito mostrano come configurare segmentTerminator
in
ParserConfig
quando
crei un archivio HL7v2.
Se hai un archivio HL7v2 esistente, puoi modificarlo per fornire il corpo ParserConfig
. Dopo aver impostato il terminatore di segmento, puoi creare o importare il messaggio.
curl
Per creare un archivio HL7v2 con il carattere di terminazione dei segmenti impostato su \n
, effettua una richiesta POST
e specifica le seguenti informazioni:
- Il nome e la posizione del set di dati principale
- Il nome dell'archivio HL7v2
- Un oggetto
parserConfig
consegmentTerminator
impostato suCg==
(la codifica Base64 di\n
)
L'esempio seguente mostra una richiesta POST
mediante curl
.
curl -X POST \ --data "{ 'parserConfig': { 'segmentTerminator': 'Cg==' } }" \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores?hl7V2StoreId=HL7V2_STORE_ID"
Se la richiesta riesce, il server restituisce la risposta in formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID", "parserConfig": { "segmentTerminator": "Cg==" } }
PowerShell
Per creare un archivio HL7v2 con il carattere di terminazione dei segmenti impostato su \n
, effettua una richiesta POST
e specifica le seguenti informazioni:
- Il nome e la posizione del set di dati principale
- Il nome dell'archivio HL7v2
- Un oggetto
parserConfig
consegmentTerminator
impostato suCg==
(la codifica Base64 di\n
)
Il seguente esempio mostra una richiesta POST
mediante PowerShell.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Post ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Body "{ 'parserConfig': { 'segmentTerminator': 'Cg==' } } ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores?hl7V2StoreId=HL7V2_STORE_ID" | Select-Object -Expand Content
Se la richiesta riesce, il server restituisce la risposta in formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID", "parserConfig": { "segmentTerminator": "Cg==" } }
Utilizzo di un'intestazione di segmento nulla
Un messaggio HL7v2 senza un
segmento di intestazione del messaggio (MSH)
ha un'intestazione di segmento null. In genere, un messaggio HL7v2 contiene un segmento MSH che definisce i metadati come l'origine, l'intento, lo scopo e la destinazione del messaggio.
MSH ti consente di cercare e filtrare i messaggi. Tuttavia, puoi archiviare
messaggi che non contengono un segmento MSH configurando l'oggetto
ParserConfig
nell'archivio HL7v2 e impostando il campo allowNullHeader
su true
.
Il seguente messaggio di esempio contiene un segmento di identificazione del paziente (PID), ma nessun segmento MSH:
PID|1||21004053^^^^MRN||SULLY^BRIAN||19611209|M|||123 MAIN ST^^MOUNTAIN SPRINGS^CO^80439
Gli esempi riportati di seguito mostrano come configurare allowNullHeader
in ParserConfig
quando
crei un archivio HL7v2.
Se hai un archivio HL7v2 esistente, puoi modificarlo e fornire il corpo ParserConfig
. Dopo aver impostato allowNullHeader
su true
,
puoi creare o importare messaggi con intestazioni di segmento null.
curl
Per creare un archivio HL7v2 e archiviare i messaggi che non contengono un segmento MSH, esegui una richiesta POST
e specifica le seguenti informazioni:
- Il nome e la posizione del set di dati principale
- Il nome dell'archivio HL7v2
- Un oggetto
parserConfig
conallowNullHeader
impostato sutrue
L'esempio seguente mostra una richiesta POST
mediante curl
.
curl -X POST \ --data "{ 'parserConfig': { 'allowNullHeader': true } }" \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores?hl7V2StoreId=HL7V2_STORE_ID"
Se la richiesta riesce, il server restituisce la risposta in formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID", "parserConfig": { "allowNullHeader": true } }
PowerShell
Per creare un archivio HL7v2 e archiviare i messaggi che non contengono un segmento MSH, esegui una richiesta POST
e specifica le seguenti informazioni:
- Il nome e la posizione del set di dati principale
- Il nome dell'archivio HL7v2
- Un oggetto
parserConfig
conallowNullHeader
impostato sutrue
Il seguente esempio mostra una richiesta POST
mediante PowerShell.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Post ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Body "{ 'parserConfig': { 'nullTerminator': true } } ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores?hl7V2StoreId=HL7V2_STORE_ID" | Select-Object -Expand Content
Se la richiesta riesce, il server restituisce la risposta in formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID", "parserConfig": { "allowNullHeader": true } }
Etichettare un messaggio HL7v2
Puoi aggiungere uno o più etichette chiave-valore a un messaggio. Un caso di utilizzo delle etichette è l'aggiunta di etichette di stato a un messaggio, in modo che un'applicazione possa eseguire query sui messaggi in base allo stato.
Gli esempi riportati di seguito mostrano come aggiungere etichette a un messaggio HL7v2 utilizzando il metodo
projects.locations.datasets.hl7V2Stores.messages.patch
.
curl
Per aggiungere etichette a un messaggio HL7v2, effettua una richiesta PATCH
e specifica le seguenti informazioni:
- Il nome e la posizione del set di dati principale
- Il nome dell'archivio HL7v2
- L'ID messaggio
- I dati dell'etichetta da aggiornare
- Una maschera di aggiornamento
L'esempio seguente mostra una richiesta PATCH
mediante curl
.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ 'labels': { 'KEY' : 'VALUE' } }" "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?updateMask=labels"
Se la richiesta riesce, il server restituisce la risposta in formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "data": "DATA", "sendFacility": "SEND_FACILITY", "sendTime": "2018-01-01T00:00:00Z", "messageType": "TYPE", "createTime": "CREATE_TIME", "patientIds": [ { "value": "VALUE_1", "type": "TYPE_1" }, { "value": "VALUE_2", "type": "TYPE_2" } ], "labels": { "KEY": "VALUE" } }
PowerShell
Per aggiungere etichette a un messaggio HL7v2, effettua una richiesta PATCH
e specifica le seguenti informazioni:
- Il nome e la posizione del set di dati principale
- Il nome dell'archivio HL7v2
- L'ID messaggio
- I dati dell'etichetta da aggiornare
- Una maschera di aggiornamento
Il seguente esempio mostra una richiesta PATCH
mediante PowerShell.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Patch ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Body "{ 'labels': { 'KEY': 'VALUE' } }" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?updateMask=labels" | Select-Object -Expand Content
Se la richiesta riesce, il server restituisce la risposta in formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "data": "DATA", "sendFacility": "SEND_FACILITY", "sendTime": "2018-01-01T00:00:00Z", "messageType": "TYPE", "createTime": "CREATE_TIME", "patientIds": [ { "value": "VALUE_1", "type": "TYPE_1" }, { "value": "VALUE_2", "type": "TYPE_2" } ], "labels": { "KEY": "VALUE" } }
Go
Java
Node.js
Python
Recupero dei contenuti di un messaggio HL7v2
Gli esempi riportati di seguito mostrano come recuperare i contenuti di un messaggio HL7v2 utilizzando il metodo
projects.locations.datasets.hl7V2Stores.messages.get
. Per determinare le parti del messaggio da recuperare, fornisci il parametro di query view
con una delle seguenti opzioni:
BASIC
: includi solo il camponame
.RAW_ONLY
: include tutti i campi del messaggio, ad eccezione del campoparsedData
.PARSED_ONLY
: include tutti i campi del messaggio, ad eccezione del campodata
.FULL
: include tutti i campi del messaggio. Questa è l'impostazione predefinita.
Gli esempi riportati di seguito mostrano come recuperare i contenuti di un messaggio HL7v2 utilizzando le visualizzazioni
FULL
, RAW_ONLY
e PARSED_ONLY
.
Utilizzo della visualizzazione FULL
Non è necessario impostare esplicitamente la visualizzazione FULL
, in quanto FULL
è il valore
predefinito. Tuttavia, nei seguenti esempi di curl
e PowerShell, la
vista FULL
viene aggiunta come parametro di query per completezza.
curl
Per recuperare i contenuti di un messaggio HL7v2 utilizzando la visualizzazione FULL
, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome e la posizione del set di dati principale
- Il nome dell'archivio HL7v2
- L'ID messaggio
FULL
comeview
L'esempio seguente mostra una richiesta GET
mediante 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/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=FULL"
Se la richiesta riesce, il server restituisce la risposta in formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "data": "DATA", "sendFacility": "SEND_FACILITY", "sendTime": "2018-01-01T00:00:00Z", "messageType": "TYPE", "createTime": "CREATE_TIME", "patientIds": [ { "value": "VALUE_1", "type": "TYPE_1" }, { "value": "VALUE_2", "type": "TYPE_2" }, { "value": "VALUE_3", "type": "TYPE_3" } ], "parsedData": { "segments": [ { ""segmentId": "SEGMENT_ID_1", "fields": { FIELDS_1 } }, { "segmentId": "SEGMENT_ID_2", "fields": { FIELDS_2 } }, { "segmentId": "SEGMENT_ID_3", "fields": { FIELDS_3 } } ] } }
PowerShell
Per recuperare i contenuti di un messaggio HL7v2 utilizzando la visualizzazione FULL
, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome e la posizione del set di dati principale
- Il nome dell'archivio HL7v2
- L'ID messaggio
FULL
comeview
Il seguente esempio mostra una richiesta GET
mediante PowerShell.
$cred = gcloud auth application-default 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/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=FULL" | Select-Object -Expand Content
Se la richiesta riesce, il server restituisce la risposta in formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "data": "DATA", "sendFacility": "SEND_FACILITY", "sendTime": "2018-01-01T00:00:00Z", "messageType": "TYPE", "createTime": "CREATE_TIME", "patientIds": [ { "value": "VALUE_1", "type": "TYPE_1" }, { "value": "VALUE_2", "type": "TYPE_2" }, { "value": "VALUE_3", "type": "TYPE_3" } ], "parsedData": { "segments": [ { ""segmentId": "SEGMENT_ID_1", "fields": { FIELDS_1 } }, { "segmentId": "SEGMENT_ID_2", "fields": { FIELDS_2 } }, { "segmentId": "SEGMENT_ID_3", "fields": { FIELDS_3 } } ] } }
Go
Java
Node.js
Python
Utilizzo della visualizzazione RAW_ONLY
Gli esempi riportati di seguito mostrano come recuperare i contenuti di un messaggio HL7v2 utilizzando
la visualizzazione RAW_ONLY
, che include tutti i campi del messaggio, ad eccezione di
parsedData
.
curl
Per recuperare i contenuti di un messaggio HL7v2 utilizzando la visualizzazione RAW_ONLY
, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome e la posizione del set di dati principale
- Il nome dell'archivio HL7v2
- L'ID messaggio
RAW_ONLY
come visualizzazione
L'esempio seguente mostra una richiesta GET
mediante 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/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=RAW_ONLY"
Se la richiesta riesce, il server restituisce la risposta in formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "data": "DATA", "sendFacility": "SEND_FACILITY", "sendTime": "2018-01-01T00:00:00Z", "messageType": "TYPE", "createTime": "CREATE_TIME", "patientIds": [ { "value": "VALUE_1", "type": "TYPE_1" }, { "value": "VALUE_2", "type": "TYPE_2" }, { "value": "VALUE_3", "type": "TYPE_3" } ] }
PowerShell
Per recuperare i contenuti di un messaggio HL7v2 utilizzando la visualizzazione RAW_ONLY
, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome e la posizione del set di dati principale
- Il nome dell'archivio HL7v2
- L'ID messaggio
RAW_ONLY
come visualizzazione
Il seguente esempio mostra una richiesta GET
mediante PowerShell.
$cred = gcloud auth application-default 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/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=RAW_ONLY" | Select-Object -Expand Content
Se la richiesta riesce, il server restituisce la risposta in formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "data": "DATA", "sendFacility": "SEND_FACILITY", "sendTime": "2018-01-01T00:00:00Z", "messageType": "TYPE", "createTime": "CREATE_TIME", "patientIds": [ { "value": "VALUE_1", "type": "TYPE_1" }, { "value": "VALUE_2", "type": "TYPE_2" }, { "value": "VALUE_3", "type": "TYPE_3" } ] }
Utilizzo della visualizzazione PARSED_ONLY
Gli esempi riportati di seguito mostrano come recuperare i contenuti di un messaggio HL7v2 utilizzando
la visualizzazione PARSED_ONLY
, che include tutti i campi del messaggio, ad eccezione di
data
.
curl
Per recuperare i contenuti di un messaggio HL7v2 utilizzando la visualizzazione PARSED_ONLY
, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome e la posizione del set di dati principale
- Il nome dell'archivio HL7v2
- L'ID messaggio
PARSED_ONLY
come visualizzazione
L'esempio seguente mostra una richiesta GET
mediante 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/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=PARSED_ONLY"
Se la richiesta riesce, il server restituisce la risposta in formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "sendFacility": "SEND_FACILITY", "sendTime": "2018-01-01T00:00:00Z", "messageType": "TYPE", "createTime": "CREATE_TIME", "patientIds": [ { "value": "VALUE_1", "type": "TYPE_1" }, { "value": "VALUE_2", "type": "TYPE_2" }, { "value": "VALUE_3", "type": "TYPE_3" } ], "parsedData": { "segments": [ { "segmentId": "SEGMENT_ID_1", "fields": { FIELDS_1 } }, { "segmentId": "SEGMENT_ID_2", "fields": { FIELDS_2 } }, { "segmentId": "SEGMENT_ID_3", "fields": { FIELDS_3 } } ] } }
PowerShell
Per recuperare i contenuti di un messaggio HL7v2 utilizzando la visualizzazione PARSED_ONLY
, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome e la posizione del set di dati principale
- Il nome dell'archivio HL7v2
- L'ID messaggio
PARSED_ONLY
come visualizzazione
Il seguente esempio mostra una richiesta GET
mediante PowerShell.
$cred = gcloud auth application-default 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/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=PARSED_ONLY" | Select-Object -Expand Content
Se la richiesta riesce, il server restituisce la risposta in formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "sendFacility": "SEND_FACILITY", "sendTime": "2018-01-01T00:00:00Z", "messageType": "TYPE", "createTime": "CREATE_TIME", "patientIds": [ { "value": "VALUE_1", "type": "TYPE_1" }, { "value": "VALUE_2", "type": "TYPE_2" }, { "value": "VALUE_3", "type": "TYPE_3" } ], "parsedData": { "segments": [ { "segmentId": "SEGMENT_ID_1", "fields": { FIELDS_1 } }, { "segmentId": "SEGMENT_ID_2", "fields": { FIELDS_2 } }, { "segmentId": "SEGMENT_ID_3", "fields": { FIELDS_3 } } ] } }
Utilizzo della visualizzazione BASIC
Gli esempi riportati di seguito mostrano come recuperare i contenuti di un messaggio HL7v2 utilizzando la visualizzazione BASIC
, che include solo il campo name
.
curl
Per recuperare i contenuti di un messaggio HL7v2 utilizzando la visualizzazione BASIC
, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome e la posizione del set di dati principale
- Il nome dell'archivio HL7v2
- L'ID messaggio
BASIC
come visualizzazione
L'esempio seguente mostra una richiesta GET
mediante 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/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=BASIC"
Se la richiesta riesce, il server restituisce la risposta in formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID" }
PowerShell
Per recuperare i contenuti di un messaggio HL7v2 utilizzando la visualizzazione BASIC
, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome e la posizione del set di dati principale
- Il nome dell'archivio HL7v2
- L'ID messaggio
BASIC
come visualizzazione
Il seguente esempio mostra una richiesta GET
mediante PowerShell.
$cred = gcloud auth application-default 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/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=BASIC" | Select-Object -Expand Content
Se la richiesta riesce, il server restituisce la risposta in formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID" }
Elenco dei messaggi HL7v2
Gli esempi riportati di seguito mostrano come elencare i messaggi in un archivio HL7v2 utilizzando il metodo. Per determinare le informazioni su ogni messaggio da includere nell'elenco,
specifica il parametro di query view
con una delle seguenti opzioni:
BASIC
: includi solo il camponame
. Questa è l'impostazione predefinita.RAW_ONLY
: include tutti i campi del messaggio, ad eccezione del campoparsedData
.PARSED_ONLY
: include tutti i campi del messaggio, ad eccezione del campodata
.FULL
: include tutti i campi del messaggio.
curl
Per elencare i messaggi in un archivio HL7v2, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome e la posizione del set di dati principale
- Il nome dell'archivio HL7v2
view
, uno traBASIC
,RAW_ONLY
,PARSED_ONLY
oFULL
oppure ometti per utilizzare il valore predefinitoBASIC
L'esempio seguente mostra una richiesta GET
mediante curl
. La richiesta specifica
?view=FULL
per includere tutti i campi del messaggio.
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/hl7V2Stores/HL7V2_STORE_ID/messages?view=FULL"
Se la richiesta riesce, il server restituisce un codice di stato HTTP 200 OK
e un array di messaggi denominato hl7_v2_messages
. La seguente risposta di esempio è
troncata.
{ "hl7_v2_messages": [ { "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "data": "DATA", "sendFacility": "SEND_FACILITY", "sendTime": "SEND_TIME", "messageType": "MESSAGE_TYPE", "createTime": "CREATE_TIME", ... }, ... ] }
PowerShell
Per elencare i messaggi in un archivio HL7v2, effettua una richiesta GET
e specifica le seguenti informazioni:
- Il nome e la posizione del set di dati principale
- Il nome dell'archivio HL7v2
view
, uno traBASIC
,RAW_ONLY
,PARSED_ONLY
oFULL
oppure ometti per utilizzare il valore predefinitoBASIC
Il seguente esempio mostra una richiesta GET
mediante PowerShell. La richiesta
specifica ?view=FULL
per includere tutti i campi del messaggio.
$cred = gcloud auth application-default 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/hl7V2Stores/HL7V2_STORE_ID/messages?view=FULL" | Select-Object -Expand Content
Se la richiesta riesce, il server restituisce la risposta in formato JSON. La risposta di esempio è troncata.
{ "hl7_v2_messages": [ { "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "data": "DATA", "sendFacility": "SEND_FACILITY", "sendTime": "SEND_TIME", "messageType": "MESSAGE_TYPE", "createTime": "CREATE_TIME", ... }, ... ] }
Go
Java
Node.js
Python
Eliminazione di un messaggio HL7v2
Gli esempi riportati di seguito mostrano come eliminare un messaggio HL7v2 utilizzando il metodo
projects.locations.datasets.hl7V2Stores.messages.delete
.
curl
Per eliminare un messaggio HL7v2, effettua una richiesta DELETE
e specifica le seguenti informazioni:
- Il nome e la posizione del set di dati principale
- Il nome dell'archivio HL7v2
- L'ID messaggio HL7v2
L'esempio seguente mostra una richiesta DELETE
mediante curl
.
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/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID"
Se la richiesta riesce, il server restituisce la risposta con un testo vuoto in formato JSON:
{}
PowerShell
Per eliminare un messaggio HL7v2, effettua una richiesta DELETE
e specifica le seguenti informazioni:
- Il nome e la posizione del set di dati principale
- Il nome dell'archivio HL7v2
- L'ID messaggio HL7v2
Il seguente esempio mostra una richiesta DELETE
mediante PowerShell.
$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/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID" | Select-Object -Expand Content
Se la richiesta riesce, il server restituisce la risposta con un testo vuoto in formato JSON:
{}
Go
Java
Node.js
Python
Passaggi successivi
- Scopri come configurare più servizi Google Cloud per inviare e ricevere messaggi HL7v2 tramite MLLP.