您在此处：
Salesforce Maps 故障排除
通过此快速参考，解决常见的 Salesforce Maps 问题。
访问权限问题：“我看不到地图”
按顺序处理此列表。从最常见的原因开始。
- 在“设置”中打开用户，然后选择权限集许可证分配。确认 Salesforce Maps 许可证已启用。如果“设置”未列出许可证，则您没有可用的许可证。如果计数为零，检查公司信息下的权限集许可证，然后联系客户团队。
- 检查权限集分配。确认已分配相应的权限集，例如 SF Maps。管理员也有地图管理员。
- 找到 Salesforce Maps 软件包，单击配置，然后打开权限组。确认用户或简档属于授予缺失访问权限的小组。
- 确认地图和位置服务在配置菜单中打开。
- 请确认 Salesforce 支持您的版本，并且贵组织对需要的功能拥有 API 访问权限。
- 如果您仍无法打开地图，请打开支持个案。在帮助中，选择，然后选择产品销售和主题 Salesforce Maps。
警告 当您选择显示用户文件夹或路由角色安全性时，用户需要 UserRole 查询权限。如果没有，Maps 会在加载时显示访问警告。
警告 如果贵组织强制执行代码交换验证密钥 (PKCE)，Maps OAuth 将静默失败。安装前，请检查连接的应用程序设置和 PKCE 要求。
记录未绘制
| 绘制症状 | 绘制原因 | 绘制修复 |
|---|---|---|
| 地图未显示记录 | 基对象未配置，或地理编码未运行 | 请确认对象类型存在基对象。检查地址和坐标字段映射。运行地理编码批处理或绘制图层以触发地理编码。 |
| 一些记录绘制，其他记录不绘制 | 地址数据不完整或无效 | 检查未绘制的记录中的地址字段。请确认所有必填地址组件都有值。修复地址后，重新对记录进行地理编码。 |
| 记录绘制在错误位置 | 基对象从错误的相关对象中提取地址 | 编辑基对象配置。确认地址位置设置为此对象或相关 ID。更正后重新进行地理编码。 |
| 图层在移动设备上显示为空 | 可见区域设置会筛选出记录 | 缩放到预期位置。刷新图层。检查移动设备启用可见区域是否意外筛选。 |
图层和文件夹问题
| 图层症状 | 图层原因 | 图层修复 |
|---|---|---|
| 无法访问企业文件夹 | 未为用户启用文件夹权限 | 打开权限组，编辑用户的权限组，启用文件夹权限并保存。 |
| 形状图层的文件夹在升级后消失 | 对象权限或文件夹可见性问题 | 检查形状图层对象的对象权限。验证文件夹可见性设置。刷新 Salesforce Maps 缓存。如果文件夹仍不可见，请联系 Salesforce 支持。 |
| 从企业子文件夹复制图层失败，显示 FIELD_INTEGRITY_ExceptionION | 源层包含用户字段集 | 复制前清除用户字段，或克隆到不同的文件夹级别。 |
| 专用 ArcGIS 图层加载失败，并出现 CORS 错误 | Esri 入口网站不允许将 Salesforce 的跨来源资源共享 (CORS) 列入允许列表 | 登录 ArcGIS 入口网站管理员控制台。转到组织设置 > 安全性。将 Salesforce 域 (*.salesforce.com、*.force.com、My Domain) 添加到 CORS 允许列表。保存并测试连接。 |
| 选择器中缺少用户文件夹节点 | 子文件夹不存在 | 这是已知的限制。从 CopyTo 和 MoveTo 创建子文件夹，以使用户文件夹节点显示在选择器中。 |
警告 文件夹管理员权限授予对整个文件夹结构的完整访问权限，而不仅仅是公司文件夹。请谨慎分配。有关详细信息，请参阅授予用户访问 Salesforce Maps 的权限。
路由和计划问题
| 路由症状 | 路由原因 | 路由修复 |
|---|---|---|
| 使用 UNABLE_TO_LOCK_ROW 优化路线失败 | 多个用户同时优化重叠记录 | 按顺序运行优化作业，而不是在用户共享共同目标记录时并行运行。 |
| “计划”选项卡上的用户搜索超时或失败 | 大型角色层次结构超出 Visualforce 远程限制 | 使用直接用户查找而不是搜索功能，或者通过组织层次结构转到用户。 |
| 在未填充路径点字段的情况下创建的意外日常任务 | 配置错误的 Maps Advanced 走访计划 | 高级路线会在 maps__WA_AdvRouteWaypoint__c 对象上创建任务。查看走访计划配置和任务生成规则。 |
| 开始和结束位置名称被截断 | 名称字段有 80 个字符的限制 | 将位置名称缩短到 80 个字符或更少。 |
自定义操作、签入和签出问题
| 操作症状 | 操作原因 | 操作修复 |
|---|---|---|
| 该流创建重复记录，例如重复任务 | Maps 自定义操作触发的流可以运行两次 | 在流中使用幂等检查来检查记录是否已经存在。添加条目条件以防止重复执行。使用唯一标识符跟踪执行情况。 |
| 依赖选项列表值不会出现在自定义处置中 | 不支持依赖选项列表 | 在自定义处置表单中使用独立选项列表，而不是依赖选项列表。 |
| 必填字段未一致强制执行 | 签出和签入之间的行为不同 | 签出并不总是强制执行您在任务字段集中定义的必填字段。调整字段集配置或添加验证规则。 |
性能和数据量问题
| 表现症状 | 性能原因 | 性能修复 |
|---|---|---|
| 移动设备上的地图绘制速度缓慢 | 一次绘制的记录过多 | 启用移动设备上的可见区域默认启用。将筛选器添加到标记图层，以减少记录计数。用于移动访问的预地理编码记录。 |
| 搜索加载时间过长 | 在太多基对象上启用全局搜索 | 对搜索结果中不需要的基对象关闭全局搜索。 |
| 大型数据集会导致性能下降 | 数据集超过建议大小 | 使用筛选标记图层，而不是绘制所有内容。提前对记录进行地理编码。考虑使用移动设备上的可见区域。 |
获取更多帮助
如果您无法使用本故障排除指南解决问题：
- 查看您的发布版本的 Maps 文档。
- 搜索 Salesforce 帮助，了解已知问题和解决方法。
- 打开支持个案。
- 在帮助中，单击。
- 选择产品销售和主题 Salesforce Maps。
- 填写必填字段。包括详细描述、复制步骤、屏幕截图或屏幕录制（如果有），以及您的组织 ID 和用户信息。
- 提交。Maps 支持工程师审核并联系您。
本文章是否解决您的问题？
请与我们共享您的想法，以便我们进行改进！
