Přeloženo pomocí AI. Komunita překlad zatím nezkontrolovala. Číst anglicky

Blog · 15. září 2023 · Steve Simpson · Integrace

Kroky Salesforce Bulk API: import dat na nakládací rampě

Úvod:

V tomto článku prozkoumáme Salesforce Bulk API, výkonný nástroj navržený pro efektivní import velkých datových sad do Salesforce. Na rozdíl od REST API, které vás omezuje na 200 záznamů na volání, umožňuje Bulk API vložit miliony záznamů zjednodušeným postupem.

Část 1: Porozumění postupu Bulk API

Salesforce Bulk API importuje velké objemy dat hladce v pěti krocích:

Diagram: externí klient, který načítá 1 000 000 záznamů přes REST API po 200 záznamech na volání, potřebuje 5 000 volání API Diagram: pět kroků Bulk API mezi externím klientem a Salesforce: otevření úlohy, nahrání souborů, spuštění zpracování, kontrola stavu a stažení úspěšných a neúspěšných záznamů

  1. Otevření úlohy (krok 1): Postup zahájíte otevřením úlohy, která vám přidělí jedinečné ID úlohy. Je to jako dostat lístek, který vás pustí na nakládací rampu.
  2. Nahrání souborů (krok 2): S ID úlohy můžete začít nahrávat datové soubory ve formátu CSV. Každý soubor může obsahovat až 10 000 záznamů, s výhradou limitů velikosti. Pod stejným ID úlohy můžete nahrát více souborů.
  3. Spuštění zpracování (krok 3): Po dokončení nahrávání dejte Salesforce pokyn, aby začal data zpracovávat, tím, že zmáčknete pomyslné „velké modré tlačítko“. Salesforce pak začne nahrané soubory zpracovávat.
  4. Kontrola stavu úlohy (krok 4): Během zpracování se můžete na stav úlohy ptát pomocí ID úlohy. Tento krok vám umožní sledovat průběh importu dat.
  5. Stažení výsledků (krok 5): Po dokončení zpracování si můžete stáhnout výsledky. Můžete stáhnout buď úspěšné záznamy, které obsahují ID Salesforce nově vložených nebo aktualizovaných záznamů, nebo neúspěšné záznamy s podrobnostmi o chybách, které nastaly.

Část 2: Ukázka Bulk API v Postmanu

Pro ilustraci postupu Bulk API použijeme Postman ke komunikaci se sandboxem Salesforce:

  1. Autentizace: Začněte ověřením, abyste získali přístupový token.
  2. Vytvoření nové úlohy: Novou úlohu zahájíte odesláním požadavku na vytvoření úlohy. Tato akce vám přidělí ID úlohy.
  3. Nahrání dat: Vložte ID úlohy do URL a nahrajte svá data. V tomto příkladu vytvoříme nový účet s názvem „Bart Buildings“.
  4. Spuštění zpracování: Dejte Salesforce pokyn ke zpracování odesláním požadavku s ID úlohy a stavem „Upload Complete“.
  5. Kontrola stavu úlohy: Sledujte průběh úlohy kontrolou jejího stavu pomocí ID úlohy. Jakmile je úloha dokončená, můžete přejít k dalšímu kroku.
  6. Stažení úspěšných záznamů: Získejte ID Salesforce nově vytvořených záznamů stažením úspěšných záznamů pomocí ID úlohy.

Snímek z Postmanu, krok 1: POST, který vytvoří úlohu příjmu dat Bulk API, s novým ID úlohy v odpovědi Snímek z Postmanu, krok 2: PUT, který nahraje data CSV do úlohy a vrátí 201 Created Snímek z Postmanu, krok 3: PATCH, který nastaví stav úlohy na UploadComplete a spustí zpracování Snímek z Postmanu, krok 4: GET, který zkontroluje stav úlohy a ukazuje JobComplete Snímek z Postmanu, krok 5: GET, který stáhne úspěšné výsledky jako CSV s novým ID záznamu

Část 3: Závěr

Salesforce Bulk API nabízí efektivní způsob, jak importovat velké datové sady do Salesforce s minimem volání API. Jednoduchým postupem v pěti krocích můžete efektivně vkládat, aktualizovat nebo i mazat miliony záznamů. Ať jde o jediný záznam, nebo o miliony, Bulk API je rychlé a spolehlivé řešení pro vaše potřeby importu dat.

Zůstaňte naladěni

Děkuji, že jste se s námi pustili do průzkumu Salesforce Bulk API. Těšte se na další užitečný obsah o využití výkonných funkcí Salesforce!

Přidejte se k www.SteveTechArc.com a ke kanálu @SteveTechArc (opens in a new tab) na YouTube. Přihlaste se k odběru a prohlubte své porozumění Salesforce a tomu, jak ho integrovat s dalšími systémy.

Pomáháme měnit svět sdílením informací o integraci s kolegy architekty a se všemi, kdo jsou na cestě k architektovi!

Přepis s pomocí AI

STA 1.7