> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/data-migrator/data-migrator-es/plantillas/disenador-de-plantillas/configurar-el-mapeo-de-registros-de-objetos.md).

# Configurar el mapeo de registros de objetos

## ![](https://626430605-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FcfMTqg4Brbm9baWutclZ%2FSummary2-Small-Icon.svg?alt=media\&token=d1cf162d-c02d-4184-988e-7f7350e450fc) Resumen

Este artículo explica cómo habilitar el mapeo de registros para los objetos en una plantilla. El mapeo de registros se controla por separado para cada objeto en cada plantilla. Hay disponibles dos métodos de mapeo de registros: Automático y Manual. No se requiere que utilice el mismo método de mapeo de registros para cada objeto en una plantilla. Las instrucciones a continuación explican cómo configurar cada método.

{% hint style="info" %}

#### Cómo funciona el mapeo de registros

Antes de usar el mapeo de registros, es importante entender cómo funciona cada método y sus limitaciones. Si aún no lo ha hecho, revise la información del siguiente artículo.

* [Cómo funciona el mapeo de registros](/data-migrator/data-migrator-es/plantillas/migracion/como-funciona-el-mapeo-de-registros.md)
  {% endhint %}

## Configurar el mapeo de registros

{% stepper %}
{% step %}

### Seleccionar plantilla

1. Haga clic **Plantillas** desde el menú de la barra lateral izquierda.
2. Haga clic en la plantilla para agregar mapeos de registros.

   <div align="left"><figure><img src="https://626430605-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FQbTzbifNNKd4wNHLuGET%2FSettingObjectRecordMapping-S01-01.png?alt=media&amp;token=8b0c3e57-25b1-44b9-9b8c-87375339e96d" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Agregar mapeo al objeto

Habilite y configure el mapeo de registros para cada objeto en el que desee usarlo.

1. Haga clic en el objeto para configurar el mapeo de registros.
2. Haga clic en el **Configuración** pestaña.
3. Haga clic **Agregar mapeo** en la **mapeo de registros** sección.

   <div align="left"><figure><img src="https://626430605-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FewH0ab3GvboUhJKH5pf3%2FSettingObjectRecordMapping-S02-02.png?alt=media&amp;token=d2186838-d213-49a4-9890-c12f07a0e478" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Configurar el mapeo automático

{% hint style="warning" %}

#### 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.
  {% endhint %}

1. Haga clic en el **mapeo de registros** desplegable.
2. Seleccione **Automático**.
3. Haga clic **Guardar**.

   <div align="left"><figure><img src="https://626430605-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FPAx3KNmGcr3h9nqMqFJS%2FSettingObjectRecordMapping-S03-01.png?alt=media&amp;token=666f3498-425d-4d97-94da-1c61de56c06b" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Configurar el mapeo manual

Al configurar el mapeo manual de registros, debe seleccionar los campos que se usarán en la clave de mapeo de registros. La selección de campos es importante para el éxito del mapeo manual de registros.

{% hint style="warning" %}

#### 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.
  {% endhint %}

1. Haga clic en el **mapeo de registros** desplegable.
2. Seleccione **Manual**.

   <div align="left"><figure><img src="https://626430605-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FRWws4zhpAi4IMf5uX7Sd%2FSettingObjectRecordMapping-S04-01.png?alt=media&amp;token=979131ad-8859-44ac-8554-e32a8bae3542" alt="" width="563"><figcaption></figcaption></figure></div>
3. Seleccione un campo de la **Campos disponibles** columna para incluirlo en la clave de mapeo de registros.
4. Haga clic en el **Flecha** hacia la derecha para mover el campo seleccionado a la **Campos seleccionados** columna.

   <div align="left"><figure><img src="https://626430605-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FkqGWHTndflh0fVXiOs07%2FSettingObjectRecordMapping-S04-02.png?alt=media&amp;token=d90ed7d5-dddf-4c87-bb1a-f8078c9f620c" alt="" width="563"><figcaption></figcaption></figure></div>
5. El campo ahora se usará como parte de la clave de mapeo de registros para este objeto.
6. Repita este proceso para agregar cada campo que desee incluir en la clave de mapeo de registros.
7. Haga clic **Guardar**.

   <div align="left"><figure><img src="https://626430605-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FBDJlyDXuWrl5I1xjiahd%2FSettingObjectRecordMapping-S04-04.png?alt=media&amp;token=0bc979cf-b635-4ae9-94fc-a1fe9d03f709" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Los campos se pueden quitar de la clave de mapeo de registros mediante un proceso similar al utilizado para agregarlos.

1. Seleccione un campo en la **Campos seleccionados**.
2. Haga clic en el **Flecha** hacia la izquierda.
   {% endhint %}
   {% endstep %}

{% step %}

### Guardar plantilla

Una vez que haya agregado el mapeo de registros a tantos objetos como sea necesario, guarde la plantilla.

1. Haga clic **Guardar plantilla** para guardar sus cambios.
   {% endstep %}
   {% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flosum.com/data-migrator/data-migrator-es/plantillas/disenador-de-plantillas/configurar-el-mapeo-de-registros-de-objetos.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
