CSV：範本與欄位
CSV 範本下載、編碼約定與常見欄位含義。
integrationcsv
受眾：教務 / 機構管理員 · 適用：SaaS / 私有
目標：按官方範本正確填表，減少校驗失敗。
使用前
- 在機構管理 資料整合 下載對應類型的 官方範本（老師 / 學生 / 班級 / 班級成員等）。
- 用 UTF-8 儲存；Excel 編輯後請確認未變成系統預設 ANSI 編碼。
- 不要改表頭列名；刪除空行與合併單元格。
- 一檔案只放一種導入類型。
欄位約定（通則）
| 類型 | 說明 |
|---|---|
| 必填 | 範本標註必填的列不可為空 |
| 信箱 | 建議小寫；同一機構內避免重複 |
| 顯示名 | 師生在 App 中看到的名稱 |
| 班級代碼 | 須與系統中已有班級或同批將導入的班級一致 |
| 角色 | 僅使用範本允許的取值（如 teacher / student） |
| 初始密碼 | 若提供，需滿足最少位數等策略；也可導入後由管理員重置 |
| 學號/工號 | 若範本有此列，建議與教務唯一鍵一致，便於對賬 |
具體列名與枚舉以範本檔案為準；不同版本範本可能增減列。
分類型注意點
| 類型 | 注意 |
|---|---|
| 班級 | 先保證代碼唯一；名稱可含年級/學期資訊 |
| 老師 / 學生 | 信箱是登入鍵之一；勿與其他角色串用同一信箱（除非產品明確支援） |
| 班級成員 | 依賴已存在的班級代碼與帳號；先導班級與人，再導關係 |