이 페이지에서는 HL7v2 저장소에서 커스텀 스키마 파서를 구성하는 시기와 방법을 보여주는 간단한 사례부터 복잡한 사례까지 다양한 예시를 제공합니다. 각 사용 사례에는 커스텀 스키마 파서를 기반으로 하는 HL7v2 메시지가 포함됩니다.
커스텀 세그먼트 종료자 및 커스텀 필드
이 섹션의 샘플은 다음과 같이 비표준 샘플 메시지를 사용합니다.
- 샘플 메시지의 세그먼트 구분 기호는 표준 캐리지 리턴(
\r
)이 아닌 새 줄(\n
)입니다. - 샘플 메시지에는 URL
https://example.com/healthcare-api/
를 지정하는 커스텀 필드인 추가 하위 필드가 있는 소프트웨어(SFT
) 세그먼트가 있습니다.
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
를 구성하는 방법을 보여줍니다.
세그먼트 종결자는 \n
의 base64 인코딩인 Cg==
로 설정됩니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트 ID
- LOCATION: 상위 데이터 세트의 위치
- DATASET_ID: HL7v2 저장소의 상위 데이터 세트
- HL7V2_STORE_ID: HL7v2 저장소 ID
JSON 요청 본문:
{ "parserConfig": { "segmentTerminator": "Cg=="" } }
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 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"
PowerShell
요청 본문을 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 응답이 표시됩니다.
커스텀 스키마를 사용하여 HL7v2 저장소 업데이트
JSON 형식으로 정의된 커스텀 스키마로 HL7v2 저장소를 업데이트할 수 있습니다.
SFT
세그먼트에 추가 필드가 포함된 커스텀 스키마를 구성한 후 샘플 메시지를 수집할 수 있습니다.
커스텀 필드 지정에 관한 자세한 내용은 SchemaPackage
를 참조하세요.
이 샘플에 지정된 구성의 동작은 다음과 같습니다.
- URL 필드를 필드
7
로 포함하도록SFT
세그먼트 정의를 다시 작성합니다. version
필터는 메시지 세그먼트 헤더(MSH
)의 필드를 기준으로 커스텀 스키마가 적용되는 수신 메시지를 결정합니다.version
필터를 제공하지 않으면 스키마는 HL7v2 저장소의 모든 HL7v2 메시지에 적용됩니다. 이 샘플에서 전송 애플리케이션 필드에My EHR
이 포함되어 있으면 커스텀SFT
세그먼트가 적용됩니다.- 나머지 사양과의 일관성을 위해 추가 필드의 필드 이름은
7
로 지정됩니다.URL
이라는 이름을 사용하여 더 구체적으로 설명할 수도 있습니다.
커스텀 스키마로 저장소를 업데이트하려면 projects.locations.datasets.hl7V2Stores.patch
메서드를 사용합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트의 ID
- LOCATION: 데이터 세트 위치
- 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" } }
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 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"
PowerShell
요청 본문을 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
버전의 파서를 사용합니다.
커스텀 스키마를 사용하여 HL7v2 메시지 수집 및 파싱
다음 샘플은 커스텀 세그먼트 종결자 및 커스텀 필드에서 HL7v2 메시지의 base64 인코딩 버전을 수집하는 방법을 보여줍니다.
HL7v2 메시지를 수집하려면 projects.locations.datasets.hl7V2Stores.messages.ingest
메서드를 사용합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트 ID
- LOCATION: 상위 데이터 세트의 위치
- DATASET_ID: HL7v2 저장소의 상위 데이터 세트
- HL7V2_STORE_ID: HL7v2 저장소 ID
JSON 요청 본문:
{ "message": { "data": "TVNIfF5+XCZ8TXkgRUhSfE15IFRlc3QgRmFjaWxpdHl8fE15IEVIUiBGYWNpbGl0eXwyMDE1MDkyNjE0MDU1MXx8T1JVXlIwMV5PUlVfUjAxfE15LUxPSV81LjBfMS4xLU5HfFR8Mi41LjF8fHxBTHxBTHx8fHx8ClNGVHxHb29nbGVeRHx2MXxIZWFsdGhjYXJlIEFQSXwxfHwyMDE5MDYwMXxodHRwczovL2V4YW1wbGUuY29tL2hlYWx0aGNhcmUvClBJRHwxfDQwOTAzMzEzMjBeXl5TSU1VTEFUT1IgTVJOXk1STnw0MDkwMzMxMzIwXl5eU0lNVUxBVE9SIE1STl5NUk5+Mjg4ODUyNzE1NF5eXk5IU05CUl5OSFNOTUJSfHxEYXZpc15DaGVsc2VhXl5eTWlzc15eQ1VSUkVOVHx8MjAwOTEwMTcwMDAwMDB8Rnx8fDE4MSBUcmFuc21pc3Npb24gUm9hZF5eTG9uZG9uXl5LRzIyIDlIWF5HQlJeSE9NRXx8MDIwIDgxMjIgOTk0N15IT01FfHx8fHx8fHx8SF5Bc2lhbiBvciBBc2lhbiBCcml0aXNoIC0gSW5kaWFuXl5efHx8fHx8fHwKUFYxfDF8SXxPdGhlcldhcmReTWFpblJvb21eQmVkIDFeU2ltdWxhdGVkIEhvc3BpdGFsXl5CRUReTWFpbiBCdWlsZGluZ140fDI4Ynx8fEMwMDNeQ3VkZHleS2V2aW5eXl5Ecl5eXkRSTkJSXlBSU05MXl5eT1JHRFJ8fHxVUk98fHx8fHx8fHwxMjUxMzI0NzIzMjIzODk0ODc4M15eXl52aXNpdGlkfHx8fHx8fHx8fHx8fHx8fHx8fHx8fEFSUklWRUR8fHwyMDIwMDUwNjE3MDgyMnx8Ck9SQ3xSRXw4MzM1ODI2Mzl8MzI2NjIzODE5M3x8Q018fHx8MjAyMDA1MDYxNzA4MjIKT0JSfDF8ODMzNTgyNjM5fDMyNjYyMzgxOTN8dXMtMDAwNV5WaXRhbCBTaWduc15XaW5QYXRoXl58fDIwMjAwNTA2MTcwODIyfDIwMjAwNTA2MTcwODIyfHx8fHx8fDIwMjAwNTA2MTcwODIyfHx8fHx8fHwyMDIwMDUwNjE3MDgyMnx8fEZ8fDEKT0JYfDF8VFh8dHQtMDAwNS0xMV5PeHlnZW5EZXZeV2VsY2hBbGx5bl5efHxWZW50dXJpfHx8fHx8Rnx8fDIwMjAwNTA2MTcwODIyfHwK" } }
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 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"
PowerShell
요청 본문을 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
필드에 커스텀 URL이 있는 JSON 문자열이 포함됩니다.
커스텀 세그먼트를 사용하는 파서 휴리스틱
다음 샘플은 HL7v2 파서가 HL7v2 저장소에서 소규모 구성으로 메시지를 파싱하는 데 휴리스틱을 사용하는 방법을 보여줍니다.
이 샘플은 다음 HL7v2 메시지를 사용합니다.
MSH|^~\&$|||||||ADT^A01|||2.1
EVN|\P\\L\\H\\N\
PID|1
ZCD|1
ZCD
세그먼트가 HL7v2 표준에 정의되어 있지 않으므로 HL7v2 메시지는 비표준입니다.
커스텀 스키마를 사용하여 HL7v2 저장소 만들기
커스텀 스키마를 사용하여 HL7v2 저장소를 만들려면 projects.locations.datasets.hl7V2Stores.create
메서드를 사용합니다.
이 구성에서는 다음 필드 3개만 사용하고 schemas
또는 types
배열은 사용하지 않습니다.
"unexpectedSegmentHandling": "PARSE"
"ignoreMinOccurs": "true"
"schematizedParsingType": "HARD_FAIL"
메시지 정의 또는 유형에 대한 다른 내용을 지정하지 않고 HL7v2 파서는 메시지가 ADT_A01
메시지라고 판단하고 MSH
, EVN
, PID
세그먼트 및 커스텀 ZCD
세그먼트를 파싱합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트 ID
- LOCATION: 상위 데이터 세트의 위치
- DATASET_ID: HL7v2 저장소의 상위 데이터 세트
- HL7V2_STORE_ID: HL7v2 저장소 ID
JSON 요청 본문:
{ "parserConfig": { "schema": { "unexpectedSegmentHandling": "PARSE", "ignoreMinOccurs": "true", "schematizedParsingType": "HARD_FAIL" } } }
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 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"
PowerShell
요청 본문을 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 응답이 표시됩니다.
커스텀 스키마를 사용하여 HL7v2 메시지 수집 및 파싱
HL7v2 메시지의 base64 인코딩 버전을 수집합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트 ID
- LOCATION: 상위 데이터 세트의 위치
- DATASET_ID: HL7v2 저장소의 상위 데이터 세트
- HL7V2_STORE_ID: HL7v2 저장소 ID
JSON 요청 본문:
{ "message": { "data": "TVNIfF5+XCYkfHx8fHx8fEFEVF5BMDF8fHwyLjENRVZOfFxQXExcSFxOXA1QSUR8MQ1aQ0R8MQ==" } }
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 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"
PowerShell
요청 본문을 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 응답이 표시됩니다.
필드가 누락된 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
의1
는maxOccurs
입니다.
- '주문' 그룹과 일치하는 세그먼트 유형이 포함된 '주문' 그룹 아래에 중첩된 다른
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 프로젝트 ID
- LOCATION: 상위 데이터 세트의 위치
- 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" } }
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 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"
PowerShell
요청 본문을 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 응답이 표시됩니다.
커스텀 스키마를 사용하여 HL7v2 메시지 수집 및 파싱
HL7v2 메시지의 base64 인코딩 버전을 수집합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트 ID
- LOCATION: 상위 데이터 세트의 위치
- DATASET_ID: HL7v2 저장소의 상위 데이터 세트
- HL7V2_STORE_ID: HL7v2 저장소 ID
JSON 요청 본문:
{ "message": { "data": "TVNIfF5+XCZ8fHx8fDIwMTAwMTAxMDAwMDAwfHxPUk1eTzAxXk8wMXwyMzcwMXwxfDIuM3x8DVBJRHwxMXxTTUlUSA1QVjF8MTENUElEfDIyfEpPSE4NUFYxfDIyDU9SQ3wzDU9CWHw0DU5URXw1DU5URXw2DU9CWHw3DU5URXw4" } }
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 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"
PowerShell
요청 본문을 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 응답이 표시됩니다.
응답에서 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" ] } ] } ] } ] } ] } }