講師勤務行事曆
適用平台：Admin 管理後台
更新日期：2026-10-01
1. 功能說明
「講師勤務行事曆」用於匯入及維護講師的研修、監考與活動資料。可一次匯入多位講師、不同月份或年度的勤務，並透過「查詢總表」查詢、修改及刪除。
系統依每筆資料的日期自動歸入對應年月，匯入時不需要選擇目標年度或月份。
2. 準備匯入檔案
進入「講師勤務行事曆匯入」，點選「下載範例檔」，依範例填寫資料。支援 .xlsx 與 .csv；CSV 建議使用 UTF-8 編碼。使用 Excel 時，請將要匯入的工作表設為目前選取的工作表後儲存。
第一列必須保留以下七個欄位名稱。即使地點或備註沒有內容，也不能刪除其表頭。
| 欄位名稱 | 說明 | 填寫要求 |
|---|---|---|
teacher_no | 講師編號 | 必填，使用系統內已存在的講師編號；有前導零時請以文字格式填寫 |
event_date | 勤務日期 | 必填，建議使用 2026-10-01 格式 |
start_time | 開始時間 | 必填，建議使用 09:00 格式 |
end_time | 結束時間 | 必填，必須晚於同一天的開始時間 |
event_title | 勤務名稱 | 必填，最多 100 字 |
location | 地點 | 可留白，最多 100 字 |
note | 備註 | 可留白，最多 400 字 |
也可使用中文表頭：「講師編號、日期、開始時間、結束時間、名稱、地點、備註」。
填寫範例
以下講師編號僅為格式示例，實際匯入請使用系統內的講師編號。
| teacher_no | event_date | start_time | end_time | event_title | location | note |
|---|---|---|---|---|---|---|
| 000001 | 2026-10-01 | 09:00 | 12:00 | 教學研修 | 台北教室 | 上午場 |
| 000001 | 2026-10-01 | 13:00 | 16:00 | 教學研修 | 台北教室 | 下午場 |
若中間有午休或其他不計入勤務的休息時間，請拆成兩筆資料。以上範例計算為 3 小時加 3 小時，共 6 小時；若填成 09:00～16:00，中間休息時間也會計入。
每筆資料只表示單日勤務，不可將結束時間填成隔日的時間。
3. 匯入勤務資料
- 在匯入頁面的「類別」選擇「研修」、「監考」或「活動」。
- 在「檔案」選擇已完成的 Excel 或 CSV 檔案。
- 點選「開始匯入」。
- 匯入成功後，確認畫面顯示的類別、講師人數與新增資料筆數。
- 點選「查詢總表」，以日期區間及類別確認匯入結果。
同一份檔案中的全部資料，都會使用本次選擇的類別。 若有不同類別，請分成不同檔案，分別選擇類別匯入。
匯入只會新增資料，不會覆蓋或刪除先前資料。已匯入的內容若需調整，請到「查詢總表」修改，避免重複匯入。
4. 匯入錯誤與衝突處理
匯入前，系統會檢查必填欄位、日期與時間、講師編號、欄位長度，以及勤務時段衝突。有資料檢核錯誤時，會以錯誤視窗列出檢查到的異常。
只要有任何錯誤，整批資料都不會寫入。 請修正後重新匯入完整檔案，不需要另外補匯其中看似正確的資料。
時段衝突的判斷
- 同一講師、同一天，匯入檔案內的勤務時段不可重疊。
- 同一講師、同一天，匯入勤務不可與系統中既有的研修、監考或活動時段重疊。
- 一筆長時段若涵蓋多筆其他勤務，會列出各組重疊，並標示涉及的資料列。
- 不同講師可在相同時段參加勤務。
- 時段前後相接可以匯入，例如 09:00～12:00 與 12:00～13:00。
- 一般授課排課可與勤務時段重疊；此處檢查的是勤務彼此的衝突。
常見錯誤
| 錯誤情況 | 處理方式 |
|---|---|
| 缺少必要表頭 | 使用範例檔的七個欄位名稱，補回缺少的表頭 |
| 缺少講師編號、日期、時間或名稱 | 補齊錯誤資料列的必填內容 |
| 講師編號不存在 | 確認編號正確，並確認講師已建立於系統 |
| 日期或時間無法辨識 | 日期改用 YYYY-MM-DD，時間改用 24 小時制 HH:MM |
| 結束時間未晚於開始時間 | 確認時間順序；每筆必須為同一天的勤務 |
| 名稱、地點或備註超過字數限制 | 縮短對應欄位內容 |
| 檔案內時段重疊 | 對照錯誤訊息的列號，調整或移除重複時段 |
| 與既有勤務衝突 | 確認是否重複匯入；必要時到查詢總表調整既有資料 |
檔案格式、上傳或表頭錯誤可能使系統無法進入逐筆檢核。此時請先依錯誤訊息修正檔案，再重新匯入。
5. 下載錯誤報告
逐筆資料檢核失敗時，可在錯誤視窗點選「下載錯誤報告 (.xlsx)」。關閉視窗後，也可在匯入頁面點選「下載最近一次匯入錯誤報告 (.xlsx)」。
報告包含全部原始資料，並附上：
- 原始列號：對應原檔案的實際列數，第一列表頭算第 1 列；空白列也會計入列號。
- 錯誤原因：同一筆資料有多個錯誤時，會合併列出；未檢出錯誤的資料列，此欄留白。
報告已凍結表頭並提供篩選，可篩選「錯誤原因」非空白的資料，逐筆處理。錯誤原因留白不表示已匯入成功；有錯誤時，整批仍未寫入。
建議對照報告修正原始匯入檔，再重新上傳。報告保留一小時，重新匯入後會更新或清除；需要留存時請先下載。
6. 查詢與修改勤務
查詢資料
- 在匯入頁面點選「查詢總表」。
- 選擇「類別」：全部、研修、監考或活動。
- 設定「開始日期」及「結束日期」。
- 點選「查詢」。
預設查詢區間為當年度 1 月 1 日至 12 月 31 日。若查詢跨年度資料，請調整日期區間。總表顯示由勤務行事曆匯入建立的資料。
修改資料
可直接在總表修改類別、日期、開始時間、結束時間、名稱、地點及備註。講師編號與姓名僅供查看，不可在此修改。
- 修改需要調整的資料。
- 欄位變更後，系統會自動勾選該筆資料；送出前請確認勾選項目。
- 點選「儲存勾選項目」。
- 確認成功訊息及更新後內容。
只會儲存勾選的資料。若勾選資料有日期、時間、名稱或勤務衝突等錯誤，本次勾選資料不會儲存，請依訊息修正後再送出。
修改日期後，資料會依新日期歸入對應年月。若改到目前查詢區間以外，或改為其他類別，請調整查詢條件後查看。
若原本填錯講師，請刪除該筆資料，再以正確講師編號重新匯入。
7. 刪除勤務資料
- 查詢要刪除的勤務。
- 勾選需要刪除的資料。
- 點選「刪除勾選項目」。
- 確認提示後，確認刪除成功訊息。
表頭核取方塊可全選目前查詢結果。刪除前請再次確認講師、日期與勤務名稱，避免刪除不相關資料。刪除後，資料不再顯示於正常查詢結果；此頁沒有復原按鈕。