Объекты Salesforce

Сводка

Предпосылки

Чтобы использовать соединитель Salesforce Objects, необходимо иметь имя пользователя и пароль учетной записи Salesforce.

Кроме того, необходимо включить доступ к API Salesforce. Чтобы проверить параметры доступа, перейдите на личную страницу Salesforce, откройте параметры профиля и найдите и убедитесь, что установлен флажок с включенным API . Обратите внимание, что у учетных записей пробной версии Salesforce нет доступа к API.

Поддерживаемые возможности

• Производство
• Настраиваемый
  • Личные домены
  • Перенаправление записей типа CNAME
  • Столбцы связей

Подключение к объектам Salesforce из Power Query Desktop

Чтобы подключиться к данным Salesforce Objects, выполните приведенные действия.

1. Выберите Salesforce Objects из списка соединителей данных для конкретного продукта и нажмите кнопку "Подключить". Дополнительные сведения см. в Где получить данные.

2. В Объектах Salesforce, выберите URL-адрес производственной среды, если для входа используется производственный URL-адрес Salesforcehttps://www.salesforce.com.

   

   Вы также можете выбрать custom и ввести настраиваемый URL-адрес для входа. Этот пользовательский URL-адрес может быть личным доменом, созданным в Salesforce, например https://contoso.salesforce.com. Вы также можете использовать выбор пользовательского URL-адреса, если вы используете собственную запись CNAME, которая перенаправляется в Salesforce. В настоящее время пользовательские URL-адреса поддерживают только домены salesforce.com и cloudforce.com.

   Замечание

   URL-адреса Lightning не поддерживаются.

   Кроме того, можно выбрать включить столбцы связей. Этот выбор изменяет запрос, включив столбцы, которые могут иметь связи внешнего ключа с другими таблицами. Если этот флажок снят, эти столбцы не отображаются.

   Выбрав URL-адрес, нажмите кнопку "ОК ", чтобы продолжить.

3. Выберите вход , чтобы войти в учетную запись Salesforce.

   

   После успешного входа выберите Connect.

4. Если вы впервые вошли с помощью определенного приложения, вам будет предложено проверить подлинность, введя код, отправленный на ваш адрес электронной почты. Вас спросят, хотите ли вы, чтобы приложение, которым вы пользуетесь, имело доступ к данным. Например, вам будет предложено разрешить Power BI Desktop получать доступ к данным Salesforce. Выберите Разрешить.

5. В диалоговом окне "Навигатор" выберите объекты Salesforce, которые требуется загрузить. Затем можно выбрать "Загрузить ", чтобы загрузить данные или выбрать преобразование данных для преобразования данных.

Подключение к объектам Salesforce из Power Query Online

Чтобы подключиться к данным Salesforce Objects, выполните приведенные действия.

1. Выберите объекты Salesforce из списка соединителей данных для конкретного продукта и нажмите кнопку "Подключить". Дополнительные сведения см. в Где получить данные.

2. В объектах Salesforce выберите URL-адрес, который требуется использовать для подключения. Выберите URL-адрес Production, если вы используете Production URL-адрес Salesforce (https://www.salesforce.com) для входа.

   

   Замечание

   В настоящее время может потребоваться выбрать Настраиваемый URL-адрес, ввести https://www.salesforce.com в текстовое поле, а затем выбрать Рабочую среду для подключения к данным.

   Вы также можете выбрать custom и ввести настраиваемый URL-адрес для входа. Этот пользовательский URL-адрес может быть личным доменом, созданным в Salesforce, например https://contoso.salesforce.com. Вы также можете использовать выбор пользовательского URL-адреса, если вы используете собственную запись CNAME, которая перенаправляется в Salesforce.

   Кроме того, можно выбрать включить столбцы связей. Этот выбор изменяет запрос, включив столбцы, которые могут иметь связи внешнего ключа с другими таблицами. Если этот флажок снят, эти столбцы не отображаются.

3. Если вы впервые делаете это подключение, при необходимости выберите локальный шлюз данных.

4. Выберите вход , чтобы войти в учетную запись Salesforce. После успешного входа нажмите кнопку "Далее".

5. В диалоговом окне "Навигатор" выберите объекты Salesforce, которые требуется загрузить. Затем выберите "Преобразовать данные ", чтобы преобразовать данные.

Указание версии API Salesforce

Для использования соединителя Salesforce требуется указать поддерживаемую версию API Salesforce. Это можно сделать, изменив запрос с помощью расширенного редактора Power Query. Например: Salesforce.Data("https://login.salesforce.com/", [ApiVersion=48]).

Если указать версию, которую Salesforce не поддерживает, возникает сообщение об ошибке, указывающее, что указан неподдерживаемый ApiVersion.

Дополнительные сведения о версиях и поддержке API Salesforce см. на веб-сайте Salesforce.

Ограничения и рекомендации

• Если в результатах соединителя Salesforce Objects отсутствуют таблицы, одной из причин может быть необходимость указания или обновления параметра ApiVersion до версии, которую поддерживает Salesforce. Чтобы указать или обновить ApiVersion, используйте расширенный редактор и явно добавьте ApiVersion этот параметр. Рассмотрим пример.

  Source = Salesforce.Data("https://login.salesforce.com/", [ApiVersion = 54.0])

  Salesforce периодически устраняет устаревшие версии API, поэтому убедитесь, что вы указываете поддерживаемую версию API Salesforce.

• Существует ограничение на количество полей, которые может содержать запрос к Salesforce. Ограничение зависит от типа столбцов, количества вычисляемых столбцов и т. д. При получении Query is either selecting too many fields or the filter conditions are too complicated ошибки это означает, что запрос превышает ограничение. Чтобы избежать этой ошибки, используйте расширенный параметр select Query и укажите нужные поля.

• Параметры сеанса Salesforce могут блокировать эту интеграцию. Убедитесь, что настройка блокировать сеансы по IP-адресу, с которого они начались отключена.

• Необходимо включить доступ к API Salesforce. Чтобы проверить параметры доступа, перейдите к параметрам профиля для текущего пользователя и установите флажок " Включить API ".

• У учетных записей пробной версии Salesforce нет доступа к API.

• Операции "Создать запись" и "Обновить запись" не поддерживают настраиваемые поля типа Picklist (Multi-Select).

• URL-адреса Lightning не поддерживаются.

• Пользовательские URL-адреса поддерживают только домены salesforce.com и cloudforce.com. Использование других доменов приводит к ошибке "Недопустимые аргументы".

• Salesforce ограничивает количество одновременных запросов, которые может выполнять одна учетная запись. Ошибка "INVALID_QUERY_LOCATOR" Это ограничение Salesforce и может возникнуть при наличии нескольких одновременных запросов к Salesforce с помощью одной и той же учетной записи. Это ограничение включает все клиентские приложения (а не только соединитель PowerQuery) с помощью API Salesforce. Чтобы уменьшить вероятность этой ошибки, выполните следующие действия.

  • Убедитесь, что количество запросов к Salesforce сведено к минимуму.
  • Используйте доступные опции (например, потоки данных) для промежуточного хранения данных из Salesforce.
  • Убедитесь, что другие использования API Salesforce с той же учетной записью не запланированы одновременно.

Дополнительные сведения о внутренних ограничениях API Salesforce см. в кратком справочнике по ограничениям и выделению ресурсов Salesforce.