Como o mapeamento de registros funciona

Visão geral

O Data Migrator usa o mapeamento de registros para manter os registros precisos em várias execuções de migração. Quando você habilita o mapeamento de registros para um objeto, o Data Migrator mapeia registros individuais entre as organizações de origem e destino para que as migrações subsequentes adicionem apenas novos registros e atualizem os existentes. Você controla o mapeamento de registros individualmente para cada objeto em um template. O Data Migrator oferece dois métodos para mapear registros entre as organizações de origem e destino: Automático e Manual. As seções a seguir descrevem como cada método funciona e incluem cenários de exemplo que ilustram o mapeamento de registros bem-sucedido e com falha.

• Como o mapeamento de registros funciona

• Como o mapeamento de registros funciona

• Como o mapeamento de registros funciona

Habilitando o mapeamento de registros

Por padrão, o mapeamento de registros está desabilitado para todos os objetos em um template. Sem o mapeamento de registros habilitado, todos os registros de origem são sempre inseridos na organização de destino durante a migração. Isso pode resultar em duplicatas se o mesmo registro existir em ambos os locais.

O mapeamento de registros de um objeto é habilitado na guia Configurações dele. O artigo a seguir descreve como habilitar o mapeamento de registros para um objeto.

• Definindo o mapeamento de registros do objeto

Mapeamento automático de registros

O mapeamento automático de registros é uma estratégia com estado, baseada em mapeamento, que usa uma tabela interna de mapeamento para vincular registros de origem e destino. Ele depende de mapeamentos históricos de implantações anteriores, em vez de dados de destino em tempo real. Depois que existe um mapeamento de origem para destino, a relação fica fixa, então não há ambiguidade para registros já migrados usando o Automático.

O Automático foi projetado para migrações repetidas quando:

• O Data Migrator é a única ferramenta de migração em uso
• A org de destino está vazia durante a primeira migração
• É necessária consistência de longo prazo entre execuções

O Automático garante que:

• O mesmo registro de origem sempre atualiza o mesmo registro de destino mapeado
• Alterações nos campos de negócio não afetam a correspondência de registros
• As atualizações de registros são determinísticas depois que um mapeamento existe

No entanto, o Automático não avalia dados de destino em tempo real.

Como o Automático funciona

O Automático segue um processo determinístico, orientado por mapeamento. O diagrama abaixo ilustra o fluxo completo.

1

Ler registro de origem

Cada registro de origem é processado individualmente durante a execução da migração.

2

Localizar mapeamento no banco de dados

O sistema verifica se já existe um mapeamento para o ID do registro de origem.

3

Avaliar o resultado do mapeamento

Mapeamento encontrado	Ação
Não	INSIRA um novo registro na org de destino.
Sim	ATUALIZE o registro de destino mapeado existente.

4

Salvar o mapeamento

Quando nenhum mapeamento existe, o sistema insere o registro na org de destino e cria um novo mapeamento. Nas migrações subsequentes, esse registro é atualizado em vez de ser inserido novamente. Esse processo se repete a cada execução, então os novos registros de origem adicionados são acompanhados no banco de dados.

Limitações

Limitações Importantes do Mapeamento Automático de Registros

• O Automático não pode mapear registros que já existem na organização de destino.
• Se outra ferramenta ou processo manual criar ou modificar registros na organização de destino, os mapeamentos Automáticos podem ficar desatualizados, levando a registros duplicados.
• O Automático só pode rastrear registros migrados por meio do Data Migrator.

Mapeamento desatualizado

O Automático é tão confiável quanto seu banco de dados. Os mapeamentos ficam desatualizados quando registros são criados na org de destino, seja manualmente ou por meio de outra ferramenta. O exemplo abaixo mostra como isso leva a registros duplicados.

Exemplo:

1. Um usuário executa uma migração de todos os registros de Contato para uma org vazia.

   1. Todos os registros de Contato são copiados da org de origem para a org de destino.
   2. Mapeamentos automáticos são criados para cada registro.
2. O usuário cria manualmente registros de Contato para Charlie e Alice nas orgs de origem e de destino.
3. O usuário executa outra migração de todos os registros de Contato da org de origem para a org de destino.

   1. Charlie e Alice não têm mapeamento automático porque não foram migrados antes.
   2. Novos registros para Charlie e Alice são criados na org de destino.
   3. A org de destino agora tem registros duplicados para Charlie e Alice: um da criação manual e outro da migração.

Mapeamento manual de registros

O mapeamento manual de registros combina um ou mais campos de registro em um ID composto que vincula registros de origem e destino. Ao contrário dos IDs externos padrão do Salesforce, qualquer campo pode ser usado no ID composto. Quando o Manual pesquisa a org de destino e encontra exatamente um registro correspondente, ele atualiza esse registro em vez de inserir um novo.

