HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.8.0 - Draft for Community Review Viet Nam cờ

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Draft for Community Review (v0.8.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

StructureMap: Bảng 4 cận lâm sàng BHYT — Logical Model — StructureMap

URL chính thức: http://fhir.hl7.org.vn/core/StructureMap/vn-sm-bhyt-xml4-cls Phiên bản: 0.8.0
Computable Name: BHYTXML4CLSLMStructureMap
Định danh khác: OID:2.25.161089673617632664299011809196868855799.43.7

Generated StructureMap scaffold for Bảng 4 cận lâm sàng BHYT — Logical Model. Source semantics come from the logical model mapping annotations in BHYTXML4CLSLM.fsh and remain aligned with the Python BHYT round-trip export adapter.

Language: vi

map "http://fhir.hl7.org.vn/core/StructureMap/vn-sm-bhyt-xml4-cls" = "BHYTXML4CLSLMStructureMap"

// Generated StructureMap scaffold for Bảng 4 cận lâm sàng BHYT — Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML4CLSLM.fsh` and remain aligned with the Python BHYT round-trip export adapter.

// FHIR-native source bundle profile used by the repository round-trip adapter.
uses "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle" alias BHYTSubmissionBundle as source
// Bảng 4 cận lâm sàng BHYT — Logical Model
uses "http://fhir.hl7.org.vn/core/StructureDefinition/bhytXml4ClsLm" alias BHYTXML4CLSLM as target

// Rows are derived from VNCoreDiagnosticReport and the linked VNCoreObservationLab results. Generated from logical-model `^mapping` annotations. Fields still missing a field-level `^mapping.map` entry remain outside this StructureMap and are tracked in `wiki/mappings/bhyt-output-data/machine/structuremap-coverage.json`.
group MapBHYTXML4CLSLM(source sourceBundle : BHYTSubmissionBundle, target targetRow : BHYTXML4CLSLM) {
  // Target field: Mã liên kết hồ sơ FHIR path: VNCoreClaim.identifier[MALK].value
  sourceBundle.entry 0..* as maLkSource -> targetRow.maLk "maLk";
  // Target field: Số thứ tự dòng FHIR path: Derived export row order from VNCoreDiagnosticReport collection
  sourceBundle.entry 0..* as sttSource -> targetRow.stt "stt";
  // Target field: MA_DICH_VU - Mã dịch vụ cận lâm sàng FHIR path: VNCoreDiagnosticReport.code.coding.code
  sourceBundle.entry 0..* as maDichVuSource -> targetRow.maDichVu "maDichVu";
  // Target field: MA_CHI_SO - Mã chỉ số cận lâm sàng FHIR path: VNCoreObservationLab.code.coding.code
  sourceBundle.entry 0..* as maChiSoSource -> targetRow.maChiSo "maChiSo";
  // Target field: TEN_CHI_SO - Tên chỉ số cận lâm sàng FHIR path: VNCoreObservationLab.code.text | VNCoreObservationLab.code.coding.display
  sourceBundle.entry 0..* as tenChiSoSource -> targetRow.tenChiSo "tenChiSo";
  // Target field: GIA_TRI - Giá trị kết quả FHIR path: VNCoreObservationLab.value[x]
  sourceBundle.entry 0..* as giaTriSource -> targetRow.giaTri "giaTri";
  // Target field: DON_VI_DO - Đơn vị đo FHIR path: VNCoreObservationLab.valueQuantity.unit | VNCoreObservationLab.valueQuantity.code
  sourceBundle.entry 0..* as donViDoSource -> targetRow.donViDo "donViDo";
  // Target field: MO_TA - Mô tả kết quả cận lâm sàng (chẩn đoán hình ảnh, thăm dò chức năng, giải phẫu bệnh) do người đọc kết quả ghi FHIR path: VNCoreObservationLab.note | VNCoreObservationLab.valueString Mapping note: Phần mô tả (finding) narrative của người đọc kết quả; để trống khi không có kết quả. Với CĐHA/thăm dò chức năng/giải phẫu bệnh không có giá trị định lượng, ghi narrative vào note hoặc valueString của Observation. Diễn giải sửa đổi toàn bộ theo QĐ 3176/QĐ-BYT (kế thừa QĐ 130/QĐ-BYT, sửa đổi bởi QĐ 4750/QĐ-BYT).
  sourceBundle.entry 0..* as moTaSource -> targetRow.moTa "moTa";
  // Target field: KET_LUAN - Kết luận của người đọc kết quả cận lâm sàng FHIR path: VNCoreDiagnosticReport.conclusion Mapping note: Kết luận của người đọc kết quả. Trường hợp xét nghiệm đã có kết quả xác định tại trường GIA_TRI (giaTri) thì để trống trường này; không có kết quả cũng để trống. Diễn giải sửa đổi toàn bộ theo QĐ 3176/QĐ-BYT (kế thừa QĐ 130/QĐ-BYT, sửa đổi bởi QĐ 4750/QĐ-BYT).
  sourceBundle.entry 0..* as ketLuanSource -> targetRow.ketLuan "ketLuan";
  // Target field: NGAY_KQ - Ngày kết quả theo định dạng yyyyMMddHHmm FHIR path: VNCoreDiagnosticReport.issued | VNCoreObservationLab.effectiveDateTime
  sourceBundle.entry 0..* as ngayKqSource -> targetRow.ngayKq "ngayKq";
  // Target field: MA_BS_DOC_KQ - Mã bác sĩ đọc kết quả FHIR path: VNCoreDiagnosticReport.resultsInterpreter.resolve().identifier.value | VNCorePractitioner.identifier.value
  sourceBundle.entry 0..* as maBsDocKqSource -> targetRow.maBsDocKq "maBsDocKq";
}