Atividade de Upsert do Salesforce

Introdução

Uma atividade Upsert do Salesforce atualiza dados existentes e insere novos dados em um endpoint do Salesforce e tem a intenção de ser usada como um alvo para consumir dados em uma operação. Após configurar uma conexão do Salesforce, você pode configurar quantas atividades do Salesforce quiser para cada conexão do Salesforce.

A atividade 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 Criando um ID externo do Salesforce para Jitterbit. Se, em vez disso, você quiser inserir apenas novos registros ou se quiser atualizar registros existentes com base na ID do objeto no Salesforce, use uma atividade Inserir ou Atualizar do Salesforce.

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 componentes.

Uma atividade existente pode ser editada a partir destes locais:

• A quadro de design (veja menu de ações do componente em Tela de design).
• A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).

Configurar uma atividade Salesforce Upsert

Siga estas etapas para configurar uma atividade Upsert do Salesforce:

• Etapa 1: Insira um nome, selecione um objeto e especifique as configurações Forneça um nome para a atividade e selecione o objeto a ser usado ao inserir dados.
• Etapa 2: Selecione o ID externo Selecione um campo existente do Salesforce que você deseja que o Harmony use como ID externo para associar registros.
• Etapa 3: Revise os esquemas de dados Todos os esquemas de solicitação ou resposta gerados a partir do endpoint são exibidos.

Etapa 1: insira um nome, selecione um objeto e especifique as configurações

Nesta etapa, você fornece um nome para a atividade e seleciona o objeto a ser usado ao inserir dados.

• Nome: Insira um nome para usar para identificar a atividade Upsert do Salesforce. O nome deve ser exclusivo para cada atividade Upsert do Salesforce e não deve conter barras (/) ou dois pontos (:).

• Selecione a Referência de Objeto: Use o menu suspenso para selecionar um objeto padrão ou personalizado do Salesforce para inserir dados. Insira o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de objetos. A pesquisa não diferencia maiúsculas de minúsculas.

  Nota

  Se a lista não for preenchida com objetos disponíveis, observe as seguintes dicas de solução de problemas:

  • A conexão Salesforce pode não ser bem-sucedido. Certifique-se de que você está conectado reabrindo a conexão e testando novamente as credenciais.

  • Uma senha do Salesforce que usa caracteres ASCII estendidos, como £, pode causar o seguinte erro ao buscar dados durante a configuração da atividade:

    Invalid username, password, security token; or user locked out. [INVALID_LOGIN]
    

    Neste caso, o teste de conexão ainda pode ser bem-sucedido. Se você receber este erro durante a configuração da atividade e estiver usando caracteres especiais na senha, tente alterar a senha.

• Atualizar: Clique no ícone de atualização para recarregar objetos e campos do endpoint do Salesforce. Isso pode ser útil se você adicionou objetos ou campos recentemente ao Salesforce.

• Configurações opcionais: Clique para expandir configurações opcionais adicionais:

  

  • Opções de operação: Essas opções se aplicam a uma operação na qual uma atividade Upsert do Salesforce é usada.

    Dica

    Opções adicionais podem ser definidas em opções de operação de uma operação.

    • Inserir valores nulos: Marque a caixa de seleção para permitir que valores nulos sejam inseridos. Se esta opção não estiver selecionada, se um valor que está sendo mapeado tiver um valor nulo ou estiver em branco (com uma sequência vazia), ele não será processado.

• Salvar e sair: Se habilitado, clique para salvar a configuração desta etapa e fechar a configuração da atividade.

• Próximo: Clique para armazenar temporariamente a configuração desta etapa e continuar para a 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 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: Selecione o ID externo

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

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

  Aviso

  O campo usado como ID externo deve ter um valor exclusivo 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 o upsert falhará para os registros com IDs duplicados.

• Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

• Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a 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 alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 3: Revise os esquemas de dados

Nesta etapa, quaisquer esquemas de solicitação ou resposta gerados a partir do endpoint são exibidos:

• Esquema de dados: Os esquemas de dados de solicitação e resposta são exibidos. Se a operação usar uma transformação, os esquemas de dados serão exibidos novamente mais tarde durante o mapeamento de transformação, onde você pode mapear campos de destino usando objetos de origem, scripts, variáveis, valores personalizados e muito mais.

  A versão da API REST do Salesforce que é usada depende da versão do agente Jitterbit que você está usando. Consulte Pré-requisitos e versões de API suportadas para links para documentação sobre os campos de esquema.

  Nota

  Para atualizar um esquema de dados em uma atividade existente, você deve avançar por cada etapa de configuração da atividade novamente, fazendo pelo menos uma alteração (como adicionar e remover um caractere do final do nome da atividade) para forçar uma atualização do esquema.

• 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 alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Próximos passos

Após configurar uma atividade Upsert do Salesforce, você pode usá-la dentro de uma operação conforme descrito abaixo. Após executar uma operação contendo uma atividade do Salesforce em um agente privado, você pode baixar os arquivos de sucesso e falha da operação.

Concluir a operação

Após configurar uma atividade Upsert do Salesforce, conclua a configuração da operação adicionando e configurando outras atividades, transformações ou scripts como etapas da operação. Você também pode configurar as configurações de operação de uma operação, que incluem a capacidade de encadear operações que estejam no mesmo fluxo de trabalho ou em workflows diferentes.

Depois que uma atividade Upsert do Salesforce for criada, as ações de menu para essa atividade serão acessíveis no painel do projeto nas guias Workflows ou Componentes e na quadro de design. Consulte menu de ações de atividade para mais detalhes.

As atividades Upsert do Salesforce podem ser usadas como um alvo com estes padrões de operação:

• Padrão de Transformação
• Padrão de arquivo de dois alvos (apenas como o primeiro alvo)
• Padrão de duas transformações (como o primeiro ou segundo alvo)

As operações que contêm uma atividade do Salesforce podem ter apenas uma atividade do Salesforce e não podem conter nenhuma outra atividade, exceto aquelas associadas à API, Banco de dados, Compartilhamento de arquivo, FTP, HTTP, Armazenamento local, Armazenamento Temporário, ou Variável conectores.

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 dentro de 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 componentes).

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

Em uma transformação, se estiver usando a opção de espelhar um esquema fornecido por uma atividade não em massa do Salesforce, o esquema espelhado resultante será criado automaticamente com um nó raiz adicional chamado records com o(s) nó(s) filho(s) espelhando o esquema. Quando campos dentro do(s) nó(s) filho(s) são mapeados, o nó se torna um nó de loop para permitir que todos os registros sejam passados em loop (veja Nós de loop em Estruturas de dados).

As operações que usam atividades do Salesforce também podem ter ações de operação configuradas para disparar 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 email após a ocorrência de uma falha de SOAP. Para obter instruções sobre como disparar uma ação em uma 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 de operação.

Exibir arquivos de sucesso e falha

Se você estiver executando uma operação contendo uma atividade do Salesforce em um agente privado, os arquivos de sucesso e falha estão disponíveis para download na página Operações de tempo de execução do Management Console. Selecione a operação relevante na tabela Operações de tempo de execução e clique na aba Registros de atividades na seção inferior da tela para exibir links de download para os arquivos, se disponíveis:

• Baixar arquivo de sucesso: Se você estiver executando a operação em um agente privado, clique no link Download para salvar os registros de sucesso como um arquivo CSV.

• Arquivo com falha no download: Se você estiver executando a operação em um agente privado, clique no link Download para salvar os registros de falhas como um arquivo CSV.