Assistente de Processo em Massa do Salesforce para Ação Upsert¶

Introdução¶

Esta página descreve como criar uma ação de Upsert de processo em massa do Salesforce usando o Assistente de processo em massa do Salesforce no Harmony Design Studio. A ação Upsert do processo em massa do Salesforce permite inserir vários registros ou (no caso de um registro já existente) atualizar um registro existente, por meio de uma instância conectada do Salesforce. Uma ação Upsert atualiza ou insere registros, dependendo dos dados fornecidos.

O processo para a ação Upsert Bulk Process é um pouco diferente do processo para Consulta, Inserção, Atualização, Exclusão ou Exclusão definitiva Ações de processo em massa. A ação Upsert Bulk Process requer que você selecione um campo de ID externo para o objeto Salesforce selecionado. As ações de consulta, inserção, atualização, exclusão e processo em massa de exclusão irreversível não exigem um campo de ID externo e não incluem esta etapa.

Antes de seguir essas etapas, consulte Assistente de processo em massa do Salesforce para obter instruções sobre como iniciar o Assistente de processo em massa do Salesforce.

Selecione o Objeto Salesforce¶

Na tela Objeto, selecione o objeto Salesforce e o Campo ID Externo que a operação utilizará.

Para selecionar um campo de ID externo, clique no botão Selecionar Campo. Neste exemplo, o objeto Account e depois o campo Id foram selecionados:

Clique em OK e, em seguida, clique em Avançar para ir para Definir a fonte.

Defina a Fonte¶

Selecione de Onde Vêm Seus Dados de Origem¶

A origem é o local dos dados a serem usados pela operação. Para o Assistente de processo em massa do Salesforce, a origem precisa ser um arquivo simples com um cabeçalho. Bancos de dados não são suportados. Para a Fonte do arquivo selecione Arquivo Local, Site FTP, Compartilhamento de Arquivo ou Armazenamento Temporário.

Como a origem precisará ser um arquivo simples para o Assistente de processo em massa do Salesforce, você pode adicionar opcionalmente validação de linha e campo. Se preferir, você pode adicionar uma fonte posteriormente no desenvolvimento do projeto. Para obter detalhes sobre as diferentes fontes, consulte Fontes.

Selecione um dos seguintes:

• Uma fonte existente Tipo no menu suspenso (Arquivo local, Site FTP, Compartilhamento de arquivo, Armazenamento temporário ou HTTP).
• Selecione Criar novo para criar uma nova fonte do tipo atualmente selecionado.

Crie uma Nova Fonte¶

Para criar uma nova fonte, selecione a opção Nova Fonte no menu suspenso:

Fontes de Arquivos¶

Para fontes de arquivo (arquivo local, site FTP, compartilhamento de arquivo ou armazenamento temporário), selecione ou crie uma fonte e, em seguida, selecione ou crie um formato de arquivo para usar com essa fonte.

Arquivo Local¶

Se você selecionar um Arquivo Local como origem, clique em Procurar para selecionar um arquivo. Como alternativa, se desejar usar um arquivo local que tenha sido usado anteriormente com o Harmony Design Studio, clique em Selecionar uma fonte de arquivo local existente e use o menu suspenso para selecionar um arquivo usado anteriormente.

Confirme o arquivo selecionado após revisar as primeiras dez linhas do arquivo:

Clique em Continuar para ir para Mapeamentos tela.

Site FTP, Compartilhamento de Arquivos Ou Armazenamento Temporário¶

Se desejar usar um site FTP existente como fonte, use o menu suspenso Tipo para selecionar seu site FTP. Caso contrário, selecione Criar novo no menu suspenso e preencha Parâmetros de conexão.

Selecione Arquivo de Amostra¶

Navegue em seu computador e selecione um arquivo de amostra que contenha o mesmo formato do arquivo que você deseja enviar ao Salesforce. O Design Studio usará essas informações nos Mapeamentos tela.

Clique em Avançar para ir para Mapeamentos tela.

Mapeamento de Transformação¶

