Вы находитесь здесь:
Рекомендации по внешним объектам Salesforce Maps
Просмотрите ключевые ограничения и зависимости, прежде чем отображать записи внешних объектов в Salesforce Maps. Данная тема охватывает алгоритм запроса, ограничения геокодирования и шифрования, а также компромиссы производительности, когда ваша организация извлекает данные посредством Salesforce Connect.
Как Salesforce Maps извлекает данные внешних объектов
Внешние объекты позволяют администраторам Salesforce открывать данные, живущие вне организации Salesforce, в режиме реального времени посредством Salesforce Connect. Внешние объекты можно отображать в Salesforce Maps, но существуют важные ограничения, когда внешний источник данных использует подключения Odata 2.0, Odata 4.0 или межорганизационные подключения.
При создании графика внешних объектов карты извлекают данные посредством Salesforce Connect, который выполняет выноски на внешние системы. Эта интеграция в реальном времени вводит определенные ограничения, которые не применяются к стандартным объектам Salesforce.
Ограничения SOQL и запросов
Внешние объекты имеют несколько ограничений запросов, влияющих на способ извлечения и отображения данных Salesforce Maps:
- Запросы взаимосвязи: Запросы, касающиеся взаимосвязей между внешними и стандартными объектами, могут не поддерживать все операции SOQL. Убедитесь, что взаимосвязи внешних объектов поддерживают поля, которые нужно отобразить.
- Агрегированные функции: Функции COUNT, SUM, AVG, MIN и MAX не поддерживаются в большинстве внешних источников данных. Функции соотнесения, зависящие от агрегации, могут не работать с внешними объектами.
- Операторы фильтрации: Не все операторы фильтрации SOQL доступны для внешних объектов. Конкретные поддерживаемые операторы зависят от версии Odata и конфигурации внешнего источника данных.
- Условие LIMIT: Внешние источники данных могут применять собственные ограничения записей, не зависимые от условий Salesforce SOQL LIMIT. Проверьте документацию внешнего источника данных на наличие определенных ограничений.
Совет Протестируйте запросы внешних объектов в консоли разработчика, прежде чем настраивать их в качестве базовых объектов в Salesforce Maps для раннего определения неподдерживаемых операций.
Требования к полям геокодирования и адреса
Особого внимания требует геокодирование внешних объектов:
- Поля адреса: Внешние объекты должны иметь поля адреса, открытые посредством внешнего источника данных. Если поля адреса недоступны напрямую, необходимо настроить взаимосвязь поиска со стандартным или настраиваемым объектом, содержащим адрес.
- Ограничения API геокодирования: Каждый раз, когда карты отображают внешние объекты, они могут инициировать операции геокодирования, учитываемые ограничениями геокодирования организации. Отслеживайте использование геокодирования при работе с большими внешними наборами данных.
- Непрямые поиски: Если вы отображаете записи, не содержащие адресов, убедитесь, что взаимосвязь между внешним объектом и объектом, содержащим адрес, правильно настроена как непрямой поиск.
Ограничения Shield Platform Encryption
Если ваша организация использует Shield Platform Encryption, помните о следующих дополнительных ограничениях при построении графиков внешних объектов:
- Зашифрованные поля: Внешние объекты не поддерживают Shield Platform Encryption напрямую. Однако, при использовании непрямого поиска стандартных объектов, содержащих зашифрованные поля, некоторые операции фильтрации и поиска могут работать некорректно.
- Ограничения поиска: Зашифрованные поля связанных стандартных объектов не могут использоваться в поисковых запросах при доступе посредством взаимосвязей внешних объектов.
- Ограничения операторов: Операторы сравнения (ЛАЙК, СОДЕРЖИТ и т. д.) могут не работать с зашифрованными полями, используемыми во взаимосвязях внешних объектов.
Важно! При возникновении непредвиденного алгоритма фильтрации внешних объектов проверьте наличие в связанных объектах зашифрованных полей, которые могут стать причиной ограничения.
Рекомендации по производительности
Создание графиков внешних объектов может повлиять на производительность карт из-за извлечения данных в реальном времени:
- Ограничения внешней выноски: Каждый запрос на извлечение данных внешних объектов учитывается ограничениями выносок организации. Большие наборы данных или частое обновление карты могут быстро использовать выноски.
- Время ответа: Производительность карт зависит от времени ответа внешнего источника данных. Медленные внешние системы приведут к задержке загрузки карты и создания графиков.
- Объем данных: Создание графиков больших объемов записей внешних объектов может происходить медленнее, чем создание графиков стандартных объектов. Рекомендуем использовать фильтры для уменьшения количества извлеченных и отображенных записей.
- Ограничения кэширования: В отличие от стандартных объектов, данные внешних объектов извлекаются в режиме реального времени при каждом запросе. Механизмы кэширования Salesforce, повышающие производительность стандартных объектов, не применяются к внешним данным.
Совет Для оптимальной производительности используйте фильтры для извлечения только внешних записей, которые нужно отобразить, и избегайте одновременного отображения чрезмерного количества внешних объектов.
Алгоритм слоя с внешними объектами
При создании слоев данных или слоев маркеров с внешними объектами:
- Создание слоя: Вы можете создать слои данных на основе внешних объектов, но применяются все описанные выше ограничения запросов.
- Щелкните для создания: Функции щелчка для создания могут иметь ограничения при использовании внешних объектов в качестве целевого. Убедитесь, что внешний источник данных поддерживает необходимые операции вставки.
- Обновления оперативных наборов данных: Изменения, внесенные во внешние данные в исходной системе, могут не отображаться немедленно в слоях карт из-за интервалов кэширования или обновления источника данных.
- Цветные слои: Цветовое кодирование на основе значений полей внешнего объекта работает так же, как и стандартные объекты, но производительность может быть медленнее при использовании больших внешних наборов данных.
Алгоритм поиска и фильтрации
Функции поиска имеют определенные ограничения для внешних объектов:
- Поиск по POI: Поиск точки интереса (POI) может выполняться медленнее с внешними объектами из-за извлечения данных в реальном времени.
- Текстовый поиск: Возможности полнотекстового поиска определяются поддержкой операций текстового поиска внешним источником данных.
- Постоянство фильтра: Фильтры, применяемые к слоям внешних объектов, могут потребовать повторной оценки при каждой загрузке карты, что может повлиять на время загрузки.
Устранение неполадок внешнего объекта
При возникновении проблем с отображением внешних объектов проверьте следующее:
| Симптом | Возможная причина и решение |
|---|---|
| Внешние объекты не отображаются на карте | Проверьте подключение и доступность внешнего источника данных. Проверьте корректность соотнесения адресных полей либо непосредственно с внешним объектом, либо посредством взаимосвязи непрямого поиска. |
| Запрос SOQL не поддерживает ошибку | Ваш запрос использует операцию SOQL, не поддерживаемую внешним источником данных. Упростите запрос или удалите неподдерживаемые операторы. Протестируйте запрос в Developer Console, чтобы определить конкретную неподдерживаемую операцию. |
| Соотнесение загрузок медленно или по истечении времени | Внешний источник данных может отвечать медленно или возвращать слишком много записей. Добавьте фильтры для уменьшения размера набора данных или проверьте производительность внешней системы. |
| Параметры фильтрации работают некорректно | Некоторые операторы фильтра могут не поддерживаться внешним источником данных. Проверьте документацию адаптера Odata на наличие поддерживаемых операторов или убедитесь, что связанные объекты не содержат зашифрованных полей, предотвращающих фильтрацию. |
| Ошибки ограничения выноски | Создание графиков внешних объектов использует выноски API. Отслеживайте ограничения выносок организации и уменьшайте частоту обновлений карты или количество отображаемых внешних объектов. |
Рекомендации по внешним объектам
При работе с внешними объектами в Salesforce Maps придерживайтесь следующих рекомендаций:
- Сначала протестируйте запросы: Используйте Developer Console для тестирования запросов SOQL по внешним объектам, прежде чем настраивать их в Maps.
- Использовать фильтры стратегически: Примените фильтры для ограничения количества извлеченных и отображенных внешних записей.
- Ограничения мониторинга: Отслеживайте ограничения выносок и использование API геокодирования при работе с внешними данными.
- Источники данных документа: Ведите документацию о внешних источниках данных, включая их ограничения, расписания обновления и поддерживаемые операции.
- План для задержки: Установите ожидания пользователей относительно медленной загрузки карт с внешними объектами, чем карт только со стандартными объектами.
- Проверить взаимосвязи: Убедитесь в правильной настройке взаимосвязей непрямого поиска, прежде чем пытаться создать график внешних объектов, не имеющих собственных адресов.
Эта статья решила вашу проблему?
Оставьте свой отзыв, чтобы мы могли стать лучше!
