Dominio del Nodo Code: Procesamiento de Datos, Llamadas a API y Generación de Archivos - Flujo de trabajo de n8n

Desarrolladores y usuarios técnicos que buscan utilizar JavaScript personalizado dentro de n8n.
Usuarios que necesitan realizar transformaciones o agregaciones de datos complejas que no son posibles con los nodos estándar de n8n.
Especialistas en automatización que buscan comprender los diferentes modos de ejecución del nodo Code de n8n (Por Elemento vs. Una vez para todos).
Cualquiera que utilice plantillas de n8n para mejorar sus habilidades de scripting personalizado.

El nodo Code de n8n es posiblemente la herramienta más potente de la plataforma, ya que permite a los usuarios inyectar lógica personalizada de JavaScript directamente en su flujo de trabajo de n8n. Este flujo de trabajo específico de n8n actúa como una guía práctica, demostrando cuatro casos de uso críticos para el nodo Code de n8n:

1. Enriquecimiento de Elementos: Calcular nuevos campos (como la edad y el nombre completo) para elementos individuales.


2. Integración Externa: Realizar peticiones HTTP asíncronas a APIs externas usando los ayudantes integrados.


3. Agregación de Datos: Resumir todos los datos entrantes (por ejemplo, calcular la edad media).


4. Generación de Archivos: Crear datos binarios (como un informe CSV) a partir de la entrada JSON agregada.

Siguiendo esta plantilla de n8n, los usuarios pueden pasar rápidamente de la creación básica de flujos a la programación de automatizaciones potentes y dinámicas.

Este completo flujo de trabajo de n8n comienza con un disparador manual de n8n (Iniciar Tutorial) y procede a través de varias etapas lógicas, cada una destacando una faceta diferente del nodo Code de n8n:

1. Inicialización de Datos: El nodo 1. Datos de Muestra de n8n inicializa una lista de objetos de usuario. El nodo 2. Dividir Usuarios de n8n asegura que cada usuario se convierta en un elemento individual, preparando los datos para el procesamiento 'Por Elemento'.


2. Transformación Por Elemento (Local): El nodo Code 3. Procesar Cada Usuario de n8n se ejecuta para cada elemento de usuario. Calcula el fullName y la age precisos del usuario usando funciones de fecha de JavaScript.


3. Transformación Por Elemento (API Externa): El nodo Code 4. Obtener Datos Externos (Avanzado) de n8n continúa ejecutándose por elemento. Demuestra cómo usar this.helpers.httpRequest para llamar a una API externa (genderize.io) basándose en el nombre del usuario, enriqueciendo los datos con la probabilidad de género.


4. Agregación: El nodo Code 5. Calcular Edad Media de n8n cambia al modo 'Ejecutar Una Vez Para Todos los Elementos'. Utiliza la función $items() para acceder a todos los resultados de los pasos anteriores y calcula una única salida de resumen que contiene el recuento total de usuarios y la edad media. Esta es una función crucial del nodo de n8n cuando se trabaja con grandes conjuntos de datos.


5. Generación de Archivos (Experto): El nodo Code final 6. Crear un Archivo Binario (Experto) de n8n agrega los datos de nuevo, genera una cadena CSV y utiliza this.helpers.prepareBinaryData para convertir la cadena en un archivo de informe binario listo para usar dentro del flujo de trabajo de n8n.

Para instalar y probar este flujo de trabajo de n8n, sigue estos pasos:

1. Copiar el JSON: Copia el código JSON del flujo de trabajo de n8n proporcionado.


2. Importar a n8n: En tu instancia de n8n, haz clic en 'Nuevo' y selecciona 'Importar desde JSON'. Pega el código y haz clic en 'Importar'.


3. Revisar la Lógica: Examina las notas adhesivas adjuntas a los nodos Code de n8n para ver las explicaciones del código JavaScript y los modos de ejecución.


4. Ejecutar: Dado que el disparador inicial de n8n es un Disparador Manual, haz clic en 'Ejecutar Flujo de Trabajo' y luego en 'Iniciar Tutorial' para ejecutar el flujo de trabajo de n8n paso a paso.


5. Inspeccionar la Salida: Comprueba la salida de cada nodo Code de n8n para observar cómo cambia la estructura de los datos, desde elementos individuales hasta un único informe agregado que contiene tanto metadatos JSON como un archivo CSV binario. No se requieren credenciales externas para esta plantilla de n8n en particular.

Inicio del Tutorial (Disparador Manual): El punto de activación inicial de n8n para ejecutar este flujo de trabajo manualmente.
1. Datos de Muestra (Nodo Set de n8n): Inicializa el flujo de trabajo con una matriz de muestra de objetos de usuario, sirviendo como entrada para el tutorial.
2. Dividir Usuarios (Nodo Split Out de n8n): Nodo esencial de n8n que convierte el único elemento que contiene la matriz de usuarios en múltiples elementos individuales, permitiendo que los nodos Code de n8n subsiguientes los procesen uno por uno.
3. Procesar Cada Usuario (Nodo Code de n8n): Su función es calcular datos derivados (fullName, age) para el elemento actual. Configuración Clave: El modo está establecido en Ejecutar Una Vez Por Cada Elemento.
4. Obtener Datos Externos (Avanzado) (Nodo Code de n8n): Su función es demostrar operaciones asíncronas usando await this.helpers.httpRequest para obtener datos externos (predicción de género) para el usuario actual. Configuración Clave: El modo está establecido en Ejecutar Una Vez Por Cada Elemento.
5. Calcular Edad Media (Nodo Code de n8n): Su función es agregar datos de todos los elementos anteriores. Utiliza $items() y reduce de JavaScript para calcular la edad media. Configuración Clave: El modo está establecido en Ejecutar Una Vez Para Todos los Elementos.

• 6. Crear un Archivo Binario (Experto) (Nodo Code de n8n): Su función es generar un informe CSV a partir de los datos agregados y convertirlo en un archivo binario usando this.helpers.prepareBinaryData. Configuración Clave: El modo está establecido en Ejecutar Una Vez Para Todos los Elementos.