員工批量匯入與匯出
員工量較多時可在員工頁面下載 CSV 範本、批次匯入並核對成功與失敗數量；匯出文件包含人員信息，應按企業內部資料管理。
本章僅介紹本企業內獲授權的操作。入口和按鈕隨企業開通範圍、員工角色與職位變化；實圖使用測試資料。
入口與前置條件
進入「基礎資料 → 員工」。匯入需要新增員工權限，匯出需要對應查看權限。先建立模板中要引用的部門、角色和職位，核對可用成員數量。
模板主要字段
| 範本列 | 填寫要求 |
|---|---|
| 目前 CSV 導入必填，不能在同一文件中重複，也不能使用已存在的郵箱。 | |
| password | 目前 CSV 匯入必填，符合帳號密碼規則；匯入後依企業流程交付員工。 |
| full_name | 員工顯示姓名。 |
| department_code | 填寫本企業已有部門編碼，不是部門名稱。 |
| role_codes | 填寫本企業已有角色編碼；多值以英文逗號或分號分隔，CSV 編輯器應正確保留整列。 |
| post_codes | 填寫本企業已有職位編碼，不是職位顯示名稱。 |
| is_active | 按範本填寫啟用狀態；其餘範本列保持普通員工預設值。 |
導入步驟
- 點選“下載模板”，以最新模板為準，不自行改動列名。
- 填寫少量員工樣本，檢查郵箱唯一性以及部門、角色、職位編碼。
- 儲存為 UTF-8 編碼的 .csv 檔案；不要將 XLSX 改副檔名偽裝成 CSV。
- 點擊“導入”，選擇文件，等待結果。
- 核對成功數、失敗數與傳回的錯誤行；先查詢確認已成功員工，再只重試失敗資料。
- 匯入後查詢系統記錄的使用者名稱/工號，按需補齊照片、手機號碼與入職日期；需要自訂工號時，先使用單一新增表單，無法在編輯頁直接變更使用者名稱。
導入與單一新增的區別
單一新增頁面支援填寫使用者名稱和選用信箱；目前 CSV 匯入以信箱和密碼作為必填列，不代表照片、手機號碼和入職日期都會自動匯入。不要把未出現在範本中的自訂列當成已支援功能。
導出與核對
點擊「匯出」以取得 CSV 後，檢查記錄範圍和字段，不預設一定只匯出了當前頁或目前篩選。表格中的長編號與日期注意保持原值。匯出資料含人員訊息，不應放入公開文件或廣播素材。
常見錯誤
編碼錯誤：重新以 UTF-8 CSV 儲存。郵箱重複：查詢已存在員工，不重複新增。部門、角色或職位編碼無效：先核對本企業基礎資料。部分行成功：只修正失敗行，不整批盲目重複導入。