Cómo funciona el mapeo de registros

Resumen

Data Migrator usa el mapeo de registros para mantener la precisión de los registros a lo largo de varias ejecuciones de migración. Cuando habilita el mapeo de registros para un objeto, Data Migrator asigna registros individuales entre las organizaciones de origen y de destino para que las migraciones posteriores agreguen solo los nuevos registros y actualicen los existentes. Usted controla el mapeo de registros individualmente para cada objeto en una plantilla. Data Migrator proporciona dos métodos para mapear registros entre las organizaciones de origen y de destino: Automático y Manual. Las siguientes secciones describen cómo funciona cada método e incluyen escenarios de ejemplo que ilustran un mapeo de registros exitoso y fallido.

• Cómo funciona el mapeo de registros

• Cómo funciona el mapeo de registros

• Cómo funciona el mapeo de registros

Habilitación del mapeo de registros

De forma predeterminada, el mapeo de registros está deshabilitado para todos los objetos de una plantilla. Sin el mapeo de registros habilitado, todos los registros de origen se insertan siempre en la organización de destino durante la migración. Esto puede provocar duplicados si el mismo registro existe en ambas ubicaciones.

El mapeo de registros para un objeto se habilita desde su pestaña Configuración. El siguiente artículo describe cómo habilitar el mapeo de registros para un objeto.

• Configurar el mapeo de registros de objetos

Mapeo automático de registros

El mapeo automático de registros es una estrategia con estado y basada en mapeo que usa una tabla de mapeo interna para vincular registros de origen y de destino. Se basa en mapeos históricos de implementaciones anteriores en lugar de datos de destino en tiempo real. Una vez que existe un mapeo de origen a destino, la relación queda fija, por lo que no hay ambigüedad para los registros ya migrados con Automático.

Automático está diseñado para migraciones repetidas cuando:

• Data Migrator es la única herramienta de migración en uso
• La org de destino está vacía durante la primera migración
• Se requiere coherencia a largo plazo entre ejecuciones

Automático garantiza que:

• El mismo registro de origen siempre actualiza el mismo registro de destino mapeado
• Los cambios en los campos empresariales no afectan la coincidencia de registros
• Las actualizaciones de registros son deterministas una vez que existe un mapeo

Sin embargo, Automático no evalúa datos de destino en tiempo real.

Cómo funciona Automático

Automático sigue un proceso determinista, impulsado por el mapeo. El diagrama siguiente ilustra el flujo completo.

1

Leer registro de origen

Cada registro de origen se procesa individualmente durante la ejecución de la migración.

2

Buscar mapeo en la base de datos

El sistema comprueba si ya existe un mapeo para el ID del registro de origen.

3

Evaluar el resultado del mapeo

Se encontró mapeo	Acción
No	INSERTAR un nuevo registro en la org de destino.
Sí	ACTUALIZAR el registro de destino mapeado existente.

4

Guardar el mapeo

Cuando no existe ningún mapeo, el sistema inserta el registro en la org de destino y crea un nuevo mapeo. En migraciones posteriores, este registro se actualiza en lugar de insertarse de nuevo. Este proceso se repite con cada ejecución, por lo que los nuevos registros de origen agregados se registran en la base de datos.

Limitaciones

Limitaciones importantes del mapeo automático de registros

• Automático no puede mapear registros que ya existen en la organización de destino.
• Si otra herramienta o un proceso manual crea o modifica registros en la organización de destino, los mapeos automáticos pueden quedar obsoletos, lo que provoca registros duplicados.
• Automático solo puede rastrear registros migrados a través de Data Migrator.

Mapeo obsoleto

Automático solo es tan fiable como su base de datos. Los mapeos se vuelven obsoletos cuando se crean registros en la org de destino, ya sea manualmente o mediante otra herramienta. El ejemplo siguiente muestra cómo esto da lugar a registros duplicados.

Ejemplo:

1. Un usuario ejecuta una migración de todos los registros de Contacto a una org vacía.

   1. Todos los registros de Contacto se copian de la org de origen a la org de destino.
   2. Se crean mapeos automáticos para cada registro.
2. El usuario crea manualmente registros de Contacto para Charlie y Alice tanto en la org de origen como en la de destino.
3. El usuario ejecuta otra migración de todos los registros de Contacto desde la org de origen a la org de destino.

   1. Charlie y Alice no tienen mapeo automático porque no se migraron antes.
   2. Se crean nuevos registros para Charlie y Alice en la org de destino.
   3. La org de destino ahora tiene registros duplicados para Charlie y Alice: uno de la creación manual y otro de la migración.

Mapeo manual de registros

El mapeo manual de registros combina uno o más campos de registro en un ID compuesto que vincula los registros de origen y de destino. A diferencia de los ID externos estándar de Salesforce, se puede usar cualquier campo en el ID compuesto. Cuando Manual busca en la org de destino y encuentra exactamente un registro coincidente, actualiza ese registro en lugar de insertar uno nuevo.

