Loading

Salesforce Field Service:Dispatcher Console 因為 FSL__FavoriteTerritories__c 值損毀而在「載入服務區域範圍成員」處暫留

發佈日期: Jul 30, 2026
描述

Salesforce Field Service Dispatcher Console 會依序載入四個階段:驗證權限、載入使用者設定、載入服務區域範圍與資源,以及載入服務區域範圍成員。當 Field Service 使用者設定記錄 (FSL__UserSetting__c) 上的「我的最愛區域範圍」欄位 (FSL__FavoriteTerritories__c) 包含損毀或格式錯誤的值時,主控台會無限期在階段 4 中暫留,而不會顯示錯誤訊息。

症狀

  • Dispatcher Console 會使用綠色核取記號完成階段 1 到 3。
  • 階段 4,「載入服務區域範圍成員」會顯示永不完成的旋轉。
  • 沒有顯示錯誤訊息。
  • 無論使用者的設定檔 (包括「系統管理員」) 為何,此問題仍會存在。
  • 此問題會存在於無痕/私人瀏覽器視窗中,以及不同瀏覽器之間。
  • 具有正確格式化的 FSL__UserSetting__c 記錄之相同組織中的其他使用者可載入 Dispatcher Console,而不會有任何問題。
  • 重新指派或重新建立權限集 (FSL_Dispatcher_License、FSL_Dispatcher_Permissions) 無法解決此問題。
  • 此問題不限於 Dispatcher Console,Field Service GO 也可能在相同階段暫留。
解決方案

本節說明如何解決由於使用者 Field Service 使用者設定記錄 (FSL__UserSetting__c) 中「我的最愛區域範圍」欄位 (FSL__FavoriteTerritories__c) 中的值損毀或格式錯誤而在階段 4 (「載入服務區域範圍成員」) 中無限暫停的 Salesforce Field Service Dispatcher Console。
在「階段 4」期間,Dispatcher Console 會從使用者的 Field Service 使用者設定記錄 (FSL__UserSetting__c) 讀取「我的最愛區域範圍」欄位 (FSL__FavoriteTerritories__c)。此欄位會儲存 JSON 格式字串,將「服務區域範圍」記錄識別碼對應至布林值,例如:{"0HhXXXXXXXXXXXXX": true}。此 JSON 會告知主控台要載入為我的最愛的區域範圍。
當欄位包含格式錯誤的值 (損毀的 JSON、非預期的字元、截斷的內容或結構不正確的字串) 時,主控台的 JavaScript 剖析器會靜默失敗。載入程序會無限期暫停,而不會產生使用者可見的錯誤。
由於失敗發生於資料剖析層 (非存取控制層),因此權限集、共用規則或設定檔變更的組合無法解決問題。

解決在 Salesforce Field Service 中 Dispatcher Console 暫留「載入服務區域範圍成員」的步驟

  1. 識別受影響使用者的 FSL__UserSetting__c 記錄。使用「Developer Console」、「工作台」或連線的 API 工具,對 Field Service 使用者設定物件 (FSL__UserSetting__c) 執行 SOQL 查詢。依照等於受影響 Dispatcher 其 18 個字元 Salesforce 使用者識別碼的 FSL__User__c 欄位進行篩選,然後傳回記錄識別碼、「我的最愛區域範圍」欄位 (FSL__FavoriteTerritories__c) 和 FSL__User__c 欄位。
  2. 檢查「我的最愛區域範圍」欄位中的值 (FSL__FavoriteTerritories__c)。有效值是 JSON 物件,其中「服務區域範圍」記錄識別碼為鍵值,布林值為 true 值。如果值為空白 JSON ({})、包含非 JSON 字元、遭截斷,或具有非預期的格式,則值會損毀。
  3. 將「我的最愛區域範圍」欄位 (FSL__FavoriteTerritories__c) 設為空值以清除欄位
  4. 要求受影響的使用者重新載入 Dispatcher Console。現在所有四個載入階段都應成功完成。
  5. 主控台載入後,使用者可以透過 Dispatcher Console 區域範圍選擇器重新選取我的最愛區域範圍。這會以正確格式化的 JSON 值重新填入「我的最愛區域範圍」欄位 (FSL__FavoriteTerritories__c)。
  6. 如果多個使用者受到影響,請針對每個使用者重複步驟 1–5。或者,對 FSL__UserSetting__c 執行大量查詢,以識別具有非空值「我的最愛區域範圍」欄位值的所有記錄,並檢查每個記錄是否有格式錯誤的內容。
知識文章編號

005388477

 
正在載入
Salesforce Help | Article