考勤資料自動同步

09-Dec-2025 · Wing Au Yeung
其他語言版本 English

概覽

要設定考勤資料自動同步至Backstage,你可以選擇透過直接資料庫連接(Database Connection)或檔案傳輸(File-based Transfer)來同步資料,下面會講述所需的準備工作和要求

A: 資料庫連接 Database Synchronisation

這是我們建議採用的實時整合方法。若您選擇直接連接考勤資料庫,請審閱以下要求:

1. 必需資料

為配置連接,我們需要您提供以下有關資料庫憑證(credentials)和結構(structure)的詳細資訊:

  • 資料庫登入資料: 用戶名稱和密碼。

  • 資料庫名稱: 儲存考勤記錄的資料庫名稱。

  • 相關表格名稱: 儲存考勤資料的相關表格名稱。

  • 資料映射 (Data Mapping): 您必須說明資料庫中哪些欄位與我們系統所需的欄位相對應。請提供以下特定欄位名稱:

    • 用戶識別碼(User Identification):user_id、employee_no

    • 打卡日期和時間:log_time、timestamp

2. 網絡和遠端存取

為使我們的系統能夠遠端存取您的資料庫,您的IT 團隊(或內部 IT 部門)必須採取以下行動:

IP 白名單 (Whitelist IP): 在您的防火牆設定中,將我們的伺服器 IP 地址和連接埠(Port)列入白名單,以允許連入連接。

連接詳細資訊: 向我們提供您的伺服器 IP(或主機名稱 Hostname)和連接埠號碼。

B:檔案傳輸同步 (TXT, CSV, Excel)

若您偏好透過檔案提供考勤資料,請確保符合以下標準。

1. 檔案格式和內容

支援格式.txt .csv 或 Excel 檔案( .xls .xlsx )。

必填欄位: 檔案中的每一行/記錄必須包含以下資訊:

  • 員工編號 (Placement Number)(或用戶 ID/用戶號碼)

  • 簽到日期和時間

2. 檔案位置和傳輸方法

在預設的匯入時間前,相關檔案必須已更新在指定的位置

2.1:本地 / 網絡磁碟(Local / Network Drive)
適用於檔案儲存在本地路徑,或我們的匯入服務可直接存取的共用網絡磁碟

2.2:遠端傳輸 (FTP/SFTP)
如果檔案儲存在遠端,請向我們提供以下連接詳細資訊:

  • 伺服器詳細資訊: FTP 伺服器 IP(或域名Domain Name)和連接埠。

  • 協議Protocol: 強烈建議使用 SFTP(Secure FTP),因為它經過加密。標準 FTP 不加密,安全性較低。

  • 憑證Credentials: 用戶名稱和密碼。

  • 檔案路徑: 來源檔案所在的確切目錄路徑 (Directory Path)

一般要求

1. 資料完整性與Backstage對應

無論選擇哪種方法,系統都必須能夠將匯入的記錄連結至Backstage

映射鍵 (Mapping Key): 所有考勤記錄必須包含一個與Backstage中現有的員工編號 (Placement Number) 或考勤號碼 (Attendance Number) 相符(例如:員工編號或用戶 ID)。未能對應的記錄將無法匯入。

2. 同步排程Synchronization Schedule

請確定您偏好的每日資料同步時間。請確保您的資料庫記錄或檔案在排定時間之前已更新並準備就緒。