Assistente de Atualização do Salesforce¶

Crie uma Operação de Upsert do Salesforce¶

Esta página descreve como criar uma operação de Upsert do Salesforce usando o Assistente de Upsert do Jitterbit Connect Salesforce.

A atividade Salesforce Upsert permite atualizar registros existentes ou inserir novos registros em uma instância conectada do Salesforce usando Jitterbit. Um "upsert" é essencialmente uma operação de atualização ou inserção, ou ambas, dependendo dos dados fornecidos.

O assistente conduz você por uma série de telas, reunindo as informações necessárias para criar a operação no projeto atual.

Inicie o Assistente¶

• Clique no ícone na parte superior da tela para exibir a janela de diálogo Jitterbit Connect:

  

• Para iniciar o assistente, clique no botão Salesforce Upsert no menu Jitterbit Connect Wizard, que abre o assistente.

Login do Salesforce¶

• Se você já criou uma Organização Salesforce login, os detalhes da conexão aparecerão no assistente de consulta. Você pode clicar no botão Testar login do Salesforce para verificar a conexão.

  

• Se você ainda não criou um login do Salesforce ou precisa usar credenciais diferentes, selecione Criar novo… no menu suspenso abaixo de Selecionar ou criar uma organização do Salesforce.

• Observe que todas as alterações feitas nesta página do assistente serão salvas automaticamente na organização do Salesforce mostrada na página. Consulte a Organização Salesforce para obter detalhes.

• Na tela de login do Salesforce, clique em Avançar para passar para a próxima tela. (Se necessário, você pode clicar no botão Voltar para retornar à tela anterior em qualquer uma dessas telas.)

Selecione o Objeto Salesforce¶

• Na tela Objeto você especifica o Objeto Salesforce e o Campo ID Externo que a operação utilizará.

• Simplifique sua visualização digitando as primeiras letras do nome de um objeto na caixa de entrada de texto Filtro ou clique no menu suspenso Objetos para mostrar e selecione entre Objetos Comuns Padrão, Todos os objetos personalizados ou Todos os objetos.

• Selecione o Objeto Salesforce desejado:

  

Selecione um Campo de ID Externo¶

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

• Clique em Avançar para ir para a tela 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.

• Se uma Fonte do arquivo (Arquivo local, site FTP, compartilhamento de arquivos ou armazenamento temporário):
  • Qual é o tipo de arquivo: texto, XML ou JSON?
  • Qual a estrutura do formato do arquivo: CSV ou delimitado?
  • Qual é o esquema de formato de campo?
  • É necessária a validação do conteúdo do arquivo de origem? (Se sua fonte for um arquivo de texto simples, você poderá adicionar opcionalmente validação de linha e campo.)
• Se uma Fonte do banco de dados, quais são as informações de conexão e SQL para recuperar os dados?
• Se uma Fonte LDAP, quais são as classes de objetos, atributos e parâmetros de pesquisa para recuperar os dados?

As telas apresentadas variam dependendo das suas respostas a essas perguntas.

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:

• Um Tipo de Origem existente no menu suspenso (Arquivo Local, Site FTP, Compartilhamento de Arquivo, Armazenamento Temporário, Banco de Dados, HTTP, LDAP ou Nenhum); ou
• Clique no botão Selecionar ou Criar Novo para criar uma nova Fonte do tipo atualmente selecionado; ou
• Escolha Nenhum se pretende fornecer valores explícitos para os dados que não vêm de outras fontes.

Crie uma Nova Fonte¶

Para criar uma nova fonte, selecione a opção Criar Novo… no menu suspenso. Os campos Nova Fonte são exibidos. Por exemplo, ao criar uma nova fonte de Arquivo Local, você verá campos semelhantes a estes:

Fontes de Arquivos¶

