O que é Transformação de dados?

O que é transformação de dados

Transformação de dados é a alteração do formato, da estrutura ou dos valores recebidos para atender a uma finalidade definida. Uma integração pode converter uma data, calcular a duração em outra unidade ou reunir campos separados em um objeto aceito pelo destino.

O mapeamento identifica de onde vem cada informação e onde ela será usada. A transformação define qual alteração será aplicada durante esse percurso, e as duas tarefas podem acontecer na mesma etapa do workflow.

O significado vem antes da conversão

Um texto formado por algarismos não é necessariamente uma quantidade. O código 00127 pode identificar uma inscrição e precisar conservar os zeros iniciais, enquanto o texto 127 pode representar uma quantidade que será usada em cálculos.

Converter ambos automaticamente para número pode eliminar parte de um identificador. Antes de ajustar o tipo, confira o significado do campo e o contrato do destino para saber se a transformação preserva a informação necessária.

Datas precisam de formato e, quando aplicável, fuso

A data 01/03/2026 representa primeiro de março quando a origem usa dia, mês e ano. Interpretá-la como mês, dia e ano produziria três de janeiro, embora ambas as saídas pareçam datas válidas.

Horários acrescentam outra necessidade de interpretação. Um instante com fuso pode ser convertido para outra referência, enquanto uma data de aniversário ou uma data de calendário não deve ganhar um deslocamento de horário apenas porque a ferramenta oferece esse recurso.

Números e unidades exigem leitura completa

Separadores decimais e de milhar variam conforme o formato recebido. Substituir toda vírgula por ponto pode funcionar para uma amostra simples e falhar quando a origem envia um valor como 1.234,50, que exige uma interpretação consistente do formato.

Também confira se o destino espera a mesma unidade. Uma duração recebida como noventa segundos e enviada para um campo em minutos precisa representar um minuto e meio, enquanto apenas copiar o número noventa alteraria o significado.

Funções de conversão podem aceitar apenas o início de um texto. Em JavaScript, parseFloat pode extrair um número e ignorar caracteres finais, por isso obter um resultado numérico não demonstra que a entrada inteira atendia ao formato exigido.

A estrutura pode mudar sem perder a associação

Uma transformação pode dividir uma lista, agrupar resultados ou compor um campo de nome completo. Esses ajustes devem preservar os identificadores necessários para relacionar a saída ao item correto, especialmente quando a quantidade ou a ordem dos itens muda.

No n8n, componentes como Edit Fields e Code oferecem formas diferentes de preparar essa saída. Escolha a etapa conforme a alteração necessária e confira também quais campos originais continuam disponíveis depois dela.

A validação acompanha a transformação

Verifique a entrada antes da conversão e confira o resultado depois dela. Um valor ausente pode exigir interrupção ou um padrão explicitamente permitido, enquanto um valor fora da faixa aceita precisa de tratamento mesmo que seu tipo esteja correto.

Uma saída em JSON válido ainda pode conter uma data errada ou uma quantidade na unidade incorreta. A aceitação do formato pelo destino não substitui a comparação com o significado previsto para cada campo.

Como testar a conversão

Use amostras que cubram identificadores com zeros iniciais, formatos de data ambíguos, campos sem valor e números com separadores. Para cada caso, registre a saída esperada e compare com o resultado produzido pela etapa.

Confira também uma entrada inválida para observar se ela é recusada ou convertida parcialmente. O teste deve demonstrar que a automação preserva as informações corretas e torna visíveis os casos que precisam de correção na origem.

Aplicação na formação

n8n Experts

A transformação converte os valores recebidos para a representação exigida pela próxima etapa da integração.

Conhecer a formação →