Atividade de Atualização em Massa do Salesforce¶

Introdução¶

Uma atividade do Salesforce Bulk Upsert atualiza um grande número de registros existentes e insere um grande número de novos registros em um endpoint do Salesforce e deve ser usado como um destino para consumir dados em uma operação. Depois de configurar uma conexão do Salesforce, você pode configurar quantas atividades do Salesforce desejar para cada conexão do Salesforce.

A atividade Bulk Upsert é mais rápida e escala melhor do que uma atividade não em massa Salesforce Upsert activity, mas deve ser usado apenas se você não precisar usar uma transformação para alterar os dados antes de atingir seu destino. (As atividades em massa do Salesforce não podem ser usadas com transformações.)

A atividade Bulk Upsert requer o uso de um campo de ID externo para (1) inserir registros se eles ainda não existirem e (2) atualizar registros se eles já existirem. Para obter informações sobre como criar um campo de ID externo no Salesforce, consulte Criar um ID externo do Salesforce para Jitterbit. Se, em vez disso, você quiser inserir em massa apenas novos registros ou se quiser atualizar em massa os registros existentes com base na ID do objeto no Salesforce, use uma Atividade de inserção em massa ou atualização em massa do Salesforce.

O conector Salesforce é compatível com Salesforce Bulk API 2.0. Para obter mais informações, consulte Pré-requisitos e versões de API compatíveis.

Criar uma Atividade do Salesforce¶

Uma instância de uma atividade é criada a partir de uma conexão usando um tipo de atividade.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a quadro de design ou copie o tipo de atividade e cole-o na quadro de design. Para obter detalhes, consulte Criando uma instância de atividade em Reutilização de componente.

Uma atividade existente pode ser editada a partir destes locais:

A quadro de design (consulte Menu de ações do componente em Quadro de Design).
A aba Componentes do painel do projeto (consulte Menu de ações do componente na Guia Componentes do painel do projeto).

Configurar uma Atividade de Inserção em Massa do Salesforce¶

Siga estas etapas para configurar uma atividade de Upsert em massa do Salesforce:

Etapa 1: Digite um nome e selecione um objeto Forneça um nome para a atividade e selecione um objeto a ser usado ao atualizar dados em massa.
Etapa 2: Especifique um ID externo Selecione um campo Salesforce existente que você deseja que o Jitterbit Harmony use como o ID externo para associar registros.
Etapa 3: Forneça o Esquema de Resposta Carregue ou selecione um arquivo CSV. Isso fornecerá o esquema a ser usado na etapa final.
Etapa 4: Cabeçalhos do mapa Mapeie os cabeçalhos do arquivo de origem fornecidos do arquivo CSV com os campos do Salesforce desejados dos registros a serem atualizados em massa.

Etapa 1: Digite um Nome e Selecione um Objeto¶

Nesta etapa, você fornece um nome para a atividade e seleciona um objeto a ser usado ao atualizar dados em massa.

atividade de atualização em massa do salesforce 1

Nome: Insira um nome a ser usado para identificar a atividade do Salesforce Bulk Upsert. O nome deve ser exclusivo para cada atividade do Salesforce Bulk Upsert e não deve conter barras (/) ou dois pontos (:).
Selecione a Referência do objeto: Use o menu suspenso para selecionar um objeto padrão ou personalizado do Salesforce para inserir dados em massa. Insira qualquer parte do nome do objeto na caixa de pesquisa para filtrar a lista de objetos. A busca não diferencia maiúsculas de minúsculas.

Nota

Se o menu suspenso não for preenchido com objetos disponíveis, a Conexão do Salesforce pode não ter sucesso. Verifique se você está conectado reabrindo a conexão e testando novamente as credenciais.
Atualizar: Clique no ícone de atualização para recarregar objetos do endpoint do Salesforce. Isso pode ser útil se você tiver adicionado objetos ao Salesforce recentemente.
Save & Exit: Se ativado, clique para salvar a configuração desta etapa e fechar a configuração da atividade.
Avançar: Clique para armazenar temporariamente a configuração desta etapa e continuar na próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.
Descartar alterações: Após fazer as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 2: Especificar um ID Externo¶

Nesta etapa, você seleciona um campo Salesforce existente que deseja que o Jitterbit Harmony use como o ID externo para associar registros.

atividade de atualização em massa do salesforce 2

ID externo: Use o menu suspenso para selecionar o campo Salesforce existente que você deseja que o Jitterbit Harmony use como o ID externo para associar registros. Para obter informações sobre como criar um campo de ID externo no Salesforce, consulte Criar um ID externo do Salesforce para Jitterbit.

Aviso

O campo usado como ID externo deve ter um valor único para cada registro. Se você tiver vários registros com o mesmo valor de ID externo, uma resposta de erro do Salesforce será retornada e a inserção em massa falhará para os registros com IDs duplicados.
Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.
Avançar: Clique para armazenar temporariamente a configuração desta etapa e continuar na próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.
Descartar alterações: Após fazer as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 3: Fornecer o Esquema de Resposta¶