Para fontes de arquivo (Arquivo Local, Site FTP, Compartilhamento de Arquivos ou Armazenamento Temporário), você precisa especificar ou criar uma fonte e, em seguida, especificar ou criar um formato de arquivo para usar com essa fonte. Se o sufixo do arquivo não puder ser usado para determinar o tipo de arquivo, você será solicitado a confirmar o arquivo e o tipo de arquivo.

Arquivo Local¶

• Especificando um Arquivo Local como origem:

  

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

  

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

• Especificando um site FTP existente como fonte:

  

• Clique no botão Avançar para ir para a tela Confirmar tipo de arquivo.

Confirme o Tipo de Arquivo¶

• Se o tipo de arquivo não puder ser confirmado com base no sufixo do nome do arquivo, você será solicitado a confirmar o tipo. Ajuste conforme necessário:

  

• Se o nome do arquivo puder ser confirmado com base no sufixo do nome do arquivo, você será solicitado a selecionar as opções para criar um formato de arquivo:

  

• Se você selecionar Revisar formato de arquivo, o botão Avançar irá para a tela Selecionar formato de arquivo. Caso contrário, clique no botão Avançar para ir para Criar uma programação e definir opções.

Selecione o Formato do Arquivo¶

• Você pode selecionar um formato de arquivo existente ou criar um novo.

• Para selecionar um formato de arquivo existente, selecione o nome no menu suspenso:

• Para criar um novo formato de arquivo, selecione Criar novo no menu suspenso, que expande a tela para exibir os campos Formato de arquivo. O exemplo abaixo mostra a criação de um novo Formato de Arquivo para uma definição simples de Documento de Texto:

  

• Preencha o campo e controles:

  • Nome: Digite o nome do novo formato de arquivo

  • Para Criar Manualmente:

    • Selecione o tipo de documento: Especifique o tipo de documento como Simples ou Complexo
    • Selecione o formato do documento: Especifique como Delimitado por caracteres ou Larguras de campo fixas

• Criar manualmente: Para obter detalhes sobre como criar o formato de arquivo manualmente, consulte estas instruções em Definindo formatos de arquivo

  • Para criar Do arquivo de amostra:

    • Clique em Criar do arquivo para abrir uma caixa de diálogo para especificar a estrutura do arquivo usando um arquivo como modelo

• Neste exemplo, Create From File foi clicado e um arquivo CSV foi especificado para usar como modelo:

• Preencha os campos e controles:

  • Tipo de arquivo de modelo: Use o menu suspenso para selecionar um tipo de arquivo de modelo
  • Delimitador: O padrão é um delimitador de vírgula
  • Selecione um arquivo de modelo: Selecione um arquivo de modelo no menu suspenso, insira um caminho ou clique no botão Procurar para navegar até um arquivo para usar como modelo
  • Conteúdo do arquivo: Uma janela preenchida automaticamente mostrando uma visualização do conteúdo do arquivo

• Quando você clica em OK, a tela Origem muda para mostrar o novo formato de arquivo, com suas seções Delimitador e Qualificador, Validação e Propriedades do segmento:

  

• Consulte Definir formatos de arquivo para obter informações adicionais, incluindo validação de linha e campo para formatos de arquivo de texto simples (simples).

Revise a Estrutura do Formato de Arquivo¶

• Clique no botão Revisar Estrutura no canto inferior esquerdo da tela. Uma caixa de diálogo exibe os campos que você selecionou para seu upsert:

  

• Se a estrutura precisar de correção, edite a estrutura na seção Definir propriedades do segmento antes de continuar.

• Se todos os elementos estiverem corretos, clique em Avançar para continuar avançando para Criar um cronograma e definir opções.

Fonte do Banco de Dados¶

• Especifique a Fonte do banco de dados você gostaria de usar:

• Escolha inserir o SQL necessário manualmente ou usando o assistente:

  

• Inserindo manualmente a instrução SQL e depois usando o botão Verificar Sintaxe:

  

• Usando o assistente, especifique as tabelas a serem usadas:

• Usando o assistente, especifique a cláusula SQL Where a ser usada:

  

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

