Von KI übersetzt. Noch nicht von der Community geprüft. Auf Englisch lesen

Blog · 15. September 2023 · Steve Simpson · Integration

Die Schritte der Salesforce Bulk API: Daten an der Laderampe importieren

Einführung:

In diesem Beitrag sehen wir uns die Salesforce Bulk API an, ein leistungsstarkes Werkzeug, mit dem sich grosse Datenmengen effizient in Salesforce importieren lassen. Anders als die REST API, die Sie auf 200 Datensätze pro Aufruf begrenzt, erlaubt die Bulk API das Einfügen von Millionen Datensätzen in einem schlanken Ablauf.

Abschnitt 1: den Ablauf der Bulk API verstehen

Die Salesforce Bulk API arbeitet in fünf Schritten, um grosse Datenmengen reibungslos zu importieren:

Diagramm: Ein externer Client, der 1’000’000 Datensätze über die REST API mit 200 Datensätzen pro Aufruf lädt, braucht 5’000 API-Aufrufe Diagramm: die fünf Schritte der Bulk API zwischen einem externen Client und Salesforce: Job öffnen, Dateien hochladen, Verarbeitung starten, Status prüfen sowie Erfolge und Fehler herunterladen

  1. Job öffnen (Schritt 1): Starten Sie den Ablauf, indem Sie einen Job öffnen; Sie erhalten eine eindeutige Job-ID. Das ist so, als bekämen Sie ein Ticket, das Ihnen Zugang zur Laderampe gewährt.
  2. Dateien hochladen (Schritt 2): Mit Ihrer Job-ID können Sie Datendateien im CSV-Format hochladen. Jede Datei kann bis zu 10’000 Datensätze enthalten, innerhalb der Grössenbeschränkungen. Unter derselben Job-ID lassen sich mehrere Dateien hochladen.
  3. Verarbeitung starten (Schritt 3): Wenn das Hochladen abgeschlossen ist, teilen Sie Salesforce mit, dass die Verarbeitung beginnen soll, indem Sie sinnbildlich den «grossen blauen Knopf» drücken. Salesforce beginnt dann mit der Verarbeitung der hochgeladenen Dateien.
  4. Job-Status prüfen (Schritt 4): Während der Verarbeitung können Sie den Job-Status mit der Job-ID abfragen. So behalten Sie den Fortschritt des Imports im Blick.
  5. Ergebnisse herunterladen (Schritt 5): Nach der Verarbeitung können Sie die Ergebnisse herunterladen. Sie können entweder die erfolgreichen Datensätze herunterladen, mit den Salesforce-IDs der neu eingefügten oder aktualisierten Datensätze, oder die fehlgeschlagenen, mit den Details zu den aufgetretenen Fehlern.

Abschnitt 2: die Bulk API mit Postman vorgeführt

Um den Ablauf der Bulk API zu zeigen, arbeiten wir mit Postman gegen eine Salesforce-Sandbox:

  1. Authentifizierung: Authentifizieren Sie sich zuerst, um ein Zugriffstoken zu erhalten.
  2. Neuen Job anlegen: Starten Sie einen neuen Job, indem Sie eine Anfrage zum Anlegen eines Jobs senden. Damit erhalten Sie eine Job-ID.
  3. Daten hochladen: Setzen Sie die Job-ID in die URL ein und laden Sie Ihre Daten hoch. In diesem Beispiel legen wir einen neuen Account namens «Bart Buildings» an.
  4. Verarbeitung starten: Teilen Sie Salesforce mit, dass die Verarbeitung beginnen soll, indem Sie eine Anfrage mit der Job-ID und dem Status «Upload Complete» senden.
  5. Job-Status prüfen: Verfolgen Sie den Fortschritt, indem Sie den Status mit der Job-ID abfragen. Sobald der Job abgeschlossen ist, können Sie zum nächsten Schritt übergehen.
  6. Erfolgreiche Datensätze herunterladen: Holen Sie sich die Salesforce-IDs der neu angelegten Datensätze, indem Sie die erfolgreichen Datensätze mit der Job-ID herunterladen.

Postman-Screenshot, Schritt 1: ein POST, der einen Bulk-API-Ingest-Job anlegt, mit der neuen Job-ID in der Antwort Postman-Screenshot, Schritt 2: ein PUT, der die CSV-Daten in den Job hochlädt und 201 Created zurückgibt Postman-Screenshot, Schritt 3: ein PATCH, der den Job-Status auf UploadComplete setzt, um die Verarbeitung zu starten Postman-Screenshot, Schritt 4: ein GET, der den Job-Status prüft und JobComplete anzeigt Postman-Screenshot, Schritt 5: ein GET, der die erfolgreichen Ergebnisse als CSV herunterlädt, mit der neuen Datensatz-ID

Abschnitt 3: Fazit

Die Salesforce Bulk API bietet eine effiziente Methode, grosse Datenmengen mit minimalen API-Aufrufen in Salesforce zu importieren. In fünf einfachen Schritten können Sie Millionen Datensätze effizient einfügen, aktualisieren oder sogar löschen. Ob ein einzelner Datensatz oder Millionen: Die Bulk API ist eine schnelle und verlässliche Lösung für Ihre Datenimporte.

Bleiben Sie dran

Danke, dass Sie die Salesforce Bulk API mit uns erkundet haben. Bleiben Sie dran für weitere Inhalte dazu, wie Sie die starken Funktionen von Salesforce nutzen!

Besuchen Sie www.SteveTechArc.com und den YouTube-Kanal @SteveTechArc (opens in a new tab). Abonnieren Sie und vertiefen Sie Ihr Verständnis von Salesforce und davon, wie Sie es mit anderen Systemen integrieren.

Die Welt ein Stück verändern, indem ich Wissen über Integration mit anderen Architekt:innen und allen auf dem Weg dorthin teile!

Transkript mit Unterstützung von KI

STA 1.7