# CQL
2025/10/13 次世代CQL國際研討會暨工作坊

## CQL
Clinical Quality Language
臨床品質語言，2011 HL7訂製的一種標準化語言，用於臨床決策支援(CDS)與品質衡量邏輯(CQMs)

主要目的
- 協助醫療系統標準化、互通
- 與FHIR整合，統一任鎮、跨系統相容
- 接近醫學與法，醫師一看就懂，用於健保規範、品質監控、指引

## ELM
Expression Logical Model
ELM 是 CQL 的機器可讀表示形式，通常以 JSON 或 XML 格式呈現

## CQL Engine
CQL 邏輯通常以人類可讀的形式編寫，但在執行前需轉換為機器可讀的 ELM

## eCQM & DQM
Electronic Clinical Quality Measure，電子臨床品質指標:使用CQL與EHR衡量醫療品質(醫療成效)

DQM（Data Quality Measure，資料品質指標）:利用結構化或非結構化資料量化醫療品質

## 流程
EHR → CDS → CQL Engine → ELM → FHIR → 執行邏輯 → UI /醫生回饋
:::info
EHR（電子病歷系統）
1️⃣醫生在 EMR/電子病歷開立醫囑或輸入臨床資料
2️⃣ CDS（Clinical Decision Support）臨床決策支援系統監控醫囑或臨床行為，將要判斷的規則送到 CQL Engine
3️⃣ CQL Engine將人類可讀的 CQL轉換成機器可讀的 ELM
4️⃣ ELM會抓取 FHIR 資料，根據規則計算或判斷
5️⃣ FHIR 資料庫提供病人結構化或標準化資料（檢驗值、用藥紀錄、過敏史等）
6️⃣ 執行邏輯，ELM 對 FHIR 資料進行規則判斷（例如：血糖值超標、藥物禁忌）
7️⃣ UI / 醫生回饋，判斷結果回到使用者界面（UI）醫生看到警示、建議或修改建議，進行臨床決策

CQL：人類可讀規則
ELM：機器可執行規則
CQL Engine：轉換與執行核心
FHIR：標準化病人資料
CDS：提供即時決策支援

:::
## CQL架構
<!--[LINE_ALBUM_CQL研討會_251014_1](https://hackmd.io/_uploads/HktwY03Txg.jpg)-->

## 開發環境
以VS Code為例
- step1.下載Java21(版本:select21-LTS/x64/Windows(.msl)
- step2.環境變數Add To Path
- step3.CMD驗證是否安裝成功 java -version
- step4.VS Code安裝擴充:Clinical Quality Language(CQL)套件

測試檔案:https://github.com/cqframework/vscode-cql/wiki/images/vscodeTest.zip

範例一

範例二

練習
CQL
測試資料

測試結果

檔案路徑都要放對

輸出失敗範例

## CQL 工作坊實作練習
納入條件:女性患者，年齡大於45歲，且BMI>=25kg/m2
排除條件:半年內做過HgA1檢測或過去一年內診斷為空腹血糖(IFG)受損

CQL

輸出結果

## 相關連結
常見CQL引擎
- CQL Ruler 開源Java平台
- CQL Compiler/Translator HL7官方工具

[PPT](https://www.canva.com/design/DAG1uNHSRkI/55OsYa4agwySenoAHWOAJQ/edit?utm_content=DAG1uNHSRkI&utm_campaign=designshare&utm_medium=link2&utm_source=sharebutton)
[CQL_HackMD陳鴻裕](https://hackmd.io/@hongyu0324/cql101)
[FHIR Helpers](https://hl7.org/fhir/uv/cql/Library-FHIRHelpers.html)
[OMOP通用資料模型](https://www.ohdsi.org/data-standardization/)
[Electronic Clinical Quality Improvement (eCQI) Resource Center](https://ecqi.healthit.gov/)
[Quality Improvement Core (QI-Core) Implementation Guide](https://build.fhir.org/ig/HL7/fhir-qi-core/)
[臺灣醫療資訊標準大平台](https://medstandard.mohw.gov.tw/)
[TWCDI](https://twcore.mohw.gov.tw/ig/twcore/twcdi.html)
[Github_CQLFormattingandUsage](https://github.com/cqframework/CQL-Formatting-and-Usage-Wiki/blob/master/Source/CheatSheet/CQL%20Cheat%20Sheet.pdf)
[10/13 次世代CQL國際研討會暨工作坊談話翻譯](https://live.vurbo.ai/?s=SSJU2534)