En esta página, se explica cómo crear, editar, ver y borrar Niveles de salud siete Versión 2.x (HL7v2) en las tiendas físicas. Los almacenes de HL7v2 contienen mensajes de HL7v2, que se usan para transmitir datos clínicos. entre sistemas.
Crea un almacén HL7v2
Antes de crear un almacén HL7v2, debes crear un conjunto de datos.
Cuando crees un almacén de HL7v2, especifica el V3
versión del analizador. No puedes cambiar la versión del analizador después de crear el almacén de HL7v2.
En los siguientes ejemplos, se muestra cómo crear un almacén de HL7v2 con el analizador V3.
Console
En la consola de Google Cloud, ve a la página Conjuntos de datos.
Selecciona el conjunto de datos en el que deseas crear el almacén de HL7v2. Se muestra 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, ingresa un nombre para el almacén de HL7v2. El nombre debe ser único en el conjunto de datos. Consulta Caracteres y requisitos de tamaño permitidos para obtener más información sobre los requisitos de nomenclatura.
Haz clic en Siguiente. Aparecerá la sección Configurar tu almacén de HL7v2.
Establece la siguiente configuración:
- En la sección Versión, deja sin cambios la selección predeterminada V3.
- Para permitir la creación y transferencia de mensajes HL7v2 sin encabezado, haz lo siguiente: Selecciona Permitir encabezados de mensajes nulos (MSH).
- Para configurar un terminador de segmentos personalizado, haz clic en Establecer un terminador de segmentos personalizado y, luego, ingresa el terminador en el campo Segment Termtor. Para ver más consulta Configura el terminador de segmentos.
- Para rechazar mensajes HL7v2 entrantes con los mismos bytes sin procesar que un mensaje HL7v2 existente en el almacén de HL7v2, selecciona Rechaza los mensajes duplicados.
Haz clic en Siguiente. Se mostrará la sección Recibir notificaciones de Cloud Pub/Sub.
Si deseas recibir notificaciones de Pub/Sub cuando se produzca un evento clínico en tu almacén de HL7v2, especifica el tema de Pub/Sub. El tema debe existir antes de que puedas configurarlo en el almacén de HL7v2.
Haz clic en Siguiente. La sección Agrega etiquetas para organizar tus almacenes de datos el código fuente.
Para agregar una o más etiquetas de clave-valor al almacén de HL7v2, haz clic en add Agregar etiqueta. Para obtener más información sobre etiquetas de recursos, consulta Usa etiquetas de recursos.
Haz clic en Crear. Se muestra la página Conjunto de datos y el almacén de HL7v2 se muestra en la tabla Almacenes de datos.
gcloud
Google Cloud CLI no admite la configuración de la versión del analizador cuando se crea
un almacén de HL7v2. En su lugar, usa la consola de Google Cloud, curl
,
PowerShell
o tu idioma preferido.
REST
Para crear un almacén de HL7v2, usa el
projects.locations.datasets.hl7V2Stores.create
.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_ID
El ID de tu proyecto de Google Cloud.LOCATION
: La ubicación del conjunto de datosDATASET_ID
es el conjunto de datos superior del almacén de HL7v2HL7V2_STORE_ID
: Un identificador para el almacén de HL7v2 sujeto a los requisitos de caracteres y tamaño del almacén de 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 comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
cat > request.json << 'EOF' { "parserConfig": { "version": "V3" } } EOF
Luego, ejecuta el siguiente comando para enviar tu solicitud de 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 comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
@' { "parserConfig": { "version": "V3" } } '@ | Out-File -FilePath request.json -Encoding utf8
Luego, ejecuta el siguiente comando para enviar tu solicitud de 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 API
Copia el cuerpo de la solicitud y abre la página de referencia del método. El panel del Explorador de API 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, completa cualquier otro campo obligatorio y haz clic en Ejecutar.
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Go
Java
Node.js
Python
Usa temas y filtros de Pub/Sub
Con Pub/Sub y los filtros con almacenes de HL7v2 es un caso de uso común, en especial 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 existente de Pub/Sub para la que la API de Cloud Healthcare envía notificaciones de eventos clínicos en un almacén de HL7v2. Con la especificación de una lista de temas de Pub/Sub existentes y filtros, la API de Cloud Healthcare puede enviar notificaciones a varios temas y puedes usar los filtros para restringir las notificaciones que se envían. Para obtener más información sobre cómo configurar los temas de Pub/Sub y filtros, consulta Notificaciones de HL7v2 y ver notificaciones de HL7v2.
Edición de un almacén HL7v2
En los siguientes ejemplos, se muestra cómo editar la lista de Pub/Sub temas y filtros que la API de Cloud Healthcare usa para enviar notificaciones de cambios en el almacén de HL7v2.
En varios ejemplos, también se muestra cómo editar las etiquetas en el almacén de HL7v2.
Cuando especifiques un tema de Pub/Sub, ingresa el URI calificado para el tema, como se muestra en el siguiente ejemplo:projects/PROJECT_ID/topics/PUBSUB_TOPIC
Console
Para editar un almacén de HL7v2, completa los siguientes pasos:
- En la consola de Google Cloud, ve a la página Conjuntos de datos.
- Selecciona el conjunto de datos que contenga el almacén de HL7v2 que deseas editar.
- En la lista Almacenes de datos, haz clic en el almacén de datos que deseas editar.
- Para editar la configuración del almacén de HL7v2, haz clic en Configuración del almacén de HL7v2.
Para obtener más información sobre las opciones de configuración del almacén de HL7v2, consulta Crea un almacén de HL7v2. - Si deseas configurar un tema de Pub/Sub para el almacén de datos, haz clic en Agregar tema de Pub/Sub y selecciona el nombre del tema. Cuando especifiques un tema de Pub/Sub, ingresa el URI calificado para el tema, como se muestra en el siguiente ejemplo:
projects/PROJECT_ID/topics/PUBSUB_TOPIC
- Si agregaste un tema de Pub/Sub, haz clic en Listo.
- Para agregar una o más etiquetas al almacén, haz clic en Usa etiquetas de recursos. Etiquetas, luego, en Agregar etiqueta e ingresa la etiqueta de par clave-valor. Para obtener más información sobre las etiquetas de recursos, consulta
- Haz clic en Guardar.
gcloud
Gcloud CLI no admite esta acción. En su lugar, usa la consola de Google Cloud, curl
, PowerShell o tu lenguaje preferido.
REST
Para editar un almacén de HL7v2, usa el método projects.locations.datasets.hl7V2Stores.patch
.
Antes de ejecutar los siguientes ejemplos, debes crear al menos uno Tema de Pub/Sub en tu proyecto.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_IDEl ID de tu proyecto de Google Cloud.
- LOCATION: La ubicación del conjunto de datos
- DATASET_ID: El conjunto de datos superior del almacén de HL7v2
- HL7V2_STORE_ID es el ID del almacén de HL7v2.
- PUBSUB_TOPIC1: Es un tema de Pub/Sub en el que se publican mensajes cuando se produce un evento en un almacén de datos.
- FILTER1 una string que se usa para hacer coincidir los mensajes publicados en PUBSUB_TOPIC1
Consulta
filter
para ver ejemplos de valores de filtro válidos. - PUBSUB_TOPIC2 es un tema de Pub/Sub en el que se publican los mensajes.
- FILTER2 una string que se usa para hacer coincidir los mensajes publicados en PUBSUB_TOPIC2
- KEY1 es la primera clave de etiqueta.
- VALUE1: El primer valor de etiqueta
- KEY2: La segunda clave de etiqueta
- VALUE2: El segundo valor de 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 comando siguiente en la terminal para crear o reemplazar 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
Luego, ejecuta el siguiente comando para enviar tu solicitud de 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 comando siguiente en la terminal para crear o reemplazar 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
Luego, ejecuta el siguiente comando para enviar tu solicitud de 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 API
Copia el cuerpo de la solicitud y abre la página de referencia del método. El panel del Explorador de API 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, completa cualquier otro campo obligatorio y haz clic en Ejecutar.
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Go
Java
Node.js
Python
Obtén detalles del almacén HL7v2
En los siguientes ejemplos, se muestra cómo obtener detalles sobre un almacén HL7v2 de anotaciones.
Console
Para ver los detalles de un almacén HL7v2:
- En la consola de Google Cloud, ve a la página Conjuntos de datos.
- Selecciona el conjunto de datos que contenga el almacén de HL7v2 que deseas ver.
- Haz clic en el nombre de la tienda de HL7v2.
En la página Detalles del almacén de datos, se muestran los detalles del almacén de HL7v2 seleccionado.
gcloud
Para obtener detalles sobre un almacén de HL7v2, ejecuta el comando gcloud healthcare hl7v2-stores describe
.
Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:
- LOCATION es la ubicación del conjunto de datos.
- DATASET_ID: El conjunto de datos superior del almacén de HL7v2
- HL7V2_STORE_ID es el ID del almacén de 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 que figura a continuación.
Si configuraste algún campo en el recurso Hl7V2Store
, también aparecerá en la respuesta.
... name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID ...
REST
Para obtener más detalles sobre un almacén HL7v2 de anotaciones, usa el método projects.locations.datasets.hl7V2Stores.get
.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_IDEl ID de tu proyecto de Google Cloud.
- LOCATION: La ubicación del conjunto de datos
- DATASET_ID: El conjunto de datos superior del almacén de HL7v2
- HL7V2_STORE_ID es el ID del almacén de HL7v2.
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente 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"
PowerShell
Ejecuta el siguiente 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
Explorador de API
Abre el página de referencia del método. El panel del Explorador de API se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Completa los campos obligatorios y haz clic en Ejecutar.
Deberías recibir una respuesta similar a la que figura a continuación.
Si configuraste algún campo en el recurso Hl7V2Store
, también aparecerá en la respuesta.
Go
Java
Node.js
Python
Enumera los almacenes HL7v2 en un conjunto de datos
En los siguientes ejemplos, se muestra cómo enumerar los almacenes HL7v2 en un conjunto de datos.
Console
Para ver los almacenes de datos en un conjunto de datos, haz lo siguiente:
- En la consola de Google Cloud, ve a la página Conjuntos de datos.
- Selecciona el conjunto de datos que contiene el almacén de datos que deseas ver.
gcloud
Para mostrar una lista de los almacenes de HL7v2 en un conjunto de datos, ejecuta el comando de gcloud healthcare hl7v2-stores list
.
Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:
- LOCATION es la ubicación del conjunto de datos.
- DATASET_ID es el conjunto de datos superior del almacén de 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 que figura a continuación.
Si configuraste algún campo en el 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 mostrar una lista de los almacenes HL7v2 en un conjunto de datos, usa el método projects.locations.datasets.hl7V2Stores.list
.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_IDEl ID de tu proyecto de Google Cloud.
- LOCATION: La ubicación del conjunto de datos
- DATASET_ID es el conjunto de datos superior del almacén de HL7v2
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente 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"
PowerShell
Ejecuta el siguiente 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
Explorador de API
Abre el página de referencia del método. El panel del Explorador de API se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Completa los campos obligatorios y haz clic en Ejecutar.
Deberías recibir una respuesta similar a la que figura a continuación.
Si configuraste algún campo en el recurso Hl7V2Store
, también aparecerá en la respuesta.
Go
Java
Node.js
Python
Borra un almacén HL7v2
En los siguientes ejemplos, se muestra cómo borrar un almacén de HL7v2.
Console
Para borrar un almacén de datos, realiza las siguientes acciones:
- En la consola de Google Cloud, ve a la página Conjuntos de datos.
- Selecciona el conjunto de datos que contiene el almacén de datos que deseas borrar.
- Elige Borrar en la lista desplegable Acciones para el almacén de datos que deseas borrar.
- Para confirmar, escribe el nombre del almacén de datos y, luego, haz clic en Borrar.
gcloud
Para borrar un almacén HL7v2 de anotaciones, ejecuta el comando gcloud healthcare hl7v2-stores delete
.
Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:
- LOCATION es la ubicación del conjunto de datos.
- DATASET_ID: El conjunto de datos superior del almacén de HL7v2
- HL7V2_STORE_ID es el ID del almacén de 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 borrar un almacén de HL7v2, usa el método projects.locations.datasets.hl7V2Stores.delete
.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_IDEl ID de tu proyecto de Google Cloud.
- LOCATION: La ubicación del conjunto de datos
- DATASET_ID: El conjunto de datos superior del almacén de HL7v2
- HL7V2_STORE_ID es el ID del almacén de HL7v2.
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente 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"
PowerShell
Ejecuta el siguiente 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
Explorador de API
Abre el página de referencia del método. El panel del Explorador de API se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Completa los campos obligatorios y haz clic en Ejecutar.
Go
Java
Node.js
Python
¿Qué sigue?
- Lee la documentación conceptual sobre cómo se implementa HL7v2 en la API de Cloud Healthcare.
- Obtén más información sobre cómo crear y administrar tiendas de HL7v2