數據庫與斷線應變疑難排解
在 Remote(遠端)模式下,遠端數據庫是永久保存營業數據的地方。數據庫無法使用期間,FMX EPOS 可把符合資格的收銀寫入排入隊列,待數據庫恢復回應後再按次序傳送。以下檢查由經理或管理員進行;收銀員應保持收銀機原狀,並通知他們。
數據庫無法使用
「數據庫無法使用」一節已登入的收銀機在數據庫斷線期間會顯示警告橫額 Database offline(數據庫離線;「Sales are kept on this till.」),之後在已保留的工作送到數據庫之前顯示 Syncing … local writes(正在同步本機寫入)。某項操作亦可能被拒絕並顯示與數據庫有關的訊息,頁面可能顯示 Database Connection Unavailable(「EPOS cannot reach the database right now. Check the network connection, then try again.」),登入頁面亦會顯示斷線。
- 記下訊息的確實內容和時間。
- 確認是否所有終端機都受影響。如只影響一部,請檢查該終端機的網絡和數據庫設定。
- 如某部終端機已打開管理後台,查看 Back Office → Diagnostics(管理後台 → 診斷)中的 Database(數據庫)和 Continuity(斷線應變)卡片。數據庫回應之前,不能重新登入管理後台。
- 只使用 FMX EPOS 提供的離線操作。如某項操作表示需要遠端數據庫,請停止,不要猜測。
- 不要登出或重新啟動其他收銀機。數據庫中斷期間,登入頁面會顯示「The database is unavailable or emergency bills are waiting to sync. Only the emergency terminal can sign in offline.」。在其他收銀機輸入 PIN 會被拒絕,並顯示「Cannot connect to the database. Check the connection and sign in again.」。
- 不要為了令訊息消失而更改儲存模式或另建數據庫。如要找出問題和合適的做法,使用 Recover Connection。
- 如數據庫在這部電腦上,並由 FMX EPOS 安裝,Recover Connection 會說明。否則請修復數據庫伺服器或網絡連接。數據庫密碼更改了,或數據庫被改名或移除,在 FMX EPOS 看來亦與斷線無異,因此這些亦要檢查。
- 傳送排隊中的寫入期間,讓終端機保持運行。
- 在每部曾經離線運作的終端機上,留意 Diagnostics Database 卡片上的 Pending Writes(待處理寫入)。Diagnostics 底部的 Terminals 卡片,以及 Database 頁面上的同一卡片,會在一個列表中顯示每部終端機的待處理寫入。
Database
- Mode
- Remote
- Pending Writes
- 3
- Review Writes
- 0
Continuity
- Emergency Journal
- Inactive
- Queueing Writes
- Yes
示意圖,並非截圖。實際畫面可能因主題或版本而有所不同。
數據庫中斷期間,需要數據庫的操作會被拒絕,並以訊息說明原因,例如「Coupons cannot be checked while the database is offline. Record the payment without a coupon or wait for the connection.」。排隊中訂單的廚房單和標籤會等到數據庫重新連接才打印;訂單到達數據庫之前,其完整訂單號碼會顯示為 Pending Sync。
數據庫恢復後,部分操作仍要等這部終端機排隊中的寫入到達數據庫。大部分訊息會列出該操作,並以「Waiting for N queued writes to reach the database.」結尾,例如「Coupons cannot be checked. Waiting for 3 queued writes to reach the database.」。這適用於任何銷售的優惠券、積分和會員優惠、排隊中訂單的廚房單和標籤打印、儲存或付款仍在排隊中的訂單的退款,以及會員費退款。訂單退款會顯示「Waiting for queued writes to reach the database. No refund has been started.」,會員費退款則只顯示「Waiting for 3 queued writes to reach the database.」。
X 和 Z 報表需要遠端數據庫。以下情況亦會拒絕 Z 報表:這部終端機有排隊中或被擱置的寫入、該時段有未知的刷卡結果或未記錄的刷卡退款,或另一部在線的終端機有未確認的寫入。訊息會列出相關終端機。如另一部終端機處於離線狀態,收銀機會顯示 Run Z Report? 和「… is offline. Its unsent data will not be in this Z. Continue?」。只有你接受該終端機未傳送的數據不計入這份 Z 報表時,才選擇 Run Z Report。
待處理寫入和需要覆核的寫入
「待處理寫入和需要覆核的寫入」一節- Diagnostics Database 卡片上的 Pending Writes,是這部終端機仍持有的所有寫入數目,包括被擱置待覆核的寫入。未被擱置的寫入會在數據庫回應後自動清除。
- Review Writes(待覆核寫入)是被擱置的寫入數目。
被擱置的寫入列於 Payment Review(付款覆核)的 Local Writes Needing Review(需要覆核的本機寫入)下。數據庫因連接中斷以外的原因拒絕某筆寫入時,例如數據錯誤或兩部收銀機同時更改同一筆記錄,該寫入便會被擱置;排在它後面的相關寫入亦會一併擱置(「Waiting for an earlier update to be reviewed.」)。標示為 Review 的寫入會在失敗後分別等候 1、5 和 15 分鐘自動重試,前提是數據庫可以連接,而且沒有較早的被擱置寫入阻擋它;等候較早更新的寫入會在該更新處理後繼續。有些錯誤需要員工或支援人員處理。使用 Reconcile 之前,先查看顯示的原因。其他訂單會繼續同步。這個列表只會在持有這些寫入的終端機上出現。
處理需要覆核的寫入:
- 在持有該寫入的終端機上,打開 Back Office → Orders → Payment Review(管理後台 → 訂單 → 付款覆核)。收銀機的 Cash & Card → Payment Review(現金與刷卡 → 付款覆核)會列出相同的寫入和相同的按鈕。
- 閱讀 Reason 欄。Operation 欄會以訂單標示訂單的儲存、付款或退款,例如 Order Payment · #12 · £12.50 · Card,其他寫入則以其類型標示。展開 Recorded Details(已記錄的詳情)查看已儲存的記錄。如無法判斷它屬於哪張訂單、哪位顧客或哪筆付款,請把截圖傳送給支援人員。
- 在 FMX EPOS 中查明永久記錄應該是甚麼。
- 修正原因,然後選擇 Retry Database Write(重試數據庫寫入)。重試永遠不會向 Clover 再發出請求。如該寫入仍留在列表中,表示尚未寫入:請再次閱讀 Reason。
- 只在別無他法時才使用 Reconcile(核對處理),見下方警告。
Local Writes Needing Review1
| Recorded | Operation | Reason | Attempts |
|---|---|---|---|
| 21/10 13:41 | Recorded Details | Review: This order was changed on another terminal. Reopen it before saving or taking payment. | 3 |
示意圖,並非截圖。實際畫面可能因主題或版本而有所不同。
Recover Connection(恢復連接)
「Recover Connection(恢復連接)」一節收銀機無法連接數據庫時,Recover Connection 會找出原因,並提供合適的做法。只有在桌面應用程式中、數據庫沒有回應,而終端機並非因維護而暫停時,才可使用。請在每部無法連接的收銀機上,於登入頁面或 Database Connection Unavailable 頁面選擇它。
What Is Wrong(問題所在)會說明數據庫的位置和 FMX EPOS 的發現。What To Do(處理方法)列出可選項目,最可能的解決方法排在最前,並標示 Recommended(建議)。Return to Sign In(返回登入)不會作任何更改。
| 頁面顯示 | 可選項目 |
|---|---|
| 這部電腦上的 MySQL 服務已停止 | Start MySQL、Reinstall MySQL、Use Another Database |
| 這部電腦上的 MySQL 正在運行,但不讓收銀機連接 | Reinstall MySQL、Enter New Connection Details、Use Another Database |
| 這部電腦上的 MySQL 已被移除,或只剩部分 | Reinstall MySQL、Use Another Database |
| 其數據庫已不存在 | Use Another Database |
| 數據庫在另一部電腦上,沒有回應 | Enter New Connection Details、Use Another Database |
Start MySQL(啟動 MySQL)
「Start MySQL(啟動 MySQL)」一節Windows 會徵求許可,之後服務便會啟動,收銀機返回登入頁面。
Reinstall MySQL(重新安裝 MySQL)
「Reinstall MySQL(重新安裝 MySQL)」一節FMX EPOS 會下載 MySQL 8.4(約 270 MB,因此這部電腦需要連接互聯網),並讓它重新使用這部電腦上的數據庫。Windows 會先徵求許可。銷售、餐牌和設定都維持不變。
Enter New Connection Details(輸入新的連接資料)
「Enter New Connection Details(輸入新的連接資料)」一節如數據庫伺服器運作正常,只是已搬移或其登入資料已更改,請使用這項。你需要店舖一位有效後台管理員的用戶名稱和密碼。
- 選擇 Enter New Connection Details,再選擇 Continue。New Connection Details(新的連接資料)頁面會打開。
- 輸入 Database Server IP Address 和 Port。如數據庫登入名稱或密碼已更改,在 Database Login(數據庫登入名稱)和 Database Password(數據庫密碼)輸入新的資料;Database Login 留空則沿用這部收銀機的登入名稱。然後在 Administrator Username 和 Password 輸入後台管理員的用戶名稱和密碼。這裏用的是後台登入資料,不是數據庫登入名稱。
- 選擇 Check Database。
- FMX EPOS 會說明該數據庫屬於哪間店舖,並詢問「Connect this till to it? Its waiting sales and emergency bills then go there.」。選擇 Connect This Till,或選擇 Cancel。
- 收銀機會返回登入頁面。之後,它排隊中的寫入會傳送到新地址的數據庫。
示意圖,並非截圖。實際畫面可能因主題或版本而有所不同。
如這部收銀機沒有在該地址的數據庫上登記,檢查會被拒絕,並顯示「This till is not registered on the database at that address, so it may be another shop’s. Check the address.」。如數據庫已因遷移而停用,請改為在 Administrator Recovery 把終端機轉到新數據庫。
Use Another Database(使用另一個數據庫)
「Use Another Database(使用另一個數據庫)」一節這會離開店舖的數據庫,所以只有在該數據庫已不存在,或你確定要重新開始時才使用。選擇 Use Another Database、Continue,再選擇 Leave This Database(離開這個數據庫)。數據會保留在該數據庫中,首次設定可以把收銀機重新連接到它。之後首次設定會打開,你可以選擇這部電腦上的新 MySQL 數據庫、Local SQLite、另一部數據庫伺服器或另一部收銀機的數據庫。選定另一個數據庫之前,Back 會返回這裏。
這部收銀機持有斷線期間儲存的銷售或應急賬單時,不能使用這個選項。這些記錄屬於該數據庫,請先把它們送到那裏。
應急終端機狀態
「應急終端機狀態」一節遠端數據庫中斷期間,只有 Emergency Terminal(應急終端機)可以保存餐廳的餐桌賬單。管理員須預先在 Database → Terminals 選定這部終端機;參閱選擇應急終端機。如沒有選定,Diagnostics 會顯示警告。選定後,該終端機必須曾經在線,才會儲存一份餐廳設定的副本。其他終端機仍可繼續使用可離線運作的收銀操作,但不能處理餐桌賬單,並會顯示「The database is offline. Only the emergency terminal with a saved configuration can do this until it is back.」。
Emergency Terminal 處理這些賬單期間,便是處於應急模式。訂單面板會顯示 EMERGENCY · NEW BILLS ONLY,而餐桌平面圖會顯示「Emergency Mode: only new bills opened on this terminal are shown. Existing remote bills and table occupancy cannot be checked.」,即只顯示在這部終端機上新開的賬單,無法查看現有的遠端賬單和餐桌佔用情況。應急模式下不能點算現金,也不能產生 X 和 Z 報表。數據庫離線期間,無法核對優惠券和會員優惠。
應急模式下的賬單和訂單會打印廚房單,但不論在斷線期間或上載之後,都不會出現在廚房屏幕上。廚房要按這些訂單的紙本廚房單工作。
中斷期間在 Emergency Terminal 上接的預約訂單,會按店舖的 Kitchen Release 規則送廚。Integration Host 暫時看不到這些訂單,因此由 Emergency Terminal 自行放行。設為 Manual 的訂單要等員工在 Emergency Terminal 的 Orders → Kitchen Release 送出。已放行的訂單在上載後不會再次送廚。
Emergency Mode: only new bills opened on this terminal are shown. Existing remote bills and table occupancy cannot be checked.
示意圖,並非截圖。實際畫面可能因主題或版本而有所不同。
數據庫恢復後,一般排隊中的寫入會先傳送,之後才上載應急賬單。上載完成前,Diagnostics 中的 Continuity 卡片會顯示 Emergency Mode(應急模式),任何問題都會在 Attention(注意)旁顯示:
- 「Finish or review the current payment and printing operation before synchronising emergency bills.」或「Record or reverse the approved card payment before synchronising emergency bills.」:先在 Emergency Terminal 上完成該付款或打印。之後上載會自動開始。
- “Emergency bills are not uploaded until this terminal’s unfinished card requests are checked: …”: FMX EPOS 未能完成上次運行留下的刷卡請求的自動檢查,訊息後會顯示原因。系統會在下次同步時再試,請保持終端機運行。如同一原因持續出現,請聯絡支援。標為 unknown 的刷卡結果本身不會阻止上載,稍後仍須在 Payment Review 核對。確認是否已有款項轉移之前,不要重複付款或退款。
- 「Emergency bills could not be uploaded and need review: …」後面附上原因:系統沒有上載任何內容。終端機會恢復處理應急賬單,直至問題修正並成功上載為止。如原因指某張應急餐桌在遠端被佔用或正在清理,即餐廳數據庫中的同一張餐桌仍有未結賬單、已付款等候釋放,或正在清潔。之前已使用並已釋放的餐桌不計算在內。請在另一部收銀機空出該餐桌,或在應急終端機把應急賬單移到一張空桌;兩張賬單都沒有被覆寫。
- 「Waiting to confirm the remote upload. Do not repeat payment or printing.」:上載期間連接中斷。賬單會保持鎖定,直至 FMX EPOS 能夠確認上載是否已經到達。數據庫一有回應,系統便會自動確認。
- 「Emergency bills were uploaded but could not be cleared from this terminal: …」:上載已經到達。FMX EPOS 會在下次同步時從這部終端機清除這些賬單。
Emergency Terminal 仍有應急賬單時,不要更新它的 FMX EPOS,因為由某個版本記錄的賬單必須由同一版本上載。不要刪除本機的應用程式數據,或切換數據庫,以強行解鎖賬單。如訊息沒有消失,請把它傳送給支援人員。
終端機停在維護頁面
「終端機停在維護頁面」一節Database 頁面上的 Data Migration、Import Data、Export Data 和排定的 Automatic Backup,都會令所有終端機暫停。暫停的終端機會顯示 Terminal Paused:「This terminal is paused for database maintenance. Do not repeat payments or printing. …」,並有 Administrator Recovery(管理員恢復)按鈕。已打開的顧客顯示屏亦會顯示暫停,但沒有這個按鈕。仍有排隊中寫入或應急賬單的終端機,會在傳送期間繼續營業,然後才暫停。匯出或自動備份期間無須操作:訊息會說明,終端機會自行恢復運作。
匯出或自動備份完成後會解除暫停。如發起操作的終端機在操作期間停機(例如停電),它重新啟動後會解除暫停。匯入或遷移成功後,只有執行該操作的終端機會繼續運作,其他每部終端機都會保持暫停:
- 匯入後,用 Resume This Terminal 逐部恢復其他終端機。
- 遷移後,用 Move to Another Database 把其他每部終端機轉到新數據庫。舊數據庫會被標示為已停用,終端機不能在舊數據庫上恢復運作。
如操作在更改任何數據之前已經失敗,FMX EPOS 通常會自行解除暫停。如新數據庫沒有確認變更,訊息會表示它「may or may not hold the new data」,所有終端機都會保持暫停。請先檢查目標數據庫,再恢復發起該操作的終端機,其他終端機便會自行恢復。如匯出或自動備份在無法連接數據庫時完成,執行該操作的終端機會在數據庫恢復回應後解除暫停。
Resume This Terminal
Move to Another Database
示意圖,並非截圖。實際畫面可能因主題或版本而有所不同。
- 在發起該操作的終端機上,閱讀遷移或匯入的最後訊息。
- 結果未明期間,不要再次發起同一項具破壞性的操作。
- 在暫停的終端機上,選擇 Administrator Recovery。
- 如要繼續使用同一個數據庫,在 Resume This Terminal(恢復此終端機)下輸入管理員的用戶名稱和密碼,然後選擇 Check & Resume This Terminal(檢查並恢復此終端機)。
- 如要把這部終端機指向新的數據庫,在桌面應用程式中填寫 Move to Another Database(轉移到另一個數據庫):新數據庫的 Database Type、Server、Database、Database Username 和 Database Password,以及 Administrator Username 和 Administrator Password,然後選擇 Move This Terminal(轉移此終端機)。如數據庫沒有任何用戶帳戶,系統會改為開始首次設定。
- 每次只處理一部終端機。
如恢復時被拒絕,並顯示「An export or automatic backup started on … has not ended. Resume that terminal first; …」,表示該終端機的匯出或自動備份仍未結束。重新啟動該終端機(自動備份則是 Integration Host):它會自行結束該操作,其他終端機隨即恢復。如它不會再回來,在 Resume This Terminal 下剔選 End an export or automatic backup another terminal started and will not finish,再選擇一次 Check & Resume This Terminal;該操作沒有更改任何數據。如恢復時被拒絕,並顯示「The configured database is still under maintenance or has been retired. Configure the destination database before resuming this terminal.」,表示另一部終端機的匯入或遷移尚未結束,或數據庫已遷移:先恢復發起操作的終端機,只有在遷移之後才使用 Move to Another Database。
維護被拒絕
「維護被拒絕」一節發起維護的終端機必須先傳送自己排隊中的寫入和應急賬單,否則會顯示「Synchronise this terminal’s emergency bills and local writes before maintenance.」。之後它會等候其他每部已登記的終端機暫停,最多 30 秒。如有終端機沒有暫停,訊息會以「Maintenance did not start. Every registered terminal must confirm that it has stopped and has nothing left to synchronise.」開頭,並列出每部相關終端機及其原因,例如「Local writes must be synchronised first」(須先同步本機寫入)、「Emergency bills must be synchronised first」(須先同步應急賬單)、「Finish the active operation」(完成進行中的操作)或「terminal has not confirmed maintenance」(終端機未確認維護)。已關機的終端機通常會顯示「Waiting for maintenance request」。
然後按拒絕訊息所列的項目處理:
- 另一部在線的終端機運行的 FMX EPOS 版本使用不同的數據庫結構(「… Update both to the same version before maintenance.」)。請先更新該終端機。
- 有終端機沒有暫停、已關機,或仍有未確認的寫入或應急賬單。
- 「Finish or review these on all terminals before database maintenance: …」:有刷卡操作正在進行、刷卡結果未知,或有打印工作正在打印或其結果未知。訊息會列出打印工作所在的終端機。
Every registered terminal must confirm that it has stopped and has nothing left to synchronise. Bar Till: Local writes must be synchronised first
Terminals
| Terminal | Last Seen | Pending Writes | Maintenance | Action |
|---|---|---|---|---|
| Front Till | 21/10/2026 14:02:10 | 0 | Paused | Remove |
| Bar Till | 21/10/2026 14:02:08 | 2 | Blocked: Local writes must be synchronised first | Remove |
| Kitchen PC | 20/10/2026 23:10:41 · Offline | 0 | Waiting for maintenance request | Remove |
示意圖,並非截圖。實際畫面可能因主題或版本而有所不同。
在訊息所指的終端機上使用 Diagnostics、Payment Review 和 Print Queue(打印隊列),並查看 Database(數據庫)頁面上的 Terminals(終端機)卡片。如某部終端機可以重新連接並同步,不要只為了繞過拒絕而移除它。
排定的 Automatic Backup(自動備份)不會等候在 Terminals 卡片上顯示為 Offline(離線)的終端機,因此晚上關機的收銀機不會阻止備份。其他所有維護都會等候每部已登記的終端機。
終端機身份衝突
「終端機身份衝突」一節每個 FMX EPOS 安裝都有自己的終端機身份。如把安裝資料夾複製到另一部電腦,兩部電腦便會帶有相同的身份。當 FMX EPOS 發現自己的身份已在另一部電腦上運行,便不會啟動收銀機,而會顯示 Terminal Identity In Use(終端機身份已被使用),連同「This terminal’s identity is also running on …」及另一部電腦的名稱。它無法判斷哪一部電腦是複製品。
Terminal Identity In Use
This terminal’s identity is also running on BAR-TILL-PC; one of the two PCs has a copied EPOS folder. Switch BAR-TILL-PC off first, wait a few minutes and start FMX EPOS here again. If this PC is the copy, create a new terminal identity for it instead.
示意圖,並非截圖。實際畫面可能因主題或版本而有所不同。
- 找出訊息中提及的電腦,並確定哪一部是複製品。
- 如這部電腦是用來取代另一部,請先關掉另一部電腦,等候數分鐘,然後在這部電腦上重新啟動 FMX EPOS。
- 如這部電腦是複製品,而兩部都須繼續運行,請在這部電腦的收銀機視窗中選擇 Create a New Terminal Identity(建立新的終端機身份)。這個按鈕只會在收銀機視窗出現。顧客顯示屏、廚房屏幕和迎賓台則提供 Try Again(再試一次)。
- 桌面應用程式會顯示「Restarting EPOS…」,然後以新終端機的身份重新啟動,並顯示登入頁面。
- 在 Local Settings → Printers(本機設定 → 打印機)重新為這部終端機選擇打印機,並檢查其終端機名稱、授權和廚房工作站打印機。
切勿在原本的收銀機上建立新身份:它的打印機、路由和未完成的刷卡結果都屬於其目前的身份。
FMX EPOS 在每部電腦上只能運行一次。如同一部電腦上另一位 Windows 用戶已經打開了 FMX EPOS,啟動時會顯示「FMX EPOS is already running for another Windows user on this PC.」。請先在該用戶的工作階段中關閉它。
必須移除一部離線的終端機
「必須移除一部離線的終端機」一節盡可能先重新連接該終端機,讓它完成同步,因為移除終端機時,系統無法檢查它未傳送的本機寫入。
- 在一部運作正常的終端機上打開 Back Office → Database(須管理員權限)。
- 在 Terminals 卡片上找出該終端機。只有另一部顯示 Offline 的終端機才會提供 Remove。
- 閱讀 Remove Terminal?,然後選擇 Remove Terminal。
移除會刪除該終端機的打印機登記和工作站路由;如 Integration Host 和 Emergency Terminal 指定的是該終端機,這些選擇亦會被清除。仍在等候其打印機的打印工作會失敗,並顯示「The terminal was removed. Choose another printer and retry.」。之後請重新選擇 Integration Host、廚房工作站打印機,以及(如移除的正是該終端機)Emergency Terminal。
如屬計劃中的儲存變更,請按照管理數據庫儲存與維護處理。