Salesforce Avançado¶

Esta página aborda opções avançadas, funcionalidade de mapeamento avançada e como incluir cabeçalhos em arquivos de sucesso/falha usando os assistentes do Jitterbit Connect Salesforce.

Opções Avançadas¶

As opções avançadas ficam acessíveis depois que você cria uma operação do Salesforce. Você pode visualizar as opções disponíveis no Design Studio seguindo estas etapas:

1. Crie uma consultar do Salesforce, inserir, inserir, atualizar, excluir ou processo em massa operação o assistente apropriado do Jitterbit Connect Salesforce.
2. Conclua o assistente e aguarde até que todos os itens do projeto sejam criados. Você será direcionado diretamente para o conector Salesforce configurado.
3. No painel à esquerda, em Jitterbit Connect > Salesforce, expanda para o conector e clique duas vezes para abrir o item.
4. Na janela, clique em Opções avançadas para expandir as configurações adicionais. As configurações são exclusivas para cada tipo de operação.

Configurações de Lote¶

Para conectores selecionados de Processo em massa (Upsert, Insert, Update, Delete e Hard Delete), as Opções avançadas > Configurações de lote permitem definir uma configuração que limita o número de registros retornados ou usados em um lote:

Use 0 ou deixe um campo vazio se não houver limitação de seu valor.

• Registros por arquivo: Por padrão, 10.000 (10.000 ou 10K).
• Caracteres por arquivo: Por padrão, 1.000.0000 (10.000.000 ou 10M).

O Assistente de consulta do Salesforce tem uma seção Opções avançadas > Opções de operação para definir o tamanho do lote diretamente.

Configurações de Fragmentação¶

O chunking não está disponível para processo em massa do Salesforce conectores (em vez disso, consulte Configurações de lote acima). Para Opções avançadas > Configurações de fragmentação de um conector configurado, você pode configurar:

• Tamanho do bloco: Por padrão, é definido como 200. Deve estar no intervalo de 1 a 200.
• Número de registros por arquivo: Por padrão, é definido como 0, o que significa todos os registros em um arquivo.
• Número máximo de threads: Por padrão, é definido como 2.

Essas configurações (e os nós de bloco de origem e de destino, se aplicável) também podem ser definidas no nível da operação; nesse caso, a janela do conector configurado precisa ser fechada e reaberta para ver as alterações nessas configurações.

A fragmentação de dados no nível da operação não está disponível para Processo em massa do Salesforce operações (em vez disso, consulte as Configurações de lote acima). Para outras operações do Salesforce, essas opções de operação estão disponíveis, conforme mostrado para uma Consulta do Salesforce operação:

Para Salesforce upsert, inserir, atualizar e excluir, por padrão o fragmentação de dados está habilitado com um Tamanho do chunk de 200 e um Número máximo de threads de 2.

Informações adicionais sobre essas configurações e fragmentação de dados em geral são abordadas em Chunking.

Opções de Data¶

Para Opções avançadas > Opções de data de um conector configurado, você pode definir as Configurações de conversão de data. Isso se aplica ao mapeamento para campos de destino do Salesforce com um date ou date-time tipo de dados, conforme descrito em Mapear para campos de data ou data e hora do Salesforce mais adiante nesta página.

• O arquivo de origem já utiliza o formato correto: Se os dados estiverem no formato esperado pelo Salesforce, você pode desabilitar esta conversão selecionando esta opção. O restante dos controles ficará desativado.
• Fuso horário: Se a opção acima não for selecionada, você poderá especificar informações sobre os campos de data e hora na fonte e os dados serão convertidos de acordo. Especifique uma destas opções de fuso horário para o date e date-time Campos:
  • Hora do servidor local: Selecione se os campos de data e data e hora forem locais para o servidor que executa o agente.
  • GMT: GMT está pré-selecionado como formato padrão.
  • Selecione um fuso horário: Se selecionado, especifique um fuso horário no menu suspenso.
• O arquivo de origem usa o formato de data europeu (dd/mm/aaaa): Isso pode ser especificado além de um Fuso horário.

