Tradotto con l'IA. Non ancora rivisto dalla comunità. Leggi in inglese

Blog · 15 settembre 2023 · Steve Simpson · Integrazione

I passaggi della Bulk API di Salesforce: importare i dati alla banchina di carico

Introduzione:

In questo articolo esploriamo la Bulk API di Salesforce, uno strumento potente pensato per importare in modo efficiente grandi set di dati in Salesforce. A differenza dell’API REST, che ti limita a 200 record per chiamata, la Bulk API permette di inserire milioni di record con un processo snello.

Sezione 1: capire il processo della Bulk API

La Bulk API di Salesforce funziona in cinque passaggi per importare senza intoppi grandi volumi di dati:

Diagramma: un client esterno che carica 1.000.000 di record tramite l'API REST, 200 record per chiamata, ha bisogno di 5.000 chiamate API Diagramma: i cinque passaggi della Bulk API tra un client esterno e Salesforce: aprire un job, caricare i file, avviare l'elaborazione, controllare lo stato e scaricare successi e fallimenti

  1. Aprire il job (passaggio 1): avvia il processo aprendo un job, che ti fornisce un ID job univoco. È come ricevere un biglietto che ti dà accesso alla banchina di carico.
  2. Caricare i file (passaggio 2): con il tuo ID job puoi iniziare a caricare file di dati in formato CSV. Ogni file può contenere fino a 10.000 record, entro i limiti di dimensione. Puoi caricare più file con lo stesso ID job.
  3. Avviare l’elaborazione (passaggio 3): quando il caricamento è completo, chiedi a Salesforce di iniziare a elaborare i dati premendo il metaforico “grande pulsante blu”. Salesforce inizia quindi a elaborare i file caricati.
  4. Controllare lo stato del job (passaggio 4): durante l’elaborazione puoi chiedere lo stato del job usando l’ID job. Questo passaggio ti permette di seguire l’avanzamento dell’importazione.
  5. Scaricare i risultati (passaggio 5): a elaborazione completata puoi scaricare i risultati. Puoi scegliere di scaricare i record riusciti, con gli ID Salesforce dei record appena inseriti o aggiornati, oppure i record non riusciti, con i dettagli degli errori riscontrati.

Sezione 2: la Bulk API dimostrata con Postman

Per illustrare il processo della Bulk API, useremo Postman per interagire con una sandbox Salesforce:

  1. Autenticazione: inizia autenticandoti per ricevere un token di accesso.
  2. Creare un nuovo job: avvia un nuovo job inviando una richiesta di creazione. Otterrai un ID job.
  3. Caricare i dati: inserisci l’ID job nell’URL e carica i tuoi dati. In questo esempio creiamo un nuovo account chiamato “Bart Buildings”.
  4. Avviare l’elaborazione: chiedi a Salesforce di iniziare inviando una richiesta con l’ID job e lo stato “Upload Complete”.
  5. Controllare lo stato del job: segui l’avanzamento controllando lo stato con l’ID job. Quando il job è completo, puoi passare al passaggio successivo.
  6. Scaricare i record riusciti: recupera l’ID Salesforce dei nuovi record scaricando i record riusciti con l’ID job.

Screenshot di Postman, passaggio 1: un POST che crea un job di ingestione della Bulk API, con il nuovo ID job nella risposta Screenshot di Postman, passaggio 2: un PUT che carica i dati CSV nel job e restituisce 201 Created Screenshot di Postman, passaggio 3: un PATCH che imposta lo stato del job su UploadComplete per avviare l'elaborazione Screenshot di Postman, passaggio 4: un GET che controlla lo stato del job e mostra JobComplete Screenshot di Postman, passaggio 5: un GET che scarica i risultati riusciti in CSV, con l'ID del nuovo record

Sezione 3: conclusione

La Bulk API di Salesforce offre un metodo efficiente per importare grandi set di dati in Salesforce con un numero minimo di chiamate API. Con cinque semplici passaggi puoi inserire, aggiornare o persino eliminare milioni di record in modo efficiente. Che tu abbia un solo record o milioni, la Bulk API è una soluzione rapida e affidabile per le tue importazioni di dati.

Resta sintonizzato

Grazie per aver esplorato con noi la Bulk API di Salesforce. Resta sintonizzato per altri contenuti utili su come sfruttare le potenti funzionalità di Salesforce!

Unisciti a noi su www.SteveTechArc.com e sul canale YouTube @SteveTechArc (opens in a new tab). Iscriviti e approfondisci la tua comprensione di Salesforce e di come integrarlo con altri sistemi.

Contribuire a cambiare il mondo condividendo conoscenze sull’integrazione con altri architetti e con chi è in cammino per diventarlo!

Trascrizione realizzata con l’aiuto dell’IA

STA 1.7