$convert 데이터 개요

아티클
08/03/2023

참고

FHIR®(Fast Healthcare Interoperability Resources) 은 개방형 의료 사양입니다.

FHIR 서비스에서 작업을 사용하면 $convert-data 상태 데이터를 다양한 형식에서 FHIR R4 데이터로 변환할 수 있습니다. 이 $convert-data 작업은 FHIR 데이터 변환을 위해 FHIR 변환기 프로젝트의 Liquid 템플릿을 사용합니다. 필요에 따라 이러한 변환 템플릿을 사용자 지정할 수 있습니다. 현재 이 $convert-data 작업은 다음 네 가지 유형의 데이터 변환을 지원합니다.

HL7v2에서 FHIR R4로
C-CDA에서 FHIR R4로
JSON에서 FHIR R4로(사용자 지정 변환 매핑용)
FHIR STU3에서 FHIR R4로

참고

다양한 형식(예: HL7v2, CCDA, JSON 및 FHIR STU3)에서 FHIR 형식으로 상태 데이터를 변환하기 위해 ETL(추출, 변환 및 로드) 파이프라인 내에서 엔드포인트를 구성 요소로 사용할 $convert-data 수 있습니다. 상태 데이터를 변환할 때 전체 워크플로에 대한 ETL 파이프라인을 만들 수 있습니다. Azure Logic Apps 또는 Azure Data Factory 기반으로 하는 ETL 엔진을 사용하는 것이 좋습니다. 예를 들어 워크플로에는 데이터 수집, 작업 수행 $convert-data , 유효성 검사, 데이터 사전/사후 처리, 데이터 보강, 데이터 중복 제거 및 FHIR 서비스의 지속성을 위해 데이터 로드가 포함될 수 있습니다.

$convert-data 엔드포인트 사용

작업은 $convert-data REST API 작업으로 FHIR 서비스에 통합됩니다. 다음과 같이 엔드포인트를 $convert-data 호출할 수 있습니다.

POST {{fhirurl}}/$convert-data

변환을 위한 상태 데이터는 요청 본문의 FHIR 서비스에 전달됩니다 $convert-data . 요청이 성공하면 FHIR 서비스는 FHIR R4로 변환된 데이터와 함께 FHIR 번들 응답을 반환합니다.

매개 변수

작업 호출은 $convert-data 요청 본문의 JSON 형식 매개 변수 내에서 변환할 상태 데이터를 패키지합니다. 다음 표에는 매개 변수가 나와 있습니다.

매개 변수 이름	설명	허용되는 값
inputData	FHIR로 변환할 데이터 페이로드입니다.	의 경우 `Hl7v2`: string 의 경우 `Ccda`: XML 의 경우 `Json`: JSON 의 경우 `FHIR STU3`: JSON
inputDataType	데이터 입력 유형입니다.	`Hl7v2`, `Ccda`, `Json`, `Fhir`
templateCollectionReference	Azure Container Registry OCI 이미지 템플릿 컬렉션에 대한 참조입니다. 참조는 변환에 사용할 Liquid 템플릿이 포함된 이미지에 대한 것입니다. 기본 템플릿 또는 FHIR 서비스 내에 등록된 사용자 지정 템플릿 이미지를 참조할 수 있습니다. 다음 섹션에서는 템플릿 사용자 지정, Azure Container Registry 호스팅 및 FHIR 서비스에 등록에 대해 설명합니다.	기본/샘플 템플릿의 경우: HL7v2 템플릿: `microsofthealth/fhirconverter:default` `microsofthealth/hl7v2templates:default` C-CDA 템플릿: `microsofthealth/ccdatemplates:default` JSON 템플릿: `microsofthealth/jsontemplates:default` FHIR STU3 템플릿: `microsofthealth/stu3tor4templates:default` 사용자 지정 템플릿의 경우: `<RegistryServer>/<imageName>@<imageDigest>`, `<RegistryServer>/<imageName>:<imageTag>`
rootTemplate	데이터를 변환하는 동안 사용할 루트 템플릿입니다.	HL7v2의 경우: ADT_A01, ADT_A02, ADT_A03, ADT_A04, ADT_A05, ADT_A08 ADT_A11, ADT_A13, ADT_A14, ADT_A15, ADT_A16, ADT_A25, ADT_A26, ADT_A27, ADT_A28, ADT_A29, ADT_A31, ADT_A47, ADT_A60, OML_O21, ORU_R01, ORM_O01, VXU_V04, SIU_S12, SIU_S13, SIU_S14, SIU_S15, SIU_S16 SIU_S17, SIU_S26, MDM_T01, MDM_T02 C-CDA의 경우: CCD, ConsultationNote, DischargeSummary, HistoryandPhysical, OperativeNote, ProcedureNote, ProgressNote, ReferralNote, TransferSummary JSON의 경우: ExamplePatient, Stu3ChargeItem FHIR STU3의 경우: FHIR STU3 리소스 이름(예: Patient, Observation, Organization)

참고

