간단히 말해, 용어 서버는 코드를 전문으로 하는 FHIR 서버입니다. CodeSystem(SNOMED CT, LOINC, ICD-10, UCUM, HL7 자체 테이블), ValueSet(목적별로 명명된 하위 집합: 활력 징후 코드, 알레르기 물질) 및 ConceptMap(시스템 간 번역)을 저장하고 표준 작업을 통해 응답합니다: $lookup(이 코드는 무엇을 의미하나요?), $validate-code(이 코드가 여기서 허용되나요?), $expand(값 세트의 코드 목록, 텍스트로 필터링 가능), $translate(다른 시스템에서 이 코드는 무엇인가요?) 및 $subsumes(A는 B의 일종인가요?). 애플리케이션은 용어의 복사본을 배포하는 대신 이를 호출합니다. 용어는 크고 라이선스가 있으며 일년에 여러 번 업데이트됩니다.
리소스
FHIR 용어 서버는 세 가지 리소스를 사용합니다. CodeSystem은 표준 URL과 버전으로 코드 시스템을 선언하며, 해당 개념이나 콘텐츠가 다른 곳에 있다는 메모를 포함합니다. ValueSet은 구성 규칙과 선택적 확장 계산을 통해 목적에 맞는 코드 하위 집합을 정의합니다. ConceptMap은 각 매핑에 대한 동등성을 사용하여 시스템 간의 소스-대상 관계를 기록합니다.
- CodeSystem은 자체 URL(
http://snomed.info/sct,http://loinc.org,http://hl7.org/fhir/sid/icd-10), 버전 및 개념 또는 콘텐츠가 다른 곳에 보관된다는 진술(content: not-present는 라이선스 시스템용)로 시스템을 선언합니다. - ValueSet에는
compose(규칙: 시스템의 모든 코드, 특정 코드 또는 필터 포함, 예: 404684003 임상 소견의 하위 항목)가 있으며, 계산될 때expansion(실제 목록)이 있습니다. 프로필의 바인딩은 값 세트를 가리킵니다. FHIR 프로필 및 확장을 참조하세요. - ConceptMap은 SNOMED CT에서 ICD-10 또는 실험실의 로컬 코드를 LOINC로 매핑하는 것과 같은 매핑에 대해 동등성(
equivalent,wider,narrower,inexact,unmatched) 및 선택적 종속성을 가진 소스 → 대상 관계를 보유합니다.
작업 및 요청
FHIR 용어 서버는 다섯 가지 표준 작업에 응답합니다. $lookup은 코드의 의미를 반환하고, $validate-code는 코드가 시스템 또는 값 집합에 속하는지 확인합니다. $expand는 텍스트로 선택적으로 필터링하여 값 집합의 코드를 나열합니다. $translate은 ConceptMap을 통해 코드를 다른 시스템으로 변환하고, $subsumes는 한 개념이 다른 개념의 종류인지 테스트합니다.
$lookup: 코드 세부 정보.
GET /CodeSystem/$lookup?system=http://loinc.org&code=4548-4
display("혈액 내 헤모글로빈 A1c/헤모글로빈.총계"), 다른 언어의 명칭 및 속성(LOINC의 경우 6개 축, SNOMED CT의 경우 부모 및 정의 관계)이 포함된 Parameters 리소스를 반환합니다.
$validate-code: 코드가 시스템 또는 값 세트에 있습니까?
GET /ValueSet/$validate-code?url=http://hl7.org/fhir/ValueSet/observation-vitalsignresult&system=http://loinc.org&code=8480-6
디스플레이와 함께 result: true 또는 메시지와 함께 false를 반환합니다. 리소스를 유효성 검사하는 서버는 바인딩된 각 요소에 대해 이 작업을 호출합니다.
$expand: 텍스트 필터링이 가능한 값 세트의 코드.
GET /ValueSet/$expand?url=http://hl7.org/fhir/ValueSet/condition-code&filter=diabetes&count=20
expansion.contains 목록(코드, 시스템, 디스플레이)이 있는 ValueSet을 반환합니다. 이것이 EHR의 진단 검색이 360,000개의 개념을 로컬로 보유하지 않고 SNOMED CT를 대상으로 작동하는 방식입니다.
$translate: 시스템 경계를 교차합니다.
GET /ConceptMap/$translate?url=https://lab.example.org/ConceptMap/local-to-loinc&system=https://lab.example.org/codes&code=GLU&targetsystem=http://loinc.org
동등성과 함께 일치 항목을 반환합니다. 동일한 작업은 서버가 호스팅하는 SNOMED CT → ICD-10 매핑을 제공합니다.
$subsumes: 계층 구조 질문.
GET /CodeSystem/$subsumes?system=http://snomed.info/sct&codeA=73211009&codeB=44054006
subsumes(당뇨병은 제2형 당뇨병의 조상입니다), subsumed-by, equivalent 또는 not-subsumed에 응답합니다. 의사 결정 지원은 모든 하위 유형을 나열하지 않고 *이 상태가 어떤 종류의 당뇨병인가요?*라고 묻는 데 사용합니다.
응답은 Parameters 리소스입니다. 처음 호출하는 사용자는 객체가 아닌 명명된 부분의 목록에 놀랄 수 있습니다.
만날 서버
실제에서 가장 흔하게 만나는 용어 서버는 다음과 같습니다. tx.fhir.org는 HL7의 공개 참조 서버로, 검증기에서 사용됩니다. CSIRO의 Ontoserver는 여러 국가 프로그램에서 사용되는 상용 서버입니다. SNOMED International의 Snowstorm은 오픈 소스이며 SNOMED CT 네이티브입니다. HAPI FHIR 및 Firely Server와 같은 일반 FHIR 서버는 용어 작업을 지원합니다. 또한 보건 기관에서 운영하는 국가 서버도 있습니다.
| 서버 | 누구 | 참고 |
|---|---|---|
| tx.fhir.org | HL7 (참조) | 공개, HL7 유효성 검사기 및 IG 게시자에서 사용; LOINC, SNOMED CT(라이선스 있는 경우), HL7 테이블, UCUM. 프로덕션 트래픽용 아님 |
| Ontoserver | CSIRO (호주) | 상업용; 국가 프로그램(호주, 영국 NHS Ontology Server, 네덜란드, 벨기에)에서 사용; ECL 쿼리가 포함된 전체 SNOMED CT |
| Snowstorm | SNOMED International | 오픈 소스; SNOMED CT 네이티브, FHIR API 포함; 공식 브라우저 지원 |
| HAPI FHIR, Firely Server, Microsoft/Google/AWS FHIR 서비스 | 공급업체 | 용어 작업을 포함하는 일반 FHIR 서버; 코드 시스템을 직접 로드 |
| 국가 서버 | 보건부 및 기관 | 종종 Ontoserver 또는 Snowstorm에 국가 버전 및 로컬 값 세트 포함 |
콘텐츠가 어려운 부분입니다. SNOMED CT는 회원국 외부에서 라이선스가 필요하고, LOINC는 약관에 동의해야 하며, ICD-10 국가 변형은 자체 배포가 있습니다. 서버는 작업을 제공하며, 콘텐츠는 합법적으로 얻고 로드해야 합니다.
애플리케이션 사용 방법
애플리케이션은 용어 서버를 사용하여 작성 시 코드와 단위를 검증하고, 텍스트 필터와 값 집합을 사용한 $expand를 통해 검색 상자를 지원하며, $lookup을 통해 공식 이름을 표시하고, $translate을 통해 로컬 코드를 LOINC 또는 SNOMED CT에서 ICD-10으로 매핑하고, $subsumes 및 SNOMED CT의 표현 제약 언어를 통해 계층 구조를 추론합니다.
- 작성 시 유효성 검사: 존재하지 않는 LOINC 코드 또는 UCUM 단위가 있는 Observation을 거부하고 문제를 명시하는 메시지를 표시합니다.
- 검색 상자: 진단, 시술 및 약물 선택기를 위한
filter가 있는$expand, 값 세트로 범위가 지정되어 임상의가 관련 개념만 볼 수 있도록 합니다. - 표시:
$lookup을 사용하여 저장된 표시 문자열이 오래되지 않도록 공식 이름과 번역을 표시합니다. - 매핑:
$translate을 사용하여 가져올 때 로컬 실험실 코드를 LOINC로 변환하거나(로컬 실험실 코드를 LOINC로 매핑하는 방법) 보고를 위해 SNOMED CT를 ICD-10으로 변환합니다(SNOMED CT 대 ICD-10). - 추론:
$subsumes및 SNOMED의 Expression Constraint Language(ECL, Ontoserver 및 Snowstorm에서$expand필터를 통해 지원)를 사용하여 계층 구조로 코호트 및 규칙을 정의합니다.
캐시를 적극적으로 사용하고(용어는 하루에 두 번이 아닌 일년에 두 번 변경됨), 프로덕션에서는 버전을 고정하고, 서버 중단을 모든 쓰기를 거부하는 이유가 아닌 유효성 검사 저하로 취급합니다.
Anpheros에서
Anpheros Platform은 관찰에 대해 수락하는 LOINC 코드 및 UCUM 단위를, 약물에 대한 ATC 코드를 자체에서 제공하는 용어(LOINC 하위 집합 및 WHO ATC 색인)와 비교하여 유효성을 검사하고 개발자 사이트에서 용어 API를 문서화합니다. 전체 SNOMED CT 또는 ICD-10 검색의 경우 라이선스 콘텐츠를 재배포하는 대신 공식 브라우저를 가리킵니다.
관련 페이지
- FHIR 프로필 및 확장 설명
- 로컬 실험실 코드를 LOINC로 매핑하는 방법
- SNOMED CT 대 ICD-10
- FHIR의 CodeableConcept 및 Coding
- 실험실 결과의 UCUM 단위
- 의료 용어 API (개발자 사이트)
출처
- HL7 FHIR R4: 용어 서비스
- HL7 FHIR R4: ValueSet $expand
- HL7 FHIR R4: ConceptMap $translate
- HL7 FHIR R4: CodeSystem $lookup
- HL7 용어 서버 tx.fhir.org
- Snowstorm (SNOMED International, GitHub)
- Ontoserver (CSIRO)
자주 묻는 질문
FHIR를 사용하려면 용어 서버가 필요합니까?
작은 시스템에 고정된 코드 목록이 있는 경우 필요하지 않습니다. 대규모 시스템의 코드를 유효성 검사하거나, 임상 검색을 제공하거나, 시스템 간에 번역하는 즉시 용어 서버를 사용하면 용어를 직접 배포하고 업데이트하는 수고를 덜 수 있습니다.
프로덕션에서 tx.fhir.org를 사용할 수 있습니까?
아니요. HL7의 유효성 검사 도구 및 테스트용 참조 서버이며 서비스 보장이 없고 일부 콘텐츠에 라이선스 제한이 있습니다. 자체 서버를 실행하거나 국가 또는 상업용 서버를 사용하십시오.
ECL이란 무엇입니까?
SNOMED CT의 Expression Constraint Language는 개념 집합에 대한 쿼리 구문입니다(예: 당뇨병 및 모든 하위 유형에 대한 << 73211009). 이를 지원하는 서버는 ValueSet 필터 및 $expand에서 ECL을 허용합니다.
서버에 SNOMED CT의 어떤 버전이 있는지 어떻게 알 수 있습니까?
CodeSystem(GET /CodeSystem?url=http://snomed.info/sct)에 문의하고 버전(예: http://snomed.info/sct/900000000000207008/version/20260301)을 읽습니다. 결과를 재현해야 하는 경우 요청에서 버전을 고정하십시오.
샌드박스에서 무료로 사용해 보세요
5분 만에 첫 FHIR 호출. 환자의 동의가 내장된 HL7 FHIR R4 API: 샌드박스에서 먼저 사용해보고, 자체 앱 또는 병원 시스템을 연결하세요.
무료 · 합성 환자 30명 · 카드 불필요
Anpheros는 환자가 직접 관리하고 어떤 병원과도 공유할 수 있는 의료 기록을 EU 기반의 HL7 FHIR R4 플랫폼에서 구축합니다. 이 가이드들은 건강 정보를 이해하고 정리하는 데 도움을 드리며, 의사의 진료를 대체하지 않습니다.
Anpheros 소개 →