데이터를 Azure API for FHIR용 FHIR로 변환

FHIR® 서비스의 $convert-data 사용자 지정 엔드포인트는 다양한 데이터 형식에서 FHIR로의 데이터 변환을 위한 것입니다. Liquid 템플릿 엔진과 FHIR 변환기 프로젝트의 템플릿을 기본 템플릿으로 사용합니다. 필요에 따라 이러한 변환 템플릿을 사용자 지정할 수 있습니다.

현재 $convert-data 사용자 지정 엔드포인트는 4가지 형식의 데이터 변환을 지원합니다.

$convert-data 엔드포인트 사용

$convert-data 작업은 서비스의 일부로 실행되도록 FHIR 서비스에 통합됩니다. 서버에서 $convert-data를 사용하도록 설정한 후 https://<<FHIR service base URL>>/$convert-data를 사용하여 서버에 API 호출을 보내 데이터를 FHIR로 변환할 수 있습니다.

매개 변수 리소스

$convert-data는 다음 표에 설명된 대로 요청 본문에서 매개 변수 리소스를 사용합니다. 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": "transaction",
  "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"
      }
    }
  ]
}

템플릿 사용자 지정

Visual Studio Code용 FHIR Converter 확장을 사용하여 필요에 따라 템플릿을 사용자 지정할 수 있습니다. 이 확장은 대화형 편집 환경을 제공하며 Microsoft에서 게시한 템플릿 및 샘플 데이터를 쉽게 다운로드할 수 있게 해줍니다. 자세한 내용은 확장의 설명서를 참조하세요.

템플릿 호스트 및 사용

ACR에서 고유한 템플릿 복사본을 호스트하는 것이 좋습니다. $convert-data 작업에서 템플릿의 자체 복사본을 호스팅하고 이를 사용하려면 4단계가 필요합니다.

1. Azure Container Registry로 템플릿을 푸시합니다.
2. Azure API for FHIR 인스턴스에서 관리 ID를 사용합니다.
3. Azure API for FHIR 관리 ID에 ACR 액세스를 제공합니다.
4. Azure API for FHIR에서 ACR 서버 등록
5. 필요에 따라 보안 액세스를 위해 ACR 방화벽을 구성합니다.

Azure Container Registry로 템플릿 푸시

ACR 인스턴스를 만든 후 FHIR 변환기 확장에서 FHIR 변환기: 푸시 템플릿 명령을 사용하여 사용자 지정된 템플릿을 ACR에 푸시할 수 있습니다. 또는 템플릿 관리 CLI 도구를 사용할 수 있습니다.

Azure API for FHIR에서 관리 ID 사용

Azure Portal에서 Azure API for FHIR 서비스의 인스턴스로 이동한 다음 ID 블레이드를 선택합니다. Azure API for FHIR에서 관리 ID를 사용하려면 상태를 켜기로 변경합니다.

Azure API for FHIR에 ACR 액세스 제공

1. 액세스 제어(IAM) 블레이드로 이동합니다.

2. 추가를 선택한 다음 역할 할당 추가를 선택하여 역할 할당 추가 페이지를 엽니다.

3. AcrPull 역할을 할당합니다.

   

Azure Portal에서 역할을 할당하는 방법에 대한 자세한 내용은 Azure 기본 제공 역할을 참조하세요.

Azure API for FHIR에서 ACR 서버 등록

Azure Portal을 사용하거나 CLI를 사용하여 ACR 서버를 등록할 수 있습니다.

Azure Portal을 사용하여 ACR 서버 등록

Azure API for FHIR 인스턴스의 데이터 변환 아래에서 아티팩트 블레이드로 이동합니다. 현재 등록된 ACR 서버 목록이 표시됩니다. 추가를 선택한 다음 드롭다운 메뉴에서 레지스트리 서버를 선택합니다. 등록을 적용하려면 저장을 선택해야 합니다. 변경 내용을 적용하고 인스턴스를 다시 시작하는 데 몇 분 정도 걸릴 수 있습니다.

CLI를 사용하여 ACR 서버 등록

Azure API for FHIR에 최대 20개의 ACR 서버를 등록할 수 있습니다.

필요한 경우 Azure PowerShell에서 Azure Health Data Services CLI를 설치합니다.

az extension add -n healthcareapis

다음 예에 따라 Azure API for FHIR에 ACR 서버를 등록합니다.

단일 ACR 서비스 등록

az healthcareapis acr add --login-servers "fhiracr2021.azurecr.io" --resource-group fhir-test --resource-name fhirtest2021

여러 ACR 서비스 등록

az healthcareapis acr add --login-servers "fhiracr2021.azurecr.io fhiracr2020.azurecr.io" --resource-group fhir-test --resource-name fhirtest2021

ACR 방화벽 구성

포털에서 Azure Storage 계정에 대해 네트워킹을 선택합니다.

선택한 네트워크를 선택합니다.

방화벽 섹션의 주소 범위 상자에 IP 주소를 지정합니다. 인터넷 또는 온-프레미스 네트워크에서의 액세스를 허용하기 위한 IP 범위를 추가합니다.

다음 표에서는 Azure API for FHIR 서비스가 프로비전된 Azure 지역의 IP 주소를 확인할 수 있습니다.

확인

templateCollectionReference 매개 변수에 템플릿 참조를 지정하여 $convert-data API를 호출합니다.

<RegistryServer>/<imageName>@<imageDigest>

다음 단계

이 문서에서는 Azure API for FHIR의 데이터 변환에 대해 알아보았습니다. Azure API for FHIR 관련 GitHub 프로젝트에 대한 자세한 내용은 다음을 참조하세요.