Fonte LDAP¶

• Especificando uma fonte LDAP:

  

• Selecionando a(s) Classe(s) de Objeto:

  

• Selecionando os Atributos:

  

• Definindo os Parâmetros de Pesquisa:

  

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

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

• Criar ou definir um cronograma é opcional e pode ser feito posteriormente. Para obter mais detalhes sobre agendamento, consulte Criar um agendamento.
• Você pode editar um cronograma existente abrindo-o na pasta Cronogramas do painel Itens do Projeto e fazendo os ajustes desejados.
• Você pode usar esta tela do assistente para adicionar agendamento 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.

• Clique na caixa de seleção Opção de resposta se precisar interagir com a resposta do Salesforce e quiser mapear informações diretamente dessa resposta:

  

• Quando terminar, clique em Avançar para ir para a tela Resumo.

Tela de Resumo¶

No Resumo, você pode editar o Nome fornecido ao assistente e especificar se deseja usar o Automapper do assistente para mapear os dados:

• Clique em Mapear e Concluir para concluir o assistente.
• Caso precise criar ou aprovar um mapeamento de transformação, você será direcionado para essa tela.
• Caso contrário, os itens de design do seu upsert serão criados e ficarão visíveis no painel Itens do Projeto no lado esquerdo da tela e você será direcionado para a página Salesforce Upsert da operação.

Mapeamento de Transformação¶

Se você escolher Selecionar um formato de arquivo existente (ou criar um novo) na tela Destino do assistente, o mapeamento da transformação aparecerá na sua área de trabalho.

• Se você especificou a caixa de seleção Usar Automapper, a maior parte ou todo o mapeamento de campos poderá ser concluído. Conclua qualquer mapeamento manual conforme apropriado.
• Um mapeamento é mostrado como uma linha entre itens nas colunas Origem (esquerda) e Destino (direita).
• Uma linha verde indica um mapeamento válido e é ainda indicada pela presença de um quadrado azul próximo ao nome de cada item mapeado de forma válida.
• Uma linha vermelha indica um mapeamento inválido.
• Uma linha amarela indica que um mapeamento tem validade questionável; entretanto, a operação tentará a transformação com esse mapeamento.
• Você pode completar o mapeamento na aba Transformação arrastando e soltando da Origem à esquerda para o Destino à direita. Quando você fizer isso, e o resultado for um mapeamento válido, um quadrado azul aparecerá à esquerda dos itens Origem e Destino.
• Para salvar sua transformação, clique na seta para baixo na faixa de status e selecione Salvar.

Conclua o mapeamento conforme necessário e clique em Concluir para concluir o assistente e a criação dos itens de design.

Upsert do Salesforce Concluído¶

• Depois de concluído, você será direcionado para a tela de resumo do novo Salesforce Upsert.
• Você pode retornar a esta página de resumo encontrando o nome da operação em Jitterbit Connect no painel Itens do Projeto.
• Você pode modificar qualquer um dos itens de design em seu projeto, como Login do Salesforce, Campo de ID externo, Ler dados de, Mapeamentos, Operação , e Executar conforme agendamento clicando no botão adjacente Editar.
• As funções dos botões Run Upsert, Test Upsert, Histórico de resultados e Delete são descritas abaixo em Implantar o projeto e executar a operação.
• 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 um Salesforce Upsert:

Opções de Arquivo¶

• Ler como UTF-8: Selecione para ler o arquivo de origem 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.
• O arquivo fonte tem um cabeçalho: Selecione para indicar se há um cabeçalho e ignore-o como se não fosse um dado.
• 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¶

