Conversión automática de tipos de datos
Nota de alcance: reconstrucción editorial basada en la documentación oficial, capturada el 2026-05-15. Describe esa versión histórica; no acredita funciones, límites ni disponibilidad actuales. Consulta la fuente vigente antes de configurar un flujo nuevo.
La conversión automática de tipos ocurre cuando un campo espera un tipo de dato y recibe otro. Puede facilitar un mapeo, pero también ocultar una diferencia entre lo que envías y lo que el módulo utiliza. Las reglas siguientes resumen la captura oficial indicada arriba.
Matrices y colecciones
- Si se espera una matriz y se recibe una matriz, se conserva. Para otro tipo, la fuente describe la creación de una matriz cuyo único elemento es el valor recibido.
- Si se espera una colección, se acepta una colección; otros tipos producen un error de validación.
Un texto que visualmente contiene JSON no es necesariamente una colección. Convierte o analiza el contenido explícitamente cuando el campo requiera una estructura.
Booleanos
| Valor recibido | Conversión documentada |
|---|---|
| Booleano | Se conserva |
| Número, incluido 0 | Sí |
Texto vacío o texto false |
No |
| Otro texto | Sí |
| Otros tipos | Sí cuando el valor existe y no es nulo |
La regla del número 0 es especialmente importante: no presupongas el comportamiento de otro lenguaje de programación. Si tu regla de negocio es «mayor que cero», expresa esa comparación en vez de confiar en una conversión implícita.
Datos binarios
Si el campo espera un buffer, un buffer con la codificación correcta se conserva. Si la codificación difiere, Make intenta convertirlo y puede devolver un error si no admite esa conversión.
El texto se codifica como datos binarios; la captura indica UTF-8 como opción cuando no se especifica otra. Booleanos, números y fechas se convierten primero a texto; las fechas se representan en ISO 8601. Otros tipos pueden producir errores de validación.
Fechas y horas
Para una fecha, un valor de tipo fecha se conserva. El texto se intenta interpretar y debe contener día, mes y año; puede incluir hora y zona horaria. Si no hay zona explícita, intervienen los ajustes correspondientes.
Un número se interpreta como milisegundos desde el 1 de enero de 1970 UTC, no como segundos. Confundir esas unidades cambia radicalmente la fecha.
La fuente incluye formatos como 2016-06-20T17:26:44.356Z y 2016-06-20. Para evitar ambigüedad entre día y mes, utiliza un formato explícito en tus datos de prueba.
Cuando se espera una hora, el texto se intenta convertir a horas, minutos y segundos. Una conversión fallida produce un error de validación.
Números
Un número se conserva. Si se recibe texto, Make intenta convertirlo a número; si falla, devuelve un error. Los demás tipos no se aceptan mediante esta conversión. Comprueba los separadores decimales y de miles antes de mapear importes.
Texto
| Tipo recibido | Resultado documentado |
|---|---|
| Texto | Sin cambios |
| Número o booleano | Representación textual |
| Fecha | Texto ISO 8601 |
| Colección | Cadena JSON |
| Matriz de colecciones | Conversiones separadas por comas |
| Otra matriz | Conversión si se admite; en caso contrario, error |
| Buffer | Texto si dispone de codificación; en caso contrario, error |
Cómo comprobar un mapeo
Prueba al menos un valor normal, uno vacío y uno del tipo incorrecto. Inspecciona la entrada efectiva del módulo, no solo cómo se ve el dato en el panel. Para identificadores, fechas e importes, es preferible una transformación explícita a depender de una conversión inesperada.