En esta página se explica cómo crear, editar, ver y eliminar almacenes Health Level Seven versión 2.x (HL7v2). Los almacenes HL7v2 contienen mensajes HL7v2, que se usan para transmitir datos clínicos entre sistemas.
Crear un almacén HL7v2
Para poder crear un almacén HL7v2, antes debes crear un conjunto de datos.
Al crear un almacén HL7v2, especifica la versión del analizador V3
. No puedes cambiar la versión del analizador después de crear el almacén HL7v2.
En los ejemplos siguientes se muestra cómo crear un almacén HL7v2 con el analizador V3.
Consola
En la Google Cloud consola, ve a la página Conjuntos de datos.
Selecciona el conjunto de datos en el que quieras crear el almacén HL7v2. Se mostrará la página Conjunto de datos.
Haz clic en add_box Crear almacén de datos. Se muestra la página Crear almacén de datos.
En el menú Tipo, selecciona HL7v2.
En el campo ID, introduce un nombre para el almacén HL7v2. El nombre debe ser único en el conjunto de datos. Consulta los caracteres permitidos y los requisitos de tamaño para obtener más información sobre los nombres.
Haz clic en Siguiente. Se muestra la sección Configurar almacén de HL7v2.
Configura las siguientes configuraciones:
- En la sección Versión, deje sin cambiar la selección predeterminada V3.
- Para permitir la creación y la ingestión de mensajes HL7v2 sin encabezado, selecciona Permitir encabezados de mensajes (MSH) nulos.
- Para definir un terminador de segmentos personalizado, haga clic en Definir un terminador de segmentos personalizado e introdúzcalo en el campo Terminador de segmentos. Para obtener más información, consulta Configurar el terminador de segmentos.
- Para rechazar los mensajes HL7v2 entrantes que tengan los mismos bytes sin formato que un mensaje HL7v2 que ya exista en el almacén HL7v2, selecciona Rechazar mensajes duplicados.
Haz clic en Siguiente. Se muestra la sección Recibir notificaciones de Cloud Pub/Sub.
Si quieres recibir notificaciones de Pub/Sub cuando se produzca un evento clínico en tu almacén HL7v2, especifica el tema de Pub/Sub. El tema debe existir para poder configurarlo en el almacén HL7v2.
Haz clic en Siguiente. Se muestra la sección Añadir etiquetas para organizar los almacenes de datos.
Para añadir una o varias etiquetas clave-valor al almacén HL7v2, haz clic en add Añadir etiqueta. Para obtener más información sobre las etiquetas de recursos, consulta el artículo Usar etiquetas de recursos.
Haz clic en Crear. Se muestra la página Conjunto de datos y el almacén HL7v2 en la tabla Almacenes de datos.
gcloud
Para crear un almacén HL7v2, ejecuta el comando gcloud healthcare hl7v2-stores create
.
Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:
PROJECT_ID
: el ID de tu Google Cloud proyectoLOCATION
: la ubicación del conjunto de datosDATASET_ID
: el conjunto de datos superior del almacén HL7v2HL7V2_STORE_ID
: un identificador del almacén HL7v2 que debe cumplir los requisitos de caracteres y tamaño del almacén HL7v2
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud healthcare hl7v2-stores create HL7V2_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --parser-version=v3
Windows (PowerShell)
gcloud healthcare hl7v2-stores create HL7V2_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION ` --parser-version=v3
Windows (cmd.exe)
gcloud healthcare hl7v2-stores create HL7V2_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION ^ --parser-version=v3
Deberías recibir una respuesta similar a la siguiente:
Respuesta
Created hl7V2Store [HL7V2_STORE_ID].
REST
Para crear un almacén HL7v2, usa el método projects.locations.datasets.hl7V2Stores.create
.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
PROJECT_ID
: el ID de tu Google Cloud proyectoLOCATION
: la ubicación del conjunto de datosDATASET_ID
: el conjunto de datos superior del almacén HL7v2HL7V2_STORE_ID
: un identificador del almacén HL7v2 que debe cumplir los requisitos de caracteres y tamaño del almacén HL7v2
Cuerpo JSON de la solicitud:
{ "parserConfig": { "version": "V3" } }
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json
.
Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:
cat > request.json << 'EOF' { "parserConfig": { "version": "V3" } } EOF
A continuación, ejecuta el siguiente comando para enviar tu solicitud 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"
PowerShell
Guarda el cuerpo de la solicitud en un archivo llamado request.json
.
Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:
@' { "parserConfig": { "version": "V3" } } '@ | Out-File -FilePath request.json -Encoding utf8
A continuación, ejecuta el siguiente comando para enviar tu solicitud 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
Explorador de APIs
Copia el cuerpo de la solicitud y abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Pega el cuerpo de la solicitud en esta herramienta, rellena los campos obligatorios y haz clic en Ejecutar.
Deberías recibir una respuesta JSON similar a la siguiente:
Go
Java
Node.js
Python
Usar temas y filtros de Pub/Sub
Usar Pub/Sub y filtros con almacenes HL7v2 es un caso práctico habitual, sobre todo cuando se transmiten mensajes HL7v2 a través de conexiones TCP/IP.
En algunos de los ejemplos de esta página se muestra cómo configurar un tema de Pub/Sub para que la API Cloud Healthcare envíe notificaciones de eventos clínicos en un almacén HL7v2. Si especificas una lista de temas y filtros de Pub/Sub, la API Cloud Healthcare puede enviar notificaciones a varios temas. Además, puedes usar los filtros para restringir las notificaciones que se envían. Para obtener más información sobre cómo configurar temas y filtros de Pub/Sub, consulta Notificaciones de HL7v2 y Ver notificaciones de HL7v2.
Editar un almacén HL7v2
En los ejemplos siguientes se muestra cómo editar la lista de temas y filtros de Pub/Sub que usa la API Cloud Healthcare para enviar notificaciones de cambios en el almacén HL7v2.
En varios ejemplos también se muestra cómo editar las etiquetas del almacén HL7v2.
Cuando especifiques un tema de Pub/Sub, introduce el URI completo del tema, tal como se muestra en el siguiente ejemplo:projects/PROJECT_ID/topics/PUBSUB_TOPIC
Consola
Para editar un almacén HL7v2, sigue estos pasos:
- En la Google Cloud consola, ve a la página Conjuntos de datos.
- Seleccione el conjunto de datos que contenga el almacén HL7v2 que quiera editar.
- En la lista Almacenes de datos, haga clic en el que quiera editar.
- Para editar la configuración del almacén HL7v2, haz clic en Configuración del almacén HL7v2.
Para obtener más información sobre las opciones de configuración del almacén HL7v2, consulta Crear un almacén HL7v2. - Si quieres configurar un tema de Pub/Sub para el almacén de datos, haz clic en Añadir tema de Pub/Sub y selecciona el nombre del tema. Cuando especifiques un tema de Pub/Sub, introduce el URI completo del tema, tal como se muestra en el siguiente ejemplo:
projects/PROJECT_ID/topics/PUBSUB_TOPIC
- Si has añadido un tema de Pub/Sub, haz clic en Hecho.
- Para añadir una o varias etiquetas a la tienda, haga clic en Usar etiquetas de recursos. Etiquetas, Añadir etiqueta e introduzca la etiqueta clave-valor. Para obtener más información sobre las etiquetas de recursos, consulta el artículo
- Haz clic en Guardar.
gcloud
La CLI de gcloud no admite esta acción. En su lugar, usa la Google Cloud consolacurl
, PowerShell o el lenguaje que prefieras.
REST
Para editar un almacén HL7v2, usa el método projects.locations.datasets.hl7V2Stores.patch
.
Antes de ejecutar los siguientes ejemplos, debes crear al menos un tema de Pub/Sub en tu proyecto.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- PROJECT_ID: el ID de tu Google Cloud proyecto
- LOCATION: la ubicación del conjunto de datos
- DATASET_ID: el conjunto de datos superior del almacén HL7v2
- HL7V2_STORE_ID: el ID del almacén HL7v2
- PUBSUB_TOPIC1: un tema de Pub/Sub en el que se publican mensajes cuando se produce un evento en un almacén de datos.
- FILTER1: cadena que se usa para buscar mensajes publicados en PUBSUB_TOPIC1.
Consulta ejemplos de valores de filtro válidos en
filter
. - PUBSUB_TOPIC2: un tema de Pub/Sub en el que se publican mensajes
- FILTER2: cadena que se usa para buscar mensajes publicados en PUBSUB_TOPIC2.
- KEY1: la primera clave de etiqueta
- VALUE1: el primer valor de la etiqueta
- KEY2: la segunda clave de etiqueta
- VALUE2: el segundo valor de la etiqueta
Cuerpo JSON de la solicitud:
{ 'notificationConfigs': [ { 'pubsubTopic': 'projects/PROJECT_ID/topics/PUBSUB_TOPIC1', 'filter' : 'FILTER1' }, { 'pubsubTopic': 'projects/PROJECT_ID/topics/PUBSUB_TOPIC2', 'filter': 'FILTER2' }, ], 'labels': { 'KEY1':'VALUE1', 'KEY2':'VALUE2' } }
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json
.
Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:
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
A continuación, ejecuta el siguiente comando para enviar tu solicitud 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"
PowerShell
Guarda el cuerpo de la solicitud en un archivo llamado request.json
.
Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:
@' { '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
A continuación, ejecuta el siguiente comando para enviar tu solicitud 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
Explorador de APIs
Copia el cuerpo de la solicitud y abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Pega el cuerpo de la solicitud en esta herramienta, rellena los campos obligatorios y haz clic en Ejecutar.
Deberías recibir una respuesta JSON similar a la siguiente:
Go
Java
Node.js
Python
Obtener detalles de un almacén HL7v2
En los ejemplos siguientes se muestra cómo obtener detalles de un almacén HL7v2.
Consola
Para ver los detalles de un almacén HL7v2, sigue estos pasos:
- En la Google Cloud consola, ve a la página Conjuntos de datos.
- Seleccione el conjunto de datos que contiene el almacén HL7v2 que quiere ver.
- Haga clic en el nombre del almacén HL7v2.
En la página Detalles del almacén de datos se muestran los detalles del almacén HL7v2 seleccionado.
gcloud
Para obtener detalles sobre un almacén HL7v2, ejecuta el comando gcloud healthcare hl7v2-stores describe
.
Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:
- LOCATION: la ubicación del conjunto de datos
- DATASET_ID: el conjunto de datos superior del almacén HL7v2
- HL7V2_STORE_ID: el ID del almacén HL7v2
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud healthcare hl7v2-stores describe HL7V2_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare hl7v2-stores describe HL7V2_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare hl7v2-stores describe HL7V2_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Deberías recibir una respuesta similar a la siguiente.
Si has configurado algún campo del recurso Hl7V2Store
, también aparecerá en la respuesta.
Respuesta
... name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID ...
REST
Para obtener detalles sobre un almacén HL7v2, usa el método projects.locations.datasets.hl7V2Stores.get
.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- PROJECT_ID: el ID de tu Google Cloud proyecto
- LOCATION: la ubicación del conjunto de datos
- DATASET_ID: el conjunto de datos superior del almacén HL7v2
- HL7V2_STORE_ID: el ID del almacén HL7v2
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el comando siguiente:
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"
PowerShell
Ejecuta el comando siguiente:
$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
Explorador de APIs
Abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Rellena los campos obligatorios y haz clic en Ejecutar.
Deberías recibir una respuesta similar a la siguiente.
Si has configurado algún campo del recurso Hl7V2Store
, también aparecerá en la respuesta.
Go
Java
Node.js
Python
Enumerar los almacenes HL7v2 de un conjunto de datos
En los ejemplos siguientes se muestra cómo enumerar los almacenes HL7v2 en un conjunto de datos.
Consola
Para ver los almacenes de datos de un conjunto de datos, sigue estos pasos:
- En la Google Cloud consola, ve a la página Conjuntos de datos.
- Selecciona el conjunto de datos que contiene el almacén de datos que quieres ver.
gcloud
Para enumerar los almacenes HL7v2 de un conjunto de datos, ejecuta el comando gcloud healthcare hl7v2-stores list
.
Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:
- LOCATION: la ubicación del conjunto de datos
- DATASET_ID: el conjunto de datos superior del almacén HL7v2
Ejecuta el siguiente 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
Deberías recibir una respuesta similar a la siguiente.
Si has configurado algún campo del recurso Hl7V2Store
, también aparecerá en la respuesta.
ID LOCATION TOPIC HL7V2_STORE_ID LOCATION projects/PROJECT_ID/topics/PUBSUB_TOPIC PUBSUB_TOPIC ...
REST
Para enumerar los almacenes HL7v2 de un conjunto de datos, usa el método projects.locations.datasets.hl7V2Stores.list
.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- PROJECT_ID: el ID de tu Google Cloud proyecto
- LOCATION: la ubicación del conjunto de datos
- DATASET_ID: el conjunto de datos superior del almacén HL7v2
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el comando siguiente:
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"
PowerShell
Ejecuta el comando siguiente:
$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
Explorador de APIs
Abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Rellena los campos obligatorios y haz clic en Ejecutar.
Deberías recibir una respuesta similar a la siguiente.
Si has configurado algún campo del recurso Hl7V2Store
, también aparecerá en la respuesta.
Go
Java
Node.js
Python
Eliminar un almacén HL7v2
En los ejemplos siguientes se muestra cómo eliminar un almacén HL7v2.
Consola
Para eliminar un almacén de datos, sigue estos pasos:
- En la Google Cloud consola, ve a la página Conjuntos de datos.
- Selecciona el conjunto de datos que contiene el almacén de datos que quieres eliminar.
- En la lista desplegable Acciones del almacén de datos que quiere eliminar, seleccione Eliminar.
- Para confirmar la acción, escribe el nombre del almacén de datos y haz clic en Eliminar.
gcloud
Para eliminar un almacén HL7v2, ejecuta el comando gcloud healthcare hl7v2-stores delete
.
Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:
- LOCATION: la ubicación del conjunto de datos
- DATASET_ID: el conjunto de datos superior del almacén HL7v2
- HL7V2_STORE_ID: el ID del almacén HL7v2
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud healthcare hl7v2-stores delete HL7V2_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare hl7v2-stores delete HL7V2_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare hl7v2-stores delete HL7V2_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Deleted hl7v2Store [HL7V2_STORE_ID].
REST
Para eliminar un almacén HL7v2, usa el método projects.locations.datasets.hl7V2Stores.delete
.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- PROJECT_ID: el ID de tu Google Cloud proyecto
- LOCATION: la ubicación del conjunto de datos
- DATASET_ID: el conjunto de datos superior del almacén HL7v2
- HL7V2_STORE_ID: el ID del almacén HL7v2
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el comando siguiente:
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"
PowerShell
Ejecuta el comando siguiente:
$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
Explorador de APIs
Abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Rellena los campos obligatorios y haz clic en Ejecutar.
Go
Java
Node.js
Python
Siguientes pasos
- Consulta la documentación conceptual sobre cómo se implementa HL7v2 en la API Cloud Healthcare.
- Consulta cómo crear y gestionar mensajes HL7v2.