Está diseñado para migrar registros a org de destino que ya contienen registros no mapeados previamente con el mapeo automático de registros, o para registros en la org de destino creados por otras herramientas. Elija cuidadosamente los campos del mapeo manual de registros: si cambia el valor de cualquiera de los campos seleccionados, el mapeo ya no coincidirá con el registro migrado previamente.

Cómo funciona Manual

Antes de usar el mapeo manual de registros para migrar registros, debe seleccionar uno o más campos del objeto para usar en el mapeo de registros. Los campos seleccionados se combinan para crear una clave que sea única y estable a la vez. Esto significa que la clave no cambia cuando cambian los campos del registro que normalmente se actualizan, y es única para cada registro de la org. Puede elegir uno o más campos para usar en la clave manual. Cuantos más campos seleccione, más probable será que la clave sea única. Sin embargo, seleccionar más campos también aumenta la probabilidad de que la clave sea inestable.

Durante el mapeo manual de registros, el proceso busca coincidencias en la org de destino con la clave generada. El diagrama y la explicación siguientes ilustran cómo funciona.

1

Leer registro de origen

Cada registro de origen se procesa individualmente durante la ejecución de la migración.

2

Generar clave

Una CLAVE se genera a partir de los campos del registro seleccionados para el mapeo manual.

3

Consultar la org de destino

Ejecute una consulta SOQL en la org de destino para la CLAVE.

4

Evaluar el resultado de la consulta

Número de registros coincidentes	Acción
0	INSERTAR un nuevo registro en la org de destino.
1	ACTUALIZAR el registro de destino coincidente existente.
2 o más	ERROR: se omite el registro. Más de un registro coincide con la CLAVE, por lo que la clave manual de este registro no es única y el registro no puede migrarse.

Limitaciones

Limitaciones importantes del mapeo manual de registros

Seleccionar una combinación de campos estables que creen un ID único para cada registro es fundamental.

• Estable: Si cambia un valor en uno de los campos seleccionados para la clave, el mapeo manual ya no coincidirá con el registro migrado previamente y se insertará un nuevo registro, lo que dará como resultado un duplicado.
• Único: Si dos o más registros comparten la misma clave en la organización de origen, la migración no puede asignarlos correctamente a los registros de destino porque la clave no es única.

Campos manuales incorrectos

El mapeo manual de registros solo es fiable si los campos elegidos para el mapeo manual crean una clave que sea a la vez estable y única. A continuación se muestran ejemplos de malas elecciones de campos.

Los siguientes ejemplos usan el objeto Contacto.

Campos seleccionados para la clave	Por qué estos campos son una mala elección
Nombre y Ciudad	Aunque Nombre rara vez cambia, al combinarlo con Ciudad hace que la clave sea inestable, porque la ciudad de un contacto puede cambiar.
Cargo y Departamento	Esta combinación no es única: varios contactos pueden compartir el mismo cargo y departamento.
Nombre y Cumpleaños	Esta combinación parece única y estable, pero Cumpleaños a menudo está vacía al principio y se completa más tarde, lo que hace que la clave sea inestable.

Escenarios de mapeo de registros

Diseño de la plantilla

Objeto: Contacto

• Campo: Nombre
• Campo: Correo electrónico
• Campo: Ciudad

Las tablas siguientes muestran los registros de origen y de destino, con las diferencias en negrita.

Registros de Contacto de la org de origen

ID	Nombre	Correo electrónico	Ciudad
001D000000kL4p1	Alice	[e-mail]	Berlín
001D000000kL4p2	Bob	[e-mail]	Londres
001D000000kL4p3	Charlie	[e-mail]	París
001D000000kL4p4	Dave	[e-mail]	Seattle

Registros de Contacto de la org de destino

ID	Nombre	Correo electrónico	Ciudad
002D000000kL5p1	Alice	[e-mail]	Nueva York
002D000000kL5p2	Bob	[e-mail]	Londres
002D000000kL5p3	Charlie	[e-mail]	París

Migración de datos con mapeo automático de registros

Escenario exitoso

En este escenario, una migración anterior ya creó un mapeo automático entre las org de origen y de destino. La tabla siguiente muestra ese mapeo.

Nombre de origen	ID de origen	ID de destino
Alice	001D000000kL4p1	002D000000kL5p1
Bob	001D000000kL4p2	002D000000kL5p2
Charlie	001D000000kL4p3	002D000000kL5p3

Cuando se ejecuta la migración, el mapeo automático de registros busca el ID de cada registro de origen en el mapeo existente. Los registros con un mapeo almacenado se actualizan en la org de destino, y los registros sin mapeo se insertan como nuevos registros. El diagrama y la tabla siguientes ilustran este proceso y las acciones resultantes en la org de destino.

