您在此处：
Salesforce Maps 外部对象注意事项
在 Salesforce Maps 中绘制外部对象记录之前，请查看关键限制和依赖性。本主题涵盖了贵组织通过 Salesforce Connect 检索数据时的查询行为、地理编码和加密约束以及性能权衡。
Salesforce Maps 如何检索外部对象数据
外部对象允许 Salesforce 管理员通过 Salesforce Connect 实时访问 Salesforce 组织外部的数据。您可以在 Salesforce Maps 中绘制外部对象，但当您的外部数据源使用 Odata 2.0、Odata 4.0 或跨组织连接时，这方面存在重要限制。
当您绘制外部对象时，Maps 会通过 Salesforce Connect 检索数据，Salesforce Connect 会对外部系统进行标注。这种实时集成引入了不适用于标准 Salesforce 对象的特定约束。
SOQL 和查询限制
外部对象有几个查询限制，会影响 Salesforce Maps 检索和显示数据的方式：
- 关系查询：涉及外部对象和标准对象之间关系的查询可能不支持所有 SOQL 操作。验证外部对象关系是否支持您需要绘制的字段。
- 聚合函数：大多数外部数据源不支持计数、求和、AVG、MIN 和 MAX 函数。依赖于聚合的地图功能可能无法与外部对象一起使用。
- 筛选器运算符：并非所有 SOQL 筛选器运算符都对外部对象可用。支持的特定运算符取决于外部数据源的 Odata 版本和配置。
- 限制条款：外部数据源可以强制执行自己的记录限制，而与 Salesforce SOQL LIMIT 条款无关。检查外部数据源文档，了解特定限制。
提示 在将外部对象查询配置为 Salesforce Maps 中的基对象之前，请在开发人员控制台中对其进行测试，以便尽早识别不支持的操作。
地理编码和地址字段要求
地理编码外部对象需要特别考虑：
- 地址字段：外部对象必须具有通过外部数据源公开的地址字段。如果地址字段不直接可用，您必须配置与包含地址的标准或自定义对象的查找关系。
- 地理编码 API 限制：地图每次绘制外部对象时，都会触发计入贵组织地理编码限制的地理编码操作。在使用大型外部数据集时，监控地理编码使用情况。
- 间接查找：如果您绘制没有地址的记录，请确保外部对象和包含地址的对象之间的关系正确配置为间接查找。
Shield Platform Encryption限制
如果您的组织使用 Shield Platform Encryption，请在绘制外部对象时了解这些附加约束：
- 加密字段：外部对象不直接支持 Shield Platform Encryption。但是，如果您正在使用对包含加密字段的标准对象的间接查找，某些筛选和搜索操作可能无法如预期正常工作。
- 搜索限制：当通过外部对象关系访问时，相关标准对象上的加密字段不能用于搜索查询。
- 操作员限制：比较运算符（例如，CONTAINS 等）可能对通过外部对象关系引用的加密字段无效。
重要 如果您遇到外部对象的意外筛选行为，请验证相关对象是否包含可能导致限制的加密字段。
性能注意事项
由于实时数据检索，绘制外部对象会影响地图性能：
- 外部标注限制：每个检索外部对象数据的请求都会计入贵组织的标注限制。大型数据集或频繁的地图刷新会快速消耗标注。
- 响应时间：Maps 性能取决于外部数据源的响应时间。外部系统缓慢将导致地图加载和绘制延迟。
- 数据量：绘制大量外部对象记录可能比绘制标准对象更慢。考虑使用筛选器，以减少检索和绘制的记录数量。
- 缓存限制：与标准对象不同，外部对象数据会在每次请求时实时检索。Salesforce 的缓存机制可提高标准对象的性能，但不适用于外部数据。
提示 为了获得最佳性能，请使用筛选器仅检索您需要绘制的外部记录，并避免同时绘制过多外部对象。
包含外部对象的图层行为
使用外部对象创建数据层或标记层时：
- 图层创建：您可以根据外部对象创建数据层，但上述所有查询限制适用。
- 单击创建：当使用外部对象作为目标对象时，单击创建功能可能有局限性。请确认外部数据源支持必要的插入操作。
- 实时数据集更新：由于缓存或数据源刷新间隔，对源系统中的外部数据所做的更改可能不会立即显示在地图图层中。
- 颜色编码图层：基于外部对象字段值的颜色编码的工作原理与标准对象相同，但在大型外部数据集下性能可能会变慢。
搜索和筛选行为
搜索功能具有外部对象的特定限制：
- POI 搜索：由于实时数据检索，兴趣点 (POI) 搜索在外部对象中执行起来可能更慢。
- 文本搜索：全文搜索功能取决于外部数据源对文本搜索操作的支持。
- 筛选器持久性：应用于外部对象图层的筛选器可能需要在每次地图加载时重新评估，从而可能影响加载时间。
外部对象故障排除
如果在绘制外部对象时遇到问题，请检查以下内容：
| 症状 | 可能的原因和解决方案 |
|---|---|
| 地图不会显示外部对象 | 请确认外部数据源已连接并可访问。检查地址字段是否直接在外部对象上或通过间接查找关系正确映射。 |
| SOQL 查询不支持错误 | 您的查询使用外部数据源不支持的 SOQL 操作。简化查询或删除不支持的运算符。在开发人员控制台中测试查询，以识别特定不支持的操作。 |
| 地图加载缓慢或超时 | 外部数据源可能响应缓慢或返回的记录过多。添加筛选器以减小数据集大小，或检查外部系统的性能。 |
| 筛选器选项未如预期正常工作 | 外部数据源可能不支持一些筛选器运算符。检查 Odata 适配器文档以了解支持的运算符，或验证相关对象是否不包含阻止筛选的加密字段。 |
| 标注限制错误 | 绘制外部对象会消耗 API 标注。监控贵组织的标注限制，并减少地图刷新的频率或绘制的外部对象的数量。 |
外部对象最佳实践
在 Salesforce Maps 中使用外部对象时，请遵循这些最佳实践：
- 首先测试查询：在地图中配置外部对象之前，使用开发人员控制台测试 SOQL 查询。
- 战略性地使用筛选器：应用筛选器，以限制检索和绘制的外部记录的数量。
- 监控限制：在使用外部数据时，跟踪标注限制和地理编码 API 使用情况。
- 文档数据源：维护有关外部数据源的文档，包括其局限性、刷新计划和支持的操作。
- 计划延迟：设定用户的预期，即带有外部对象的地图加载速度可能比带有标准对象的地图慢。
- 验证关系：在尝试绘制缺少自己地址的外部对象之前，请确保正确配置间接查找关系。
本文章是否解决您的问题？
请与我们共享您的想法，以便我们进行改进！