Ele foi projetado para migrar registros para orgs de destino que já contêm registros não mapeados anteriormente com o mapeamento automático de registros, ou para registros na org de destino criados por outras ferramentas. Escolha os campos do mapeamento manual com cuidado: se o valor de qualquer campo selecionado mudar, o mapeamento não corresponderá mais ao registro migrado anteriormente.

Como o Manual funciona

Antes de usar o mapeamento manual de registros para migrar registros, você deve selecionar um ou mais campos para o objeto a serem usados no mapeamento de registros. Os campos selecionados são combinados para criar uma chave que é ao mesmo tempo exclusiva e estável. Isso significa que a chave não muda quando campos de registro comumente atualizados mudam, e ela é exclusiva para cada registro na org. Você pode escolher um ou mais campos para usar na chave Manual. Quanto mais campos você selecionar, maior a probabilidade de a chave ser exclusiva. No entanto, selecionar mais campos também aumenta a chance de a chave ser instável.

Durante o mapeamento manual de registros, o processo pesquisa na org de destino correspondências com a chave gerada. O diagrama e a explicação abaixo ilustram como isso funciona.

1

Ler registro de origem

Cada registro de origem é processado individualmente durante a execução da migração.

2

Gerar chave

Um CHAVE é gerada a partir dos campos do registro selecionados para o mapeamento Manual.

3

Consultar a org de destino

Execute uma consulta SOQL na org de destino para a CHAVE.

4

Avaliar o resultado da consulta

Número de registros correspondentes	Ação
0	INSIRA um novo registro na org de destino.
1	ATUALIZE o registro de destino correspondente existente.
2 ou mais	ERRO - o registro é ignorado. Mais de um registro corresponde à CHAVE, portanto a chave Manual para este registro não é exclusiva e o registro não pode ser migrado.

Limitações

Limitações Importantes do Mapeamento Manual de Registros

Selecionar uma combinação de campos estáveis que criem um ID único para cada registro é fundamental.

• Estável: Se um valor em um dos campos selecionados para a chave mudar, o mapeamento Manual não corresponderá mais ao registro migrado anteriormente, e um novo registro será inserido, resultando em uma duplicata.
• Único: Se dois ou mais registros compartilharem a mesma chave na organização de origem, a migração não poderá mapeá-los corretamente para os registros de destino porque a chave não é única.

Campos manuais inadequados

O mapeamento manual de registros só é confiável se os campos escolhidos para o mapeamento Manual criarem uma chave que seja ao mesmo tempo estável e exclusiva. Abaixo estão exemplos de escolhas ruins de campos.

Os exemplos a seguir usam o objeto Contato.

Campos selecionados para a chave	Por que esses campos são uma má escolha
Nome e Cidade	Embora Nome mude raramente, combiná-lo com Cidade torna a chave instável, porque a cidade de um contato pode mudar.
Cargo e Departamento	Essa combinação não é exclusiva: vários contatos podem ter o mesmo cargo e departamento.
Nome e Data de nascimento	Essa combinação parece exclusiva e estável, mas Data de nascimento geralmente fica em branco no início e é preenchida depois, o que torna a chave instável.

Cenários de mapeamento de registros

Design do template

Objeto: Contato

• Campo: Nome
• Campo: E-mail
• Campo: Cidade

As tabelas abaixo mostram os registros de origem e destino, com as diferenças em negrito.

Registros de Contato da org de origem

ID	Nome	E-mail	Cidade
001D000000kL4p1	Alice	[e-mail]	Berlim
001D000000kL4p2	Bob	[e-mail]	Londres
001D000000kL4p3	Charlie	[e-mail]	Paris
001D000000kL4p4	Dave	[e-mail]	Seattle

Registros de Contato da org de destino

ID	Nome	E-mail	Cidade
002D000000kL5p1	Alice	[e-mail]	Nova York
002D000000kL5p2	Bob	[e-mail]	Londres
002D000000kL5p3	Charlie	[e-mail]	Paris

Migração de dados com mapeamento automático de registros

Cenário bem-sucedido

Neste cenário, uma migração anterior já havia criado um mapeamento automático entre as orgs de origem e de destino. A tabela abaixo mostra esse mapeamento.

Nome de origem	ID de origem	ID de destino
Alice	001D000000kL4p1	002D000000kL5p1
Bob	001D000000kL4p2	002D000000kL5p2
Charlie	001D000000kL4p3	002D000000kL5p3

Quando a migração é executada, o mapeamento automático de registros procura o ID de cada registro de origem no mapeamento existente. Os registros com um mapeamento armazenado são atualizados na org de destino, e os registros sem um mapeamento são inseridos como novos registros. O diagrama e a tabela abaixo ilustram esse processo e as ações resultantes na org de destino.

