Блог · 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: відкрити job, завантажити файли, запустити обробку, перевірити статус і завантажити успішні та невдалі записи

Відкрийте job (крок 1): Почніть процес із відкриття job, що дає вам унікальний ID job. Цей крок схожий на отримання квитка, що відкриває вам доступ до вантажної рампи.
Завантажте файли (крок 2): Маючи ID job, ви можете почати завантажувати файли даних у форматі CSV. Кожен файл може містити до 10 000 записів з урахуванням обмежень розміру. Під тим самим ID job можна завантажити кілька файлів.
Запустіть обробку (крок 3): Коли завантаження завершено, повідомте Salesforce почати обробку даних, натиснувши метафоричну «велику синю кнопку». Тоді Salesforce почне обробляти завантажені файли.
Перевірте статус job (крок 4): Під час обробки ви можете дізнатися статус job за його ID. Цей крок дає змогу стежити за ходом імпорту даних.
Завантажте результати (крок 5): Після завершення обробки ви можете завантажити результати. Можна завантажити або успішні записи, що містять Salesforce ID щойно вставлених чи оновлених записів, або невдалі записи з подробицями про помилки.

Розділ 2: демонстрація Bulk API за допомогою Postman

Щоб проілюструвати процес Bulk API, ми використаємо Postman для роботи із sandbox Salesforce:

Автентифікація: Почніть з автентифікації, щоб отримати токен доступу.
Створіть новий job: Ініціюйте новий job, надіславши запит на його створення. Ця дія дасть вам ID job.
Завантажте дані: Вставте ID job в URL і завантажте дані. У цьому прикладі ми створимо новий акаунт із назвою “Bart Buildings”.
Запустіть обробку: Повідомте Salesforce почати обробку, надіславши запит з ID job і статусом “Upload Complete”.
Перевірте статус job: Стежте за ходом job, перевіряючи його статус за ID. Коли job завершено, можна переходити до наступного кроку.
Завантажте успішні записи: Отримайте Salesforce ID щойно створених записів, завантаживши успішні записи за ID job.

Скриншот Postman, крок 1: POST, що створює ingest job Bulk API, з новим ID job у відповіді Скриншот Postman, крок 2: PUT, що завантажує дані CSV у job і повертає 201 Created Скриншот Postman, крок 3: PATCH, що встановлює стан job на UploadComplete, щоб запустити обробку Скриншот Postman, крок 4: GET, що перевіряє статус job і показує 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