Mapeie cabeçalhos do arquivo de origem para os campos correspondentes do Salesforce. Além dos cabeçalhos, o Bulk Process não envolve nenhum outro mapeamento.

Você pode mapear:

• Arrastando e soltando um Cabeçalho do arquivo de origem em um Campo do Salesforce.

• Selecionando os campos Origem e Salesforce juntos e clicando no botão Mapa.

• O botão Mapeamento automático é mapeado com base em nomes correspondentes entre os Cabeçalhos do arquivo de origem e os Campos do Salesforce.

• O botão Importar mapeamentos do arquivo importa um conjunto de mapeamentos salvo anteriormente de um arquivo.

• O botão Salvar mapeamentos em arquivo salva todos os mapeamentos em um arquivo local.

• O botão Mapa mapeia entre os campos de origem e de destino selecionados.

• O botão Remover remove um mapeamento selecionado.

• O botão Recomeçar exclui todos os mapeamentos e reinicia.

• Quando terminar, clique em Avançar para ir para Criar uma programação e definir opções.

Crie uma Programação e Selecione Opções¶

Criar ou definir uma programação é opcional e pode ser feito posteriormente. Para mais detalhes sobre agendamento, consulte Horários. Você pode editar um cronograma existente abrindo-o na categoria Programações do painel de itens do projeto e fazendo os ajustes desejados. Você pode usar esta tela do assistente para adicionar um cronograma a uma operação não programada ou abrir a operação no painel de itens do projeto e fazer os ajustes apropriados.

• Defina a Ocorrência, Frequência Diária (horas ou minutos) e Duração da operação.
• Ao definir Duração, esteja ciente de que as datas Começando em e Terminando em em uma programação são inclusivas.
• Para exibir essas opções, abra os triângulos de divulgação ao lado de Ocorrência, Frequência Diária e Duração.
• Quando terminar, clique em Avançar para ir para a Tela de Resumo.

Tela de Resumo¶

Na tela Resumo, você pode editar o nome dado ao assistente:

Clique em Concluir para concluir o assistente.

Processo em Massa do Salesforce Concluído¶

Depois de concluído, você será direcionado para a tela Resumo do novo processo em massa do Salesforce. Você pode retornar a esta página de resumo encontrando o nome da operação em Jitterbit Connect no painel de itens do projeto.

• Você pode modificar qualquer um dos itens de design em seu projeto, como Login do Salesforce, Mapeamentos, Ler dados de, Operação e Executar conforme cronograma por clicando no adjacente Editar.
• As funções dos botões Executar upload em massa, Histórico de resultados e Excluir são descritas abaixo em Implantar o projeto e executar a operação (Os rótulos reais e os botões disponíveis variam dependendo do assistente de Processo em Massa específico usado. Este exemplo mostra o assistente de Inserção em Massa).
• Opções avançadas incluem opções de operação como fragmentação de dados e truncamento de campo. Eles são abordados abaixo em Opções avançadas.

Opções Avançadas¶

Estas opções avançadas estão disponíveis para uma ação de upload em massa do Salesforce:

Opções de Arquivo¶

• Ler como UTF-8: Selecione para ler o arquivo de origem como codificação de caracteres UTF-8.
• Escrever como UTF-8: Selecione para gravar o arquivo de destino como codificação de caracteres UTF-8.
• Opções de data: Exibe uma caixa de diálogo para definir as opções de data para a fonte. Consulte o Salesforce avançado página.
• Iniciar na linha de dados: Fornece o número da primeira linha do arquivo de origem a ser considerado como dados.

Opções de Operação¶

• Configurações em lote: Exibe uma caixa de diálogo para definir as configurações em massa. Consulte o Salesforce avançado página.
• Modo Serial: Se selecionado, permite a inserção de valores nulos em um registro.
• Compactar dados: Por padrão, a compactação está ativada.
• Chunking não está disponível para operações de Processo em Massa. Consulte Configurações em lote na página Salesforce Advanced página em vez disso.