Nesta etapa, carregue ou selecione um arquivo CSV. O arquivo CSV fornecerá o esquema a ser usado na Etapa 4: Cabeçalhos do Mapa.

atividade de atualização em massa do salesforce 3

Fornecer esquema de resposta: O esquema de resposta define o esquema usado pelo arquivo CSV fornecido. Esse esquema de resposta é usado como parte da atividade em massa do Salesforce para criar mapeamentos na próxima etapa. Selecione uma das duas opções abaixo.

Nota

Os esquemas para atividades em massa do Salesforce sempre fazem parte da atividade e nunca podem ser definidos em uma transformação, pois as transformações não podem ser usadas em uma operação que tenha uma atividade em massa do Salesforce.
- Use Saved Schema: Escolha esta opção para selecionar um esquema existente que foi previamente definido no projeto atual.
  - Esquemas salvos: Use o menu suspenso para selecionar um esquema existente para reutilização.
  - Exibir esquema: Depois que um esquema carregado existente é selecionado, você pode visualizar o esquema diretamente na área de texto abaixo do menu suspenso. Embora um esquema salvo não seja editável, esta área de texto pode ser copiada usando Control+C(Windows ou Linux) ou Command+C(macOS). Esta área de texto é apenas para a exibição de esquemas carregados existentes e não para flat, hierárquico ou espelhado esquemas personalizados.
  - Validação: As informações de validação são fornecidas abaixo da área de texto e são baseadas na extensão do arquivo do esquema salvo.
    - Fornecer novo esquema: Escolha esta opção para definir um novo esquema carregando um arquivo ou inserindo-o manualmente na área de texto.
  - Nome do esquema: Digite um nome para o esquema na caixa de texto superior, incluindo a extensão do arquivo. Se nenhuma extensão de arquivo for fornecida, o arquivo será tratado como CSV por padrão. Se você estiver carregando um arquivo, pode deixar em branco, pois o nome é preenchido assim que o arquivo é carregado.
  - Carregar arquivo: Clique neste botão para abrir uma caixa de diálogo onde você pode carregar um esquema de um arquivo que pode ser acessado na máquina atual:
    - Arquivo: Use o botão Procurar para procurar um arquivo simples com um cabeçalho que ainda não foi usado no projeto atual. Arquivos de até 5 MB de tamanho podem ser carregados.
      
      Aviso
      
      Se você tentar carregar um arquivo com o mesmo nome de um arquivo existente já definido no projeto, uma caixa de diálogo perguntará se você deseja substituir o arquivo existente. Se você clicar em Continuar, o arquivo será substituído pelo novo arquivo com o mesmo nome em todos os locais onde for utilizado no projeto. Se não quiser sobrescrever o arquivo, clique em Cancelar e modifique manualmente o arquivo para que ele tenha um nome que ainda não esteja sendo usado e tente carregá-lo novamente.
    - Carregar: Clique neste botão para carregar o esquema do arquivo. Observe que alguns dados podem ser convertidos durante o processamento, conforme descrito em Processamento de esquema.
    - Cancelar: Clique em Cancelar para fechar a caixa de diálogo Carregar arquivo de esquema sem salvar.
  - Visualizar/editar esquema: Depois que um esquema é carregado, você pode visualizá-lo ou editá-lo diretamente na área de texto abaixo do botão Carregar arquivo. Outra opção é inserir ou colar manualmente um esquema nessa área sem carregar um esquema de um arquivo.
  - Validação: Conforme você edita um esquema, as informações de validação serão fornecidas abaixo da área de texto, com quaisquer erros relatados uma linha por vez. Ou seja, depois de resolver um erro em uma linha, erros de sintaxe adicionais a serem resolvidos podem ser relatados nas linhas subsequentes. A validação é baseada na extensão de arquivo do esquema fornecido.
Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.
Avançar: Clique para armazenar temporariamente a configuração desta etapa e continuar na próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.
Descartar alterações: Após fazer as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 4: Cabeçalhos do Mapa¶

Nesta etapa, você mapeia os cabeçalhos do arquivo de origem do arquivo CSV fornecido em Etapa 3: fornecer o esquema de resposta para os campos Salesforce desejados dos registros a serem atualizados em massa.

atividade de atualização em massa do salesforce 4