Opções de Propriedade¶

Para Opções avançadas > Política de nova tentativa de um conector configurado, você pode configurar Regras de propriedade do Salesforce:

Política de Nova Tentativa¶

Para Opções avançadas > Política de nova tentativa de um conector configurado, você pode configurar:

• Não usar novas tentativas: Selecione para não usar novas tentativas e desative o restante desta caixa de diálogo
• Número de novas tentativas: Por padrão, 3.
• Intervalo de repetição (em segundos): Por padrão, 30 segundos.

Funcionalidade de Mapeamento Avançado¶

Como parte dos assistentes do Jitterbit Connect Salesforce, ao concluir determinados mapeamentos, o Design Studio cria automaticamente scripts de mapeamento que são comuns para determinados casos de uso. Eles se aplicam ao mapeamento para o Salesforce date e date-time campos em uma operação de upsert, inserção ou atualização do Salesforce ou operação em massa do mesmo tipo, bem como ao mapear uma resposta de um Salesforce, inserção, atualização ou exclusão do Salesforce para outro destino.

Mapear para Campos de Data Ou Data e Hora do Salesforce¶

Essa funcionalidade se aplica ao mapeamento de uma origem especificada para um campo de destino do Salesforce que tenha um date ou date-time tipo de dados em um upsert do Salesforce, inserir ou atualizar operação ou um processo em massa do Salesforce operação do tipo upsert, insert ou update. A origem é especificada durante a conclusão do assistente do Jitterbit Connect Salesforce.

Como auxílio ao usuário, ao completar um mapeamento de transformação, qualquer date ou date-time os campos presentes na sua fonte serão mapeados com lógica de script que converte esses campos para o formato esperado pelo Salesforce. A lógica de script específica adicionada depende das Configurações de conversão de data conforme especificado nas Opções de data descrito anteriormente nesta página.

Por exemplo, suponha que os dados de origem estejam no formato de YYYY-MM-DD HH:MM:SS e o fuso horário de origem é GMT. Neste caso, aplicam-se as configurações padrão:

Com este exemplo, quando um campo de origem (json$item.LastModifiedDate$) é mapeado para um destino date ou date-time campo (root$transaction.body$create$Account.LastModifiedDate$), a lógica do script é adicionada automaticamente ao campo de destino. O script adicionado usa a função Jitterbit GetUTCFormattedDateTime() e especifica seus parâmetros usando o campo de origem, fuso horário especificado ("UTC") e booleano para o formato de data europeu (false).

A lógica de script específica inserida depende das Configurações de conversão de data fornecidas pelo usuário. É importante que os dados de origem estejam em um formato que possa ser convertido com a lógica inserida com base nestas configurações. Por exemplo, se você tentar mapear a partir de um campo de origem que não contém data ou data e hora, ele não poderá ser convertido com esta lógica.

Erros de Registro Retornados do Salesforce¶

Esta funcionalidade se aplica ao mapear a resposta do Salesforce que é retornada durante a criação de um upsert do Salesforce, inserir, atualizar ou excluir, na etapa Programação e opções, a caixa de seleção Opção de resposta para "Preciso interagir com a resposta do Salesforce" está marcada. Esta opção é selecionada por padrão.

Para auxiliar o usuário, quando esta opção é selecionada, uma segunda transformação é automaticamente adicionada à operação que gera um script mapeado para capturar quaisquer erros retornados do Salesforce e gravá-los no log da operação. O destino da transformação é um esquema simples em que a mensagem de erro do Salesforce é mapeada automaticamente para um campo que contém um script gerado para registrar os erros. Além disso, para operações de upsert ou atualização do Salesforce, o campo-chave externo também é registrado no log.

Por exemplo, se esta opção for selecionada durante a criação de uma operação de upsert do Salesforce, será criada uma operação semelhante à mostrada abaixo. A operação inclui a transformação de solicitação inicial para realizar o upsert, bem como uma segunda transformação de resposta usada para registrar a resposta do Salesforce:

