跳轉到主要內容
稽核日誌是每家公司對 Alforse 主要業務記錄的建立、更新與刪除所保存的歷程,包含每項變更的操作者及其動到的欄位。由管理員開啟;之後任何有權檢視設定的人,不必到處詢問就能回答「這是誰在何時改的?」。

稽核日誌如何運作

記錄預設為關閉,且每家公司各自保存。一旦開啟,Alforse 會記錄受稽核實體之後的每一項變更。在你啟用之前、或關閉期間所做的變更,永遠不會被記錄。 項目是依人們所處理的業務實體分組,而不是依發生變更的資料庫列。例如,編輯品項的成本會產生一筆品項項目,而不是底層 itemCost 列的項目。

一筆項目包含什麼

差異會省略 updatedAt、updatedBy 與內部嵌入向量等簿記欄位,所以項目只顯示人們會在意的變更。

受稽核的實體

只有以下實體會受稽核。對其他任何東西的變更都不會被記錄,無論記錄是否開啟。

開啟與關閉記錄

設定 → 稽核記錄下的稽核記錄卡片只有一個切換開關。 關閉切換開關會停止新的項目,但保留既有歷程。重新開啟會從那一刻起恢復記錄;關閉期間的空檔會維持空白。

檢閱變更

同樣的資料可在兩種範圍檢視。

單筆記錄的歷程

在多數詳細資料頁面上,例如客戶、銷售訂單、工單或出貨,歷程動作會開啟一個側邊面板,顯示該記錄的時間軸。每項變更顯示操作、操作者、時間,以及可展開的已變更欄位清單。 如果記錄為關閉,面板會顯示 “Audit logging is not enabled”(稽核記錄未啟用)。可以更新設定的使用者會得到啟用它的捷徑;其他人則會被告知聯絡管理員。

全公司日誌

在設定 → 稽核記錄上,選取檢視全部以開啟全螢幕的所有稽核日誌表格。它可搜尋且有分頁,欄位有實體、操作、變更者、變更與時間。 操作會顯示為彩色徽章:已建立為綠色,已更新為藍色,已刪除為紅色。展開一列可查看其欄位層級的差異,選取實體的值可開啟它所指的記錄。

保留與封存

即時日誌保留 30 天的項目。每晚有一項工作會把較舊的項目移入壓縮封存檔,記錄封存檔的日期範圍、列數與大小,並從即時資料表中刪除這些項目。 封存檔列在設定頁面的已封存記錄之下。下載會建立指向壓縮匯出檔的短效簽署連結,所以請每次都重新要求新連結,而不要儲存舊的。在第一份封存檔出現之前,卡片會說明超過 30 天的日誌將封存在這裡。

權限與方案

關於設定模組如何對應到員工類型,請見權限與存取。

疑難排解

”Upgrade to Business to enable audit logging”(升級至 Business 以啟用稽核記錄)

原因:公司不是 Business 方案,所以設定 → 稽核記錄中的切換開關被擋住。 解決方法:升級方案,然後開啟記錄。

“Upgrade to unlock audit history”(升級以解鎖稽核歷程)

原因:同一個方案限制,顯示在記錄的歷程面板中。 解決方法:升級到 Business 方案;此限制同時涵蓋設定切換開關與面板。

“Audit logging is not enabled”(稽核記錄未啟用)

原因:歷程面板已開啟,但公司的記錄是關閉的。 解決方法:具有更新設定權限的使用者在設定 → 稽核記錄中開啟它。如果你沒有該權限,請詢問管理員。

“Failed to enable audit logging” 或 “Failed to disable audit logging”(無法啟用/停用稽核記錄)

原因:建立或移除公司的日誌儲存與變更訂閱時發生伺服器錯誤。 解決方法:再試一次。如果持續失敗,日誌資料表或其訂閱可能不同步;再切換一次即可重新同步。

“Failed to generate download URL”(無法產生下載 URL)

原因:Alforse 無法建立簽署連結,原因可能是封存檔儲存的檔案遺失,或簽署請求失敗。 解決方法:再試一次。連結很快就會過期,所以舊連結無法使用。

記錄沒有顯示歷程

請檢查三件事。變更發生時記錄必須是開啟的,因為 Alforse 絕不回填。該記錄的實體必須出現在受稽核的實體中。而且只動到簿記欄位(updatedAt、updatedBy、嵌入向量)的變更不會顯示欄位層級的差異。

表格中缺少較舊的變更

即時日誌只保留最近 30 天。較舊的變更請到已封存記錄下的可下載匯出檔中尋找。

相關內容