繁體中文
自訂打印信件
目標
建立可重複使用的信件範本，讓系統帶入診所、醫生、病人及診症資料，再核對內容及列印。這項功能在介面稱為 自訂文件；範本在 設定 → 打印 → 範本 管理。
開始前
- 核對目前診所。自訂範本屬於所選診所。
- 建立或修改共用範本需要相應的打印範本權限；列印時亦須能開啟相關診症或結賬紀錄。
- 先準備診所批准的信件文字及紙張尺寸，並用虛構或獲批准的範例紀錄核對結果。
截圖中的教學範本保持停用，右邊預覽使用系統內建的虛構資料。日常列印選單只會列出已啟用的自訂範本。
1. 建立或選擇範本
- 開啟 設定 → 打印 → 範本。
- 在左邊 自訂範本 選擇要修改的範本。確實需要新範本時，才按旁邊的 新增自訂範本 加號。
- 填寫清楚的 範本名稱，例如「就診資料信」。這是選單內的名稱，與印在紙上的標題分開。
- 核對 啟用。準備中的範本可先取消勾選；要供同事日常選用時，再勾選並儲存。
- 在 紙張設定 選擇尺寸，核對四邊邊距及 基本字體大小。A4 為 210 × 297 毫米，A5 為 148 × 210 毫米。
加號會立即建立範本
按 新增自訂範本 會立即新增一筆紀錄，而且預設為啟用。不要反覆按加號開啟表單。需要保留為草稿時，取消 啟用 後按 儲存變更。
2. 編寫標題及正文
- 按需要選擇 標題圖片，並核對 標題、診所、醫生、病人、個案 和 簽署 的顯示欄位。
- 向下捲動至 標題範本，填寫要印在信件上方的標題。這欄可以使用變數，也可以留空。
- 在 正文範本 填寫信件文字及變數。正文不可只有空格。
- 在右邊 預覽 閱讀整份文件，核對換行、重複資料、字體及紙張邊界。
- 按 儲存變更，再重新選取範本核對內容。如要投入使用，確認 啟用 已勾選並儲存。
欄位勾選控制頁首資料區及簽署區的顯示；正文內的變數會獨立帶入資料。例如取消 病人姓名，不會停用正文中的 {{patient.name}}。同一資料同時出現在頁首和正文時，要自行決定是否保留。
3. 變數怎樣寫
把完整變數放在兩組大括號內，例如：
text
病人：{{patient.name}}
病人編號：{{patient.code}}
預約日期：{{caseInfo.date}}
醫生：{{doctor.name}}- 變數名稱區分大小寫，保留中間的英文句點。
{{ patient.name }}亦可使用，但名稱內不要加入空格。 - 標題範本 及 正文範本 使用相同的變數。
- 未填寫、沒有提供或名稱寫錯的變數會變成空白，不會自動補上「不適用」。變數前後的文字仍會保留。
- 正文以純文字顯示，保留換行。HTML、Markdown 標記、條件判斷、運算及迴圈不會成為格式或程式。
- 日期、時間、年齡和性別使用系統提供的文字；切換介面語言不會自動翻譯整封信件。
設定頁預覽有自己的示範資料。 實際病人資料要在診症或結賬開啟 自訂文件 後核對。設定預覽中的症狀、日期及病人並非目前選取的真實紀錄。
4. 全部可用變數
以下七組共有 44 個可帶入資料的變數。每個變數都以對應紀錄有資料為前提；另外兩個有特殊限制的欄位列於表後。
頁首資料 title
資料來自目前所選診所。title 指頁首使用的診所資料，不是信件的標題文字。
| 變數 | 帶入內容 |
|---|---|
{{title.clinicName}} | 診所名稱。 |
{{title.clinicNameEn}} | 診所英文名稱。 |
{{title.clinicAddress}} | 診所地址。 |
{{title.clinicAddressEn}} | 診所英文地址。 |
{{title.tel}} | 診所電話。 |
{{title.fax}} | 診所傳真。 |
診所資料 clinic
資料同樣來自目前所選診所，另有營業時間。
| 變數 | 帶入內容 |
|---|---|
{{clinic.name}} | 診所名稱，與 title.clinicName 相同來源。 |
{{clinic.nameEn}} | 診所英文名稱。 |
{{clinic.address}} | 診所地址。 |
{{clinic.addressEn}} | 診所英文地址。 |
{{clinic.tel}} | 診所電話。 |
{{clinic.fax}} | 診所傳真。 |
{{clinic.openAt}} | 診所設定的營業開始時間。 |
{{clinic.closeAt}} | 診所設定的營業結束時間。 |
醫生資料 doctor
使用這次診症／預約所帶入的醫生資料，不是目前登入者的姓名。電話、電郵及專業資料須由該醫生紀錄提供。
| 變數 | 帶入內容 |
|---|---|
{{doctor.name}} | 醫生姓名。 |
{{doctor.nameEn}} | 醫生英文姓名。 |
{{doctor.tel}} | 醫生電話。 |
{{doctor.email}} | 醫生電郵。 |
{{doctor.major}} | 醫生專業資格。 |
{{doctor.subject}} | 醫生科目。 |
英文專業資格使用下方的 {{sign.majorEn}}。
病人資料 patient
資料來自這份文件所屬病人。
| 變數 | 帶入內容及格式 |
|---|---|
{{patient.name}} | 病人姓名。 |
{{patient.nameEn}} | 病人英文姓名。 |
{{patient.gender}} | 性別代碼：MALE、FEMALE 或 UNKNOWN。 |
{{patient.idNoLabel}} | 證件號碼的英文欄位名稱，按證件類型顯示，例如 HKID Card No.。 |
{{patient.idNo}} | 證件號碼。 |
{{patient.dob}} | 出生日期，使用英文日期格式，例如 1 Jan 1990。 |
{{patient.age}} | 按目前日期計算的足歲年齡，例如 36 year(s)；未填或無效的出生日期會留空。 |
{{patient.mobileNo}} | 病人完整電話號碼，包含紀錄提供的區號。 |
{{patient.code}} | 按目前診所設定格式化的病人編號，可能包含前綴。 |
預約資料 caseInfo
名稱必須使用 caseInfo。以下日期與時間來自這次預約，不是列印當刻或下一次覆診。
| 變數 | 帶入內容及格式 |
|---|---|
{{caseInfo.date}} | 預約日期，使用英文日期格式，例如 23 Jan 2025。 |
{{caseInfo.appointmentTime}} | 預約紀錄的時間；沒有預約日期時，這組資料會留空。 |
簽署資料 sign
這組提供簽署區可用的診所、醫生姓名及資格文字。把它寫在正文不會產生手寫簽名或簽名圖片。
| 變數 | 帶入內容 |
|---|---|
{{sign.clinicName}} | 診所名稱。 |
{{sign.clinicNameEn}} | 診所英文名稱。 |
{{sign.doctorName}} | 醫生姓名。 |
{{sign.doctorNameEn}} | 醫生英文姓名。 |
{{sign.major}} | 醫生專業資格。 |
{{sign.majorEn}} | 醫生英文專業資格。 |
診症內容 report
資料來自這次載入的診症。從結賬開啟時，須先有關聯診症並完成載入。未填寫的臨床內容會留空。
| 變數 | 帶入內容 |
|---|---|
{{report.complaint}} | 症狀內容。變數名稱使用 complaint。 |
{{report.findings}} | 檢查發現。 |
{{report.diagnosis}} | 診斷。 |
{{report.treatmentPlan}} | 治療計劃。 |
{{report.notes}} | 給病人的備註，不包括私人備註。 |
{{report.vitals}} | 體徵摘要，包含已填寫的測量值及單位。 |
{{report.procedures}} | 治療項目摘要。 |
設定頁的內建示範只提供症狀、檢查發現、診斷及治療計劃。report.notes、report.vitals 及 report.procedures 在設定預覽可能空白，須在有相應資料的診症核對。
另外兩個欄位的限制
| 欄位寫法 | 目前行為及處理方法 |
|---|---|
{{caseInfo.channel}} | 設定頁示範有 Walk-in，但目前實際列印沒有帶入預約途徑，會留空。信件需要這項資料時，先在列印視窗手動核對及填寫。 |
{{sign.patientSign}} | 不是病人簽名。設定示範值是 true，實際帶入的是內部文字 ignored，不應插入信件。需要紙本簽署位置時，在範本的 簽署 勾選 病人簽署。 |
藥物、化驗結果、付款金額、病人地址、過敏、病史及自訂臨床欄位沒有對應的自訂文件變數。不要從其他文件類型的欄位名稱推測寫法；需要這些內容時，使用相應文件或經核對後手動填寫。
5. 可複製的信件範例
就診資料信
在 標題範本 貼上：
text
就診資料信 — {{patient.name}}在 正文範本 貼上，再按診所用途修改固定文字：
text
致 {{patient.name}}：
以下為本次就診資料，供核對：
病人編號：{{patient.code}}
預約日期：{{caseInfo.date}}
預約時間：{{caseInfo.appointmentTime}}
醫生：{{doctor.name}}
如需查詢，請致電 {{clinic.tel}} 聯絡本診所。
{{clinic.name}}
{{clinic.address}}診症摘要信
在 標題範本 填寫「診症摘要」，並在 正文範本 使用以下內容。交出文件前，由負責醫生核對每項臨床資料及收件用途。
text
病人：{{patient.name}} / {{patient.nameEn}}
病人編號：{{patient.code}}
預約日期：{{caseInfo.date}}
症狀：
{{report.complaint}}
檢查發現：
{{report.findings}}
診斷：
{{report.diagnosis}}
治療計劃：
{{report.treatmentPlan}}
體徵：
{{report.vitals}}
治療項目：
{{report.procedures}}
給病人的備註：
{{report.notes}}
{{sign.doctorName}}
{{sign.major}}
{{sign.clinicName}}刪去不適用的整段文字；空白變數不會自動隱藏「診斷：」等固定小標題。
6. 為病人建立及列印信件
- 開啟正確的診症或結賬，先核對診所、病人、預約日期及醫生。診症內容有修改時，先確認儲存成功。
- 按 列印 → 自訂文件，再選擇已啟用的範本。等待病人及相關診症資料載入完成。
- 在 自訂範本 核對所選名稱，再閱讀已帶入資料的 標題範本 及 正文範本。
- 按需要修改這一次信件的文字，補齊必需資料。列印視窗新增的變數不會再次自動替換；需要更改變數時，回到設定修改範本，再重新開啟文件。
- 選擇 打印機。使用瀏覽器流程時選 瀏覽器打印。
- 核對右邊 預覽，確認沒有其他病人的文字、空白必填資料或不適用段落。
- 按 建立文件並列印，再完成瀏覽器的列印選項。
- 到病人的 文件 清單確認文件已保存，需要時開啟預覽。紙本是否印出須另行核對。
切換範本或關閉後重新開啟視窗，會重新套用範本。這次在列印視窗修改的文字不會更新原有共用範本。若列印停滯，先檢查 文件，避免重複建立。
病人文件輸出示範待補
目前圖片涵蓋範本設定及示範預覽。仍需在獲批准的虛構診症完成「建立文件 → 文件清單 → PDF 預覽」的完整示範及紙本列印核對。
7. 儲存為新範本
具備新增打印範本權限時，列印視窗下方會提供 儲存為新範本。選定範本並填寫非空白正文後，按此按鈕，輸入新的範本名稱，再按 儲存。
會儲存目前畫面的文字並啟用新範本
病人資料在開啟列印視窗時已替換成文字，例如 {{patient.name}} 已變成姓名。儲存為新範本 會保存目前的標題和正文，不會自動還原變數，而且新範本會立即啟用。若打算共用，先移除所有病人個人資料；儲存後到 設定 → 打印 → 範本 補回所需變數並核對啟用狀態。
要維護供不同病人重複使用的信件，優先在設定頁編寫含變數的範本。
完成後檢查
- 重新選取範本後，名稱、內容、變數、紙張及啟用狀態仍然正確。
- 實際文件的病人、日期及醫生正確；必需資料沒有留空。
- 已閱讀完整正文，移除不適用段落及示範文字。
- 病人的 文件 清單有預期紀錄；列印結果另外核對。
❓ 常見問題
為甚麼列印選單找不到範本？
核對目前診所，以及範本的 啟用 是否已勾選並儲存。等待範本載入完成；仍找不到時，請管理員核對帳號對診症、結賬及範本的權限。
為甚麼變數變成空白？
先核對名稱大小寫及句點，再檢查對應紀錄是否有資料。臨床內容須有已載入的關聯診症；caseInfo.channel 目前沒有帶入實際列印。正文中變數前後的固定文字仍會保留。
預覽有資料，為甚麼病人的信件沒有？
設定頁使用內建示範資料。請在診症或結賬的 自訂文件 核對實際紀錄。相反，設定預覽未提供的備註、體徵及治療項目，仍可在有相應診症資料時帶入。
可以自訂日期格式或使用今天日期嗎？
目前沒有日期格式指令或今天日期變數。caseInfo.date 是預約日期，patient.dob 是出生日期；兩者使用系統提供的英文日期文字。如信件需要其他日期或格式，核對後在這次列印視窗手動修改。
可以在信件加入私人備註或藥物清單嗎？
report.notes 只帶入給病人的備註，不包含私人備註。自訂文件沒有藥物清單變數；處方內容請使用相應的處方文件入口。
已儲存文件會跟着範本更新嗎？
已建立的文件保留當時的版面及內容。修改共用範本會供之後新開啟的自訂文件使用；如需更正已建立的信件，先核對原文件，再按診所流程重新建立正確版本。
中文頁面為甚麼仍有英文文字？
變數名稱、性別代碼、日期、證件欄位名稱及部分文件固定字樣可使用英文。範本正文亦不會因切換介面而自動翻譯。若設定欄位仍沿用切換前的語言，先保存所需修改，再重新載入頁面。
按取消會刪除已建立的文件嗎？
離開列印編輯視窗的 取消 不等於刪除文件；取消瀏覽器列印亦不能當作「沒有歸檔」的證據。重試前先查看病人的 文件 清單。