Codificación Base64 para Múltiples Archivos Binarios Mediante Código Personalizado - Flujo de trabajo de n8n

Desarrolladores que necesitan subir varios archivos a una API que exige estrictamente la codificación Base64.
Usuarios de n8n que necesitan manipulación avanzada de archivos binarios más allá de los nodos estándar de n8n.
Especialistas en automatización que buscan plantillas robustas de n8n para tareas de conversión de archivos.
Cualquier persona interesada en aprovechar el poder del nodo Código de n8n para el procesamiento de datos.

Esta plantilla de flujo de trabajo especializada de n8n aborda un desafío común de integración: procesar archivos comprimidos que contienen múltiples archivos binarios y convertirlos a cadenas Base64 para su consumo por parte de la API. Si bien los nodos estándar de n8n manejan bien la codificación Base64 de archivos únicos, el procesamiento por lotes requiere lógica personalizada. Este flujo de trabajo de n8n proporciona una solución robusta al combinar la descarga de archivos, la descompresión y un nodo n8n cuidadosamente diseñado que ejecuta JavaScript para iterar sobre los binarios extraídos y realizar la codificación necesaria. Si maneja frecuentemente datos comprimidos y necesita transformar el contenido de manera eficiente, esta plantilla de n8n es esencial para su conjunto de herramientas.

Todo el proceso se inicia mediante un sencillo disparador manual de n8n, lo que facilita su prueba y despliegue.

1. Inicio: El disparador de n8n 'Al hacer clic en 'Ejecutar flujo de trabajo'' comienza la ejecución de la automatización.


2. Descarga: Un nodo n8n de Solicitud HTTP descarga un archivo ZIP de ejemplo que contiene los archivos a procesar.


3. Descomprimir: El nodo n8n de Compresión (Descomprimir) posterior procesa automáticamente el archivo binario descargado, expandiendo el contenido y generando un elemento separado por cada archivo encontrado dentro del ZIP, cada uno con su propia propiedad binaria.


4. Codificar (Código Personalizado): La funcionalidad principal reside en el nodo Código n8n 'Codificar a base64'. Este nodo utiliza JavaScript personalizado para iterar sobre los múltiples elementos binarios creados por el nodo Descomprimir de n8n. Para cada elemento, utiliza la función integrada this.helpers.getBinaryDataBuffer para recuperar de forma segura los datos del archivo como un búfer. Luego, este búfer se convierte en una cadena Base64, y la salida se estructura ordenadamente para los nodos n8n subsiguientes, proporcionando la ruta del archivo y los datos codificados.

Para empezar a utilizar esta potente plantilla de flujo de trabajo de n8n, siga estos pasos:

1. Importar: Copie los datos JSON proporcionados y navegue hasta su instancia de n8n.


2. Haga clic en 'Nuevo' y luego en 'Importar desde JSON' y pegue el código.


3. Sin Credenciales: Este flujo de trabajo específico de n8n no requiere credenciales externas ya que utiliza URL públicas y nodos internos de n8n (Solicitud HTTP, Código, Disparador Manual).


4. Ejecución: Haga clic en el botón del disparador de n8n 'Ejecutar Flujo de Trabajo' para probar el proceso inmediatamente.


5. Personalización: Modifique el nodo n8n 'Descargar ZIP del sitio de demostración de n8n' para que apunte a la URL de origen de su archivo ZIP específico y así adaptar el flujo de trabajo de n8n a sus necesidades. Si la API de destino requiere una estructura de salida diferente, ajuste el JavaScript dentro del nodo Código de n8n en consecuencia.

Este flujo de trabajo de n8n se basa en tres nodos principales de n8n para lograr el procesamiento y la conversión de archivos:

Al hacer clic en 'Ejecutar flujo de trabajo' (Disparador Manual de n8n)
Función: Actúa como punto de partida para este flujo de trabajo de n8n bajo demanda.
Configuración Clave: No se requiere configuración; sirve como un sencillo disparador manual de n8n.

Descargar ZIP del sitio de demostración de n8n (Nodo Solicitud HTTP de n8n)
Función: Descarga el archivo ZIP fuente desde un repositorio remoto de GitHub. Esto proporciona los datos binarios necesarios para el procesamiento.
Configuración Clave: La URL se establece en https://github.com/n8n-io/n8n-demo-website/archive/refs/heads/main.zip. El formato de respuesta es fundamental, debe establecerse en file para manejar los datos como binarios.

Descomprimir (Nodo de Compresión de n8n)
Función: Descomprime el archivo ZIP descargado. Esto es crucial porque convierte un elemento de entrada (el ZIP) en múltiples elementos de salida (los archivos dentro del ZIP), preparándolos para el procesamiento por lotes por el siguiente nodo n8n.
Configuración Clave: Utiliza la configuración predeterminada para la descompresión.

Codificar a base64 (Nodo Código de n8n)
Función: Itera sobre todos los archivos binarios generados por el nodo Descomprimir de n8n. Utiliza JavaScript personalizado y las utilidades de n8n (this.helpers.getBinaryDataBuffer) para recuperar el búfer sin procesar de cada archivo y luego convierte ese búfer en una cadena Base64, compilando los resultados en una matriz JSON estructurada.
Configuración Clave: Contiene la lógica personalizada para la codificación Base64, asegurando el procesamiento eficiente de múltiples archivos binarios en un solo paso dentro del flujo de trabajo de n8n.