Loading

Salesforce Field Service:由于 FSL__FavoriteTerritories__c 值损坏,派遣人控制台在“加载服务区域成员”处挂起

发布日期: Jul 30, 2026
描述

Salesforce Field Service 派遣人控制台分四个顺序阶段加载:验证权限、加载用户设置、加载服务区域和资源以及加载服务区域成员。当 Field Service 用户设置记录 (FSL__UserSetting__c) 上的收藏夹区域字段 (FSL__FavoriteTerritories__c) 包含损坏或格式错误的值时,控制台将在阶段 4 无限期挂起,而不会显示错误消息。

症状

  • 派遣人控制台使用绿色复选标记完成阶段 1 至 3。
  • 阶段 4“加载服务区域成员”持续显示加载动画,无法完成加载。
  • 未显示错误消息。
  • 无论用户简档如何,问题都会持续存在,系统管理员账号也不例外。
  • 该问题在无痕/专用浏览器窗口以及各类浏览器中均持续存在。
  • 同一组织内其他 FSL__UserSetting__c 记录格式正常的用户可正常加载派遣人控制台。
  • 重新分配或重新创建权限集(FSL_Dispatcher_License、FSL_Dispatcher_Permissions)不会解决问题。
  • 问题不仅限于派遣人控制台 — Field Service GO 也可能在相同阶段挂起。
解决方案

本节说明如何解决 Salesforce Field Service 派遣人控制台在阶段 4(“加载服务区域成员”)无限期挂起,原因通常是用户的 Field Service 用户设置记录 (FSL__UserSetting__c) 上的收藏夹区域字段 (FSL__FavoriteTerritories__c) 中的值损坏或格式错误。
在阶段 4 期间,派遣人控制台从用户的 Field Service 用户设置记录 (FSL__UserSetting__c) 中读取收藏夹区域字段 (FSL__FavoriteTerritories__c)。此字段存储 JSON 格式的字符串,将服务区域记录 ID 映射到布尔值,例如:{"0HhXXXXXXXXXXXXX": true。此 JSON 会告诉控制台将哪些区域加载为收藏夹。
当字段包含格式错误的值(损坏的 JSON、意外的字符、截断的内容或结构不正确的字符串)时,控制台的 JavaScript 解析器会静默失败。加载过程会无限期挂起,而不会引发用户可见的错误。
因为故障发生在数据解析层(不是访问控制层),所以更改权限集、共享规则或简档都不能解决问题。

解决派遣人控制台在 Salesforce Field Service 中“加载服务区域成员”挂起的步骤

  1. 识别受影响用户的 FSL__UserSetting__c 记录。使用开发人员控制台、工作台或连接的 API 工具,对 Field Service 用户设置对象 (FSL__UserSetting__c) 运行 SOQL 查询。通过 FSL__User__c 字段筛选,匹配受影响派遣人的 18 位 Salesforce 用户 ID,并返回记录 ID、收藏夹区域字段 (FSL__FavoriteTerritories__c) 以及 FSL__User__c 字段。
  2. 检查收藏夹区域字段 (FSL__FavoriteTerritories__c) 中的值。有效值是 JSON 对象,服务区域记录 ID 作为密钥,布尔值 true 作为值。如果值为空 JSON ({})、包含非 JSON 字符、被截断或具有意外的格式,则会损坏。
  3. 通过将收藏夹区域字段设置为 Null,将其清除
  4. 要求受影响的用户重新加载派遣人控制台。现在,所有四个加载阶段都应成功完成。
  5. 加载控制台后,用户可以通过派遣人控制台区域选择器重新选择收藏夹区域。这将使用格式正确的 JSON 值重新填充收藏夹区域字段 (FSL__FavoriteTerritories__c)。
  6. 如果影响多个用户,请为每个用户重复步骤 1-5。或者,对 FSL__UserSetting__c 运行批量查询,以识别收藏夹区域字段值非 Null 的所有记录,并检查每个记录是否存在格式错误的内容。
知识文章编号

005388477

 
正在加载
Salesforce Help | Article