Questa pagina spiega come creare, modificare, visualizzare ed eliminare gli archivi Health Level Seven Version 2.x (HL7v2). Gli archivi HL7v2 contengono messaggi HL7v2, che vengono utilizzati per trasmettere i dati clinici tra i sistemi.
Creazione di un archivio HL7v2
Prima di poter generare un archivio HL7v2, devi creare un set di dati.
Quando crei un archivio HL7v2, specifica la versione del parser V3
. Non puoi modificare la versione del parser dopo aver creato l'archivio HL7v2.
Gli esempi riportati di seguito mostrano come creare un archivio HL7v2 utilizzando il parser V3.
Nella console Google Cloud, vai alla pagina Set di dati.
Seleziona il set di dati in cui vuoi creare l'archivio HL7v2. Viene visualizzata la pagina Set di dati.
Fai clic su add_box Crea datastore. Viene visualizzata la pagina Crea datastore.
Nel menu Tipo, seleziona HL7v2.
Nel campo ID, inserisci un nome per l'archivio HL7v2. Il nome deve essere univoco nel set di dati. Per ulteriori requisiti di denominazione, consulta la sezione Caratteri consentiti e requisiti relativi alle dimensioni.
Fai clic su Avanti. Viene visualizzata la sezione Configura il tuo datastore HL7v2.
Configura le seguenti impostazioni:
- Nella sezione Versione, lascia invariata la selezione predefinita V3.
- Per consentire la creazione e l'importazione di messaggi HL7v2 senza intestazione, selezionate Consenti intestazioni messaggio null (MSH).
- Per impostare un carattere di terminazione dei segmenti personalizzato, fai clic su Imposta un carattere di terminazione dei segmenti personalizzato e inserisci il carattere nel campo Carattere di terminazione dei segmenti. Per maggiori informazioni, consulta Impostare il carattere di terminazione dei segmenti.
- Per rifiutare i messaggi HL7v2 in arrivo con gli stessi byte non elaborati di un messaggio HL7v2 che esiste già nell'archivio HL7v2, seleziona Rifiuta messaggi duplicati.
Fai clic su Avanti. Viene visualizzata la sezione Ricevi notifiche Cloud Pub/Sub.
Se vuoi ricevere notifiche Pub/Sub quando si verifica un evento clinico nel tuo archivio HL7v2, specifica l'argomento Pub/Sub. L'argomento deve esistere prima che tu possa configurarlo nell'archivio HL7v2.
Fai clic su Avanti. Viene visualizzata la sezione Aggiungi etichette per organizzare i tuoi datastore.
Per aggiungere una o più etichette chiave/valore all'archivio HL7v2, fai clic su add Aggiungi etichetta. Per saperne di più sulle etichette delle risorse, consulta Utilizzare le etichette delle risorse.
Fai clic su Crea. Viene visualizzata la pagina Set di dati e l'archivio HL7v2 viene visualizzato nella tabella Datastore.
Per creare un archivio HL7v2, esegui il comando gcloud healthcare hl7v2-stores create
.
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
: l'ID del tuo progetto Google CloudPROJECT_ID
: la posizione del set di datiLOCATION
: il set di dati principale dell'archivio HL7v2DATASET_ID
: un identificatore per l'archivio HL7v2 soggetto ai requisiti relativi alle dimensioni e ai caratteri degli archivi HL7v2HL7V2_STORE_ID
Esegui il seguente comando:
Linux, macOS o Cloud Shell
gcloud healthcare hl7v2-stores createHL7V2_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --parser-version=v3
Windows (PowerShell)
gcloud healthcare hl7v2-stores createHL7V2_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION ` --parser-version=v3
Windows (cmd.exe)
gcloud healthcare hl7v2-stores createHL7V2_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION ^ --parser-version=v3
Dovresti ricevere una risposta simile alla seguente:
Risposta
Created hl7V2Store [HL7V2_STORE_ID ].
Per creare un archivio HL7v2, utilizza il metodo
projects.locations.datasets.hl7V2Stores.create
.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
: l'ID del tuo progetto Google CloudPROJECT_ID
: la posizione del set di datiLOCATION
: il set di dati principale dell'archivio HL7v2DATASET_ID
: un identificatore per l'archivio HL7v2 soggetto ai requisiti relativi a dimensioni e caratteri dell'archivio HL7v2HL7V2_STORE_ID
Corpo JSON della richiesta:
{ "parserConfig": { "version": "V3" } }
Per inviare la richiesta, scegli una delle seguenti opzioni:
Salva il corpo della richiesta in un file denominato request.json
.
Esegui questo comando nel terminale per creare o sovrascrivere
questo file nella directory corrente:
cat > request.json << 'EOF' { "parserConfig": { "version": "V3" } } EOF
Quindi, esegui il seguente 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?hl7V2StoreId=HL7V2_STORE_ID "
Salva il corpo della richiesta in un file denominato request.json
.
Esegui questo comando nel terminale per creare o sovrascrivere
questo file nella directory corrente:
@' { "parserConfig": { "version": "V3" } } '@ | Out-File -FilePath request.json -Encoding utf8
Quindi, esegui il seguente 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?hl7V2StoreId=HL7V2_STORE_ID " | Select-Object -Expand Content
Copia il corpo della richiesta e apri la pagina di riferimento del metodo. Il riquadro Esplora 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:
Risposta
{ "name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID ", "parserConfig": { "version": "V3" } }
Utilizzare argomenti e filtri Pub/Sub
L'utilizzo di Pub/Sub e dei filtri con gli archivi HL7v2 è un caso d'uso comune, in particolare per la trasmissione di messaggi HL7v2 su connessioni TCP/IP.
Alcuni degli esempi in questa pagina mostrano come configurare un argomento Pub/Sub esistente a cui l'API Cloud Healthcare invia notifiche di eventi clinici in un archivio HL7v2. Specificando un elenco di argomenti e filtri Pub/Sub esistenti, l'API Cloud Healthcare può inviare notifiche a più argomenti e puoi utilizzare i filtri per limitare le notifiche inviate. Per ulteriori informazioni su come configurare gli argomenti e i filtri Pub/Sub, consulta Notifiche HL7v2 e Visualizzare le notifiche HL7v2.
Modifica di un archivio HL7v2
Gli esempi riportati di seguito mostrano come modificare l'elenco di argomenti e filtri Pub/Sub utilizzati dall'API Cloud Healthcare per inviare notifiche relative alle modifiche dell'archivio HL7v2.
Diversi esempi mostrano anche come modificare le etichette nell'archivio HL7v2.
Quando specifichi un argomento Pub/Sub, inserisci l'URI qualificato dell'argomento, come mostrato nel seguente esempio:projects/PROJECT_ID /topics/PUBSUB_TOPIC
Per modificare un archivio HL7v2, completa i seguenti passaggi:
- Nella console Google Cloud, vai alla pagina Set di dati.
- Seleziona il set di dati contenente l'archivio HL7v2 da modificare.
- Nell'elenco Datastore, fai clic sul datastore da modificare.
- Per modificare la configurazione dell'archivio HL7v2, fai clic su Configurazione dell'archivio HL7v2.
Per ulteriori informazioni sulle opzioni di configurazione dell'archivio HL7v2, consulta Creazione di un archivio HL7v2. - Se vuoi configurare un argomento Pub/Sub per il datastore, fai clic su Aggiungi argomento Pub/Sub e seleziona il nome dell'argomento. Quando specifichi un argomento Pub/Sub, inserisci l'URI qualificato dell'argomento, come mostrato nel seguente esempio:
projects/
PROJECT_ID /topics/PUBSUB_TOPIC - Se hai aggiunto un argomento Pub/Sub, fai clic su Fine.
- Per aggiungere una o più etichette al negozio, fai clic su Utilizzare le etichette delle risorse. Etichette, poi su Aggiungi etichetta e inserisci l'etichetta chiave/valore. Per saperne di più sulle etichette delle risorse, vedi
- Fai clic su Salva.
La gcloud CLI non supporta questa azione. Utilizza invece la console Google Cloud, curl
, PowerShell o la lingua che preferisci.
Per modificare un archivio HL7v2, utilizza il metodo projects.locations.datasets.hl7V2Stores.patch
.
Prima di eseguire i seguenti esempi, devi creare almeno un argomento Pub/Sub nel tuo progetto.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
PROJECT_ID : l'ID del tuo progetto Google CloudLOCATION : la posizione del set di datiDATASET_ID : il set di dati principale dell'archivio HL7v2HL7V2_STORE_ID : l'ID dell'archivio HL7v2PUBSUB_TOPIC1 : un argomento Pub/Sub a cui vengono pubblicati i messaggi quando si verifica un evento in un datastoreFILTER1 : una stringa utilizzata per abbinare i messaggi pubblicati su PUBSUB_TOPIC1Vedi
filter
per esempi di valori di filtro validi.PUBSUB_TOPIC2 : un argomento Pub/Sub a cui vengono pubblicati i messaggiFILTER2 : una stringa utilizzata per abbinare i messaggi pubblicati su PUBSUB_TOPIC2KEY1 : la prima chiave di etichettaVALUE1 : il primo valore dell'etichettaKEY2 : la seconda chiave di etichettaVALUE2 : il secondo valore dell'etichetta
Corpo JSON della richiesta:
{ 'notificationConfigs': [ { 'pubsubTopic': 'projects/PROJECT_ID /topics/PUBSUB_TOPIC1 ', 'filter' : 'FILTER1 ' }, { 'pubsubTopic': 'projects/PROJECT_ID /topics/PUBSUB_TOPIC2 ', 'filter': 'FILTER2 ' }, ], 'labels': { 'KEY1 ':'VALUE1 ', 'KEY2 ':'VALUE2 ' } }
Per inviare la richiesta, scegli una delle seguenti opzioni:
Salva il corpo della richiesta in un file denominato request.json
.
Esegui questo comando nel terminale per creare o sovrascrivere
questo file nella directory corrente:
cat > request.json << 'EOF' { 'notificationConfigs': [ { 'pubsubTopic': 'projects/PROJECT_ID /topics/PUBSUB_TOPIC1 ', 'filter' : 'FILTER1 ' }, { 'pubsubTopic': 'projects/PROJECT_ID /topics/PUBSUB_TOPIC2 ', 'filter': 'FILTER2 ' }, ], 'labels': { 'KEY1 ':'VALUE1 ', 'KEY2 ':'VALUE2 ' } } EOF
Quindi, esegui il seguente comando per inviare la richiesta REST:
curl -X PATCH \
-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 ?updateMask=notificationConfigs,labels"
Salva il corpo della richiesta in un file denominato request.json
.
Esegui questo comando nel terminale per creare o sovrascrivere
questo file nella directory corrente:
@' { 'notificationConfigs': [ { 'pubsubTopic': 'projects/PROJECT_ID /topics/PUBSUB_TOPIC1 ', 'filter' : 'FILTER1 ' }, { 'pubsubTopic': 'projects/PROJECT_ID /topics/PUBSUB_TOPIC2 ', 'filter': 'FILTER2 ' }, ], 'labels': { 'KEY1 ':'VALUE1 ', 'KEY2 ':'VALUE2 ' } } '@ | Out-File -FilePath request.json -Encoding utf8
Quindi, esegui il seguente 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; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID ?updateMask=notificationConfigs,labels" | Select-Object -Expand Content
Copia il corpo della richiesta e apri la pagina di riferimento del metodo. Il riquadro Esplora 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:
Risposta
{ "name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID ", "labels": { "KEY1 ": "VALUE1 ", "KEY2 ": "VALUE2 " }, "notificationConfigs": [ { "pubsubTopic": "projects/PROJECT_ID /topics/PUBSUB_TOPIC1 ", "filter": "FILTER1 " }, { "pubsubTopic": "projects/PROJECT_ID /topics/PUBSUB_TOPIC2 ", "filter": "FILTER2 " } ] }
Recupero dei dettagli di un archivio HL7v2
Gli esempi riportati di seguito mostrano come recuperare i dettagli di un archivio HL7v2.
Per visualizzare i dettagli di un archivio HL7v2:
- Nella console Google Cloud, vai alla pagina Set di dati.
- Seleziona il set di dati contenente l'archivio HL7v2 che vuoi visualizzare.
- Fai clic sul nome dell'archivio HL7v2.
La pagina Dettagli datastore mostra i dettagli dell'archivio HL7v2 selezionato.
Per recuperare i dettagli di un archivio HL7v2, esegui il comando gcloud healthcare hl7v2-stores describe
.
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
LOCATION : la posizione del set di datiDATASET_ID : il set di dati principale dell'archivio HL7v2HL7V2_STORE_ID : l'ID dell'archivio HL7v2
Esegui il seguente comando:
Linux, macOS o Cloud Shell
gcloud healthcare hl7v2-stores describeHL7V2_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare hl7v2-stores describeHL7V2_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare hl7v2-stores describeHL7V2_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Dovresti ricevere una risposta simile alla seguente.
Se nella risorsa Hl7V2Store
hai configurato dei campi, questi vengono visualizzati anche nella risposta.
Risposta
... name: projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID ...
Per recuperare i dettagli di un archivio HL7v2, utilizza il metodo projects.locations.datasets.hl7V2Stores.get
.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
PROJECT_ID : l'ID del tuo progetto Google CloudLOCATION : la posizione del set di datiDATASET_ID : il set di dati principale dell'archivio HL7v2HL7V2_STORE_ID : l'ID dell'archivio HL7v2
Per inviare la richiesta, scegli una delle seguenti opzioni:
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 /hl7V2Stores/HL7V2_STORE_ID "
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 /hl7V2Stores/HL7V2_STORE_ID " | Select-Object -Expand Content
Apri la pagina di riferimento del metodo. Il riquadro Esplora API si apre sul lato destro della pagina. Puoi interagire con questo strumento per inviare richieste. Compila i campi obbligatori e fai clic su Esegui.
Dovresti ricevere una risposta simile alla seguente.
Se nella risorsa Hl7V2Store
hai configurato dei campi, questi vengono visualizzati anche nella risposta.
Risposta
{ "name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID " ... }
Elenco degli archivi HL7v2 in un set di dati
Gli esempi riportati di seguito mostrano come elencare gli archivi HL7v2 in un set di dati.
Per visualizzare i datastore in un set di dati:
- Nella console Google Cloud, vai alla pagina Set di dati.
- Seleziona il set di dati contenente il datastore che vuoi visualizzare.
Per elencare gli archivi HL7v2 in un set di dati, esegui il comando gcloud healthcare hl7v2-stores list
.
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
LOCATION : la posizione del set di datiDATASET_ID : il set di dati principale dell'archivio HL7v2
Esegui il seguente comando:
Linux, macOS o Cloud Shell
gcloud healthcare hl7v2-stores list --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare hl7v2-stores list --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare hl7v2-stores list --dataset=DATASET_ID ^ --location=LOCATION
Dovresti ricevere una risposta simile alla seguente.
Se nella risorsa Hl7V2Store
hai configurato dei campi, questi vengono visualizzati anche nella risposta.
ID LOCATION TOPICHL7V2_STORE_ID LOCATION projects/PROJECT_ID /topics/PUBSUB_TOPIC PUBSUB_TOPIC ...
Per elencare gli archivi HL7v2 in un set di dati, utilizza il metodo projects.locations.datasets.hl7V2Stores.list
.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
PROJECT_ID : l'ID del tuo progetto Google CloudLOCATION : la posizione del set di datiDATASET_ID : il set di dati principale dell'archivio HL7v2
Per inviare la richiesta, scegli una delle seguenti opzioni:
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 /hl7V2Stores"
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 /hl7V2Stores" | Select-Object -Expand Content
Apri la pagina di riferimento del metodo. Il riquadro Esplora API si apre sul lato destro della pagina. Puoi interagire con questo strumento per inviare richieste. Compila i campi obbligatori e fai clic su Esegui.
Dovresti ricevere una risposta simile alla seguente.
Se nella risorsa Hl7V2Store
hai configurato dei campi, questi vengono visualizzati anche nella risposta.
Risposta
{ "hl7V2Stores": [ { "name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID " ... }, { ... } ] }
Eliminazione di un archivio HL7v2
Gli esempi riportati di seguito mostrano come eliminare un archivio HL7v2.
Per eliminare un datastore:
- Nella console Google Cloud, vai alla pagina Set di dati.
- Seleziona il set di dati contenente il datastore da eliminare.
- Scegli Elimina dall'elenco a discesa Azioni per l'datastore che vuoi eliminare.
- Per confermare, digita il nome datastore e fai clic su Elimina.
Per eliminare un archivio HL7v2, esegui il comando gcloud healthcare hl7v2-stores delete
.
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
LOCATION : la posizione del set di datiDATASET_ID : il set di dati principale dell'archivio HL7v2HL7V2_STORE_ID : l'ID dell'archivio HL7v2
Esegui il seguente comando:
Linux, macOS o Cloud Shell
gcloud healthcare hl7v2-stores deleteHL7V2_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare hl7v2-stores deleteHL7V2_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare hl7v2-stores deleteHL7V2_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Deleted hl7v2Store [HL7V2_STORE_ID ].
Per eliminare un archivio HL7v2, utilizza il metodo projects.locations.datasets.hl7V2Stores.delete
.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
PROJECT_ID : l'ID del tuo progetto Google CloudLOCATION : la posizione del set di datiDATASET_ID : il set di dati principale dell'archivio HL7v2HL7V2_STORE_ID : l'ID dell'archivio HL7v2
Per inviare la richiesta, scegli una delle seguenti opzioni:
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 /hl7V2Stores/HL7V2_STORE_ID "
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 /hl7V2Stores/HL7V2_STORE_ID " | Select-Object -Expand Content
Apri la pagina di riferimento del metodo. Il riquadro Esplora API si apre sul lato destro della pagina. Puoi interagire con questo strumento per inviare richieste. Compila i campi obbligatori e fai clic su Esegui.
Risposta
{}
Passaggi successivi
- Leggi la documentazione concettuale su come HL7v2 è implementato nell'API Cloud Healthcare.
- Scopri come creare e gestire i messaggi HL7v2.