Sheet Manager (n8n Custom Node)

Sheet Manager es un nodo personalizado para n8n que permite crear, leer, editar, visualizar y borrar archivos .xlsx directamente desde tus flujos de trabajo. Está construido usando exceljs, funciona sin credenciales y opera sobre rutas relativas a un directorio de trabajo (/data/sheet-manager por defecto).

Características principales

• Crear archivos XLSX con encabezados personalizados y filas dinámicas.
• Agregar datos a hojas existentes sin sobrescribir (modo append).
• Visualizar contenido de hojas específicas como JSON y archivo binario.
• Editar filas específicas en función de una condición.
• Eliminar archivos XLSX fácilmente.
• Leer archivo completo como binario para descargar o reenviar.

Instalación

Este nodo es parte de un desarrollo personalizado. Asegúrate de colocarlo en tu directorio de nodos personalizados en n8n:

~/.n8n/custom-nodes/

Parámetros del Nodo

Campo	Descripción	Operaciones disponibles
Operación	Define la acción a realizar (view, create, edit, etc)	Todos
Archivo (.xlsx)	Ruta al archivo. Si no es absoluta, se asume dentro de /data/sheet-manager	Todos
Nombre del Archivo	Reemplaza el nombre del archivo en la ruta	create
Hoja	Nombre de la hoja a procesar	view, create, edit
Modo Append	Agrega datos al final en lugar de sobrescribir	create
Encabezados personalizados	Define manualmente los encabezados de columna	create
Valor por Defecto para Vacíos	Se usa cuando falta una propiedad en un objeto	create
Datos JSON	Array de objetos que representan filas	create
Columna de Condición	Columna para buscar la fila a modificar	edit
Valor de Condición	Valor exacto a buscar en la columna de condición	edit
Columna a Modificar	Columna a cambiar (si se omite, se usa la de condición)	edit
Nuevo Valor	Valor nuevo a asignar	edit

{
  "operation": "create",
  "filePath": "reporte.xlsx",
  "sheetName": "Ventas",
  "append": true,
  "headers": {
    "headersValues": [{ "header": "Producto" }, { "header": "Cantidad" }]
  },
  "defaultFillValue": "N/A",
  "data": [
    { "Producto": "Manzana", "Cantidad": 10 },
    { "Producto": "Pera" }
  ]
}

Consideraciones

• Si una hoja no existe en create, se crea automáticamente.
• En edit, la búsqueda es exacta (pero case-insensitive).
• El orden de las columnas no afecta el funcionamiento.
• Las hojas deben tener encabezados en la primera fila.

Requisitos

• Node.js >= 18
• n8n instalado localmente o en entorno controlado
• Dependencia: exceljs

Autor

Desarrollado por Elimeleth

Correo: [email protected]

Optimizado para flujos de trabajo robustos y dinámicos.