第 12 課：術語 - CodeSystem、ValueSet、ConceptMap

HL7 FHIR - 基礎到進階醫療資料標準

第 4 部分：資料類型、術語和設定文件

亞洲開發網

1. 主要醫學術語系統

系統	整理	目的	FHIR 系統 URI
ICD-10	世界衛生組織	疾病分類與死因	http://hl7.org/fhir/sid/icd-10
斯諾梅德CT	斯諾梅德國際	全面的臨床術語	http://snomed.info/sct
洛因克	雷根斯特里夫	實驗室檢測和臨床觀察	http://loinc.org
接收標準	自然語言管理	標準化藥物名稱（美國）	http://www.nlm.nih.gov/research/umls/rxnorm
空中交通管制	世界衛生組織	藥物依組別分類（國際）	http://www.whocc.no/atc
顯性PT	美國醫學協會	醫療程序/服務代碼	http://www.ama-assn.org/go/cpt
CVX	疾病預防控制中心	疫苗代碼	http://hl7.org/fhir/sid/cvx
UCUM	雷根斯特里夫	計量單位	http://unitsofmeasure.org

ICD-10 — 國際疾病分類

用於 條件代碼, 遭遇診斷。越南使用官方 ICD-10 (WHO)。

{
  "system": "http://hl7.org/fhir/sid/icd-10",
  "code": "E11.9",
  "display": "Type 2 diabetes mellitus without complications"
}

SNOMED CT — 醫學系統命名法

最全面的術語系統，35萬+個概念、層次關係（本體）。

{
  "system": "http://snomed.info/sct",
  "code": "73211009",
  "display": "Diabetes mellitus"
}

LOINC — 邏輯觀察識別碼名稱和代碼

97,000 多個用於測試和臨床觀察的代碼。用於 觀察程式碼, 診斷報告.code。

{
  "system": "http://loinc.org",
  "code": "4548-4",
  "display": "Hemoglobin A1c/Hemoglobin.total in Blood"
}

2. 代碼系統資源

編碼系統 定義一組概念（代碼）－可以是國際系統或自訂系統。

{
  "resourceType": "CodeSystem",
  "url": "http://hospital.vn/fhir/CodeSystem/loai-kham",
  "name": "LoaiKham",
  "title": "Loại hình khám chữa bệnh",
  "status": "active",
  "content": "complete",
  "count": 5,
  "concept": [
    {
      "code": "KSK",
      "display": "Khám sức khỏe",
      "definition": "Khám sức khỏe tổng quát định kỳ"
    },
    {
      "code": "KBT",
      "display": "Khám bệnh thường",
      "definition": "Khám bệnh ngoại trú thông thường"
    },
    {
      "code": "CC",
      "display": "Cấp cứu",
      "definition": "Khám cấp cứu"
    },
    {
      "code": "BHYT",
      "display": "Khám BHYT",
      "definition": "Khám bảo hiểm y tế"
    },
    {
      "code": "DV",
      "display": "Khám dịch vụ",
      "definition": "Khám theo yêu cầu (dịch vụ)"
    }
  ]
}

3. 值集資源

值集 從一個或多個代碼系統中選擇一個子集。

{
  "resourceType": "ValueSet",
  "url": "http://hospital.vn/fhir/ValueSet/vital-signs-codes",
  "name": "VitalSignsCodes",
  "title": "Mã dấu hiệu sinh tồn",
  "status": "active",
  "compose": {
    "include": [
      {
        "system": "http://loinc.org",
        "concept": [
          {"code": "8480-6", "display": "Systolic blood pressure"},
          {"code": "8462-4", "display": "Diastolic blood pressure"},
          {"code": "8867-4", "display": "Heart rate"},
          {"code": "8310-5", "display": "Body temperature"},
          {"code": "9279-1", "display": "Respiratory rate"},
          {"code": "2708-6", "display": "Oxygen saturation (SpO2)"},
          {"code": "29463-7", "display": "Body weight"},
          {"code": "8302-2", "display": "Body height"}
        ]
      }
    ]
  }
}

帶過濾器的值集

{
  "resourceType": "ValueSet",
  "url": "http://hospital.vn/fhir/ValueSet/icd10-cardiovascular",
  "compose": {
    "include": [
      {
        "system": "http://hl7.org/fhir/sid/icd-10",
        "filter": [
          {
            "property": "concept",
            "op": "is-a",
            "value": "I00-I99"
          }
        ]
      }
    ],
    "exclude": [
      {
        "system": "http://hl7.org/fhir/sid/icd-10",
        "concept": [
          {"code": "I99"}
        ]
      }
    ]
  }
}

4. ConceptMap－程式碼系統之間的映射

{
  "resourceType": "ConceptMap",
  "url": "http://hospital.vn/fhir/ConceptMap/icd10-to-snomed",
  "name": "ICD10ToSNOMED",
  "title": "ICD-10 → SNOMED CT Mapping",
  "status": "active",
  "sourceScope": "http://hl7.org/fhir/sid/icd-10",
  "targetScope": "http://snomed.info/sct",
  "group": [
    {
      "source": "http://hl7.org/fhir/sid/icd-10",
      "target": "http://snomed.info/sct",
      "element": [
        {
          "code": "I10",
          "display": "Essential (primary) hypertension",
          "target": [
            {
              "code": "38341003",
              "display": "Hypertensive disorder",
              "relationship": "equivalent"
            }
          ]
        },
        {
          "code": "E11",
          "display": "Type 2 diabetes mellitus",
          "target": [
            {
              "code": "44054006",
              "display": "Type 2 diabetes mellitus",
              "relationship": "equivalent"
            }
          ]
        }
      ]
    }
  ]
}

關係類型

關係	描述
同等	完全等價
源比目標窄	源比目標窄
來源比目標更廣泛	來源比目標更廣泛
不相關	不相關

5. 術語綁定

綁定指定哪些元素需要使用 ValueSet 中的程式碼。

實力	描述	例如
需要。必填	需要使用 ValueSet 中的程式碼	患者性別
可擴展的	應該使用。如果找不到，您可以使用其他程式碼	條件代碼
首選	推薦。可以使用其他代碼	遭遇型
例子	只是例子。可以使用任何值集	觀察程式碼

6. 術語服務運營

# $validate-code — kiểm tra code có hợp lệ trong ValueSet
POST /ValueSet/$validate-code
{
  "resourceType": "Parameters",
  "parameter": [
    {"name": "url", "valueUri": "http://hl7.org/fhir/ValueSet/administrative-gender"},
    {"name": "code", "valueCode": "male"},
    {"name": "system", "valueUri": "http://hl7.org/fhir/administrative-gender"}
  ]
}

# $expand — mở rộng ValueSet ra danh sách codes
GET /ValueSet/$expand?url=http://hospital.vn/fhir/ValueSet/vital-signs-codes

# $lookup — tra cứu thông tin code
GET /CodeSystem/$lookup?system=http://loinc.org&code=4548-4

# $translate — ánh xạ code qua ConceptMap
GET /ConceptMap/$translate?system=http://hl7.org/fhir/sid/icd-10&code=I10&target=http://snomed.info/sct

七、總結

• 編碼系統 — 定義代碼集（ICD-10、SNOMED CT、LOINC 或自訂）

• 值集 — 从CodeSystems中选择子集，用于绑定

• 概念圖 — 代碼系統之間的對應 (ICD-10 ↔ SNOMED CT)

• 結合強度 — 必需 > 可扩展 > 首选 > 示例

• 術語操作 — $validate-code、$expand、$lookup、$translate