Questa pagina spiega come importare, creare, etichettare, elencare, visualizzare ed eliminare HL7v2 messaggi. I messaggi HL7v2 vengono utilizzati per trasmettere dati clinici tra i sistemi. Un messaggio HL7v2 può contenere informazioni su un'osservazione risultato, una prescrizione da inviare a una farmacia, una transazione finanziaria o altri eventi clinici.
Panoramica della creazione e dell'importazione di messaggi HL7v2
Utilizzare uno dei seguenti metodi per archiviare un messaggio HL7v2 nel API Cloud Healthcare:
Quando utilizzi messages.ingest
, il metodo genera una risposta contenente
uno dei seguenti:
- Un messaggio di conferma HL7v2 (
ACK
) in caso di esito positivo - Un messaggio di conferma negativa (
NACK
) in caso di errore
I messaggi ACK
e NACK
vengono utilizzati per rispondere ai sistemi di interfaccia HL7v2
che si aspettano di ricevere
queste conferme.
Importazione e creazione di messaggi con un adattatore MLLP
I messaggi HL7v2 vengono consegnati tra i sistemi di assistenza e il l'API Cloud Healthcare utilizzando il protocollo MLLP (minimo livello inferiore). Per ulteriori informazioni le informazioni, vedi MLLP e l'adattatore MLLP di Google Cloud. Per istruzioni su come configurare un adattatore MLLP per comunicare in modo sicuro con l'API Cloud Healthcare, consulta Trasmissione di messaggi HL7v2 tramite connessioni TCP/IP.
Importazione di messaggi HL7v2
Una volta che l'API Cloud Healthcare importa il messaggio da un sistema di assistenza,
L'API Cloud Healthcare genera una risposta contenente un campo hl7ack
che contiene un messaggio HL7v2 codificato in base64 con il seguente
caratteristiche:
- Il tipo di messaggio è
ACK
. - Il servizio di invio e quello ricevente sono invertiti, l'applicazione e la ricezione dell'applicazione vengono invertite.
- L'ora di invio del messaggio è l'ora corrente e un nuovo ID controllo generati.
- Il valore del campo
MSH-9.1
definisce il tipo di messaggio. - Il valore del campo
MSA.1
definisce un tipo di risposta. Un tipo di rispostaAA
indicaApplication Accept
, che indica che il messaggio è stato convalidato e importati. - Il valore
MSA.2
contiene lo stile del messaggio originale ID di controllo.
Gli esempi riportati di seguito mostrano come importare un messaggio HL7v2 utilizzando il comando
projects.locations.datasets.hl7V2Stores.messages.ingest
.
curl
Per importare un messaggio HL7v2, effettua una richiesta POST
e specifica quanto segue
informazioni:
- Il nome e la località del set di dati padre
- Nome dell'archivio HL7v2
- Un
Message
L'esempio seguente mostra una richiesta POST
che utilizza curl
e un file JSON di esempio
chiamata
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, effettua una richiesta POST
e specifica quanto segue
informazioni:
- Il nome e la località del set di dati padre
- Nome dell'archivio HL7v2
- Un
Message
L'esempio seguente 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 comando
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
scarica il
hl7v2-sample.json
JSON.
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: set di dati padre dell'archivio HL7v2
- HL7V2_STORE_ID: l'ID store HL7v2
- HL7V2_MESSAGE_FILE: il percorso di un file in formato JSON contenente un messaggio HL7v2 sulla tua macchina locale
Per inviare la richiesta, scegli una delle seguenti 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 l'app pagina di riferimento del metodo. Sul lato destro della pagina si apre il riquadro Explorer API. Puoi interagire con questo strumento per inviare richieste. Compila tutti i campi obbligatori e fai clic su Esegui.
hl7v2-sample.json
, viene restituito il seguente output
File JSON:
Go
Java
Node.js
Python
Codifica e separatori dei segmenti di messaggi HL7v2
Il separatore di segmenti predefinito in HL7v2 è un ritorno a capo (\r
). La maggior parte del testo
Gli editor utilizzano caratteri di nuova riga (\n
) come separatori di segmento. Questo produce HL7v2
messaggi che non possono essere importati nell'API Cloud Healthcare utilizzando
configurazione predefinita. consentire a un archivio HL7v2 di importare messaggi che utilizzano
caratteri di nuova riga come separatori di segmento; 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 in una shell di Linux:
sed -z 's/\n/\r/g' INPUT_FILENAME > OUTPUT_FILENAME
I metodi di importazione e creazione si aspettano che i messaggi HL7v2 siano codificati in base64 stringhe. Per convertire una stringa nella codifica base64, esegui questo comando in un Shell di Linux:
openssl base64 -A -in ./INPUT_FILENAME -out ./OUTPUT_FILENAME
Impostazione del carattere di terminazione dei segmenti
Durante la creazione o l'importazione dei dati,
Formato del messaggio HL7v2
richiede che i segmenti vengano terminati utilizzando
\r
. è possibile configurare un archivio HL7v2 per accettare messaggi HL7v2
con un carattere di terminazione non standard, come \n
.
Considera il seguente messaggio HL7v2 che utilizza il valore predefinito \r
come segmento
terminatore. Questo messaggio viene accettato per impostazione predefinita quando si crea 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 messaggio precedente, ad eccezione del fatto che
utilizza \n
come carattere di terminazione dei segmenti:
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 un carattere di terminazione non standard, configura il
ParserConfig
nell'archivio HL7v2 e impostare il campo segmentTerminator
sul
con codifica base64 di \n
.
I seguenti esempi mostrano come configurare segmentTerminator
in
ParserConfig
quando
crea un archivio HL7v2.
Se hai già un archivio HL7v2, puoi
modificalo
per fornire il corpo ParserConfig
. Dopo aver impostato il carattere di terminazione dei segmenti,
può creare o importare
il messaggio.
curl
Per creare un archivio HL7v2 con il carattere di terminazione dei segmenti impostato su \n
, crea una
POST
e specifica le seguenti informazioni:
- Il nome e la località del set di dati padre
- Nome dell'archivio HL7v2
- Un oggetto
parserConfig
consegmentTerminator
impostato suCg==
(il codifica Base64 di\n
)
L'esempio seguente mostra una richiesta POST
che utilizza 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 ha esito positivo, 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
, crea una
POST
e specifica le seguenti informazioni:
- Il nome e la località del set di dati padre
- Nome dell'archivio HL7v2
- Un oggetto
parserConfig
consegmentTerminator
impostato suCg==
(il codifica Base64 di\n
)
L'esempio seguente 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 ha esito positivo, 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 nulla. Tipicamente, un messaggio HL7v2 contiene un file MSH che
definisce metadati come l'origine, l'intento, lo scopo e la destinazione del messaggio.
Il file MSH consente di cercare e filtrare i messaggi. Tuttavia, puoi archiviare
i messaggi che non contengono un file MSH, configurando
ParserConfig
nell'archivio HL7v2 e impostare il campo allowNullHeader
su true
.
Il seguente messaggio di esempio contiene un segmento di identificazione del paziente (PID, Patient Identification), ma nessun MSH:
PID|1||21004053^^^^MRN||SULLY^BRIAN||19611209|M|||123 MAIN ST^^MOUNTAIN SPRINGS^CO^80439
I seguenti esempi mostrano come configurare allowNullHeader
in ParserConfig
quando
crea un archivio HL7v2.
Se hai già un archivio HL7v2, puoi
modificalo
e fornisce il corpo ParserConfig
. Dopo aver impostato allowNullHeader
su true
,
puoi creare o importare messaggi con intestazioni di segmento nulle.
curl
Per creare un archivio HL7v2 e archiviare i messaggi che non contengono un MSH, crea una
POST
e specifica le seguenti informazioni:
- Il nome e la località del set di dati padre
- Nome dell'archivio HL7v2
- Un oggetto
parserConfig
conallowNullHeader
impostato sutrue
L'esempio seguente mostra una richiesta POST
che utilizza 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 ha esito positivo, 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 MSH, crea una
POST
e specifica le seguenti informazioni:
- Il nome e la località del set di dati padre
- Nome dell'archivio HL7v2
- Un oggetto
parserConfig
conallowNullHeader
impostato sutrue
L'esempio seguente 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 ha esito positivo, 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 d'uso per le etichette consiste nell'aggiungere etichette di stato a un messaggio per consentire a un'applicazione di eseguire query sui messaggi. per stato.
Gli esempi riportati di seguito mostrano come aggiungere etichette a un messaggio HL7v2 utilizzando il comando
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 località del set di dati padre
- Nome dell'archivio HL7v2
- L'ID del messaggio
- Dati dell'etichetta da aggiornare
- Una maschera di aggiornamento
L'esempio seguente mostra una richiesta PATCH
che utilizza 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 ha esito positivo, 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 località del set di dati padre
- Nome dell'archivio HL7v2
- L'ID del messaggio
- Dati dell'etichetta da aggiornare
- Una maschera di aggiornamento
L'esempio seguente 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 ha esito positivo, 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
I seguenti esempi mostrano come ottenere i contenuti di un messaggio HL7v2 utilizzando il
projects.locations.datasets.hl7V2Stores.messages.get
. Per determinare le parti del messaggio da ottenere, fornisci la query view
con una delle seguenti opzioni:
BASIC
: includi solo il camponame
.RAW_ONLY
: includi tutti i campi del messaggio, tranne iparsedData
.PARSED_ONLY
: includi tutti i campi del messaggio, tranne idata
.FULL
: includi tutti i campi del messaggio. Questa è l'impostazione predefinita.
I seguenti esempi mostrano come ottenere i contenuti di un messaggio HL7v2 utilizzando il
FULL
, RAW_ONLY
e PARSED_ONLY
viste.
Utilizzo della vista FULL
Non è necessario impostare esplicitamente la vista FULL
perché FULL
è l'impostazione predefinita
valore. Tuttavia, nei seguenti esempi di curl
e PowerShell,
La vista FULL
viene aggiunta come parametro di query per la completezza.
curl
Per ottenere i contenuti di un messaggio HL7v2 utilizzando la vista FULL
, crea un GET
e specificare le seguenti informazioni:
- Il nome e la località del set di dati padre
- Nome dell'archivio HL7v2
- L'ID del messaggio
FULL
comeview
L'esempio seguente mostra una richiesta GET
che utilizza curl
.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=FULL"
Se la richiesta ha esito positivo, 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 ottenere i contenuti di un messaggio HL7v2 utilizzando la vista FULL
, crea un GET
e specificare le seguenti informazioni:
- Il nome e la località del set di dati padre
- Nome dell'archivio HL7v2
- L'ID del messaggio
FULL
comeview
L'esempio seguente 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 ha esito positivo, 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 vista RAW_ONLY
Gli esempi riportati di seguito mostrano come ottenere i contenuti di un messaggio HL7v2 utilizzando
la visualizzazione RAW_ONLY
, che include tutti i campi dei messaggi tranne
parsedData
.
curl
Per ottenere i contenuti di un messaggio HL7v2 utilizzando la vista RAW_ONLY
, crea un
GET
e specifica le seguenti informazioni:
- Il nome e la località del set di dati padre
- Nome dell'archivio HL7v2
- L'ID del messaggio
RAW_ONLY
come vista
L'esempio seguente mostra una richiesta GET
che utilizza curl
.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=RAW_ONLY"
Se la richiesta ha esito positivo, 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 ottenere i contenuti di un messaggio HL7v2 utilizzando la vista RAW_ONLY
, crea un
GET
e specifica le seguenti informazioni:
- Il nome e la località del set di dati padre
- Nome dell'archivio HL7v2
- L'ID del messaggio
RAW_ONLY
come vista
L'esempio seguente 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 ha esito positivo, 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 vista PARSED_ONLY
Gli esempi riportati di seguito mostrano come ottenere i contenuti di un messaggio HL7v2 utilizzando
la visualizzazione PARSED_ONLY
, che include tutti i campi dei messaggi tranne
data
.
curl
Per ottenere i contenuti di un messaggio HL7v2 utilizzando la vista PARSED_ONLY
, crea un
GET
e specifica le seguenti informazioni:
- Il nome e la località del set di dati padre
- Nome dell'archivio HL7v2
- L'ID del messaggio
PARSED_ONLY
come vista
L'esempio seguente mostra una richiesta GET
che utilizza curl
.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=PARSED_ONLY"
Se la richiesta ha esito positivo, 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 ottenere i contenuti di un messaggio HL7v2 utilizzando la vista PARSED_ONLY
, crea un
GET
e specifica le seguenti informazioni:
- Il nome e la località del set di dati padre
- Nome dell'archivio HL7v2
- L'ID del messaggio
PARSED_ONLY
come vista
L'esempio seguente 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 ha esito positivo, 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 vista BASIC
Gli esempi riportati di seguito mostrano come ottenere i contenuti di un messaggio HL7v2 utilizzando
la vista BASIC
, che include solo il campo name
.
curl
Per ottenere i contenuti di un messaggio HL7v2 utilizzando la vista BASIC
, crea un
GET
e specifica le seguenti informazioni:
- Il nome e la località del set di dati padre
- Nome dell'archivio HL7v2
- L'ID del messaggio
BASIC
come vista
L'esempio seguente mostra una richiesta GET
che utilizza curl
.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=BASIC"
Se la richiesta ha esito positivo, 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 ottenere i contenuti di un messaggio HL7v2 utilizzando la vista BASIC
, crea un
GET
e specifica le seguenti informazioni:
- Il nome e la località del set di dati padre
- Nome dell'archivio HL7v2
- L'ID del messaggio
BASIC
come vista
L'esempio seguente 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 ha esito positivo, 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
. Per determinare le informazioni di ciascun 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
: includi tutti i campi del messaggio, tranne iparsedData
.PARSED_ONLY
: includi tutti i campi del messaggio, tranne idata
.FULL
: includi 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 località del set di dati padre
- Nome dell'archivio HL7v2
view
, uno traBASIC
,RAW_ONLY
,PARSED_ONLY
oFULL
oppure ometti in utilizza il valore predefinito diBASIC
L'esempio seguente mostra una richiesta GET
che utilizza 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 ha esito positivo, il server restituisce un codice di stato HTTP 200 OK
e
un array di messaggi con nome hl7_v2_messages
. La seguente risposta di esempio è
troncato.
{ "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 località del set di dati padre
- Nome dell'archivio HL7v2
view
, uno traBASIC
,RAW_ONLY
,PARSED_ONLY
oFULL
oppure ometti in utilizza il valore predefinito diBASIC
L'esempio seguente 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 ha esito positivo, 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 comando
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 località del set di dati padre
- Nome dell'archivio HL7v2
- L'ID del messaggio HL7v2
L'esempio seguente mostra una richiesta DELETE
che utilizza 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 ha esito positivo, il server restituisce la risposta del corpo vuota in JSON formato:
{}
PowerShell
Per eliminare un messaggio HL7v2, effettua una richiesta DELETE
e specifica
le seguenti informazioni:
- Il nome e la località del set di dati padre
- Nome dell'archivio HL7v2
- L'ID del messaggio HL7v2
L'esempio seguente 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 ha esito positivo, il server restituisce il corpo della risposta vuoto in JSON formato:
{}