Переведено ИИ. Сообщество еще не проверило перевод. Читать на английском

Блог · 15 сентября 2023 г. · Steve Simpson · Интеграция

Шаги Salesforce Bulk API: импорт данных на погрузочной платформе

Введение:

В этой статье мы рассмотрим Salesforce Bulk API — мощный инструмент для эффективного импорта больших наборов данных в Salesforce. В отличие от REST API, который ограничивает вас 200 записями за вызов, Bulk API позволяет вставлять миллионы записей с помощью отлаженного процесса.

Раздел 1: как устроен процесс Bulk API

Salesforce Bulk API работает по процессу из пяти шагов, позволяющему без проблем импортировать большие объемы данных:

Схема: внешнему клиенту, загружающему 1 000 000 записей через REST API по 200 записей за вызов, нужно 5 000 вызовов API Схема: пять шагов Bulk API между внешним клиентом и Salesforce: открыть задание, загрузить файлы, запустить обработку, проверить статус и скачать успешные и неуспешные записи

  1. Открытие задания (шаг 1): Начните процесс с открытия задания, которое дает вам уникальный ID задания. Этот шаг похож на получение пропуска на погрузочную платформу.
  2. Загрузка файлов (шаг 2): Имея ID задания, можно начать загружать файлы данных в формате CSV. Каждый файл может содержать до 10 000 записей с учетом ограничений по размеру. Под одним ID задания можно загрузить несколько файлов.
  3. Запуск обработки (шаг 3): Когда загрузка завершена, попросите Salesforce начать обработку данных, нажав образную «большую синюю кнопку». После этого Salesforce начнет обрабатывать загруженные файлы.
  4. Проверка статуса задания (шаг 4): Во время обработки можно запросить статус задания по его ID. Этот шаг позволяет следить за ходом импорта.
  5. Скачивание результатов (шаг 5): Когда обработка завершена, можно скачать результаты. Вы можете скачать либо успешные записи с ID Salesforce вновь вставленных или обновленных записей, либо неуспешные записи с подробностями о возникших ошибках.

Раздел 2: демонстрация Bulk API в Postman

Чтобы показать процесс Bulk API, мы воспользуемся Postman для работы с песочницей Salesforce:

  1. Аутентификация: Начните с аутентификации, чтобы получить маркер доступа.
  2. Создание нового задания: Запустите новое задание, отправив запрос на создание задания. В ответ вы получите ID задания.
  3. Загрузка данных: Вставьте ID задания в URL и загрузите данные. В этом примере мы создадим новую организацию «Bart Buildings».
  4. Запуск обработки: Попросите Salesforce начать обработку, отправив запрос с ID задания и статусом «Upload Complete».
  5. Проверка статуса задания: Следите за ходом задания, проверяя его статус по ID. Когда задание завершено, можно переходить к следующему шагу.
  6. Скачивание успешных записей: Получите ID Salesforce для вновь созданных записей, скачав успешные записи по ID задания.

Снимок экрана Postman, шаг 1: POST, создающий задание загрузки (ingest) Bulk API, с ID нового задания в ответе Снимок экрана Postman, шаг 2: PUT, загружающий данные CSV в задание и возвращающий 201 Created Снимок экрана Postman, шаг 3: PATCH, устанавливающий состояние задания UploadComplete для запуска обработки Снимок экрана Postman, шаг 4: GET, проверяющий статус задания и показывающий JobComplete Снимок экрана Postman, шаг 5: GET, скачивающий успешные результаты в CSV с ID новой записи

Раздел 3: заключение

Salesforce Bulk API — эффективный способ импортировать большие наборы данных в Salesforce с минимальным числом вызовов API. Простой процесс из пяти шагов позволяет эффективно вставлять, обновлять и даже удалять миллионы записей. Будь то одна запись или миллионы, Bulk API дает быстрое и надежное решение для импорта данных.

Следите за новостями

Спасибо, что изучили Salesforce Bulk API вместе с нами. Следите за новыми материалами о том, как использовать мощные возможности Salesforce!

Присоединяйтесь к www.SteveTechArc.com и YouTube-каналу @SteveTechArc (opens in a new tab). Подписывайтесь и углубляйте свое понимание Salesforce и того, как интегрировать его с другими системами.

Помогаем менять мир, делясь знаниями об интеграции с коллегами-архитекторами и теми, кто идет по пути к профессии архитектора!

Расшифровка сделана с помощью ИИ

STA 1.7