Vertaald door AI. Nog niet door de community nagekeken. Lees in het Engels

Blog · 15 september 2023 · Steve Simpson · Integratie

Stappen van de Salesforce Bulk API: data importeren aan het laadperron

Inleiding:

In deze blogpost verkennen we de Salesforce Bulk API, een krachtig hulpmiddel om grote datasets efficiënt in Salesforce te importeren. Anders dan de REST API, die je beperkt tot 200 records per aanroep, laat de Bulk API je via een gestroomlijnd proces miljoenen records invoegen.

Deel 1: het proces van de Bulk API begrijpen

De Salesforce Bulk API werkt met een proces van vijf stappen om grote hoeveelheden data soepel te importeren:

Diagram: een externe client die 1.000.000 records laadt via de REST API, met 200 records per aanroep, heeft 5.000 API-aanroepen nodig Diagram: de vijf stappen van de Bulk API tussen een externe client en Salesforce: een job openen, bestanden uploaden, de verwerking starten, de status controleren, en successen en mislukkingen downloaden

  1. De job openen (stap 1): Begin het proces door een job te openen, die je een unieke job-ID geeft. Deze stap is te vergelijken met een kaartje krijgen dat je toegang geeft tot het laadperron.
  2. Bestanden uploaden (stap 2): Met je job-ID kun je databestanden in CSV-formaat gaan uploaden. Elk bestand kan tot 10.000 records bevatten, binnen de groottelimieten. Je kunt meerdere bestanden onder dezelfde job-ID uploaden.
  3. De verwerking starten (stap 3): Als het uploaden klaar is, laat je Salesforce weten dat het de data mag gaan verwerken door op de figuurlijke “grote blauwe knop” te drukken. Salesforce begint dan de geüploade bestanden te verwerken.
  4. De status van de job controleren (stap 4): Tijdens de verwerking kun je met de job-ID naar de status van de job vragen. Met deze stap volg je de voortgang van de data-import.
  5. De resultaten downloaden (stap 5): Als de verwerking klaar is, kun je de resultaten downloaden. Je kunt de geslaagde records downloaden, met de Salesforce-ID’s van de nieuw ingevoegde of bijgewerkte records, of de mislukte records, met details over de fouten die optraden.

Deel 2: de Bulk API demonstreren met Postman

Om het proces van de Bulk API te laten zien, gebruiken we Postman om met een Salesforce-sandbox te werken:

  1. Authenticatie: Begin met authenticeren om een access token te krijgen.
  2. Een nieuwe job aanmaken: Start een nieuwe job door een request te sturen om een job aan te maken. Dat levert je een job-ID op.
  3. Data uploaden: Zet de job-ID in de URL en upload je data. In dit voorbeeld maken we een nieuw account aan met de naam “Bart Buildings”.
  4. De verwerking starten: Laat Salesforce weten dat het mag beginnen met verwerken door een request te sturen met de job-ID en de status “Upload Complete”.
  5. De status van de job controleren: Volg de voortgang van de job door met de job-ID de status te controleren. Als de job klaar is, kun je naar de volgende stap.
  6. Geslaagde records downloaden: Haal de Salesforce-ID van de nieuw aangemaakte records op door met de job-ID de geslaagde records te downloaden.

Schermafbeelding van Postman, stap 1: een POST die een ingest-job van de Bulk API aanmaakt, met de nieuwe job-ID in het antwoord Schermafbeelding van Postman, stap 2: een PUT die de CSV-data naar de job uploadt en 201 Created teruggeeft Schermafbeelding van Postman, stap 3: een PATCH die de status van de job op UploadComplete zet om de verwerking te starten Schermafbeelding van Postman, stap 4: een GET die de status van de job controleert en JobComplete toont Schermafbeelding van Postman, stap 5: een GET die de geslaagde resultaten als CSV downloadt, met de nieuwe record-ID

Deel 3: conclusie

De Salesforce Bulk API biedt een efficiënte methode om grote datasets met zo weinig mogelijk API-aanroepen in Salesforce te importeren. Met een eenvoudig proces van vijf stappen kun je miljoenen records efficiënt invoegen, bijwerken of zelfs verwijderen. Of je nu met één record werkt of met miljoenen, de Bulk API biedt een snelle en betrouwbare oplossing voor je data-import.

Blijf op de hoogte

Bedankt dat je met ons de Salesforce Bulk API verkende. Blijf kijken voor meer inzichtelijke content over het benutten van de krachtige functies van Salesforce!

Volg www.SteveTechArc.com en het YouTube-kanaal @SteveTechArc (opens in a new tab). Abonneer je en verdiep je begrip van Salesforce en hoe je het met andere systemen kunt integreren.

De wereld helpen veranderen door integratiekennis te delen met collega-architecten en met iedereen die op weg is om architect te worden!

Transcript met hulp van AI

STA 1.7