ID	Nombre	Correo electrónico	Ciudad	Operación
002D000000kL5p1	Alice	[e-mail]	Berlín	ACTUALIZAR
002D000000kL5p2	Bob	[e-mail]	Londres	ACTUALIZAR
002D000000kL5p3	Charlie	[e-mail]	París	ACTUALIZAR
002D000000kL5p4	Dave	[e-mail]	Seattle	INSERTAR

Luego se agrega un nuevo mapeo automático para el registro recién insertado:

Nombre de origen	ID de origen	ID de destino
Dave	001D000000kL4p4	002D000000kL5p4

Escenario fallido

En este escenario, una migración anterior ya había creado un mapeo automático entre las org de origen y de destino; sin embargo, en ese momento solo se habían mapeado dos registros. La tabla siguiente muestra ese mapeo.

Nombre de origen	ID de origen	ID de destino
Alice	001D000000kL4p1	002D000000kL5p1
Bob	001D000000kL4p2	002D000000kL5p2

Antes de la siguiente migración, una herramienta externa agrega un registro de Charlie tanto a la org de origen como a la de destino. Cuando se ejecuta la migración, Automático busca el ID de cada registro de origen en el mapeo existente, actualizando los registros de destino que ya tienen un mapeo e insertando nuevos registros para los que no lo tienen.

El diagrama y la tabla siguientes ilustran este proceso y las acciones resultantes en la org de destino. Como no existe un mapeo automático para Charlie, la migración inserta un registro duplicado, mostrado en la fila adicional insertada.

ID	Nombre	Correo electrónico	Ciudad	Operación
002D000000kL5p1	Alice	[e-mail]	Berlín	ACTUALIZAR
002D000000kL5p2	Bob	[e-mail]	Londres	ACTUALIZAR
002D000000kL5p3	Charlie	[e-mail]	París
002D000000kL5p4	Charlie	[e-mail]	París	INSERTAR
002D000000kL5p5	Dave	[e-mail]	Seattle	INSERTAR

Luego se agregan dos nuevos mapeos automáticos para los registros recién insertados:

Nombre de origen	ID de origen	ID de destino
Charlie	001D000000kL4p3	002D000000kL5p4
Dave	001D000000kL4p4	002D000000kL5p5

La migración falló porque una herramienta externa agregó a Charlie tanto a la org de origen como a la de destino sin crear un mapeo automático entre ambas. Al no existir un mapeo para Charlie, Automático insertó un nuevo registro en la org de destino en lugar de actualizar el existente, lo que provocó un duplicado.

Migración de datos con mapeo manual de registros

Escenario exitoso

Clave de campo manual: Nombre

En este escenario, el mapeo manual de registros compara registros usando la clave configurada. Con Nombre como clave manual, el sistema genera una clave para cada registro de origen y consulta la org de destino para buscar una coincidencia. Los registros que devuelven exactamente una coincidencia se actualizan, y los que no devuelven ninguna se insertan. El diagrama y la tabla siguientes ilustran el proceso de mapeo manual de registros y las acciones resultantes en la org de destino.

ID	Nombre	Correo electrónico	Ciudad	Operación
002D000000kL5p1	Alice	[e-mail]	Berlín	ACTUALIZAR
002D000000kL5p2	Bob	[e-mail]	Londres	ACTUALIZAR
002D000000kL5p3	Charlie	[e-mail]	París	ACTUALIZAR
002D000000kL5p4	Dave	[e-mail]	Seattle	INSERTAR

Escenario fallido

Clave de campo manual: Nombre + Correo electrónico

En este escenario, el mapeo manual de registros usa Nombre + Correo electrónico como la clave configurada. Para cada registro de origen, el sistema genera esta clave y consulta la org de destino para buscar una coincidencia. Como el registro de origen de Bob tiene un nuevo valor en uno de los campos clave, ya no coincide con su registro en la org de destino.

Los registros que devuelven exactamente una coincidencia se actualizan, y los registros sin coincidencia se insertan. El diagrama y la explicación siguientes muestran el proceso de mapeo manual de registros y las acciones resultantes en la org de destino. Como la clave de origen de Bob ya no coincide con su registro de destino existente, la migración inserta un duplicado, mostrado en la fila adicional insertada.

ID	Nombre	Correo electrónico	Ciudad	Operación
002D000000kL5p1	Alice	[e-mail]	Berlín	ACTUALIZAR
002D000000kL5p2	Bob	[e-mail]	Londres
002D000000kL5p3	Charlie	[e-mail]	París	ACTUALIZAR
002D000000kL5p4	Bob	[e-mail]	Londres	INSERTAR
002D000000kL5p5	Dave	[e-mail]	Seattle	INSERTAR

La migración falló porque el valor de Bob Correo electrónico cambió en la org de origen después de que se creara el registro de destino. Como Correo electrónico forma parte de la clave manual, la nueva clave generada a partir del registro de origen (Bob + [e-mail]) ya no coincidía con la clave del registro de destino existente (Bob + [e-mail]). Al no encontrar coincidencia, Manual insertó un nuevo registro en la org de destino en lugar de actualizar el existente, lo que dio lugar a un duplicado.