Traduzido por IA. Ainda não revisado pela comunidade. Ler em inglês

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

As etapas da Bulk API do Salesforce: importando dados na doca de carga

Introdução:

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

Seção 1: entendendo o processo da Bulk API

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

Diagrama: um cliente externo carregando 1.000.000 de registros pela API REST, a 200 registros 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 arquivos, iniciar o processamento, verificar o status e baixar 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 à doca de carga.
  2. Enviar arquivos (etapa 2): com o ID do job, você pode começar a enviar arquivos de dados em formato CSV. Cada arquivo pode ter até 10.000 registros, respeitando os limites de tamanho. Você pode enviar vários arquivos no mesmo ID de job.
  3. Iniciar o processamento (etapa 3): quando o envio terminar, avise o Salesforce para começar a processar os dados apertando o metafórico “grande botão azul”. O Salesforce então começa a processar os arquivos enviados.
  4. Verificar o status do job (etapa 4): durante o processamento, você pode consultar o status do job usando o ID. Assim você acompanha o andamento da importação.
  5. Baixar os resultados (etapa 5): terminado o processamento, você pode baixar os resultados. Dá para baixar os registros com sucesso, que incluem os IDs do Salesforce dos registros recém-inseridos ou atualizados, ou os registros com falha, com os detalhes dos erros encontrados.

Seção 2: demonstrando a Bulk API com o Postman

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

  1. Autenticação: comece se autenticando para receber um token de acesso.
  2. Criar um novo job: inicie um novo job enviando uma requisição de criação. Isso fornece um ID de job.
  3. Enviar os dados: coloque o ID do job na URL e envie seus dados. Neste exemplo, vamos criar uma nova conta chamada “Bart Buildings”.
  4. Iniciar o processamento: avise o Salesforce para começar enviando uma requisição com o ID do job e o status “Upload Complete”.
  5. Verificar o status do job: acompanhe o andamento verificando o status com o ID do job. Quando o job terminar, você pode seguir para a próxima etapa.
  6. Baixar os registros com sucesso: obtenha o ID do Salesforce dos registros recém-criados baixando os registros com sucesso usando o 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 retorna 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 status do job, mostrando JobComplete Captura do Postman, etapa 5: um GET que baixa os resultados com sucesso em CSV, com o ID do novo registro

Seção 3: conclusão

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

Fique de olho

Obrigado por explorar a Bulk API do Salesforce com a gente. Fique de olho em 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). Inscreva-se e aprofunde seu entendimento do Salesforce e de como integrá-lo a outros sistemas.

Ajudando a mudar o mundo compartilhando 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