• Política de Nova Tentativa: Exibe uma caixa de diálogo para definir as políticas de nova tentativa. Consulte o Salesforce avançado página.
• Configurações de agrupamento: Exibe uma caixa de diálogo para definir as configurações de fragmentação de dados. Por padrão, o fragmentação de dados é habilitado com um tamanho de chunk de 200 e um número máximo de 2 threads. Consulte o Salesforce avançado página.
• Inserir valores nulos: Se selecionado, permite a inserção de valores nulos em um registro.
• Compactar: Por padrão, a compactação está ativada.
• Permitir truncamento de campo: Se selecionado, se um valor para determinados tipos de dados do Salesforce for muito grande, o valor será truncado; caso contrário, valores muito grandes gerarão um erro.
• Todos ou nenhum: Se selecionado, qualquer registro com falha em um determinado bloco de registros fará com que todas as alterações do bloco sejam revertidas. Os pedaços que não possuem registros com falha serão confirmados mesmo se um pedaço diferente tiver registros com falha.

• Regras de registros duplicados:

  • Permitir salvar: Se selecionado, permite salvar registros duplicados, ignorando quaisquer alertas do Salesforce.
  • Incluir detalhes do registro: Se selecionado, retorna campos e valores para registros detectados como duplicados; caso contrário, apenas os IDs de registro serão retornados.
  • Executar como usuário atual: Se selecionado, as regras de compartilhamento para o usuário atual serão aplicadas.

• Opções de propriedade: Exibe uma caixa de diálogo para definir as opções de propriedade. Consulte o Salesforce avançado página.

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¶

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:

• Clique no ícone Implantar na barra de ferramentas; ou

• No painel Itens do Projeto, clique com o botão direito em Nome do projeto recém-criado e, em seguida, clique com o botão esquerdo em Implantar no menu suspenso resultante; ou

• Clique com o botão direito em Operações na parte superior do painel Itens do Projeto e, em seguida, clique com o botão esquerdo em Implementar no menu suspenso resultante.

O processo de implantar do projeto começa a enviar o projeto para o Harmony e uma mensagem de progresso é exibida.

• 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 do Salesforce. Os rótulos (como Run Query ou Run Insert) variarão dependendo do assistente que você está usando. O botão Histórico de resultados não está disponível na página de resumo Consultas do Salesforce e o botão Teste… não está disponível na página de resumo Processos em massa do Salesforce.

• Pressione o botão Run… apropriado 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 exibe na parte inferior da tela o status, a hora recebida, a hora iniciada e a hora em que a operação concluiu o processamento.
  • Quando a operação conclui o processamento, o pop-up Result exibe o horário de conclusão, o status, o número de registros que foram processados com êxito e o número de registros que falharam no processamento. Os botões Visualizar arquivo de sucesso e Visualizar arquivo de falha são descritos abaixo.

• Pressione o botão Test… para testar a operação. Esta opção destina-se a testar a operação apenas em um ambiente conectado a um Salesforce Sandbox e não deve ser usada em um ambiente de produção. Selecionar Inserção de teste na página de resumo Inserções do Salesforce, por exemplo, processa e insere os primeiros 200 registros no Salesforce Sandbox. Observação: O botão Test… não está disponível na página de resumo Processos em massa do Salesforce.

• Pressione o botão Histórico de resultados para exibir uma lista pop-up de atividades recentes, incluindo o tempo de conclusão, o status, o número de registros processados com sucesso 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. Observação: O botão Histórico de resultados não está disponível na página de resumo Consultas do Salesforce.

• Pressione o botão Excluir para excluir a operação do projeto.

  • A janela pop-up Confirmar exclusão é exibida. Clique em Excluir para confirmar e excluir a operação.

  • O pop-up Excluir itens do assistente? exibe 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. NOTA: 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 após você pressionar o botão Executar... ou o botão Histórico de resultados conforme descrito acima e, em seguida, selecionar um dos resultados. Este é um exemplo da janela pop-up 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 Exibir 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, são mostrados três registros:

  

  • Copiar arquivo para...: Este botão salva os registros de sucesso ou falha em um arquivo CSV. O nome do arquivo padrão é salesforce.csv.

  • Abrir programa externo: Esta opção não está disponível no momento.