客戶資料匯入
說明如何填寫 school、student、order 三個 CSV 檔案，將舊系統資料匯入 LinkClass。
本文件說明如何填寫 3 個 CSV 檔案，將舊系統資料匯入新系統。請先閱讀匯入順序與通用規則，再按各檔案的欄位說明填寫。
匯入檔案總覽
| 順序 | 檔案 | 內容 | 每列代表 |
|---|---|---|---|
| 1 | school_export.csv | 校舍、課室、導師、課程、課堂 | 一堂課 |
| 2 | student_export.csv | 學生、家長 | 一個學生 |
| 3 | order_export.csv | 訂單、訂單項目、付款 | 一個訂單項目 |
匯入順序不可顛倒：order 檔案所引用的學生必須已存在於 student
檔案；student 檔案所引用的年級／科目若不存在，系統會自動建立。
通用規則
- 日期格式一律為
YYYY-MM-DD（例：2026-09-01）；時間格式一律為HH:MM24 小時制（例：10:00）。 - 沒有資料的欄位請留空，不要填寫
N/A、0、-，否則系統會當成有效資料處理。 - 重複匯入是安全的：已存在的紀錄會自動跳過。匯入後請查閱報告，修正錯誤欄位後直接重新匯入同一份檔案即可，不會產生重複資料。
- 單一列出錯不會影響其他列。報告的
errors部分會列出每列錯誤（列號 + 原因），按報告修正即可。 - 請勿修改檔案第一行（欄位標題）。
已存在的紀錄會全部跳過，可安心重新匯入同一批檔案，不會造成重複。
常見問題
| 情況 | 系統行為 | 處理方法 |
|---|---|---|
| 學生編號已存在（重新匯入／檔案內重複列） | 不會重複建立；以檔案中非空白欄位更新該生資料，空白欄位保留原值；計入 skipped | 無需處理；確認更新欄位正確即可 |
| 訂單中的學生不存在 | 該列記入錯誤「找不到學生 xxx」，該訂單不建立，其餘列照常匯入 | 檢查 student 檔是否漏了該編號（常見：舊系統只有繳費紀錄、沒有學生資料）→ 補入 student 檔 → 重新匯入 order 檔 |
| 課程編號重複 | 該列記入錯誤「課程代碼重複，請加上期數區分」 | 多期課程的 Course Code 加上期數（ENG2324-1、ENG2324-2） |
| 科目／年級／學生來源不存在 | 自動建立 | 無需處理；其後可於系統內改名 |
| 日期／時間／金額格式錯誤 | 該列記入錯誤（列號 + 原因） | 按錯誤訊息修正該列後重新匯入 |
| 家長電話留空 | 該學生無家長資料（不會報錯） | 有家長資料才填寫電話 |
已付款訂單的 Paid Amount 留空 | 視為全數付款 | 部分付款請填寫實際已付金額 |
| 重新匯入同一批檔案 | 已存在紀錄全部跳過，可安心重新匯入 | 直接重新匯入即可 |
school_export.csv（每列 = 一堂課）
| 欄位 | 必填 | 限制／說明 |
|---|---|---|
Course Code | ✓ | 課程編號。同一課程的所有列必須完全相同；整個檔案不得重複（多期課程請加期數區分，如 ENG2324-1、ENG2324-2） |
Course Name | ✓ | 課程名稱 |
Term | 學期／期別（例：2024-25） | |
Series | 系列（例：English） | |
Subject | 科目名稱（例：English、Math、數學）；不存在會自動建立 | |
School Level | 年級名稱（例：Secondary 2、中二）；不存在會自動建立 | |
Teacher | 導師姓名（例：Mr Wong）；不存在會自動建立 | |
Center | ✓ | 校舍名稱；同一校舍所有列必須一致（例：Central Campus） |
Classroom | 課室名稱（例：Room 201） | |
Quota | 課程名額（數字） | |
Lesson Date | ✓ | 該堂課日期（例：2026-09-01）；課堂不會跨日 |
Lesson Start Time | 該堂課開始時間（例：10:00） | |
Lesson End Time | 該堂課結束時間（例：11:30） | |
Price per Lesson | 每堂收費（數字） | |
Lesson Remark | 堂次備註（文字） |
系統自動計算，毋須填寫：課程開始／結束日期（由第一堂／最後一堂課推算）、課程收費（由每堂課收費總和計算）、課程狀態、課堂編號。
student_export.csv（每列 = 一個學生）
| 欄位 | 必填 | 限制／說明 |
|---|---|---|
Student number | ✓ | 學生編號；整個檔案必須唯一；同時是學生登入帳戶 |
Student Name | 英文姓名（姓 + 名，例：CHAN Tai Man） | |
Gender | Male / Female / 男 / 女 | |
Date of birth | 出生日期 | |
Student Phone | 電話號碼。香港電話（8 位）或內地電話（11 位、以 1 開頭）可直接填寫純號碼，系統會自動判斷區號；其他地區請加上區號前綴（例：+886 912345678）；亦可直接填寫 +852 91234567、8613812345678 等帶區號格式 | |
School Name | 學校名稱（例：St Paul Co-ed） | |
School Level | 年級（規則與 school 檔相同） | |
Teaching Language | English / Chinese（留空則預設為 English） | |
Parent Phone | 電話號碼（格式與 Student Phone 相同，包括自動區號判斷）；留空 = 該學生無家長資料 | |
Parent Name | 家長姓名（例：CHAN Wai Ming） | |
Relationship | 與學生關係（例：father、mother、父、母） | |
Enrolment Date | 入學／報名日期 | |
Remarks | 內部備註（不會向學生顯示） |
系統自動行為：
- 學生編號留空時會自動產生；建議沿用舊系統編號，方便對照。
- 學生預設密碼 = 學生電話號碼（不含區號）；無電話號碼的學生預設密碼為
000000。
密碼只在建立時設定，重複匯入不會覆蓋原有密碼；學生登入後可自行更改。
order_export.csv（每列 = 一個訂單項目）
| 欄位 | 必填 | 限制／說明 |
|---|---|---|
Reference Number | ✓ | 舊系統單號。同一張訂單有多個項目時：所有項目共用同一單號、各佔一列（例：同一張單有 2 個項目 → 2 列，單號相同） |
Student number | ✓ | 學生編號；必須已存在於 student 檔案 |
Item Name | ✓ | 訂單項目名稱（例：English Level 2） |
Price | 項目單價（數字；數量恆為 1，毋須填寫） | |
Order Status | Paid / Partial Paid / Pending / Cancelled（或中文：已付 / 部分 / 未付 / 取消） | |
Paid At | 付款日期；有付款才填寫 | |
Paid Amount | 已付金額。Partial Paid 必填；Paid 留空 = 視為全數付款 | |
Remark | 備註 |
系統自動行為：
- 舊單號會保留在系統中，新系統單號會自動產生。
- 學生的欠款金額與付款狀態由訂單自動計算，毋須手動填寫。
- 報名（學生 × 課程）與出席紀錄不會隨今次匯入一併產生。
注意事項
- 請按順序匯入：
school_export.csv→student_export.csv→order_export.csv。 - 空白欄位請留空，勿填寫用作代替空白的符號。
- 匯入後請查閱報告中的錯誤列，修正後直接重新匯入同一份檔案即可。
返回首頁：文件總覽