要設定考勤資料自動同步至Backstage,你可以選擇透過直接資料庫連接(Database Connection)或檔案傳輸(File-based Transfer)來同步資料,下面會講述所需的準備工作和要求
這是我們建議採用的實時整合方法。若您選擇直接連接考勤資料庫,請審閱以下要求:
為配置連接,我們需要您提供以下有關資料庫憑證(credentials)和結構(structure)的詳細資訊:
資料庫登入資料: 用戶名稱和密碼。
資料庫名稱: 儲存考勤記錄的資料庫名稱。
相關表格名稱: 儲存考勤資料的相關表格名稱。
資料映射 (Data Mapping): 您必須說明資料庫中哪些欄位與我們系統所需的欄位相對應。請提供以下特定欄位名稱:
用戶識別碼(User Identification):user_id、employee_no
打卡日期和時間:log_time、timestamp
為使我們的系統能夠遠端存取您的資料庫,您的IT 團隊(或內部 IT 部門)必須採取以下行動:
IP 白名單 (Whitelist IP): 在您的防火牆設定中,將我們的伺服器 IP 地址和連接埠(Port)列入白名單,以允許連入連接。
連接詳細資訊: 向我們提供您的伺服器 IP(或主機名稱 Hostname)和連接埠號碼。
若您偏好透過檔案提供考勤資料,請確保符合以下標準。
支援格式: .txt 、 .csv 或 Excel 檔案( .xls 、 .xlsx )。
必填欄位: 檔案中的每一行/記錄必須包含以下資訊:
員工編號 (Placement Number)(或用戶 ID/用戶號碼)
簽到日期和時間
在預設的匯入時間前,相關檔案必須已更新在指定的位置
2.1:本地 / 網絡磁碟(Local / Network Drive)
適用於檔案儲存在本地路徑,或我們的匯入服務可直接存取的共用網絡磁碟
2.2:遠端傳輸 (FTP/SFTP)
如果檔案儲存在遠端,請向我們提供以下連接詳細資訊:
伺服器詳細資訊: FTP 伺服器 IP(或域名Domain Name)和連接埠。
協議Protocol: 強烈建議使用 SFTP(Secure FTP),因為它經過加密。標準 FTP 不加密,安全性較低。
憑證Credentials: 用戶名稱和密碼。
檔案路徑: 來源檔案所在的確切目錄路徑 (Directory Path)
無論選擇哪種方法,系統都必須能夠將匯入的記錄連結至Backstage
映射鍵 (Mapping Key): 所有考勤記錄必須包含一個與Backstage中現有的員工編號 (Placement Number) 或考勤號碼 (Attendance Number) 相符(例如:員工編號或用戶 ID)。未能對應的記錄將無法匯入。
請確定您偏好的每日資料同步時間。請確保您的資料庫記錄或檔案在排定時間之前已更新並準備就緒。