FHIR STU3에서 FHIR R4로의 템플릿은 FHIR R4 사양에서 FHIR STU3 리소스와 해당 리소스 간에만 필드 차이의 매핑을 제공하는 Liquid 템플릿입니다. FHIR STU3 리소스 중 일부는 FHIR R4에서 이름이 변경되거나 제거됩니다. FHIR STU3에서 FHIR R4로의 변환에 대한 리소스 차이 및 제약 조건에 대한 자세한 내용은 FHIR STU3에서 FHIR R4로의 변환에 대한 리소스 차이 및 제약 조건을 참조하세요.

참고

JSON 템플릿은 고유한 변환 매핑을 빌드하는 데 사용할 샘플 템플릿입니다. 미리 정의된 상태 데이터 메시지 형식을 준수하는 기본 템플릿이 아닙니다 . JSON 자체는 HL7v2 또는 C-CDA와 달리 상태 데이터 형식으로 지정되지 않습니다. 따라서 기본 JSON 템플릿을 제공하는 대신 사용자 지정 매핑의 시작점으로 사용할 수 있는 몇 가지 샘플 JSON 템플릿을 제공합니다.

경고

기본 템플릿은 MIT 라이선스에 따라 릴리스되며 Microsoft 지원 지원되지 않습니다.

기본 템플릿은 데이터 변환 워크플로를 시작하는 데 도움이 되는 경우에만 제공됩니다. 이러한 기본 템플릿은 프로덕션용이 아니며 Microsoft가 FHIR 서비스에 대한 업데이트를 릴리스할 때 변경될 수 있습니다. 여러 버전의 FHIR 서비스에서 일관된 데이터 변환 동작을 수행하려면 다음을 수행해야 합니다.

Azure Container Registry instance 템플릿의 자체 복사본을 호스트합니다.
FHIR 서비스에 템플릿을 등록합니다.
API 호출에서 등록된 템플릿을 사용합니다.
변환 동작이 요구 사항을 충족하는지 확인합니다.

사용자 고유의 템플릿을 호스팅하는 방법에 대한 자세한 내용은 사용자 고유의 템플릿 호스트를 참조하세요.

샘플 요청

{
    "resourceType": "Parameters",
    "parameter": [
        {
            "name": "inputData",
            "valueString": "MSH|^~\\&|SIMHOSP|SFAC|RAPP|RFAC|20200508131015||ADT^A01|517|T|2.3|||AL||44|ASCII\nEVN|A01|20200508131015|||C005^Whittingham^Sylvia^^^Dr^^^DRNBR^D^^^ORGDR|\nPID|1|3735064194^^^SIMULATOR MRN^MRN|3735064194^^^SIMULATOR MRN^MRN~2021051528^^^NHSNBR^NHSNMBR||Kinmonth^Joanna^Chelsea^^Ms^^D||19870624000000|F|||89 Transaction House^Handmaiden Street^Wembley^^FV75 4GJ^GBR^HOME||020 3614 5541^PRN|||||||||C^White - Other^^^||||||||\nPD1|||FAMILY PRACTICE^^12345|\nPV1|1|I|OtherWard^MainRoom^Bed 183^Simulated Hospital^^BED^Main Building^4|28b|||C005^Whittingham^Sylvia^^^Dr^^^DRNBR^D^^^ORGDR|||CAR|||||||||16094728916771313876^^^^visitid||||||||||||||||||||||ARRIVED|||20200508131015||"
        },
        {
            "name": "inputDataType",
            "valueString": "Hl7v2"
        },
        {
            "name": "templateCollectionReference",
            "valueString": "microsofthealth/fhirconverter:default"
        },
        {
            "name": "rootTemplate",
            "valueString": "ADT_A01"
        }
    ]
}

샘플 응답

{
    "resourceType": "Bundle",
    "type": "batch",
    "entry": [
        {
            "fullUrl": "urn:uuid:9d697ec3-48c3-3e17-db6a-29a1765e22c6",
            "resource": {
                "resourceType": "Patient",
                "id": "9d697ec3-48c3-3e17-db6a-29a1765e22c6",
          ...
          ...
            },
            "request": {
                "method": "PUT",
                "url": "Location/50becdb5-ff56-56c6-40a1-6d554dca80f0"
            }
        }
    ]
}

FHIR 변환의 결과는 일괄 처리로 FHIR 번들입니다.

FHIR 번들은 FHIR R4 사양 - 번들 - FHIR v4.0.1의 기대에 부합해야 합니다.
특정 프로필에 대해 유효성을 검사하려는 경우 FHIR $validate 작업을 활용하여 일부 사후 처리를 수행해야 합니다.

다음 단계

이 문서에서는 Azure Health Data Service에서 $convert-data FHIR 서비스를 사용하여 상태 데이터를 FHIR R4로 변환하기 위해 엔드포인트를 사용하는 방법과 작업에 대해 알아보았습니다.

Azure Portal 사용하기 위한 $convert-data 설정을 구성하는 방법을 알아보려면

Azure Portal 사용하여 $convert 데이터에 대한 설정 구성

문제를 해결하는 $convert-data방법을 알아보려면 를 참조하세요.

$convert 데이터 문제 해결

에 대한 FAQ(질문과 대답)에 $convert-data대해 알아보려면 를 참조하세요.

$convert 데이터에 대한 질문과 대답

FHIR®은 미국 상표청에 등록된 Health Level Seven International의 등록 상표이며 허가를 받아 사용됩니다.