Traduzido com IA. Ainda não revisto pela comunidade. Ler em inglês

Blog · 15 de setembro de 2023 · Steve Simpson · Integração

As etapas da Bulk API do Salesforce: importar dados no cais de carga

Introdução:

Neste artigo, vamos explorar a Bulk API do Salesforce, uma ferramenta poderosa feita para importar grandes conjuntos de dados com eficiência para o Salesforce. Ao contrário da API REST, que o limita a 200 registos por chamada, a Bulk API permite inserir milhões de registos num processo simplificado.

Secção 1: entender o processo da Bulk API

A Bulk API do Salesforce funciona em cinco etapas para importar grandes volumes de dados sem complicações:

Diagrama: um cliente externo que carrega 1.000.000 de registos pela API REST, a 200 registos por chamada, precisa de 5.000 chamadas de API Diagrama: as cinco etapas da Bulk API entre um cliente externo e o Salesforce: abrir um job, enviar ficheiros, iniciar o processamento, verificar o estado e transferir sucessos e falhas

  1. Abrir o job (etapa 1): comece o processo abrindo um job, que fornece um ID de job único. É como receber uma senha que dá acesso ao cais de carga.
  2. Enviar ficheiros (etapa 2): com o ID do job, pode começar a enviar ficheiros de dados em formato CSV. Cada ficheiro pode ter até 10.000 registos, respeitando os limites de tamanho. Pode enviar vários ficheiros com o mesmo ID de job.
  3. Iniciar o processamento (etapa 3): quando o envio terminar, avise o Salesforce para começar a processar os dados carregando no metafórico «grande botão azul». O Salesforce começa então a processar os ficheiros enviados.
  4. Verificar o estado do job (etapa 4): durante o processamento, pode consultar o estado do job usando o ID. Assim acompanha o andamento da importação.
  5. Transferir os resultados (etapa 5): terminado o processamento, pode transferir os resultados. Pode transferir os registos com sucesso, que incluem os IDs do Salesforce dos registos acabados de inserir ou atualizar, ou os registos com falha, com os detalhes dos erros encontrados.

Secção 2: demonstrar a Bulk API com o Postman

Para ilustrar o processo da Bulk API, vamos usar o Postman para interagir com uma sandbox do Salesforce:

  1. Autenticação: comece por se autenticar para receber um token de acesso.
  2. Criar um novo job: inicie um novo job enviando um pedido de criação. Isso fornece um ID de job.
  3. Enviar os dados: coloque o ID do job no URL e envie os seus dados. Neste exemplo, vamos criar uma nova conta chamada «Bart Buildings».
  4. Iniciar o processamento: avise o Salesforce para começar enviando um pedido com o ID do job e o estado «Upload Complete».
  5. Verificar o estado do job: acompanhe o andamento verificando o estado com o ID do job. Quando o job terminar, pode avançar para a próxima etapa.
  6. Transferir os registos com sucesso: obtenha o ID do Salesforce dos registos acabados de criar transferindo os registos com sucesso através do ID do job.

Captura do Postman, etapa 1: um POST que cria um job de ingestão da Bulk API, com o novo ID do job na resposta Captura do Postman, etapa 2: um PUT que envia os dados CSV para o job e devolve 201 Created Captura do Postman, etapa 3: um PATCH que define o estado do job como UploadComplete para iniciar o processamento Captura do Postman, etapa 4: um GET que verifica o estado do job, a mostrar JobComplete Captura do Postman, etapa 5: um GET que transfere os resultados com sucesso em CSV, com o ID do novo registo

Secção 3: conclusão

A Bulk API do Salesforce oferece um método eficiente para importar grandes conjuntos de dados para o Salesforce com o mínimo de chamadas de API. Em cinco etapas simples, pode inserir, atualizar ou até eliminar milhões de registos com eficiência. Seja um único registo ou milhões, a Bulk API é uma solução rápida e fiável para as suas importações de dados.

Fique atento

Obrigado por explorar a Bulk API do Salesforce connosco. Fique atento a mais conteúdo sobre como aproveitar os recursos poderosos do Salesforce!

Junte-se a nós em www.SteveTechArc.com e no canal do YouTube @SteveTechArc (opens in a new tab). Subscreva e aprofunde o seu entendimento do Salesforce e de como integrá-lo com outros sistemas.

A ajudar a mudar o mundo, partilhando conhecimento sobre integração com outros arquitetos e com quem está na jornada para se tornar um!

Transcrição feita com a ajuda de IA

STA 1.7