Salesforce
Renta отправляет строки из вашего хранилища данных в Salesforce как записи стандартных и кастомных объектов: контакты, лиды, аккаунты, сделки, кейсы и любой кастомный объект вашей org.
Один пайплайн пишет в один объект. Поле External ID, по которому идёт сопоставление, решает, обновит строка существующую запись или создаст новую.
Аутентификация
Renta авторизуется через Salesforce OAuth. Перед входом выберите окружение: Production использует обычный вход Salesforce, Sandbox авторизует sandbox org через тестовый вход.
Salesforce попросит выдать Renta полный доступ в пределах прав пользователя, под которым вы входите, и право обновлять этот доступ. Renta читает описания объектов и полей, чтобы заполнить списки в настройках, а записи пишет при доставке данных пайплайном.
Подключение назначения Salesforce
- Перейдите в раздел Connections > Catalog в левом меню и откройте вкладку Destinations.
- Откройте категорию Reverse ETL и нажмите карточку Salesforce.
- Environment.
Оставьте Production для боевой org или выберите Sandbox для sandbox org. - Нажмите Log in to your Salesforce account. Salesforce откроется в этой же вкладке.
Введите учётные данные пользователя, от имени которого будут работать пайплайны, и нажмите Log In. На следующем экране подтвердите запрошенный доступ. Salesforce вернёт вас в Renta.
Renta подтвердит выданный доступ и покажет подключённую org и пользователя. Завершите настройку:
- Destination name.
Renta подставит домен org и email пользователя. Замените их на любое удобное имя. Оно используется только в интерфейсе Renta.
Нажмите Save.
Новое назначение появится в списке Destinations со статусом Active. Теперь его можно использовать в пайплайнах Reverse ETL.
Подготовка модели данных
Пайплайн Reverse ETL читает данные из модели данных: это SQL-запрос, сохранённый в разделе Data models, который решает, какие строки хранилища синхронизировать и что лежит в каждой строке. Создайте её до пайплайна, потому что списки в маппинге заполняются колонками модели.
Добавьте в запрос колонку со стабильным идентификатором записи и отметьте её уникальным ключом модели. Именно это значение Renta будет отправлять в поле External ID в Salesforce.
-- Контакты, подготовленные для Salesforce. Запрос возвращает строки, таблица не создаётся.
WITH demo_contacts AS (
SELECT
'crm-demo-0001' AS guid,
'James' AS first_name,
'Miller' AS last_name,
'james.miller@example.com' AS email,
'+1 212 555 0101' AS phone,
'Head of Marketing' AS title
UNION ALL SELECT 'crm-demo-0002','Olivia','Johnson','olivia.johnson@example.com','+1 312 555 0102','CTO'
UNION ALL SELECT 'crm-demo-0003','William','Davis','william.davis@example.com','+1 214 555 0103','Analyst'
)
SELECT * FROM demo_contactsСоздание модели данных
В левом меню откройте Data models и нажмите New model. Затем:
- Source.
Выберите подключение хранилища, к которому пойдёт запрос. - Write your model query.
Вставьте свой SQL. Тип запроса оставьте SQL query. - Run preview.
Проверьте строки и названия колонок. Когда результат устраивает, нажмите Next step.
Для модели, которая питает пайплайны, выберите Reverse ETL only. Если та же модель должна отвечать и на вопросы агентов, выберите один из вариантов с AI agents.
Просмотрите колонки, которые Renta прочитала из запроса, и отметьте ту, что опознаёт строку. По этому ключу Reverse ETL отличает изменённую строку от новой, поэтому выбирайте колонку, по которой будете сопоставлять и в Salesforce, в примере это guid.
Задайте имя и короткое описание, затем нажмите Create model. Именно это имя вы выберете в списке Data model при создании пайплайна.
Модель появится в списке с областью Reverse ETL и готова к использованию в пайплайне.
Создание пайплайна Salesforce
Назначение и модель данных должны быть готовы до начала.
В левом меню нажмите New pipeline. На шаге Source переключитесь на Reverse ETL и выберите своё хранилище данных, например Google BigQuery.
Выберите подключение хранилища, в котором лежат ваши модели данных, и нажмите Next step.
На шаге Destination выберите Salesforce в блоке Already connected и нажмите Next step.
Выберите подключение Salesforce, созданное ранее. На карточке видны домен org и подключённый пользователь, поэтому sandbox легко отличить от боевой org. Нажмите Next step.
Настройка пайплайна
Н а последнем шаге выберите данные для пайплайна, объект Salesforce и способ записи.
Модель данных и объект Salesforce
Укажите пайплайну, откуда брать данные и в какой объект их писать. Всё, что ниже, зависит от этих двух настроек, поэтому начните с них.
- Data model.
Выберите модель для синхронизации. Из неё берутся колонки для сопоставления и маппинга ниже. - Salesforce object.
Выберите объект, в который пишет Renta, например Contact или Lead. Список Renta читает из вашей org. В нём стандартные и кастомные объекты, которые подключённый пользователь может создавать, обновлять и запрашивать, под каждым подписано его API-имя.
Один пайплайн пишет в один объект. Чтобы поддерживать в актуальном состоянии и контакты, и аккаунты, к которым они относятся, сделайте по пайплайну на каждый объект.
Режим синхронизации
Решите, как строка превращается в запись.
| Режим | Поле сопоставления | Описание |
|---|---|---|
| Upsert | External ID | Обновляет запись, у которой совпал External ID, и создаёт новую, если совпадения нет. Вариант по умолчанию и подходящий для большинства синхронизаций. |
| Update only | External ID или Id | Обновляет только сопоставленные записи, а строки без совпадения отклоняет. Подходит, когда состав записей определяет Salesforce, а хранилище только обогащает их. |
| Create only | Нет | Всегда создаёт запись. Правила дубликатов в Salesforce могут отклонить строку. |
| Mirror | External ID | Обновляет строки, которые есть в модели, и применяет политику удаления к тем, что из неё пропали. Единственный режим, который обрабатывает удалённые строки. |
Поведение при удалении строки
Задайте, что произойдёт с записью Salesforce, чья строка пропала из модели данных.
| Вариант | Описание |
|---|---|
| Ignore | Запись остаётся как есть. Вариант по умолчанию. |
| Clear fields | Оставляет запись и очищает поля, которые пишет этот пайплайн. Поле сопоставления, обязательные поля и чекбоксы не трогает. |
| Delete | Переносит запись в корзину Salesforce, откуда администратор может восстановить её в течение 15 дней. Безвозвратного удаления нет. |
Сопоставление записей
Укажите, какое значение опознаёт запись, чтобы строка обновляла именно свою запись, а не добавляла ещё одну.
Левый список предлагает уникальный ключ модели данных. Правый: поля выбранного объекта с признаком External ID в Salesforce. В режиме Update only в списке есть ещё и Id записи. В режиме Create only сопоставлять нечего, и блок остаётся пустым.
Уникальность поля ещё не делает его External ID: стандартный Email, например, здесь не появится. Renta отправляет сопоставленное значение с каждой строкой, поэтому повторять его в блоке маппинга ниже не нужно.
Маппинг полей
Свяжите колонки модели данных с полями Salesforce. В правом списке только поля, которые подключённый пользователь может записать в выбранном режиме, поэтому формульные, roll-up и системные поля туда не попадают.
| Тип маппинга | Описание |
|---|---|
| Standard | Берёт значение из колонки модели данных. |
| Static | Записывает одно и то же фиксированное значение в каждую запись. |
| Variable | Записывает значение самой синхронизации: например, имя модели данных или время старта запуска. |
Поля, без которых Salesforce не создаст запись, например Last Name у контакта, предвыбраны в режимах Upsert, Create only и Mirror. Укажите для каждого из них колонку источника. Удалить такую строку из маппинга нельзя. Режим Update only записи не создаёт, поэтому обязательных полей в нём нет.
В поле-ссылку, например Account ID, передавайте колонку с Salesforce Id существующей связанной записи. Синхронизируйте родительские записи раньше тех, которые на них ссылаются.
Пустые значения
У каждой строки маппинга своё правило для пустых значений источника. Откройте его по значку шестерёнки рядом со строкой.
| Вариант | Описание |
|---|---|
| Don’t sync null values | Пропускает поле, когда колонка источника пуста, и Salesforce сохраняет текущее значение. Вариант по умолчанию. |
| Always sync | Очищает поле Salesforce, когда колонка источника пуста. Подходит, когда хранилище это единственный источник истины для поля. |
Чекбоксы и поля, которые Salesforce считает обязательными, не очищаются ни при каком варианте. У о бязательных строк показан заблокированный Always sync, а пустое значение в них просто не отправляется.
Дальше задайте имя пайплайна.
Поле Integration name задаёт имя пайплайна в интерфейсе Renta. Измените его так, как вам удобно.
Расписание
Выберите, как часто запускается пайплайн.
| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную из интерфейса или через API. |
| Daily | Пайплайн запускается раз в сутки в указанное время обновления. |
| Interval | Пайплайн запускается через заданные интервалы времени. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily укажите Update time (точное время старта каждого запуска) и нажмите Create pipeline.
Новый пайплайн появится в разделе Pipelines на вкладке Reverse ETL, где видно его запуски и прогресс.
Стратегия синхронизации
Renta синхронизирует данные инкрементально. Запуск сравнивает модель данных с состоянием, записанным на прошлом запуске, и отправляет только то, что изменилось, поэтому ночная синхронизация трогает несколько записей, а не всю модель. Первому запуску сравнивать не с чем, и он отдаёт всё.
| Состояние строки | Что делает Renta |
|---|---|
| Новая | Создаёт запись или обновляет сопоставленную, в зависимости от режима синхронизации. |
| Изменённая | Записывает замапленные поля заново с новыми значениями. Поля вне маппинга остаются прежними. |
| Без изменений | Ничего не отправляет. |
| Удалённая | Игнорируется во всех режимах, кроме Mirror, где решает выбранная политика удаления. |
Ограничения
- Для сопоставления нужен External ID.
Режимы Upsert и Mirror опознают запись по полю с признаком External ID. Без него пайплайн может только создавать записи или обновлять их по Id записи в режиме Update only. - Отклонённая строка не останавливает остальные.
Salesforce отвечает по каждой записи отдельно, поэтому строка, которую он отверг, например из-за правила валидации или неизвестного значения пиклиста, отклоняется сама по себе, а остальная пачка всё равно записывается. Причины видны в логе запуска. - Запуск останавливается, когда отказов слишком много.
Renta прерывает запуск, если отклонено больше 30% пачки или больше 10% всех строк, отправленных к этому моменту. Уже записан ные записи остаются в Salesforce, а следующий запуск продолжает с места остановки. - Суточный лимит API соблюдается.
Перед записью Renta проверяет, сколько суточных запросов к API осталось у org. Если их меньше 5 000, запуск останавливается, ничего не отправив, и его можно повторить после сброса лимита. - Объекты и поля за вас не создаются.
Renta пишет в объекты, поля и значения пиклистов, которые уже заданы в вашей org. Сначала добавьте недостающее поле в Salesforce, потом запустите пайплайн снова.
Ready to get started?
Build your data pipeline today or get a personalized demo. Start free!
Need help?
Get expert support to ensure your project succeeds. We're here to help!
Feature requests?
Help shape our product! Share your ideas for new features and integrations.