En esta página, se explica cómo transferir, crear, etiquetar, enumerar, ver y borrar mensajes HL7v2.
Descripción general de la creación y la transferencia de mensajes de HL7v2
El método messages.create
se usa para almacenar un mensaje de HL7v2 en la API de Cloud Healthcare.
El método messages.ingest
también se usa para almacenar un mensaje de HL7v2 en la API de Cloud Healthcare.
Sin embargo, también genera una respuesta que contiene un mensaje de confirmación de recepción de HL7v2 ( ACK
) cuando tenga éxito o un mensaje de confirmación negativa (NACK
) en caso de error, adecuado para responder a los sistemas de interfaz de HL7v2 que esperan estas confirmaciones de recepción.
Creación y transferencia de mensajes con un adaptador de MLLP
Los mensajes HL7v2 se entregan entre los sistemas de atención y la API de Cloud Healthcare mediante el protocolo de capa inferior mínima (MLLP). Para obtener más información, consulta MLLP y el adaptador de MLLP de Google Cloud Platform. Si deseas obtener instrucciones sobre cómo configurar un adaptador de MLLP para que se comunique de forma segura con la API de Cloud Healthcare, consulta Transmite mensajes HL7v2 a través de conexiones TCP/IP.
Transfiere mensajes de HL7v2
Después de que la API de Cloud Healthcare transfiere el mensaje desde un sistema de atención, la API de Cloud Healthcare genera una respuesta que contiene un campo hl7ack
que contiene un mensaje de HL7v2 codificado en base64 con las siguientes características:
- El tipo de mensaje es
ACK
. - Se revierten la instalación de envío y la de recepción, y se revierten la aplicación de envío y la aplicación de recepción.
- La hora de envío del mensaje es la hora actual, y se genera un ID de control nuevo.
- El valor del campo
MSA.1
define un tipo de respuesta. Un tipo de respuestaAA
indicaApplication Accept
, lo que significa que el mensaje se validó y transfirió de forma correcta. - El valor
MSA.2
contiene el ID de control del mensaje original.
En los siguientes ejemplos, se muestra cómo transferir un mensaje de HL7v2 con el método projects.locations.datasets.hl7V2Stores.messages.ingest
.
curl
Para transferir un mensaje de HL7v2, realiza una solicitud POST
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- Un mensaje
- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud POST
con curl
y un archivo JSON de ejemplo llamado 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"
En la siguiente respuesta de ejemplo, se muestran los detalles de hl7Ack
y del mensaje.
{ "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
Para transferir un mensaje de HL7v2, realiza una solicitud POST
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- Un mensaje
- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud POST
mediante Windows PowerShell y un archivo JSON de muestra llamado 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
En la siguiente respuesta de ejemplo, se muestran los detalles de hl7Ack
y del mensaje.
{ "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
Crea mensajes de HL7v2
En los siguientes ejemplos, se muestra cómo crear un mensaje de HL7v2 con el método projects.locations.datasets.hl7V2Stores.messages.create
.
curl
Para crear un mensaje de HL7v2, realiza una solicitud POST
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- Un mensaje
Si necesitas un mensaje de HL7v2 de muestra para usar con los comandos de muestra, puedes descargar el archivo JSON
hl7v2-sample.json
. - Un token de acceso
En el siguiente ejemplo, se muestra una solicitud POST
con curl
y un archivo JSON de ejemplo llamado 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"
Si la solicitud tiene éxito, se mostrará la respuesta en formato JSON en el servidor:
{ "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": "1970-01-01T00:00:00Z", "patientIds": [ { "value": "14\u0001111", "type": "MRN" }, { "value": "11111111", "type": "MRN" }, { "value": "1111111111", "type": "ORGNMBR" } ] }
PowerShell
Para crear un mensaje de HL7v2, realiza una solicitud POST
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- Un mensaje
Si necesitas un mensaje de HL7v2 de muestra para usar con los comandos de muestra, puedes descargar el archivo JSON
hl7v2-sample.json
. - Un token de acceso
En el siguiente ejemplo, se muestra una solicitud POST
mediante Windows PowerShell y un archivo JSON de muestra llamado 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" | Select-Object -Expand Content
Si la solicitud tiene éxito, se mostrará la respuesta en formato JSON en el servidor:
{ "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": "1970-01-01T00:00:00Z", "patientIds": [ { "value": "14\u0001111", "type": "MRN" }, { "value": "11111111", "type": "MRN" }, { "value": "1111111111", "type": "ORGNMBR" } ] }
Go
Java
Node.js
Python
Codificación y separadores de segmentos de los mensajes de HL7v2
El separador de segmento predeterminado en HL7v2 es un retorno de carro (\r
). La mayoría de los editores de texto usan caracteres de salto de línea (\n
) como separadores de segmentos. Esto produce mensajes HL7v2 que no se pueden transferir a la API de Cloud Healthcare mediante la configuración predeterminada. Para permitir que una tienda HL7v2 transfiera mensajes que usan caracteres de salto de línea como separadores de segmentos, consulta Configura el terminador de segmentos.
Para convertir los caracteres de salto de línea en un archivo a retorno de carro, ejecuta el siguiente comando en una shell de Linux:
sed -z 's/\n/\r/g' INPUT_FILENAME > OUTPUT_FILENAME
Los métodos de transferencia y creación esperan que los mensajes de HL7v2 sean strings codificadas en base64. Para convertir una string en codificación base64, ejecuta el siguiente comando en un shell de Linux:
openssl base64 -A -in ./INPUT_FILENAME -out ./OUTPUT_FILENAME
Configura el terminador de segmentos
Cuando creas o transfieres datos, el formato de mensaje de HL7v2 requiere que los segmentos finalicen con el carácter de retorno, \r
. Puedes configurar un almacén de HL7v2 para aceptar mensajes de HL7v2 con un terminador no estándar, como \n
.
Considera el siguiente mensaje de HL7v2 que usa el \r
predeterminado como terminador de segmentos. Este mensaje se acepta de forma predeterminada cuando creas un almacén de 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
El mensaje siguiente es idéntico al mensaje anterior, excepto que usa \n
como terminador de segmentos:
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
Para almacenar el mensaje con el terminador no estándar, configura el objeto ParserConfig
en la tienda HL7v2 y establece el campo segmentTerminator
en la codificación base64 de \n
.
En los siguientes ejemplos, se muestra cómo configurar segmentTerminator
en ParserConfig
cuando creas un almacén de HL7v2.
Si tienes un almacén de HL7v2 existente, puedes editarlo para proporcionar el cuerpo ParserConfig
. Después de configurar el terminador de segmentos, puedes crear o transferir el mensaje.
curl
Para crear una tienda HL7v2 con el terminador de segmentos configurado en \n
, realiza una solicitud POST
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- Un objeto
parserConfig
con elsegmentTerminator
configurado comoCg==
(la codificación base64 de\n
) - Un token de acceso
En el siguiente ejemplo, se muestra una solicitud POST
mediante curl
.
curl -X POST \ --data "{ 'parserConfig': { 'segmentTerminator': 'Cg==' } }" \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores?hl7V2StoreId=HL7V2_STORE_ID"
Si la solicitud tiene éxito, se mostrará la respuesta en formato JSON en el servidor:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID", "parserConfig": { "segmentTerminator": "Cg==" } }
PowerShell
Para crear una tienda HL7v2 con el terminador de segmentos configurado en \n
, realiza una solicitud POST
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- Un objeto
parserConfig
con elsegmentTerminator
configurado comoCg==
(la codificación base64 de\n
) - Un token de acceso
En el siguiente ejemplo, se muestra una solicitud POST
mediante Windows 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
Si la solicitud tiene éxito, se mostrará la respuesta en formato JSON en el servidor:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID", "parserConfig": { "segmentTerminator": "Cg==" } }
Usa un encabezado de segmento nulo
Un mensaje HL7v2 sin un segmento de encabezado de mensaje (MSH) tiene un encabezado de segmento nulo. Por lo general, un mensaje HL7v2 contiene un MSH que define metadatos como la fuente, el intent, el propósito y el destino del mensaje.
El MSP te permite buscar y filtrar mensajes. Sin embargo, puedes almacenar mensajes que no contienen un MSH configura el objeto ParserConfig
en el almacén HL7v2 y establece el campo allowNullHeader
en true
.
El siguiente mensaje de muestra contiene un segmento de identificación de pacientes (PID), pero sin MSH:
PID|1||21004053^^^^MRN||SULLY^BRIAN||19611209|M|||123 MAIN ST^^MOUNTAIN SPRINGS^CO^80439
En los siguientes ejemplos, se muestra cómo configurar allowNullHeader
en ParserConfig
cuando creas un almacén de HL7v2.
Si tienes un almacén de HL7v2 existente, puedes editarlo y proporcionar el cuerpo ParserConfig
. Después de configurar allowNullHeader
como true
, puedes crear o transferir mensajes con encabezados de segmentos nulos.
curl
Para crear una tienda HL7v2 y mensajes de almacenamiento que no contengan un MSH, realiza una solicitud POST
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- Un objeto
parserConfig
conallowNullHeader
configurado comotrue
- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud POST
mediante curl
.
curl -X POST \ --data "{ 'parserConfig': { 'allowNullHeader': true } }" \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores?hl7V2StoreId=HL7V2_STORE_ID"
Si la solicitud tiene éxito, se mostrará la respuesta en formato JSON en el servidor:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID", "parserConfig": { "allowNullHeader": true } }
PowerShell
Para crear una tienda HL7v2 y mensajes de almacenamiento que no contengan un MSH, realiza una solicitud POST
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- Un objeto
parserConfig
conallowNullHeader
configurado comotrue
- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud POST
mediante Windows 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
Si la solicitud tiene éxito, se mostrará la respuesta en formato JSON en el servidor:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID", "parserConfig": { "allowNullHeader": true } }
Etiqueta un mensaje de HL7v2
Puedes agregar una o más etiquetas de clave-valor a un mensaje. Un caso práctico para las etiquetas es agregar etiquetas de estado a un mensaje con el fin de que una aplicación pueda consultar mensajes por estado.
En los siguientes ejemplos, se muestra cómo agregar etiquetas a un mensaje HL7v2 mediante el método projects.locations.datasets.hl7V2Stores.messages.patch
.
curl
Para agregar etiquetas a un mensaje de HL7v2, realiza una solicitud PATCH
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- El ID del mensaje
- Los datos de la etiqueta que deseas actualizar
- Una máscara de actualización
- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud PATCH
mediante curl
.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ 'labels': { 'KEY' : 'VALUE' } }" "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?updateMask=labels"
Si la solicitud tiene éxito, se mostrará la respuesta en formato JSON en el servidor:
{ "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
Para agregar etiquetas a un mensaje de HL7v2, realiza una solicitud PATCH
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- El ID del mensaje
- Los datos de la etiqueta que deseas actualizar
- Una máscara de actualización
- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud PATCH
mediante Windows 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
Si la solicitud tiene éxito, se mostrará la respuesta en formato JSON en el servidor:
{ "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
Obtén el contenido de los mensajes de HL7v2
Los siguientes ejemplos muestran cómo obtener el contenido de un mensaje de HL7v2 con el método projects.locations.datasets.hl7V2Stores.messages.get
. Para determinar las partes del mensaje que deseas obtener, proporciona el parámetro de consulta view
con una de las siguientes opciones:
BASIC
: Incluye solo el camponame
.RAW_ONLY
: incluye todos los campos del mensaje, excepto el campoparsedData
.PARSED_ONLY
: incluye todos los campos del mensaje, excepto el campodata
.FULL
: Incluye todos los campos del mensaje. Esta es la opción predeterminada.
En los siguientes ejemplos, se muestra cómo obtener el contenido de un mensaje HL7v2 mediante las vistas FULL
, RAW_ONLY
y PARSED_ONLY
.
Usa la vista FULL
No es necesario que configures explícitamente la vista FULL
, ya que FULL
es el valor predeterminado. Sin embargo, en las siguientes muestras de curl
y Windows PowerShell, la vista FULL
se agrega como un parámetro de consulta para su finalización.
curl
Para obtener el contenido de un mensaje HL7v2 mediante la vista FULL
, realiza una solicitud GET
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- El ID del mensaje
FULL
como laview
- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud GET
mediante curl
.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=FULL"
Si la solicitud tiene éxito, se mostrará la respuesta en formato JSON en el servidor:
{ "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
Para obtener el contenido de un mensaje HL7v2 mediante la vista FULL
, realiza una solicitud GET
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- El ID del mensaje
FULL
como laview
- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud GET
mediante Windows 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
Si la solicitud tiene éxito, se mostrará la respuesta en formato JSON en el servidor:
{ "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
Usa la vista RAW_ONLY
En los siguientes ejemplos, se muestra cómo obtener el contenido de un mensaje HL7v2 mediante la vista RAW_ONLY
, que incluye todos los campos del mensaje, excepto parsedData
.
curl
Para obtener el contenido de un mensaje HL7v2 mediante la vista RAW_ONLY
, realiza una solicitud GET
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- El ID del mensaje
RAW_ONLY
como la vista- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud GET
mediante curl
.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=RAW_ONLY"
Si la solicitud tiene éxito, se mostrará la respuesta en formato JSON en el servidor:
{ "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
Para obtener el contenido de un mensaje HL7v2 mediante la vista RAW_ONLY
, realiza una solicitud GET
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- El ID del mensaje
RAW_ONLY
como la vista- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud GET
mediante Windows 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
Si la solicitud tiene éxito, se mostrará la respuesta en formato JSON en el servidor:
{ "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" } ] }
Usa la vista PARSED_ONLY
En los siguientes ejemplos, se muestra cómo obtener el contenido de un mensaje HL7v2 mediante la vista PARSED_ONLY
, que incluye todos los campos del mensaje, excepto data
.
curl
Para obtener el contenido de un mensaje HL7v2 mediante la vista PARSED_ONLY
, realiza una solicitud GET
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- El ID del mensaje
PARSED_ONLY
como la vista- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud GET
mediante curl
.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=PARSED_ONLY"
Si la solicitud tiene éxito, se mostrará la respuesta en formato JSON en el servidor:
{ "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
Para obtener el contenido de un mensaje HL7v2 mediante la vista PARSED_ONLY
, realiza una solicitud GET
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- El ID del mensaje
PARSED_ONLY
como la vista- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud GET
mediante Windows 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
Si la solicitud tiene éxito, se mostrará la respuesta en formato JSON en el servidor:
{ "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 } } ] } }
Usa la vista BASIC
En los siguientes ejemplos, se muestra cómo obtener el contenido de un mensaje HL7v2 mediante la vista BASIC
, que incluye solo el campo name
.
curl
Para obtener el contenido de un mensaje HL7v2 mediante la vista BASIC
, realiza una solicitud GET
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- El ID del mensaje
BASIC
como la vista- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud GET
mediante curl
.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=BASIC"
Si la solicitud tiene éxito, se mostrará la respuesta en formato JSON en el servidor:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID" }
PowerShell
Para obtener el contenido de un mensaje HL7v2 mediante la vista BASIC
, realiza una solicitud GET
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- El ID del mensaje
BASIC
como la vista- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud GET
mediante Windows 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
Si la solicitud tiene éxito, se mostrará la respuesta en formato JSON en el servidor:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID" }
Enumera mensajes de HL7v2
En los siguientes ejemplos, se muestra cómo enumerar los mensajes en un almacén de HL7v2 con el método. Para determinar la información sobre cada mensaje que se incluirá en la lista, especifica el parámetro de consulta view
con una de las siguientes opciones:
BASIC
: Incluye solo el camponame
. Esta es la opción predeterminada.RAW_ONLY
: incluye todos los campos del mensaje, excepto el campoparsedData
.PARSED_ONLY
: incluye todos los campos del mensaje, excepto el campodata
.FULL
: Incluye todos los campos del mensaje.
curl
Para enumerar los mensajes en una tienda HL7v2, realiza una solicitud GET
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- El
view
, uno deBASIC
,RAW_ONLY
,PARSED_ONLY
oFULL
o se omite para usar el valor predeterminado deBASIC
- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud GET
mediante curl
. La solicitud especifica ?view=FULL
para incluir todos los campos del mensaje.
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"
Si la solicitud es exitosa, el servidor muestra un código de estado HTTP 200 OK
y un arreglo de mensajes llamado hl7_v2_messages
. La siguiente respuesta de muestra está truncada.
{ "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
Para enumerar los mensajes en una tienda HL7v2, realiza una solicitud GET
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- El
view
, uno deBASIC
,RAW_ONLY
,PARSED_ONLY
oFULL
o se omite para usar el valor predeterminado deBASIC
- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud GET
mediante Windows PowerShell. La solicitud especifica ?view=FULL
para incluir todos los campos del mensaje.
$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
Si la solicitud tiene éxito, se mostrará la respuesta en formato JSON en el servidor. La respuesta de muestra está truncada.
{ "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
Borra un mensaje de HL7v2
En las siguientes muestras, se muestra cómo borrar un mensaje de HL7v2 con el método projects.locations.datasets.hl7V2Stores.messages.delete
.
curl
Para borrar un mensaje de HL7v2, realiza una solicitud DELETE
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- El ID del mensaje de HL7v2
- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud DELETE
mediante curl
.
curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID"
Si la solicitud es exitosa, el servidor muestra la respuesta de cuerpo vacío en formato JSON:
{}
PowerShell
Para borrar un mensaje de HL7v2, realiza una solicitud DELETE
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- El nombre del almacén de HL7v2
- El ID del mensaje de HL7v2
- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud DELETE
mediante Windows 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
Si la solicitud se realiza con éxito, el servidor muestra el cuerpo de la respuesta vacío en formato JSON:
{}