Mapear cabeçalhos: Esta etapa é usada para mapear campos por coluna no arquivo de origem para aqueles na atividade de destino em massa do Salesforce. Para concluir um mapeamento, arraste um campo de origem à esquerda para um campo de destino à direita. Quando os campos são mapeados, o fundo fica laranja e uma linha é desenhada entre os campos mapeados. Para remover um mapeamento, clique no campo de origem ou no campo de destino.
- Cabeçalhos do arquivo de origem: O lado esquerdo mostra os cabeçalhos das colunas no arquivo fornecido na etapa anterior.
  - Pesquisar: Digite qualquer parte do nome do cabeçalho na caixa de pesquisa para filtrar a lista de cabeçalhos. A busca não diferencia maiúsculas de minúsculas.
  - Importar mapeamento: Para importar um mapeamento que foi exportado anteriormente, clique no link Importar mapeamento e insira a entrada na caixa de diálogo:
    - Tipo de arquivo: Use o menu suspenso para selecionar o formato do arquivo de mapeamento:
      - JDL: Selecione JDL para usar um arquivo que foi exportado de uma operação de processo em massa do Design Studio (da opção Design Studio para Salvar mapeamentos para Arquivo descrito em Mapeamento de Transformação em Assistente de processo em massa do Salesforce para ação Upsert).
      - JSON: Selecione JSON para usar um arquivo que foi exportado do Cloud Studio usando o link Export Mapping descrito abaixo.
    - Arquivo: Clique no botão Procurar à direita para selecionar um arquivo que contém o mapeamento.
    - Upload: Após selecionar um arquivo, clique em Upload para carregar o mapeamento.
      
      Aviso
      
      O mapeamento carregado substitui todos os mapeamentos existentes, se houver.
    - Cancelar: Clique em Cancelar para fechar a caixa de diálogo de importação sem carregar um mapeamento.
  - Exportar mapeamento: Para exportar um mapeamento existente, clique no link Exportar mapeamento. Isso inicia o processo de download em seu navegador. O arquivo exportado está no formato JSON. Cada mapeamento de campo inclui o nome do campo de origem, o nome do campo de destino e o índice de origem.
    
    Nota
    
    Mapeamentos de atividade em massa exportados não podem ser importados como mapeamentos de transformação e pode ser importado apenas usando o link Import Mapping descrito acima.
- Salesforce Fields: O lado direito mostra os nomes das colunas no Salesforce que estão disponíveis para serem mapeados.
  - Pesquisar: Digite qualquer parte do nome da coluna na caixa de pesquisa para filtrar a lista de cabeçalhos. A busca não diferencia maiúsculas de minúsculas.
  - Automap: Clique no link Automap para mapear os nomes dos campos de origem e destino que correspondem exatamente (independentemente do caso) e têm tipos de dados idênticos. Os campos que são mapeados automaticamente são adicionados a quaisquer mapeamentos existentes, que são deixados no lugar.
  - Reiniciar: Clique no link Reiniciar para limpar todos os mapeamentos.
- Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.
- Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.
- Descartar alterações: Após fazer as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Próximos Passos¶

Depois de configurar uma atividade de atualização em massa do Salesforce, conclua a configuração da operação adicionando e configurando outras atividades ou scripts como etapas da operação. Você também pode definir as configurações de operação de uma operação, que incluem a capacidade de encadear operações que estão no mesmo ou em workflows diferentes.

Após a criação de uma atividade do Salesforce Bulk Upsert, as ações de menu dessa atividade podem ser acessadas no painel do projeto nas guias Workflows ou Componentes e na quadro de design. Consulte Menu de Ações de Atividade para detalhes.

As atividades do Salesforce Bulk Upsert podem ser usadas como destino com este padrão de operação:

Padrão de destino em massa do Salesforce

Uma atividade do Salesforce pode ser usada como uma etapa de operação em apenas uma única operação. Ou seja, você não pode referenciar a mesma atividade várias vezes em outras operações. Em vez disso, você pode fazer uma cópia de uma atividade do Salesforce para usar em outro lugar (consulte Reutilização de componente).

Outros padrões não são válidos usando as atividades do Salesforce Bulk Upsert. Veja os padrões de validação na Validade da Operação página.

Um caso de uso típico é usar uma atividade de inserção em massa do Salesforce no Padrão de destino em massa do Salesforce. Neste exemplo, a atividade de leitura de FTP (Read Bulk Upsert Request) fornece dados para a operação. A atividade Bulk Upsert do Salesforce (Bulk Upsert) é usada como destino, recebendo dados dentro da operação. Uma mensagem é então registrada pelo script Write to Operation Log:

operação de atividade de atualização em massa do salesforce 1

Além disso, a fonte baseada em arquivo usada na operação deve usar um formato de arquivo simples com um cabeçalho e apenas estes tipos de dados:

Base64
Boleano
Formatos de data
Dobro
inteiro
Identificação do Salesforce
Corda

As operações que usam atividades do Salesforce também podem ter ações de operação configuradas para serem acionadas em uma falha de SOAP — um erro resultante de um formato de mensagem incorreto, processamento de cabeçalho ou incompatibilidade. As ações de operação podem ser configuradas para executar uma operação ou enviar um e-mail após a ocorrência de uma falha de SOAP. Para obter instruções sobre como acionar uma ação em caso de falha de SOAP, consulte Ações de operação.

Para usar a atividade com funções de script, grave os dados em um local temporário e use esse local temporário na função de script.

Quando estiver pronto, implantar e execute a operação e valide o comportamento verificando os logs da operação.