Mapeamento de dados

Definição

Mapeamento de dados estabelece a correspondência entre campos e estruturas de origem e destino. O mapeamento identifica de onde sai cada informação e onde ela deve chegar no formato esperado. O resultado é uma peça com a forma que o destino entende, sem alterar ainda o conteúdo que cada campo carrega.

Nomes, aninhamento e ausência

A correspondência precisa tratar nomes diferentes entre os sistemas, campos aninhados e valores ausentes. Um campo com nome distinto recebe o valor do campo correspondente, e um campo interno exige o caminho completo da estrutura. Quando o valor de origem não existe, o mapeamento precisa de um comportamento definido, como um valor padrão ou um campo vazio.

const destino = {
name: origem.nome_completo,
email: origem.contato.email
}

Mapear e transformar

O mapeamento define a correspondência, e alterar formato ou conteúdo pode exigir uma transformação adicional. Quando o destino espera um tipo diferente ou uma estrutura reorganizada, o fluxo combina as duas etapas. O mapeamento mostra onde cada valor vai, e a transformação ajusta como esse valor chega.

Campo ausente e verificação

A falha comum é mapear um campo que não existe na origem: o item é entregue ao destino com o valor vazio ou a etapa falha sem explicação clara. Para verificar, inspecione o item de saída do mapeamento e confira se todos os campos do destino receberam o valor esperado. Quando um campo do destino aparece vazio e a origem não tinha o valor correspondente, o mapeamento precisa prever essa ausência, e a comparação entre a entrada e a saída mostra qual correspondência ficou sem origem.

Aplicação na formação

n8n Experts

Na formação n8n Experts, o mapeamento define qual campo da origem alimenta cada campo do destino.

Conhecer a formação →