Ao abrir a transformação de resposta neste exemplo, o lado de destino mostra um esquema simples com um único campo que já está mapeado:

Ao clicar duas vezes no campo de resposta, você pode ver que a lógica de script foi adicionada usando campos da resposta do Salesforce junto com várias funções do Jitterbit. A lógica determina que se a resposta de sucesso do Salesforce (root$transaction.response$body$upsertResponse$result.success$) retorna false, a mensagem de erro do Salesforce (root$transaction.response$body$upsertResponse$result.errors#.message$) será gravado no log de operação. Como esta é uma operação de upsert que requer um ID externo para corresponder aos registros do upsert, o ID externo (root$transaction.request$body$upsert$Account#.Jitterbit_Account_ID__c$) também é relatado no log.

Se você alterar posteriormente qual campo é usado como ID externo, o script precisará ser atualizado com a nova referência do objeto de origem.

Observe que para operações de inserção e exclusão do Salesforce, que não usam um campo de ID externo para corresponder aos registros, a referência de ID externo é excluída do script. Para tais operações, o script mapeado contém esta lógica, abreviada para excluir o ID:

<trans>
// This mapping is part of a Salesforce wizard.
// Modifying it may cause the wizard to malfunction.
If(root$transaction.response$body$createResponse$result.success$ == false,
    WriteToOperationLog(
        SumString(root$transaction.response$body$createResponse$result.errors#.message$, ". ", false)
    )
)
</trans>

Incluir Cabeçalhos em Arquivos de Sucesso e Falha¶

Você pode incluir cabeçalhos como arquivos de sucesso/falha em uma operação de upsert ou atualização do Salesforce a partir de uma origem de banco de dados. Você deve estar usando um Agente Privado versão 8.24 ou posterior para fazer isso seguindo as instruções abaixo.

Estas etapas mostram como capturar a sequência de cabeçalho de uma origem de banco de dados e, em seguida, cabeçalho -la no início de um arquivo de sucesso ou falha:

1. Defina a variável Jitterbit jitterbit.sfdc.dbsource.sfheader
2. Defina as opções de arquivo de sucesso e falha
3. Defina as opções de operação

Defina a Variável Jitterbitjitterbit.sfdc.dbsource.sfheader¶

1. Crie um script pôr jitterbit.sfdc.dbsource.sfheader para true:

   <trans>
   $jitterbit.sfdc.dbsource.sfheader=true;
   </trans>
   

2. Crie o Assistente do Salesforce Upsert ou Atualizar operação.

3. Insira o script no início da operação de atualização ou upsert, conforme mostrado aqui para uma operação de upsert:

   

Defina as Opções de Arquivo de Sucesso e Falha¶

1. Crie um destino de arquivo local a ser usado para os registros de sucesso:
   1. Clique em Opções do destino e marque a caixa de seleção Escrever cabeçalhos.
   2. Salve a configuração do destino clicando no ícone Salvar.
2. Repita essas etapas para criar um destino de arquivo local a ser usado para os registros de falha.

Este exemplo mostra uma meta concluída destinada ao uso com registros de sucesso:

Defina as Opções de Operação¶

1. Clique com o botão direito na operação ou clique na seta suspensa para selecionar o item de menu Opções:

   

2. A caixa de diálogo Opções de operação permite especificar a gravação de registros de sucesso e falha:

   

   1. Clique no menu suspenso Gravar registros de sucesso em e selecione o destino apropriado na lista ou selecione Criar novo para criar um novo destino de tipo de arquivo.
   2. Clique no menu suspenso Gravar registros de falha em e selecione o destino apropriado na lista ou selecione Criar novo para criar um novo destino de tipo de arquivo.

   Nota

   Se você escolher Criar novo, consulte Destino de arquivo local para obter instruções sobre como criar novos arquivos.

3. Clique em OK e depois clique no ícone Salvar para salvar as alterações na operação.

Este exemplo mostra a gravação de registros de sucesso no destino criado acima e a configuração da gravação de registros de falha em um destino diferente: