Kroki Salesforce Bulk API: import danych na rampie załadunkowej
Wprowadzenie:
W tym wpisie przyjrzymy się Salesforce Bulk API, potężnemu narzędziu do sprawnego importowania dużych zbiorów danych do Salesforce. W przeciwieństwie do REST API, które ogranicza cię do 200 rekordów na wywołanie, Bulk API pozwala wstawić miliony rekordów w uproszczonym procesie.
Część 1: jak działa proces Bulk API
Salesforce Bulk API działa w pięciu krokach, które pozwalają płynnie importować duże wolumeny danych:
- Otwarcie zadania (krok 1): zacznij proces od otwarcia zadania, które daje ci unikalny identyfikator zadania. Ten krok przypomina otrzymanie biletu, który wpuszcza cię na rampę załadunkową.
- Przesłanie plików (krok 2): z identyfikatorem zadania możesz zacząć przesyłać pliki danych w formacie CSV. Każdy plik może zawierać do 10 000 rekordów, w granicach limitów rozmiaru. W ramach tego samego identyfikatora zadania możesz przesłać wiele plików.
- Rozpoczęcie przetwarzania (krok 3): po zakończeniu przesyłania daj Salesforce znać, żeby zaczął przetwarzać dane, naciskając metaforyczny „wielki niebieski przycisk”. Salesforce zacznie wtedy przetwarzać przesłane pliki.
- Sprawdzenie statusu zadania (krok 4): w trakcie przetwarzania możesz pytać o status zadania, używając jego identyfikatora. Ten krok pozwala śledzić postęp importu danych.
- Pobranie wyników (krok 5): po zakończeniu przetwarzania możesz pobrać wyniki. Do wyboru masz pobranie rekordów, które się udały, z identyfikatorami Salesforce nowo wstawionych albo zaktualizowanych rekordów, albo rekordów, które się nie udały, ze szczegółami napotkanych błędów.
Część 2: Bulk API w Postmanie
Żeby zilustrować proces Bulk API, użyjemy Postmana do pracy z sandboxem Salesforce:
- Uwierzytelnianie: zacznij od uwierzytelnienia, żeby otrzymać token dostępu.
- Utworzenie nowego zadania: zainicjuj nowe zadanie, wysyłając żądanie jego utworzenia. W odpowiedzi dostaniesz identyfikator zadania.
- Przesłanie danych: wstaw identyfikator zadania do adresu URL i prześlij dane. W tym przykładzie utworzymy nowe konto o nazwie „Bart Buildings”.
- Rozpoczęcie przetwarzania: daj Salesforce znać, żeby zaczął przetwarzanie, wysyłając żądanie z identyfikatorem zadania i statusem „Upload Complete”.
- Sprawdzenie statusu zadania: śledź postęp zadania, sprawdzając jego status za pomocą identyfikatora. Gdy zadanie się zakończy, możesz przejść do następnego kroku.
- Pobranie rekordów, które się udały: pobierz identyfikator Salesforce nowo utworzonych rekordów, pobierając udane rekordy za pomocą identyfikatora zadania.
Część 3: podsumowanie
Salesforce Bulk API to sprawna metoda importowania dużych zbiorów danych do Salesforce przy minimalnej liczbie wywołań API. W prostym, pięciokrokowym procesie możesz sprawnie wstawiać, aktualizować, a nawet usuwać miliony rekordów. Niezależnie od tego, czy masz do czynienia z jednym rekordem, czy z milionami, Bulk API daje szybkie i niezawodne rozwiązanie twoich potrzeb importu danych.
Bądźmy w kontakcie
Dziękuję za wspólne poznawanie Salesforce Bulk API. Czekaj na kolejne treści o wykorzystywaniu potężnych możliwości Salesforce!
Dołącz do www.SteveTechArc.com i kanału YouTube @SteveTechArc (opens in a new tab). Zasubskrybuj i pogłębiaj swoje zrozumienie Salesforce i tego, jak integrować go z innymi systemami.
Pomagam zmieniać świat, dzieląc się wiedzą o integracji z innymi architektami i z tymi, którzy są na drodze do architektury!
STA 1.7