Assistente de processo em massa do Salesforce para ações de consulta, inserção, atualização, exclusão ou exclusão permanente no Jitterbit Design Studio

Introdução

Esta página descreve como criar uma ação de Consulta, Inserção, Atualização, Exclusão ou Exclusão Permanente em Massa do Salesforce usando o Assistente de Processo em Massa do Salesforce no Jitterbit Design Studio.

• Uma ação de Consulta em Massa do Salesforce consulta um grande número de registros de um endpoint do Salesforce.
• Uma ação de Inserção em Massa do Salesforce insere novos dados em um endpoint do Salesforce.
• Uma ação de Atualização em Massa do Salesforce atualiza dados existentes em um endpoint do Salesforce.
• Uma ação de Exclusão em Massa ou Exclusão Permanente em Massa do Salesforce exclui um grande número de registros existentes em um endpoint do Salesforce.

As ações de Consulta, Inserção, Atualização, Exclusão ou Exclusão Permanente em Massa são ligeiramente diferentes do processo para a ação de upsert em massa. Ao contrário da ação de Upsert em Massa, as ações de Consulta, Inserção, Atualização, Exclusão e Exclusão Permanente em Massa não exigem um campo de ID externo e não incluem esta etapa.

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

Selecione o objeto do Salesforce

Na tela de Objetos, selecione o objeto do Salesforce que a operação usará.

Clique em Próximo para avançar 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 Massa 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 sua fonte precisará ser um arquivo plano para o Assistente de Processamento em Massa 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, consulte a documentação sobre Fontes.

Selecione uma das 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 Arquivo 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 Massa não envolve outros mapeamentos.

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, em seguida, clicando no botão Mapear.

• O botão Mapeamento Automático mapeia com base em nomes correspondentes entre os Cabeçalhos do 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 começa de novo.

• Quando terminar, clique em Próximo para ir 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, Frequência Diária (horas ou minutos) e Duração da operação.
• Ao definir a Duração, esteja ciente de que as datas de Início e Fim 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 ir para a 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 em Agenda, clicando em Editar ao lado.
• As funções dos botões Executar 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 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 campos. Elas são abordadas abaixo em Opções Avançadas.

Opções Avançadas

As seguintes opções avançadas estão disponíveis para um Processo em Massa do Salesforce.

Para uma ação de Consulta:

Para uma ação de Inserir ou Atualizar:

Para uma ação de Excluir ou Excluir Permanentemente (as opções de data estão desativadas):

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 Salesforce avançado.
• 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. Veja 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 compressão está ativada.
• O particionamento não está disponível para operações de Processo em Massa. Veja 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

Uma vez que você tenha configurado a ação de Processo em Massa, 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 executá-lo 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 ícone Implantar na barra de ferramentas.

• No painel de itens do projeto, clique 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, que o retornará à tela anterior.

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

Executar a operação

Esta imagem mostra os botões disponíveis nas páginas de resumo do Assistente de Processamento em Massa do Salesforce. Os rótulos (como Executar Consulta em Massa ou Executar Inserção em Massa) variarão dependendo do assistente específico que você está usando.

Clique em Executar em Massa... 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 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 concluir 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 Visualizar Arquivo de Sucesso e Visualizar 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 é exibida. Clique em Excluir para confirmar e deletar a operação.
• A janela de diálogo Itens do Assistente de Exclusão 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.

Veja Criar uma operação para 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 janela 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 em uma janela pop-up.
• 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 em uma janela pop-up.

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.