View a markdown version of this page

를 사용하여 용어 간 코드 매핑 $translate - AWS HealthLake
용도지원되는 파라미터예제응답 파라미터동작오류 처리경고

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

를 사용하여 용어 간 코드 매핑 $translate

AWS HealthLake 는 ConceptMap 리소스에 대한 $translate 작업을 지원하므로 데이터 스토어에 수집한 ConceptMaps를 사용하여 한 코드 시스템의 코드를 다른 코드의 동등한 코드로 매핑할 수 있습니다. 이 작업은 다음이 필요한 경우에 특히 유용합니다.

  • 용어 간 코드 매핑(예: ICD-10-CM에서 SNOMED CT로)

  • 수신 데이터를 정식 코드 시스템으로 정규화

  • 다양한 용어를 사용하는 시스템 간 상호 운용성 지원

  • 이기종 소스 용어를 표준화하여 임상 데이터 분석 실행

용도

$translate 작업은 GET 및 POST 메서드를 모두 사용하여 ConceptMap 리소스에서 호출할 수 있습니다.

지원되는 작업

GET  [base]/ConceptMap/$translate?url={...}&system={...}&code={...}
GET  [base]/ConceptMap/[id]/$translate?system={...}&code={...}
POST [base]/ConceptMap/$translate
POST [base]/ConceptMap/[id]/$translate

지원되는 파라미터

HealthLake는 FHIR R4 $translate 파라미터의 하위 집합을 지원합니다.

파라미터 유형 필수 설명
code code 예 번역할 소스 코드
system uri 예 코드가 속한 코드 시스템
url uri 아니요 변환할 특정 ConceptMap의 정식 URL
source uri 아니요 소스 값 세트가이 URI와 동일한 맵으로 제한합니다.
target uri 아니요 대상 값 세트가이 URI와 같은 맵으로 제한합니다.
targetsystem uri 아니요 이 코드 시스템의 대상 코드로 일치를 제한합니다.
참고

url, source및 target 파라미터는 유형 수준 호출()에만 적용되는 범위 필터입니다[base]/ConceptMap/$translate. 인스턴스 호출(ConceptMap/[id]/$translate)에서는 , code system및 만 targetsystem 적용되므로 무시됩니다.

예제

GET 요청(ConceptMap ID 기준)

GET [base]/ConceptMap/example-conceptmap/$translate?system=http://snomed.info/sct&code=44054006
GET 요청(정규 URL 기준)

GET [base]/ConceptMap/$translate?url=http://example.com/ConceptMap/sct-to-icd10&system=http://snomed.info/sct&code=44054006
POST 요청

POST [base]/ConceptMap/$translate
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "url",
      "valueUri": "http://example.com/ConceptMap/sct-to-icd10"
    },
    {
      "name": "system",
      "valueUri": "http://snomed.info/sct"
    },
    {
      "name": "code",
      "valueCode": "44054006"
    },
    {
      "name": "targetsystem",
      "valueUri": "http://hl7.org/fhir/sid/icd-10-cm"
    }
  ]
}
샘플 응답

작업은 Parameters 리소스를 반환합니다. result 파라미터는 일치 항목을 찾았는지 여부를 나타냅니다. 각 에는 대상concept과가 match 포함됩니다equivalence.

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "result",
      "valueBoolean": true
    },
    {
      "name": "match",
      "part": [
        {
          "name": "equivalence",
          "valueCode": "equivalent"
        },
        {
          "name": "concept",
          "valueCoding": {
            "system": "http://hl7.org/fhir/sid/icd-10-cm",
            "code": "E11.9",
            "display": "Type 2 diabetes mellitus without complications"
          }
        }
      ]
    }
  ]
}

응답 파라미터

응답에는 다음 파라미터가 포함됩니다.

파라미터 유형 설명
result 부울 일치 항목을 찾았는지 여부
match BackboneElement ConceptMap에서 찾은 일치 항목
match.equivalence code 소스 개념과 대상 개념 간의 동등성 정도
match.concept 코딩 대상 개념(시스템, 코드 및 디스플레이 포함)

동작

$translate 작업:

  1. 필수 파라미터(code 및 system)를 검증합니다.

  2. 인스턴스별 [id] 또는 정식 별로 ConceptMap을 해결합니다url.

  3. targetsystem 제공된 경우 선택적으로 일치 항목을 필터링하여 소스 코드를 변환합니다.

  4. 동등한 대상 코드match당 1개 또는 매핑이 없는 result: false 경우 result: true를 반환합니다.

오류 처리

작업은 다음 오류 조건을 처리합니다.

  • 400 잘못된 요청: 잘못된 $translate 요청(부적합 요청 또는 필수 파라미터 누락)

  • 404 찾을 수 없음: 데이터 스토어에서 ConceptMap을 찾을 수 없음

경고

이 릴리스에서는 다음이 지원되지 않습니다.

  • reverse 파라미터(대상에서 소스로의 역번역)

  • 여러 ConceptMaps에서 연결된 번역

  • 10개 이상의 ConceptMap 리소스가 $translate 쿼리와 일치할 수 있으므로 처음 10개 ConceptMaps 일치 항목만 ConceptMap의 date 필드(가장 최근 필드)에 따라 반환됩니다.

$translate 작업 사양에 대한 자세한 내용은 FHIR R4 ConceptMap $translate 설명서를 참조하세요.