本页面介绍从简单到复杂的各种用例示例，展示了在 HL7v2 存储区中配置自定义架构解析器的时间和方式。每个用例都包含自定义架构解析器所依据的 HL7v2 消息。
自定义细分终止符和自定义字段
本部分中的示例使用以下方面不符合标准的示例消息：
- 示例消息的细分终止符是换行符 (
\n)，而不是标准回车符 (\r)。 - 示例消息包含一个软件
SFT细分，其中有一个额外的子字段：指定网址https://example.com/healthcare-api/的自定义字段。
MSH|^~\&|My EHR|My Test Facility||My EHR Facility|20150926140551||ORU^R01^ORU_R01|My-LOI_5.0_1.1-NG|T|2.5.1|||AL|AL|||||\n
SFT|Google^D|v1|Healthcare API|1||20190601|https://example.com/healthcare-api/\n
PID|1||PATID5421^^^My MPI^MR||Zhang^Sally^Brian^^^^L||19840611|F||2106-3^White^HL70005|123 Main Street^^Mountain Springs^CO^80439^^H||^PRN^PH^^^203^2290210|||||||||N^Not Hispanic or Latino^HL70189\n
ORC|RE|833582639|3266238193||CM||||20101234567890\n
OBR|1|833582639|3266238193|us-0005^Vital Signs^WinPath^^||20101234567890|20101234567890|||||||20101234567890||||||||20101234567890|||F||1\n
OBX|1|NM|tt-0005-07^MDC_PULS_RATE_NON_INV^MDC^^||52.31|MDC_DIM_BEAT_PER_MIN|50-200||||F|||20101234567890||\n
OBX|2|NM|tt-0005-12^PAIN LEVEL^L^^||1.71|/10|1-10||||F|||20101234567890||\n
OBX|3|NM|tt-0005-09^MDC_TEMP^MDC^^||36.22|MDC_DIM_DEGC|36-38||||F|||20101234567890||\n
使用自定义细分终止符更新 HL7v2 存储区
如果您的消息使用非标准终止符（如自定义细分终止符和自定义字段中提供的示例消息），您必须指定细分终止符。示例消息使用非标准 \n 作为其细分终止符。
以下示例展示了在创建 HL7v2 存储区时，如何在在 ParserConfig 中配置 segmentTerminator。
细分终止符设置为 Cg==，即 \n 的 base-64 编码。
在使用任何请求数据之前，请先进行以下替换：
PROJECT_ID ：您的 Google Cloud 项目 IDLOCATION ：父级数据集的位置DATASET_ID ：HL7v2 存储区的父数据集HL7V2_STORE_ID ：HL7v2 存储区 ID
请求 JSON 正文：
{
"parserConfig": {
"segmentTerminator": "Cg==""
}
}
如需发送请求，请选择以下方式之一：
将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：
cat > request.json << 'EOF'
{
"parserConfig": {
"segmentTerminator": "Cg==""
}
}
EOF然后，执行以下命令以发送 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/HL7V2_STORE_ID "
将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：
@'
{
"parserConfig": {
"segmentTerminator": "Cg==""
}
}
'@ | Out-File -FilePath request.json -Encoding utf8然后，执行以下命令以发送 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/HL7V2_STORE_ID " | Select-Object -Expand Content
您应该收到类似以下内容的 JSON 响应：
响应
{
"name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID ",
"parserConfig": {
"segmentTerminator": "Cg=="
}
}
使用自定义架构更新 HL7v2 存储区
您可以使用以 JSON 格式定义的自定义架构更新 HL7v2 存储区。在配置 SFT 细分中包含额外字段的自定义架构后，您可以注入示例消息。如需了解如何指定自定义元素，请参阅 SchemaPackage。
此示例中指定的配置具有以下行为：
- 重写
SFT细分定义，使其网址字段为字段7。 version过滤条件根据消息细分标头 (MSH) 中的字段确定自定义架构适用于哪些传入消息。如果未提供version过滤条件，则该架构适用于 HL7v2 存储区中的所有 HL7v2 消息。在此示例中，如果发送应用字段包含My EHR，则自定义SFT细分适用。- 此额外字段命名为
7，以便与规范的其余部分保持一致。您还可以将其命名为URL，使其描述更容易理解。
要使用自定义架构更新存储区，请使用 projects.locations.datasets.hl7V2Stores.patch 方法。
在使用任何请求数据之前，请先进行以下替换：
PROJECT_ID ：您的 Google Cloud 项目的 IDLOCATION ：数据集位置DATASET_ID ：HL7v2 存储区的父数据集HL7V2_STORE_ID ：HL7v2 存储区 ID
请求 JSON 正文：
{
"parserConfig": {
"schema": {
"schematizedParsingType": "HARD_FAIL",
"types": [
{
"version": [
{
"mshField": "3.1",
"value": "My EHR"
}
],
"type": [
{
"name": "SFT",
"fields": [
{
"name": "1",
"type": "XON",
"minOccurs": 1,
"maxOccurs": 1
},
{
"name": "2",
"type": "ST",
"minOccurs": 1,
"maxOccurs": 1
},
{
"name": "3",
"type": "ST",
"minOccurs": 1,
"maxOccurs": 1
},
{
"name": "4",
"type": "ST",
"minOccurs": 1,
"maxOccurs": 1
},
{
"name": "5",
"type": "TX",
"maxOccurs": 1
},
{
"name": "6",
"type": "DTM",
"maxOccurs": 1
},
{
"name": "7",
"type": "ST",
"maxOccurs": 1
}
]
}
]
}
]
},
"version": "V3"
}
}
如需发送请求，请选择以下方式之一：
将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：
cat > request.json << 'EOF'
{
"parserConfig": {
"schema": {
"schematizedParsingType": "HARD_FAIL",
"types": [
{
"version": [
{
"mshField": "3.1",
"value": "My EHR"
}
],
"type": [
{
"name": "SFT",
"fields": [
{
"name": "1",
"type": "XON",
"minOccurs": 1,
"maxOccurs": 1
},
{
"name": "2",
"type": "ST",
"minOccurs": 1,
"maxOccurs": 1
},
{
"name": "3",
"type": "ST",
"minOccurs": 1,
"maxOccurs": 1
},
{
"name": "4",
"type": "ST",
"minOccurs": 1,
"maxOccurs": 1
},
{
"name": "5",
"type": "TX",
"maxOccurs": 1
},
{
"name": "6",
"type": "DTM",
"maxOccurs": 1
},
{
"name": "7",
"type": "ST",
"maxOccurs": 1
}
]
}
]
}
]
},
"version": "V3"
}
}
EOF然后，执行以下命令以发送 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=parser_config.schema"
将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：
@'
{
"parserConfig": {
"schema": {
"schematizedParsingType": "HARD_FAIL",
"types": [
{
"version": [
{
"mshField": "3.1",
"value": "My EHR"
}
],
"type": [
{
"name": "SFT",
"fields": [
{
"name": "1",
"type": "XON",
"minOccurs": 1,
"maxOccurs": 1
},
{
"name": "2",
"type": "ST",
"minOccurs": 1,
"maxOccurs": 1
},
{
"name": "3",
"type": "ST",
"minOccurs": 1,
"maxOccurs": 1
},
{
"name": "4",
"type": "ST",
"minOccurs": 1,
"maxOccurs": 1
},
{
"name": "5",
"type": "TX",
"maxOccurs": 1
},
{
"name": "6",
"type": "DTM",
"maxOccurs": 1
},
{
"name": "7",
"type": "ST",
"maxOccurs": 1
}
]
}
]
}
]
},
"version": "V3"
}
}
'@ | Out-File -FilePath request.json -Encoding utf8然后，执行以下命令以发送 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=parser_config.schema" | Select-Object -Expand Content
V3 版本解析器。
响应
{
"name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID ",
"parserConfig": {
"segmentTerminator": "Cg==",
"schema": {
"schematizedParsingType": "HARD_FAIL",
"types": [
{
"version": [
{
"mshField": "3.1",
"value": "My EHR"
}
],
"type": [
{
"name": "SFT",
"fields": [
{
"name": "1",
"type": "XON",
"minOccurs": 1,
"maxOccurs": 1
},
{
"name": "2",
"type": "ST",
"minOccurs": 1,
"maxOccurs": 1
},
{
"name": "3",
"type": "ST",
"minOccurs": 1,
"maxOccurs": 1
},
{
"name": "4",
"type": "ST",
"minOccurs": 1,
"maxOccurs": 1
},
{
"name": "5",
"type": "TX",
"maxOccurs": 1
},
{
"name": "6",
"type": "DTM",
"maxOccurs": 1
},
{
"name": "7",
"type": "ST",
"maxOccurs": 1
}
]
}
]
}
]
}
}
}
使用自定义架构注入和解析 HL7v2 消息
以下示例展示了如何从自定义细分终止符和自定义字段中注入 base-64 编码版本的 HL7v2 消息。如需注入 HL7v2 消息，请使用 projects.locations.datasets.hl7V2Stores.messages.ingest 方法。
在使用任何请求数据之前，请先进行以下替换：
PROJECT_ID ：您的 Google Cloud 项目 IDLOCATION ：父级数据集的位置DATASET_ID ：HL7v2 存储区的父数据集HL7V2_STORE_ID ：HL7v2 存储区 ID
请求 JSON 正文：
{
"message": {
"data": "TVNIfF5+XCZ8TXkgRUhSfE15IFRlc3QgRmFjaWxpdHl8fE15IEVIUiBGYWNpbGl0eXwyMDE1MDkyNjE0MDU1MXx8T1JVXlIwMV5PUlVfUjAxfE15LUxPSV81LjBfMS4xLU5HfFR8Mi41LjF8fHxBTHxBTHx8fHx8ClNGVHxHb29nbGVeRHx2MXxIZWFsdGhjYXJlIEFQSXwxfHwyMDE5MDYwMXxodHRwczovL2V4YW1wbGUuY29tL2hlYWx0aGNhcmUvClBJRHwxfDQwOTAzMzEzMjBeXl5TSU1VTEFUT1IgTVJOXk1STnw0MDkwMzMxMzIwXl5eU0lNVUxBVE9SIE1STl5NUk5+Mjg4ODUyNzE1NF5eXk5IU05CUl5OSFNOTUJSfHxEYXZpc15DaGVsc2VhXl5eTWlzc15eQ1VSUkVOVHx8MjAwOTEwMTcwMDAwMDB8Rnx8fDE4MSBUcmFuc21pc3Npb24gUm9hZF5eTG9uZG9uXl5LRzIyIDlIWF5HQlJeSE9NRXx8MDIwIDgxMjIgOTk0N15IT01FfHx8fHx8fHx8SF5Bc2lhbiBvciBBc2lhbiBCcml0aXNoIC0gSW5kaWFuXl5efHx8fHx8fHwKUFYxfDF8SXxPdGhlcldhcmReTWFpblJvb21eQmVkIDFeU2ltdWxhdGVkIEhvc3BpdGFsXl5CRUReTWFpbiBCdWlsZGluZ140fDI4Ynx8fEMwMDNeQ3VkZHleS2V2aW5eXl5Ecl5eXkRSTkJSXlBSU05MXl5eT1JHRFJ8fHxVUk98fHx8fHx8fHwxMjUxMzI0NzIzMjIzODk0ODc4M15eXl52aXNpdGlkfHx8fHx8fHx8fHx8fHx8fHx8fHx8fEFSUklWRUR8fHwyMDIwMDUwNjE3MDgyMnx8Ck9SQ3xSRXw4MzM1ODI2Mzl8MzI2NjIzODE5M3x8Q018fHx8MjAyMDA1MDYxNzA4MjIKT0JSfDF8ODMzNTgyNjM5fDMyNjYyMzgxOTN8dXMtMDAwNV5WaXRhbCBTaWduc15XaW5QYXRoXl58fDIwMjAwNTA2MTcwODIyfDIwMjAwNTA2MTcwODIyfHx8fHx8fDIwMjAwNTA2MTcwODIyfHx8fHx8fHwyMDIwMDUwNjE3MDgyMnx8fEZ8fDEKT0JYfDF8VFh8dHQtMDAwNS0xMV5PeHlnZW5EZXZeV2VsY2hBbGx5bl5efHxWZW50dXJpfHx8fHx8Rnx8fDIwMjAwNTA2MTcwODIyfHwK"
}
}
如需发送请求，请选择以下方式之一：
将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：
cat > request.json << 'EOF'
{
"message": {
"data": "TVNIfF5+XCZ8TXkgRUhSfE15IFRlc3QgRmFjaWxpdHl8fE15IEVIUiBGYWNpbGl0eXwyMDE1MDkyNjE0MDU1MXx8T1JVXlIwMV5PUlVfUjAxfE15LUxPSV81LjBfMS4xLU5HfFR8Mi41LjF8fHxBTHxBTHx8fHx8ClNGVHxHb29nbGVeRHx2MXxIZWFsdGhjYXJlIEFQSXwxfHwyMDE5MDYwMXxodHRwczovL2V4YW1wbGUuY29tL2hlYWx0aGNhcmUvClBJRHwxfDQwOTAzMzEzMjBeXl5TSU1VTEFUT1IgTVJOXk1STnw0MDkwMzMxMzIwXl5eU0lNVUxBVE9SIE1STl5NUk5+Mjg4ODUyNzE1NF5eXk5IU05CUl5OSFNOTUJSfHxEYXZpc15DaGVsc2VhXl5eTWlzc15eQ1VSUkVOVHx8MjAwOTEwMTcwMDAwMDB8Rnx8fDE4MSBUcmFuc21pc3Npb24gUm9hZF5eTG9uZG9uXl5LRzIyIDlIWF5HQlJeSE9NRXx8MDIwIDgxMjIgOTk0N15IT01FfHx8fHx8fHx8SF5Bc2lhbiBvciBBc2lhbiBCcml0aXNoIC0gSW5kaWFuXl5efHx8fHx8fHwKUFYxfDF8SXxPdGhlcldhcmReTWFpblJvb21eQmVkIDFeU2ltdWxhdGVkIEhvc3BpdGFsXl5CRUReTWFpbiBCdWlsZGluZ140fDI4Ynx8fEMwMDNeQ3VkZHleS2V2aW5eXl5Ecl5eXkRSTkJSXlBSU05MXl5eT1JHRFJ8fHxVUk98fHx8fHx8fHwxMjUxMzI0NzIzMjIzODk0ODc4M15eXl52aXNpdGlkfHx8fHx8fHx8fHx8fHx8fHx8fHx8fEFSUklWRUR8fHwyMDIwMDUwNjE3MDgyMnx8Ck9SQ3xSRXw4MzM1ODI2Mzl8MzI2NjIzODE5M3x8Q018fHx8MjAyMDA1MDYxNzA4MjIKT0JSfDF8ODMzNTgyNjM5fDMyNjYyMzgxOTN8dXMtMDAwNV5WaXRhbCBTaWduc15XaW5QYXRoXl58fDIwMjAwNTA2MTcwODIyfDIwMjAwNTA2MTcwODIyfHx8fHx8fDIwMjAwNTA2MTcwODIyfHx8fHx8fHwyMDIwMDUwNjE3MDgyMnx8fEZ8fDEKT0JYfDF8VFh8dHQtMDAwNS0xMV5PeHlnZW5EZXZeV2VsY2hBbGx5bl5efHxWZW50dXJpfHx8fHx8Rnx8fDIwMjAwNTA2MTcwODIyfHwK"
}
}
EOF然后，执行以下命令以发送 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/HL7V2_STORE_ID /messages:ingest"
将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：
@'
{
"message": {
"data": "TVNIfF5+XCZ8TXkgRUhSfE15IFRlc3QgRmFjaWxpdHl8fE15IEVIUiBGYWNpbGl0eXwyMDE1MDkyNjE0MDU1MXx8T1JVXlIwMV5PUlVfUjAxfE15LUxPSV81LjBfMS4xLU5HfFR8Mi41LjF8fHxBTHxBTHx8fHx8ClNGVHxHb29nbGVeRHx2MXxIZWFsdGhjYXJlIEFQSXwxfHwyMDE5MDYwMXxodHRwczovL2V4YW1wbGUuY29tL2hlYWx0aGNhcmUvClBJRHwxfDQwOTAzMzEzMjBeXl5TSU1VTEFUT1IgTVJOXk1STnw0MDkwMzMxMzIwXl5eU0lNVUxBVE9SIE1STl5NUk5+Mjg4ODUyNzE1NF5eXk5IU05CUl5OSFNOTUJSfHxEYXZpc15DaGVsc2VhXl5eTWlzc15eQ1VSUkVOVHx8MjAwOTEwMTcwMDAwMDB8Rnx8fDE4MSBUcmFuc21pc3Npb24gUm9hZF5eTG9uZG9uXl5LRzIyIDlIWF5HQlJeSE9NRXx8MDIwIDgxMjIgOTk0N15IT01FfHx8fHx8fHx8SF5Bc2lhbiBvciBBc2lhbiBCcml0aXNoIC0gSW5kaWFuXl5efHx8fHx8fHwKUFYxfDF8SXxPdGhlcldhcmReTWFpblJvb21eQmVkIDFeU2ltdWxhdGVkIEhvc3BpdGFsXl5CRUReTWFpbiBCdWlsZGluZ140fDI4Ynx8fEMwMDNeQ3VkZHleS2V2aW5eXl5Ecl5eXkRSTkJSXlBSU05MXl5eT1JHRFJ8fHxVUk98fHx8fHx8fHwxMjUxMzI0NzIzMjIzODk0ODc4M15eXl52aXNpdGlkfHx8fHx8fHx8fHx8fHx8fHx8fHx8fEFSUklWRUR8fHwyMDIwMDUwNjE3MDgyMnx8Ck9SQ3xSRXw4MzM1ODI2Mzl8MzI2NjIzODE5M3x8Q018fHx8MjAyMDA1MDYxNzA4MjIKT0JSfDF8ODMzNTgyNjM5fDMyNjYyMzgxOTN8dXMtMDAwNV5WaXRhbCBTaWduc15XaW5QYXRoXl58fDIwMjAwNTA2MTcwODIyfDIwMjAwNTA2MTcwODIyfHx8fHx8fDIwMjAwNTA2MTcwODIyfHx8fHx8fHwyMDIwMDUwNjE3MDgyMnx8fEZ8fDEKT0JYfDF8VFh8dHQtMDAwNS0xMV5PeHlnZW5EZXZeV2VsY2hBbGx5bl5efHxWZW50dXJpfHx8fHx8Rnx8fDIwMjAwNTA2MTcwODIyfHwK"
}
}
'@ | Out-File -FilePath request.json -Encoding utf8然后，执行以下命令以发送 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/HL7V2_STORE_ID /messages:ingest" | Select-Object -Expand Content
ORU_R01.SFT.7 字段中具有自定义网址的 JSON 字符串。响应
{
"hl7Ack": "TVNIfF5+XCZ8fE15IEVIUiBGYWNpbGl0eXxNeSBFSFJ8TXkgVGVzdCBGYWNpbGl0eXwyMDIwMDUwNjIxNDY1MXx8QUNLfDcwY2IxMjJhLTUxYzctNGFkYy04NzFkLWZlMzJjZTgxYzI5OHxUfDIuNS4xDU1TQXxBQXxNeS1MT0lfNS4wXzEuMS1ORw==",
"message": {
"name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID /messages/HL7V2_MESSAGE_ID ",
"data": "TVNIfF5+XCZ8TXkgRUhSfE15IFRlc3QgRmFjaWxpdHl8fE15IEVIUiBGYWNpbGl0eXwyMDE1MDkyNjE0MDU1MXx8T1JVXlIwMV5PUlVfUjAxfE15LUxPSV81LjBfMS4xLU5HfFR8Mi41LjF8fHxBTHxBTHx8fHx8ClNGVHxHb29nbGVeRHx2MXxIZWFsdGhjYXJlIEFQSXwxfHwyMDE5MDYwMXxodHRwczovL2V4YW1wbGUuY29tL2hlYWx0aGNhcmUvClBJRHwxfHxQQVRJRDU0MjFeXl5NeSBNUEleTVJ8fFpoYW5nXlNhbGx5XkJyaWFuXl5eXkx8fDE5ODQwNjExfEZ8fDIxMDYtM15XaGl0ZV5ITDcwMDA1fDEyMyBNYWluIFN0cmVldF5eTW91bnRhaW4gU3ByaW5nc15DT144MDQzOV5eSHx8XlBSTl5QSF5eXjIwM14yMjkwMjEwfHx8fHx8fHx8Tl5Ob3QgSGlzcGFuaWMgb3IgTGF0aW5vXkhMNzAxODkKT1JDfFJFfDgzMzU4MjYzOXwzMjY2MjM4MTkzfHxDTXx8fHwyMDIwMDUwNjE3MDgyMgpPQlJ8MXw4MzM1ODI2Mzl8MzI2NjIzODE5M3x1cy0wMDA1XlZpdGFsIFNpZ25zXldpblBhdGheXnx8MjAyMDA1MDYxNzA4MjJ8MjAyMDA1MDYxNzA4MjJ8fHx8fHx8MjAyMDA1MDYxNzA4MjJ8fHx8fHx8fDIwMjAwNTA2MTcwODIyfHx8Rnx8MQpPQlh8MXxOTXx0dC0wMDA1LTA3Xk1EQ19QVUxTX1JBVEVfTk9OX0lOVl5NRENeXnx8NTIuMzF8TURDX0RJTV9CRUFUX1BFUl9NSU58NTAtMjAwfHx8fEZ8fHwyMDIwMDUwNjE3MDgyMnx8Ck9CWHwyfE5NfHR0LTAwMDUtMTJeUEFJTiBMRVZFTF5MXl58fDEuNzF8LzEwfDEtMTB8fHx8Rnx8fDIwMjAwNTA2MTcwODIyfHwKT0JYfDN8Tk18dHQtMDAwNS0wOV5NRENfVEVNUF5NRENeXnx8MzYuMjJ8TURDX0RJTV9ERUdDfDM2LTM4fHx8fEZ8fHwyMDIwMDUwNjE3MDgyMnx8Cg==",
"sendFacility": "My Test Facility",
"sendTime": "2015-09-26T14:05:51Z",
"messageType": "ORU",
"createTime": "CREATE_TIME ",
"patientIds": [
{
"value": "PATID5421",
"type": "MR"
}
],
"schematizedData": {
"data": {
\"ORU_R01\": {
\"DSC\": null,
\"MSH\": {
\"0\": \"MSH\",
\"1\": \"|\",
\"2\": \"^~\\\\\\u0026\",
\"3\": {
\"1\": \"My EHR\"
},
\"4\": {
\"1\": \"My Test Facility\"
},
\"5\": null,
\"6\": {
\"1\": \"My EHR Facility\"
},
\"7\": \"20150926140551\",
\"8\": null,
\"9\": {
\"1\": \"ORU\",
\"2\": \"R01\",
\"3\": \"ORU_R01\"
},
\"10\": \"My-LOI_5.0_1.1-NG\",
\"11\": {
\"1\": \"T\"
},
\"12\": {
\"1\": \"2.5.1\"
},
\"13\": null,
\"14\": null,
\"15\": \"AL\",
\"16\": \"AL\",
\"17\": null,
\"18\": null,
\"19\": null,
\"20\": null,
\"21\": null
},
\"PATIENT_RESULT\": [
{
\"ORDER_OBSERVATION\": [
{
\"COMMON_ORDER\": {
\"ORC\": {
\"0\": \"ORC\",
\"1\": \"RE\",
\"2\": {
\"1\": \"833582639\"
},
\"3\": {
\"1\": \"3266238193\"
},
\"4\": null,
\"5\": \"CM\",
\"6\": null,
\"7\": null,
\"8\": null,
\"9\": \"CREATE_TIME\"
},
\"ORDER_DOCUMENT\": null,
\"PRT\": null
},
\"CTD\": null,
\"CTI\": null,
\"FT1\": null,
\"NTE\": null,
\"OBR\": {
\"0\": \"OBR\",
\"1\": \"1\",
\"2\": {
\"1\": \"833582639\"
},
\"3\": {
\"1\": \"3266238193\"
},
\"4\": {
\"1\": \"us-0005\",
\"2\": \"Vital Signs\",
\"3\": \"WinPath\",
\"4\": null,
\"5\": null
},
\"5\": null,
\"6\": \"CREATE_TIME\",
\"7\": \"CREATE_TIME\",
\"8\": null,
\"9\": null,
\"10\": null,
\"11\": null,
\"12\": null,
\"13\": null,
\"14\": \"CREATE_TIME\",
\"15\": null,
\"16\": null,
\"17\": null,
\"18\": null,
\"19\": null,
\"20\": null,
\"21\": null,
\"22\": \"CREATE_TIME\",
\"23\": null,
\"24\": null,
\"25\": \"F\",
\"26\": null,
\"27\": [
{
\"1\": {
\"1\": \"1\"
}
}
]
},
\"OBSERVATION\": [
{
\"NTE\": null,
\"OBX\": {
\"0\": \"OBX\",
\"1\": \"1\",
\"2\": \"NM\",
\"3\": {
\"1\": \"tt-0005-07\",
\"2\": \"MDC_PULS_RATE_NON_INV\",
\"3\": \"MDC\",
\"4\": null,
\"5\": null
},
\"4\": null,
\"5\": [
{
\"1\": {
\"1\": \"52.31\"
}
}
],
\"6\": {
\"1\": \"MDC_DIM_BEAT_PER_MIN\"
},
\"7\": \"50-200\",
\"8\": null,
\"9\": null,
\"10\": null,
\"11\": \"F\",
\"12\": null,
\"13\": null,
\"14\": \"CREATE_TIME\",
\"15\": null,
\"16\": null
},
\"PRT\": null
},
{
\"NTE\": null,
\"OBX\": {
\"0\": \"OBX\",
\"1\": \"2\",
\"2\": \"NM\",
\"3\": {
\"1\": \"tt-0005-12\",
\"2\": \"PAIN LEVEL\",
\"3\": \"L\",
\"4\": null,
\"5\": null
},
\"4\": null,
\"5\": [
{
\"1\": {
\"1\": \"1.71\"
}
}
],
\"6\": {
\"1\": \"/10\"
},
\"7\": \"1-10\",
\"8\": null,
\"9\": null,
\"10\": null,
\"11\": \"F\",
\"12\": null,
\"13\": null,
\"14\": \"CREATE_TIME\",
\"15\": null,
\"16\": null
},
\"PRT\": null
},
{
\"NTE\": null,
\"OBX\": {
\"0\": \"OBX\",
\"1\": \"3\",
\"2\": \"NM\",
\"3\": {
\"1\": \"tt-0005-09\",
\"2\": \"MDC_TEMP\",
\"3\": \"MDC\",
\"4\": null,
\"5\": null
},
\"4\": null,
\"5\": [
{
\"1\": {
\"1\": \"36.22\"
}
}
],
\"6\": {
\"1\": \"MDC_DIM_DEGC\"
},
\"7\": \"36-38\",
\"8\": null,
\"9\": null,
\"10\": null,
\"11\": \"F\",
\"12\": null,
\"13\": null,
\"14\": \"CREATE_TIME\",
\"15\": null,
\"16\": null
},
\"PRT\": null
}
],
\"PRT\": null,
\"SPECIMEN\": null,
\"TIMING_QTY\": null
}
],
\"PATIENT\": {
\"ARV\": null,
\"NK1\": null,
\"NTE\": null,
\"PATIENT_OBSERVATION\": null,
\"PD1\": null,
\"PID\": {
\"0\": \"PID\",
\"1\": \"1\",
\"2\": null,
\"3\": [
{
\"1\": \"PATID5421\",
\"2\": null,
\"3\": null,
\"4\": {
\"1\": \"My MPI\"
},
\"5\": \"MR\"
}
],
\"4\": null,
\"5\": [
{
\"1\": {
\"1\": \"Zhang\"
},
\"2\": \"Sally\",
\"3\": \"Brian\",
\"4\": null,
\"5\": null,
\"6\": null,
\"7\": \"L\"
}
],
\"6\": null,
\"7\": \"19840611\",
\"8\": {
\"1\": \"F\"
},
\"9\": null,
\"10\": [
{
\"1\": \"2106-3\",
\"2\": \"White\",
\"3\": \"HL70005\"
}
],
\"11\": [
{
\"1\": {
\"1\": \"123 Main Street\"
},
\"2\": null,
\"3\": \"Mountain Springs\",
\"4\": \"CO\",
\"5\": \"80439\",
\"6\": null,
\"7\": \"H\"
}
],
\"12\": null,
\"13\": [
{
\"1\": null,
\"2\": \"PRN\",
\"3\": \"PH\",
\"4\": null,
\"5\": null,
\"6\": \"203\",
\"7\": \"2290210\"
}
],
\"14\": null,
\"15\": null,
\"16\": null,
\"17\": null,
\"18\": null,
\"19\": null,
\"20\": null,
\"21\": null,
\"22\": [
{
\"1\": \"N\",
\"2\": \"Not Hispanic or Latino\",
\"3\": \"HL70189\"
}
]
},
\"PRT\": null,
\"VISIT\": null
}
}
],
\"SFT\": [
{
\"0\": \"SFT\",
\"1\": {
\"1\": \"Google\",
\"2\": {
\"1\": \"D\"
}
},
\"2\": \"v1\",
\"3\": \"Healthcare API\",
\"4\": \"1\",
\"5\": {
\"1\": {
\"1\": \"\"
}
},
\"6\": \"20190601\",
\"7\": \"https://example.com/healthcare-api/\"
}
],
\"UAC\": null
}
}"
}
}
}
解析器启发法使用自定义细分
以下示例展示了 HL7v2 解析器如何使用启发法解析在 HL7v2 存储区中具有次要配置的消息。
此示例使用以下 HL7v2 消息：
MSH|^~\&$|||||||ADT^A01|||2.1
EVN|\P\\L\\H\\N\
PID|1
ZCD|1
HL7v2 消息是非标准的，因为未在 HL7v2 标准中定义 ZCD 细分。
创建使用自定义架构的 HL7v2 存储区
如需使用自定义架构创建 HL7v2 存储区，请使用 projects.locations.datasets.hl7V2Stores.create 方法。
请注意，该配置仅使用以下三个字段，且不包含 schemas 或 types 数组：
"unexpectedSegmentHandling": "PARSE""ignoreMinOccurs": "true""schematizedParsingType": "HARD_FAIL"
如果未指定有关消息定义或其类型的任何内容，则 HL7v2 解析器会确定消息是 ADT_A01 消息，并解析 MSH、EVN 和 PID 细分以及自定义 ZCD 细分。
在使用任何请求数据之前，请先进行以下替换：
PROJECT_ID ：您的 Google Cloud 项目 IDLOCATION ：父级数据集的位置DATASET_ID ：HL7v2 存储区的父数据集HL7V2_STORE_ID ：HL7v2 存储区 ID
请求 JSON 正文：
{
"parserConfig": {
"schema": {
"unexpectedSegmentHandling": "PARSE",
"ignoreMinOccurs": "true",
"schematizedParsingType": "HARD_FAIL"
}
}
}
如需发送请求，请选择以下方式之一：
将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：
cat > request.json << 'EOF'
{
"parserConfig": {
"schema": {
"unexpectedSegmentHandling": "PARSE",
"ignoreMinOccurs": "true",
"schematizedParsingType": "HARD_FAIL"
}
}
}
EOF然后，执行以下命令以发送 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 "
将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：
@'
{
"parserConfig": {
"schema": {
"unexpectedSegmentHandling": "PARSE",
"ignoreMinOccurs": "true",
"schematizedParsingType": "HARD_FAIL"
}
}
}
'@ | Out-File -FilePath request.json -Encoding utf8然后，执行以下命令以发送 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
您应该收到类似以下内容的 JSON 响应：
响应
{
"name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID ",
"parserConfig": {
"schema": {
"schematizedParsingType": "HARD_FAIL",
"ignoreMinOccurs": true,
"unexpectedSegmentHandling": "PARSE"
}
}
}
使用自定义架构注入和解析 HL7v2 消息
注入 base 64 编码版本的 HL7v2 消息。
在使用任何请求数据之前，请先进行以下替换：
PROJECT_ID ：您的 Google Cloud 项目 IDLOCATION ：父级数据集的位置DATASET_ID ：HL7v2 存储区的父数据集HL7V2_STORE_ID ：HL7v2 存储区 ID
请求 JSON 正文：
{
"message": {
"data": "TVNIfF5+XCYkfHx8fHx8fEFEVF5BMDF8fHwyLjENRVZOfFxQXExcSFxOXA1QSUR8MQ1aQ0R8MQ=="
}
}
如需发送请求，请选择以下方式之一：
将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：
cat > request.json << 'EOF'
{
"message": {
"data": "TVNIfF5+XCYkfHx8fHx8fEFEVF5BMDF8fHwyLjENRVZOfFxQXExcSFxOXA1QSUR8MQ1aQ0R8MQ=="
}
}
EOF然后，执行以下命令以发送 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/HL7V2_STORE_ID /messages:ingest"
将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：
@'
{
"message": {
"data": "TVNIfF5+XCYkfHx8fHx8fEFEVF5BMDF8fHwyLjENRVZOfFxQXExcSFxOXA1QSUR8MQ1aQ0R8MQ=="
}
}
'@ | Out-File -FilePath request.json -Encoding utf8然后，执行以下命令以发送 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/HL7V2_STORE_ID /messages:ingest" | Select-Object -Expand Content
您应该收到类似以下内容的 JSON 响应：
响应
{
"hl7Ack": "TVNIfF5+XCZ8fHx8fDIwMjIwMzE0MjExMTM1fHxBQ0t8Mjk1MmMxNDctZjczNS00MzczLWFmOTktNDgzNDRlODIwODJkfHwyLjENTVNBfEFB",
"message": {
"name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID /messages/HL7V2_MESSAGE_ID ",
"data": "TVNIfF5+XCYkfHx8fHx8fEFEVF5BMDF8fHwyLjENRVZOfFxQXExcSFxOXA1QSUR8MQ1aQ0R8MQ==",
"messageType": "ADT",
"createTime": "CREATE_TIME ",
"schematizedData": {
"data": "{\"ADT_A01\":{\"ACC\":null,\"AL1\":null,\"ARV_1\":null,\"ARV_2\":null,\"DB1\":null,\"DG1\":null,\"DRG\":null,\"EVN\":[{\"0\":\"EVN\",\"1\":\"LN\\\\\"}],\"GT1\":null,\"INSURANCE\":null,\"MSH\":{\"0\":\"MSH\",\"1\":\"|\",\"10\":null,\"11\":null,\"12\":{\"1\":\"2.1\"},\"2\":\"^~\\\\\\u0026$\",\"3\":null,\"4\":null,\"5\":null,\"6\":null,\"7\":null,\"8\":null,\"9\":{\"1\":\"ADT\",\"2\":\"A01\"}},\"NK1\":null,\"OBX\":null,\"PD1\":null,\"PDA\":null,\"PID\":[{\"0\":\"PID\",\"1\":\"1\"}],\"PROCEDURE\":null,\"PV1\":null,\"PV2\":null,\"ROL_1\":null,\"ROL_2\":null,\"SFT\":null,\"UAC\":null,\"UB1\":null,\"UB2\":null,\"ZCD\":[{\"0\":[{\"1\":{\"1\":\"ZCD\"}}],\"1\":[{\"1\":{\"1\":\"1\"}}]}]}}"
}
}
}
解析器使用缺少字段的 HL7v2 消息
以下示例展示了如何使用类型和组定义来解析 HL7v2 消息：
MSH|^~\&|||||20100101000000||ORM^O01^O01|23701|1|2.3||
PID|11|SMITH
PV1|11
PID|22|JOHN
PV1|22
ORC|3
OBX|4
NTE|5
NTE|6
OBX|7
NTE|8
HL7v2 消息是非标准的，因为它仅使用除 MSH 之外的其他所有细分中的几个字段（在某些情况下是单个字段）。例如，HL7v2 标准要求 PID 细分包含患者的主要语言、地址和出生日期等字段，但示例消息中的 PID 细分仅包含患者的 ID 以及患者的名字或姓氏。
HL7v2 消息遵循 HL7 语法，但几乎完全自定义。
创建使用自定义架构的 HL7v2 存储区
在使用自定义架构创建 HL7v2 存储区之前，请仔细查看架构中使用的 ParserConfig 对象的以下属性：
schemas 数组：
mshField设置为消息中第一个细分的第 12 个字段（由竖线|字符分隔）。该字段的值为2.3。因此，为 HL7v2 存储区提供的schema将应用于任何与mshField和value对应的 HL7v2 消息。- 消息类型
ORM通过包含以下信息的members数组指定：ORM消息的细分类型为消息细分标头，或MSH- 一个名为“患者”的组，其
maxOccurs为 2。- 另一个嵌套在“患者”组下的
members组，其中包含与“患者”组匹配的细分类型。该细分类型为PID。 - 另一个名为“患者就诊”的组。与“患者”类似，存在与“患者就诊”匹配的细分。该细分类型为
PV1。
- 另一个嵌套在“患者”组下的
- 一个名为“订单”的组，其出现次数没有上限或下限。
- 另一个嵌套在“订单”组下的
members组，其中包含与“订单”组匹配的细分类型。该细分类型为ORC。 - 另一个名为“观察对象”的组，它有自己的
members数组。members数组包含两个映射到“观察对象”的细分：OBX和NTE。OBX的maxOccurs为1。
- 另一个嵌套在“订单”组下的
types 数组：
- 与
schemas数组类似，mshField设置为消息中第一个细分的第 12 个字段（由竖线|字符分隔）。该字段的值为2.3。因此，为 HL7v2 存储区提供的types将应用于任何与mshField和value对应的 HL7v2 消息。 ST和SI数据类型声明为STRING基元。由于仅声明了ST和SI，因此您可以得出消息没有自定义类型的结论。Patient组的maxOccurs为2，细分类型为PID，因此字段PID中声明了两种类型。这两种类型都是SI。- 下表列出了其余细分类型及其相关字段和类型。其余的所有细分只出现一次，并使用
SI类型。
在使用任何请求数据之前，请先进行以下替换：
PROJECT_ID ：您的 Google Cloud 项目 IDLOCATION ：父级数据集的位置DATASET_ID ：HL7v2 存储区的父数据集HL7V2_STORE_ID ：HL7v2 存储区 ID
请求 JSON 正文：
{
"parserConfig": {
"schema": {
"schematizedParsingType": "HARD_FAIL",
"unexpectedSegmentHandling": "PARSE",
"schemas": [
{
"version": [
{
"mshField": "12",
"value": "2.3"
}
],
"messageSchemaConfigs": {
"ORM_O01": {
"name": "ORM_O01",
"members": [
{
"segment": {
"type": "MSH"
}
},
{
"group": {
"name": "Patient",
"maxOccurs": 2,
"members": [
{
"segment": {
"type": "PID"
}
},
{
"group": {
"name": "Patient Visit",
"members": [
{
"segment": {
"type": "PV1"
}
}
]
}
}
]
}
},
{
"group": {
"name": "Order",
"members": [
{
"segment": {
"type": "ORC"
}
},
{
"group": {
"name": "Observation",
"members": [
{
"segment": {
"type": "OBX",
"maxOccurs": 1
}
},
{
"segment": {
"type": "NTE"
}
}
]
}
}
]
}
}
]
}
}
}
],
"types": [
{
"version": [
{
"mshField": "12",
"value": "2.3"
}
],
"type": [
{
"name": "ST",
"primitive": "STRING"
},
{
"name": "SI",
"primitive": "STRING"
},
{
"name": "PID",
"fields": [
{
"name": "1",
"type": "SI"
},
{
"name": "2",
"type": "SI"
}
]
},
{
"name": "PV1",
"fields": [
{
"name": "1",
"type": "SI"
}
]
},
{
"name": "ORC",
"fields": [
{
"name": "1",
"type": "SI"
}
]
},
{
"name": "OBX",
"fields": [
{
"name": "1",
"type": "SI"
}
]
},
{
"name": "NTE",
"fields": [
{
"name": "1",
"type": "SI"
}
]
}
]
}
],
},
"version": "V3"
}
}
如需发送请求，请选择以下方式之一：
将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：
cat > request.json << 'EOF'
{
"parserConfig": {
"schema": {
"schematizedParsingType": "HARD_FAIL",
"unexpectedSegmentHandling": "PARSE",
"schemas": [
{
"version": [
{
"mshField": "12",
"value": "2.3"
}
],
"messageSchemaConfigs": {
"ORM_O01": {
"name": "ORM_O01",
"members": [
{
"segment": {
"type": "MSH"
}
},
{
"group": {
"name": "Patient",
"maxOccurs": 2,
"members": [
{
"segment": {
"type": "PID"
}
},
{
"group": {
"name": "Patient Visit",
"members": [
{
"segment": {
"type": "PV1"
}
}
]
}
}
]
}
},
{
"group": {
"name": "Order",
"members": [
{
"segment": {
"type": "ORC"
}
},
{
"group": {
"name": "Observation",
"members": [
{
"segment": {
"type": "OBX",
"maxOccurs": 1
}
},
{
"segment": {
"type": "NTE"
}
}
]
}
}
]
}
}
]
}
}
}
],
"types": [
{
"version": [
{
"mshField": "12",
"value": "2.3"
}
],
"type": [
{
"name": "ST",
"primitive": "STRING"
},
{
"name": "SI",
"primitive": "STRING"
},
{
"name": "PID",
"fields": [
{
"name": "1",
"type": "SI"
},
{
"name": "2",
"type": "SI"
}
]
},
{
"name": "PV1",
"fields": [
{
"name": "1",
"type": "SI"
}
]
},
{
"name": "ORC",
"fields": [
{
"name": "1",
"type": "SI"
}
]
},
{
"name": "OBX",
"fields": [
{
"name": "1",
"type": "SI"
}
]
},
{
"name": "NTE",
"fields": [
{
"name": "1",
"type": "SI"
}
]
}
]
}
],
},
"version": "V3"
}
}
EOF然后，执行以下命令以发送 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 "
将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：
@'
{
"parserConfig": {
"schema": {
"schematizedParsingType": "HARD_FAIL",
"unexpectedSegmentHandling": "PARSE",
"schemas": [
{
"version": [
{
"mshField": "12",
"value": "2.3"
}
],
"messageSchemaConfigs": {
"ORM_O01": {
"name": "ORM_O01",
"members": [
{
"segment": {
"type": "MSH"
}
},
{
"group": {
"name": "Patient",
"maxOccurs": 2,
"members": [
{
"segment": {
"type": "PID"
}
},
{
"group": {
"name": "Patient Visit",
"members": [
{
"segment": {
"type": "PV1"
}
}
]
}
}
]
}
},
{
"group": {
"name": "Order",
"members": [
{
"segment": {
"type": "ORC"
}
},
{
"group": {
"name": "Observation",
"members": [
{
"segment": {
"type": "OBX",
"maxOccurs": 1
}
},
{
"segment": {
"type": "NTE"
}
}
]
}
}
]
}
}
]
}
}
}
],
"types": [
{
"version": [
{
"mshField": "12",
"value": "2.3"
}
],
"type": [
{
"name": "ST",
"primitive": "STRING"
},
{
"name": "SI",
"primitive": "STRING"
},
{
"name": "PID",
"fields": [
{
"name": "1",
"type": "SI"
},
{
"name": "2",
"type": "SI"
}
]
},
{
"name": "PV1",
"fields": [
{
"name": "1",
"type": "SI"
}
]
},
{
"name": "ORC",
"fields": [
{
"name": "1",
"type": "SI"
}
]
},
{
"name": "OBX",
"fields": [
{
"name": "1",
"type": "SI"
}
]
},
{
"name": "NTE",
"fields": [
{
"name": "1",
"type": "SI"
}
]
}
]
}
],
},
"version": "V3"
}
}
'@ | Out-File -FilePath request.json -Encoding utf8然后，执行以下命令以发送 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
您应该收到类似以下内容的 JSON 响应：
响应
{
"name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID ",
"parserConfig": {
"schema": {
"schematizedParsingType": "HARD_FAIL",
"schemas": [
{
"version": [
{
"mshField": "12",
"value": "2.3"
}
],
"messageSchemaConfigs": {
"ORM_O01": {
"name": "ORM_O01",
"members": [
{
"segment": {
"type": "MSH"
}
},
{
"group": {
"name": "Patient",
"maxOccurs": 2,
"members": [
{
"segment": {
"type": "PID"
}
},
{
"group": {
"name": "Patient Visit",
"members": [
{
"segment": {
"type": "PV1"
}
}
]
}
}
]
}
},
{
"group": {
"name": "Order",
"members": [
{
"segment": {
"type": "ORC"
}
},
{
"group": {
"name": "Observation",
"members": [
{
"segment": {
"type": "OBX",
"maxOccurs": 1
}
},
{
"segment": {
"type": "NTE"
}
}
]
}
}
]
}
}
]
}
}
}
],
"types": [
{
"version": [
{
"mshField": "12",
"value": "2.3"
}
],
"type": [
{
"name": "ST",
"primitive": "STRING"
},
{
"name": "SI",
"primitive": "STRING"
},
{
"name": "PID",
"fields": [
{
"name": "1",
"type": "SI"
},
{
"name": "2",
"type": "SI"
}
]
},
{
"name": "PV1",
"fields": [
{
"name": "1",
"type": "SI"
}
]
},
{
"name": "ORC",
"fields": [
{
"name": "1",
"type": "SI"
}
]
},
{
"name": "OBX",
"fields": [
{
"name": "1",
"type": "SI"
}
]
},
{
"name": "NTE",
"fields": [
{
"name": "1",
"type": "SI"
}
]
}
]
}
],
"unexpectedSegmentHandling": "PARSE"
},
"version": "V3"
}
}
使用自定义架构注入和解析 HL7v2 消息
注入 base64 编码版本的 HL7v2 消息。
在使用任何请求数据之前，请先进行以下替换：
PROJECT_ID ：您的 Google Cloud 项目 IDLOCATION ：父级数据集的位置DATASET_ID ：HL7v2 存储区的父数据集HL7V2_STORE_ID ：HL7v2 存储区 ID
请求 JSON 正文：
{
"message": {
"data": "TVNIfF5+XCZ8fHx8fDIwMTAwMTAxMDAwMDAwfHxPUk1eTzAxXk8wMXwyMzcwMXwxfDIuM3x8DVBJRHwxMXxTTUlUSA1QVjF8MTENUElEfDIyfEpPSE4NUFYxfDIyDU9SQ3wzDU9CWHw0DU5URXw1DU5URXw2DU9CWHw3DU5URXw4"
}
}
如需发送请求，请选择以下方式之一：
将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：
cat > request.json << 'EOF'
{
"message": {
"data": "TVNIfF5+XCZ8fHx8fDIwMTAwMTAxMDAwMDAwfHxPUk1eTzAxXk8wMXwyMzcwMXwxfDIuM3x8DVBJRHwxMXxTTUlUSA1QVjF8MTENUElEfDIyfEpPSE4NUFYxfDIyDU9SQ3wzDU9CWHw0DU5URXw1DU5URXw2DU9CWHw3DU5URXw4"
}
}
EOF然后，执行以下命令以发送 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/HL7V2_STORE_ID /messages:ingest"
将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：
@'
{
"message": {
"data": "TVNIfF5+XCZ8fHx8fDIwMTAwMTAxMDAwMDAwfHxPUk1eTzAxXk8wMXwyMzcwMXwxfDIuM3x8DVBJRHwxMXxTTUlUSA1QVjF8MTENUElEfDIyfEpPSE4NUFYxfDIyDU9SQ3wzDU9CWHw0DU5URXw1DU5URXw2DU9CWHw3DU5URXw4"
}
}
'@ | Out-File -FilePath request.json -Encoding utf8然后，执行以下命令以发送 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/HL7V2_STORE_ID /messages:ingest" | Select-Object -Expand Content
您应该收到类似以下内容的 JSON 响应：
响应
{
"hl7Ack": "TVNIfF5+XCZ8fHx8fDIwMjIwMzE0MjE1NzU3fHxBQ0t8NGU4NjIyMDMtZTA3OC00YjhlLWExOWYtNzA3ZjhkNTk5OTY2fDF8Mi4zDU1TQXxBQXwyMzcwMQ==",
"message": {
"name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /hl7V2Stores/HL7V2_STORE_ID /messages/HL7V2_MESSAGE_ID ",
"data": "TVNIfF5+XCZ8fHx8fDIwMTAwMTAxMDAwMDAwfHxPUk1eTzAxXk8wMXwyMzcwMXwxfDIuM3x8DVBJRHwxMXxTTUlUSA1QVjF8MTENUElEfDIyfEpPSE4NUFYxfDIyDU9SQ3wzDU9CWHw0DU5URXw1DU5URXw2DU9CWHw3DU5URXw4",
"sendTime": "2010-01-01T00:00:00Z",
"messageType": "ORM",
"createTime": "CREATE_TIME ",
"schematizedData": {
"data": {
"ORM_O01": [
{
"MSH": [
{
"0": "MSH",
"1": "|",
"2": "^~\\\\\\u0026",
"3": null,
"4": null,
"5": null,
"6": null,
"7": "20100101000000",
"8": null,
"9": {
"1": "ORM",
"2": "O01",
"3": "O01"
},
"10": "23701",
"11": {
"1": "1"
},
"12": {
"1": "2.3"
},
"13": null,
"14": null
}
],
"Order": [
{
"ORC": [
{
"0": "ORC",
"1": [
"3"
]
}
],
"Observation": [
{
"NTE": [
{
"0": "NTE",
"1": [
"5"
]
},
{
"0": "NTE",
"1": [
"6"
]
}
],
"OBX": {
"0": "OBX",
"1": [
"4"
]
}
},
{
"NTE": [
{
"0": "NTE",
"1": [
"8"
]
}
],
"OBX": {
"0": "OBX",
"1": [
"7"
]
}
}
]
}
],
"Patient": [
{
"PID": [
{
"0": "PID",
"1": [
"11"
],
"2": [
"SMITH"
]
}
],
"Patient Visit": [
{
"PV1": [
{
"0": "PV1",
"1": [
"11"
]
}
]
}
]
},
{
"PID": [
{
"0": "PID",
"1": [
"22"
],
"2": [
"JOHN"
]
}
],
"Patient Visit": [
{
"PV1": [
{
"0": "PV1",
"1": [
"22"
]
}
]
}
]
}
]
}
]
}
}
}
}
如需查看响应中 data 字段的可读版本，请展开以下部分：
展开
{
"data": {
"ORM_O01": [
{
"MSH": [
{
"0": "MSH",
"1": "|",
"2": "^~\\\\\\u0026",
"3": null,
"4": null,
"5": null,
"6": null,
"7": "20100101000000",
"8": null,
"9": {
"1": "ORM",
"2": "O01",
"3": "O01"
},
"10": "23701",
"11": {
"1": "1"
},
"12": {
"1": "2.3"
},
"13": null,
"14": null
}
],
"Order": [
{
"ORC": [
{
"0": "ORC",
"1": [
"3"
]
}
],
"Observation": [
{
"NTE": [
{
"0": "NTE",
"1": [
"5"
]
},
{
"0": "NTE",
"1": [
"6"
]
}
],
"OBX": {
"0": "OBX",
"1": [
"4"
]
}
},
{
"NTE": [
{
"0": "NTE",
"1": [
"8"
]
}
],
"OBX": {
"0": "OBX",
"1": [
"7"
]
}
}
]
}
],
"Patient": [
{
"PID": [
{
"0": "PID",
"1": [
"11"
],
"2": [
"SMITH"
]
}
],
"Patient Visit": [
{
"PV1": [
{
"0": "PV1",
"1": [
"11"
]
}
]
}
]
},
{
"PID": [
{
"0": "PID",
"1": [
"22"
],
"2": [
"JOHN"
]
}
],
"Patient Visit": [
{
"PV1": [
{
"0": "PV1",
"1": [
"22"
]
}
]
}
]
}
]
}
]
}
}