Saltearse al contenido

Data Mapping

Este modulo transforma un objeto de datos de entrada aplicando un mapa de correspondencia campo a campo definido en un archivo JSON de configuracion. Lee el archivo de mapping desde la carpeta config/ del proyecto, donde cada clave del mapping representa el nombre del campo de salida y el valor representa el nombre del campo de entrada. Es una forma simple y declarativa de renombrar y reorganizar campos de un objeto. Util para adaptar datos entre diferentes formatos de API o para normalizar estructuras de datos.

ParametroTipoRequeridoDescripcion
mappingFilestringSiNombre del archivo JSON de mapping ubicado en la carpeta config/. Ejemplo: order_mapping.json
mapschemastringNoEsquema de mapping alternativo (uso interno).
{
"nextModule": "siguiente_modulo",
"data": {
"nombre": "Juan Perez",
"correo": "juan@email.com",
"telefono": "123456789"
}
}
{
"mappingFile": "contacto_mapping.json"
}

Donde config/contacto_mapping.json contiene:

{
"nombre": "full_name",
"correo": "email",
"telefono": "phone"
}
  • El archivo de mapping debe estar en la carpeta config/ del proyecto
  • Si un campo del mapping no existe en los datos de entrada, se asigna null
  • Es un mapping unidireccional y plano (no soporta estructuras anidadas)
  • Para transformaciones mas complejas con expresiones, usar el modulo dataMapper
  • dataMapper (mapping avanzado con expresiones)
  • dataTransform (transformacion con esquema)
  • dataset (generacion de datasets)