> 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-pt-br/modelos/designer-de-modelos/definindo-o-mapeamento-de-registros-do-objeto.md).
# Definindo o mapeamento de registros do objeto
##  Visão geral
Este artigo explica como habilitar o mapeamento de registros para objetos em um modelo. O mapeamento de registros é नियंत्रalado separadamente para cada objeto em cada modelo. Dois métodos de mapeamento de registros estão disponíveis: Automático e Manual. Você não é obrigado a usar o mesmo método de mapeamento de registros para cada objeto em um modelo. As instruções abaixo explicam como configurar cada método.
{% hint style="info" %}
#### Como o mapeamento de registros funciona
Antes de usar o mapeamento de registros, é importante entender como cada método funciona e suas limitações. Se você ainda não fez isso, revise as informações no artigo a seguir.
* [Como o mapeamento de registros funciona](/data-migrator/data-migrator-pt-br/modelos/migracao/como-o-mapeamento-de-registros-funciona.md)
{% endhint %}
## Definir mapeamento de registros
{% stepper %}
{% step %}
### Selecionar modelo
1. Clique em **Modelos** no menu da barra lateral esquerda.
2. Clique no modelo para adicionar mapeamentos de registros.
{% endstep %}
{% step %}
### Adicionar mapeamento ao objeto
Habilite e configure o mapeamento de registros para cada objeto em que deseja usá-lo.
1. Clique no objeto para o qual deseja configurar o mapeamento de registros.
2. Clique no **Configurações** aba.
3. Clique em **Adicionar mapeamento** na seção de **Mapeamento de registros** seção.
{% endstep %}
{% step %}
### Configurar mapeamento automático
{% hint style="warning" %}
#### 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.
{% endhint %}
1. Clique no **Mapeamento de registros** menu suspenso.
2. Selecione **Automático**.
3. Clique em **Salvar**.
{% endstep %}
{% step %}
### Configurar mapeamento manual
Ao configurar o mapeamento manual de registros, você deve selecionar os campos a serem usados na chave de mapeamento de registros. A seleção dos campos é importante para o sucesso do mapeamento manual de registros.
{% hint style="warning" %}
#### 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.
{% endhint %}
1. Clique no **Mapeamento de registros** menu suspenso.
2. Selecione **Manual**.
3. Selecione um campo da coluna de **Campos disponíveis** para incluir na chave de mapeamento de registros.
4. Clique no **Seta para a direita** para mover o campo selecionado para a coluna de **Campos selecionados** coluna.
5. O campo agora será usado como parte da chave de mapeamento de registros para este objeto.
6. Repita este processo para adicionar cada campo que você deseja incluir na chave de mapeamento de registros.
7. Clique em **Salvar**.
{% hint style="info" %}
Os campos podem ser removidos da chave de mapeamento de registros usando um processo semelhante ao usado para adicioná-los.
1. Selecione um campo na **Campos selecionados**.
2. Clique no **esquerda** seta.
{% endhint %}
{% endstep %}
{% step %}
### Salvar modelo
Depois de adicionar o mapeamento de registros a quantos objetos forem necessários, salve o modelo.
1. Clique em **Salvar modelo** para salvar suas alterações.
{% 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-pt-br/modelos/designer-de-modelos/definindo-o-mapeamento-de-registros-do-objeto.md?ask=&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.
