Assistente de Processo em Massa do Salesforce para Ações de Consulta, Inserção, Atualização, Exclusão Ou Exclusão Irreversível¶

Introdução¶

Esta página descreve como criar uma ação de consulta, inserção, atualização, exclusão ou exclusão definitiva de processo em massa do Salesforce usando o assistente de processo em massa do Salesforce no Harmony 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 os dados existentes em um endpoint do Salesforce.
• Uma ação de exclusão em massa ou exclusão forçada 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 do processo em massa são ligeiramente diferentes do processo para a ação de inserção de processo em massa. Ao contrário da ação Upsert do processo em massa, as ações Consultar, Inserir, Atualizar, Excluir 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 as etapas a seguir, 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 que a operação utilizará.

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 sua fonte 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 a documentação em Fontes.

Selecione um de:

• 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 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¶

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 Inserir ou Atualizar:

Para uma ação 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 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 í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 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¶

Esta imagem mostra os botões disponíveis nas páginas de resumo do Assistente de processo em massa do Salesforce. Os rótulos (como Executar consulta em massa ou Executar inserção em massa) variam 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 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 é 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 em uma janela pop-up.
• 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 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 não está disponível no momento.