$convert-data 개요

아티클
03/01/2024

참고 항목

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로

참고 항목

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

$convert-data 엔드포인트 사용

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

POST {{fhirurl}}/$convert-data

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

매개 변수

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

매개 변수 이름	설명	허용되는 값
inputData	FHIR로 변환할 데이터 페이로드.	`Hl7v2`의 경우: 문자열 `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 STU3 리소스와 FHIR R4 사양의 해당 리소스 간에만 필드 차이의 매핑을 제공하는 Liquid 템플릿입니다. 일부 FHIR STU3 리소스는 FHIR R4에서 이름이 변경되거나 제거되었습니다. FHIR STU3-FHIR R4 변환에 대한 리소스 차이 및 제약 조건에 대한 자세한 내용은 FHIR STU3-FHIR R4 변환에 대한 리소스 차이점 및 제약 조건을 참조하세요.

참고 항목

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

Warning

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

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

Azure Container Registry 인스턴스에서 사용자의 템플릿 복사본을 호스트합니다.
템플릿을 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 작업을 활용하여 일부 사후 처리를 수행해야 합니다.

다음 단계

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

Azure Portal을 사용하여 $convert-data에 대한 설정을 구성하는 방법은 다음을 참조하세요.

Azure Portal을 사용하여 $convert-data에 대한 설정 구성

$convert-data 문제 해결 방법은 다음을 참조하세요.

$convert-data 문제 해결

$convert-data에 대한 FAQ(질문과 대답)에 대해 알아보려면

$convert-data에 대한 질문과 대답

FHIR®은 미국 특허청에 등록된 Health Level Seven International의 등록 상표이며 해당 사용 허가 하에 사용됩니다.

$convert-data 개요

$convert-data 엔드포인트 사용

매개 변수

샘플 요청

샘플 응답

다음 단계

추가 리소스