ID	Nome	E-mail	Cidade	Operação
002D000000kL5p1	Alice	[e-mail]	Berlim	ATUALIZAR
002D000000kL5p2	Bob	[e-mail]	Londres	ATUALIZAR
002D000000kL5p3	Charlie	[e-mail]	Paris	ATUALIZAR
002D000000kL5p4	Dave	[e-mail]	Seattle	INSERIR

Em seguida, é adicionado um novo mapeamento automático para o registro recém-inserido:

Nome de origem	ID de origem	ID de destino
Dave	001D000000kL4p4	002D000000kL5p4

Cenário com falha

Neste cenário, uma migração anterior já havia criado um mapeamento automático entre as orgs de origem e de destino; no entanto, apenas dois registros estavam mapeados naquela época. A tabela abaixo mostra esse mapeamento.

Nome de origem	ID de origem	ID de destino
Alice	001D000000kL4p1	002D000000kL5p1
Bob	001D000000kL4p2	002D000000kL5p2

Antes da próxima migração, uma ferramenta externa adiciona um registro para Charlie tanto na org de origem quanto na org de destino. Quando a migração é executada, o Automático procura o ID de cada registro de origem no mapeamento existente, atualizando os registros de destino que já têm um mapeamento e inserindo novos registros para os que não têm.

O diagrama e a tabela abaixo ilustram esse processo e as ações resultantes na org de destino. Como não existe mapeamento automático para Charlie, a migração insere um registro duplicado, mostrado na linha adicional inserida.

ID	Nome	E-mail	Cidade	Operação
002D000000kL5p1	Alice	[e-mail]	Berlim	ATUALIZAR
002D000000kL5p2	Bob	[e-mail]	Londres	ATUALIZAR
002D000000kL5p3	Charlie	[e-mail]	Paris
002D000000kL5p4	Charlie	[e-mail]	Paris	INSERIR
002D000000kL5p5	Dave	[e-mail]	Seattle	INSERIR

Em seguida, dois novos mapeamentos automáticos são adicionados para os registros recém-inseridos:

Nome de origem	ID de origem	ID de destino
Charlie	001D000000kL4p3	002D000000kL5p4
Dave	001D000000kL4p4	002D000000kL5p5

A migração falhou porque uma ferramenta externa adicionou Charlie tanto na org de origem quanto na org de destino sem criar um mapeamento automático entre eles. Sem mapeamento para Charlie, o Automático inseriu um novo registro na org de destino em vez de atualizar o existente, resultando em uma duplicata.

Migração de dados com mapeamento manual de registros

Cenário bem-sucedido

Chave do campo Manual: Nome

Neste cenário, o mapeamento manual de registros corresponde aos registros usando a chave configurada. Com Nome como chave Manual, o sistema gera uma chave para cada registro de origem e consulta a org de destino em busca de uma correspondência. Os registros que retornam exatamente uma correspondência são atualizados, e os registros que não retornam correspondência são inseridos. O diagrama e a tabela abaixo ilustram o processo de mapeamento manual de registros e as ações resultantes na org de destino.

ID	Nome	E-mail	Cidade	Operação
002D000000kL5p1	Alice	[e-mail]	Berlim	ATUALIZAR
002D000000kL5p2	Bob	[e-mail]	Londres	ATUALIZAR
002D000000kL5p3	Charlie	[e-mail]	Paris	ATUALIZAR
002D000000kL5p4	Dave	[e-mail]	Seattle	INSERIR

Cenário com falha

Chave do campo Manual: Nome + E-mail

Neste cenário, o mapeamento manual de registros usa Nome + E-mail como a chave configurada. Para cada registro de origem, o sistema gera essa chave e consulta a org de destino em busca de correspondência. Como o registro de origem de Bob tem um novo valor em um dos campos da chave, ele não corresponde mais ao registro dele na org de destino.

Os registros que retornam exatamente uma correspondência são atualizados, e os registros sem correspondência são inseridos. O diagrama e a explicação abaixo mostram o processo de mapeamento manual de registros e as ações resultantes na org de destino. Como a chave de Bob na origem não corresponde mais ao registro existente no destino, a migração insere uma duplicata, mostrada na linha adicional inserida.

ID	Nome	E-mail	Cidade	Operação
002D000000kL5p1	Alice	[e-mail]	Berlim	ATUALIZAR
002D000000kL5p2	Bob	[e-mail]	Londres
002D000000kL5p3	Charlie	[e-mail]	Paris	ATUALIZAR
002D000000kL5p4	Bob	[e-mail]	Londres	INSERIR
002D000000kL5p5	Dave	[e-mail]	Seattle	INSERIR

A migração falhou porque o E-mail valor mudou na org de origem depois que o registro de destino foi criado. Como E-mail faz parte da chave Manual, a nova chave gerada a partir do registro de origem (Bob + [e-mail]) não correspondeu mais à chave do registro existente de destino (Bob + [e-mail]). Sem encontrar correspondência, o Manual inseriu um novo registro na org de destino em vez de atualizar o existente, resultando em uma duplicata.