Assistente de processo em massa do Salesforce para ação de upsert no Jitterbit Design Studio

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 Jitterbit Design Studio. A ação de Upsert de Processo em Massa do Salesforce permite que você insira múltiplos registros ou (no caso de um registro já existir) atualize um registro existente, através de uma instância conectada do Salesforce. Uma ação de Upsert atualiza ou insere registros, dependendo dos dados fornecidos.

O processo para a ação de Upsert de Processo em Massa é ligeiramente diferente do processo para ações de Consulta, inserção, atualização, exclusão ou exclusão permanente. A ação de Upsert de Processo em Massa exige que você selecione um campo de ID externo para o objeto Salesforce selecionado. Ações de Consulta, Inserção, Atualização, Exclusão e Exclusão Permanente de Processo em Massa não exigem um campo de ID externo e não incluem esta etapa.

Antes de seguir por estas etapas, consulte o assistente de processo em massa do Salesforce para instruções sobre como iniciar o Assistente de Processo em Massa do Salesforce.

Selecionar o objeto Salesforce

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

Para selecionar um Campo de ID Externo, clique no botão Selecionar Campo. Neste exemplo, o objeto Conta e, em seguida, o campo Id foram selecionados:

Clique em OK, depois clique em Próximo para mover para Definir a fonte.

Definir a fonte

Selecione de onde seus dados de origem vêm

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

Como a fonte precisará ser um arquivo plano para o Assistente de Processamento em Lote do Salesforce, você pode opcionalmente adicionar validação de linha e campo. Se preferir, você pode adicionar uma fonte mais tarde no desenvolvimento do projeto. Para detalhes sobre as diferentes fontes, veja Fontes.

Selecione uma das seguintes opções:

• Um Tipo de fonte existente no menu suspenso (um dos Arquivo Local, Site FTP, Compartilhamento de Arquivo, Armazenamento Temporário ou HTTP).
• Selecione Criar Novo para criar uma nova fonte do tipo atualmente selecionado.

Criar uma nova fonte

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

Fontes de Arquivo

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 fonte, clique em Procurar para selecionar um arquivo. Alternativamente, se você quiser usar um arquivo local que já foi utilizado com o Jitterbit Design Studio, clique em Selecionar uma Fonte de Arquivo Local Existente e use o menu suspenso para selecionar um arquivo previamente utilizado.

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

Clique em Continuar para ir para a tela de Mapeamentos.

Site FTP, Compartilhamento de Arquivos ou Armazenamento Temporário

Se você quiser 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 os Parâmetros de Conexão.

Selecionar arquivo de amostra

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

Clique em Próximo para ir para a tela de Mapeamentos.

Mapeamento de transformação

Mapeie os cabeçalhos do arquivo de origem para os campos correspondentes do Salesforce. Além dos cabeçalhos, o Processo em Lote não envolve outros mapeamentos.

Você pode mapear:

• Arrastando e soltando um Cabeçalho de Arquivo de Origem em um Campo do Salesforce.

• Selecionando os campos Origem e Salesforce juntos e, em seguida, clicando no botão Mapear.

• O botão Mapeamento Automático mapeia com base em nomes correspondentes entre os Cabeçalhos de Arquivo de Origem e os Campos do Salesforce.

• O botão Importar Mapeamentos de Arquivo importa um conjunto de mapeamentos previamente salvo de um arquivo.

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

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

• O botão Remover remove um mapeamento selecionado.

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

• Quando terminar, clique em Próximo para mover para Criar um cronograma e definir opções.

Criar um cronograma e selecionar opções

Criar ou definir um cronograma é opcional e pode ser feito em um momento posterior. Para mais detalhes sobre agendamento, consulte Cronogramas. Você pode editar um cronograma existente abrindo-o na categoria Cronogramas 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 agendada ou abrir a operação no painel de itens do projeto e fazer os ajustes apropriados.

• Defina a Ocorrência, a Frequência Diária (horas ou minutos) e a Duração da operação.
• Ao definir a Duração, esteja ciente de que as datas Iniciando em e Terminando em em um cronograma são inclusivas.
• Para exibir essas opções, abra os caret ao lado de Ocorrência, Frequência Diária e Duração.
• Quando terminar, clique em Próximo para mover para Tela de Resumo.

Tela de Resumo

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

Clique em Concluir para finalizar o assistente.

Processo em massa do Salesforce concluído

Uma vez concluído, você será levado à tela de Resumo para o novo Processo em Massa do Salesforce. Você pode retornar a esta página de resumo encontrando o nome da operação sob 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 agendado, clicando em Editar ao lado.
• As funções dos botões Executar Bulk Upsert, 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 variarão dependendo do assistente de Processo em Massa específico utilizado. Este exemplo mostra o assistente de Inserção em Massa).
• Opções Avançadas incluem opções de operação, como divisão e truncamento de campo. Elas são abordadas abaixo em Opções avançadas.

Opções avançadas

Essas opções avançadas estão disponíveis para uma ação de Bulk Upsert 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 escrever 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 origem. Veja a página Avançado do Salesforce.
• Começar na Linha de Dados: Fornece o número da linha da primeira linha do arquivo de origem a ser considerada como dados.

Opções de operação

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

Opções adicionais de operação para gravar registros de sucesso e falha são descritas na página Salesforce avançado.

Implantar o projeto e executar a operação

Depois de configurar a ação de Processamento em Lote, você pode implantar e executar a operação. Você também pode visualizar arquivos de sucesso e falha se estiver usando agentes privados.

Implantar o projeto

Implantar um projeto antes de executar não é necessário, pois ele será implantado automaticamente, se necessário.

Para implantar o projeto, faça uma das seguintes ações:

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

• No painel de itens do projeto, clique com o botão direito no Nome do projeto recém-criado e, em seguida, 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 implantação 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 implantação, clique em Cancelar, o que o retornará à tela anterior.

A operação agora está completa e implantada.

Executar a operação

Clique no botão Executar Bulk Upsert para colocar a operação na fila para execução.

Se o projeto ainda não foi implantado ou foi alterado desde a última implantação, 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ções é exibido na parte inferior da tela, rastreando o status, o horário de recebimento, o horário de início e o horário em que a operação concluiu o processamento.

• Quando a operação conclui o processamento, a caixa de diálogo Resultado exibirá o horário de conclusão, o status, o número de registros que foram processados com sucesso e o número de registros que falharam ao processar. Os botões Ver Arquivo de Sucesso e Ver Arquivo de Falha são descritos abaixo.

Clique no botão Histórico de Resultados para exibir uma lista de atividades recentes, incluindo o horário de conclusão, status, o número de registros processados com sucesso e o número de registros que falharam ao processar. Selecione um resultado na lista para habilitar os botões Ver Arquivo de Sucesso e Ver Arquivo de Falha, que são descritos abaixo.

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

• A janela de diálogo Confirmar Exclusão será exibida. Clique em Excluir para confirmar e deletar a operação.
• A janela de diálogo Excluir Itens do Assistente exibirá os componentes da operação associada.
  • 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 dentro do projeto. Apenas a operação de inserção será 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 Visualizar Arquivo de Sucesso e Visualizar Arquivo de Falha estão disponíveis após clicar no botão Executar ou no botão Histórico de Resultados, conforme descrito acima, e em seguida selecionar um dos resultados. Este é um exemplo da caixa de diálogo Histórico de Resultados, mostrando os botões e um resultado selecionado:

• Visualizar 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 que foram processados com sucesso.
• Visualizar Arquivo de Falha: Se você estiver executando a operação em um agente privado, selecionar o botão Visualizar Arquivo de Falha exibe os primeiros 100 registros que falharam ao processar.

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 atualmente não está disponível.