Opções de operação adicionais para gravar registros de sucesso e falha estão descritas no Salesforce Advanced página.

Implantar o Projeto e Executar a Operação¶

Depois de configurar a ação Processo em massa, você poderá implantar e executar a operação. Você também pode visualizar arquivos de sucesso e falha se estiver usando Agentes Privados.

Implantar o Projeto¶

Não é necessário implantar um projeto antes de executá-lo, pois ele será implantado automaticamente, se necessário.

Para implantar o projeto, siga um destes procedimentos:

• Clique no botão Implantar na barra de ferramentas.

• No painel de itens do projeto, clique com o botão direito em Nome do projeto recém-criado e clique em Implantar no menu suspenso resultante.

• Clique em Operações na parte superior do painel de itens do projeto e, em seguida, clique em Implantar no menu suspenso resultante.

O processo de implantar do projeto começará a enviar o projeto para o Harmony e uma mensagem de progresso aparecerá.

• Para executar a mensagem de progresso em segundo plano, clique em Executar em segundo plano.

• Para cancelar o processo de implantar, clique em Cancelar, que retornará à tela anterior.

A operação agora está concluída e implantada.

Execute a Operação¶

Clique no botão Executar upload em massa para colocar a operação na fila para execução.

Se o projeto ainda não tiver sido implantado ou tiver sido alterado desde a última implantar, ele será implantado automaticamente. Consulte Criar uma operação para obter informações adicionais sobre como criar, implantar e executar operações.

• O Monitor de Operação é exibido na parte inferior da tela, rastreando o status, a hora recebida, a hora iniciada e a hora em que a operação concluiu o processamento.

• Quando o processamento da operação for concluído, a caixa de diálogo Resultado exibirá o horário de conclusão, o status, o número de registros processados com êxito e o número de registros cujo processamento falhou. Os botões Visualizar arquivo de sucesso e Visualizar arquivo de falha são descritos abaixo.

Clique no botão Histórico de resultados para exibir uma lista de atividades recentes, incluindo o tempo de conclusão, o status, o número de registros processados com êxito e o número de registros que não foram processados. Selecione um resultado na lista para ativar os botões Visualizar arquivo de sucesso e Visualizar arquivo de falha, que são descritos abaixo.

Clique no botão Excluir para excluir a operação do projeto.

• A janela de diálogo Confirmar exclusão será exibida. Clique em Excluir para confirmar e excluir a operação.
• A caixa de diálogo Excluir itens do assistente exibirá os componentes da operação associados.
  • Selecione Sim para excluir os objetos do assistente associados, além da operação de inserção.
  • Se você selecionar Não, os objetos do assistente permanecerão disponíveis no projeto. Somente a operação de inserção é excluída.
  • Selecionar Cancelar cancela a exclusão da operação de inserção e dos objetos do assistente associados.

Consulte Criar uma operação para obter informações adicionais sobre como criar, implantar e executar operações.

Visualizar Arquivos de Sucesso e Falha¶

A visualização de arquivos de sucesso e falha está disponível se você estiver executando operações em um Agente Privado. Os botões Exibir arquivo de sucesso e Exibir arquivo de falha estão disponíveis depois que você clica no botão Executar ou no botão Histórico de resultados conforme descrito acima e, em seguida, seleciona um dos resultados. Este é um exemplo da caixa de diálogo Histórico de resultados, mostrando os botões e um resultado selecionado:

• Ver arquivo de sucesso: Se você estiver executando a operação em um Agente Privado, selecionar o botão Visualizar arquivo de sucesso exibe os primeiros 100 registros processados com êxito.
• Ver arquivo de falha: Se você estiver executando a operação em um Agente Privado, selecionar o botão Exibir arquivo de falha exibe os primeiros 100 registros que não foram processados.

Neste exemplo, três registros são mostrados:

• Copiar arquivo para: Salva os registros de sucesso ou falha em um arquivo CSV com o nome de arquivo padrão salesforce.csv.
• Abrir Programa Externo: Esta opção não está disponível no momento.