Elysia Tools
Navegación
Workflow Playbook
Flujo acotado para un libro o una hoja: selecciona un rango, mapea encabezados, convierte la tabla limpia a JSON y revisa fuente, tipos, nulos y duplicados sin convertirlo en una ingesta por lotes ni una entrega al warehouse.
Temas
Este flujo sirve a analistas, equipos de operaciones y desarrolladores que preparan un solo libro o una sola hoja para un consumidor JSON. Conserva una copia intacta y produce un array JSON revisado o una vista de rango delimitado. La ingesta por lotes, la entrada por API o S3, la unión de varios libros y la entrega a SQL, Parquet o warehouse no forman parte de este camino.
Anota el nombre de la hoja, el rango A1 o nombrado, la fila de encabezados y el número esperado de filas de datos. Usa xlsx-range-extractor en modo records cuando cada fila deba convertirse en un objeto, o en modo cell_objects cuando las direcciones sean evidencia. Activa la eliminación de blancos solo si esos blancos no tienen significado para la revisión. El límite importa: el mapeador y el transformador leen la hoja completa, no un rango arbitrario.
En una copia de trabajo, usa xlsx-column-mapper con la fila de encabezados real. Pon los nombres canónicos en renameMapJson, los alias en aliasMapJson, la secuencia deseada en reorderColumns y las eliminaciones intencionadas en removeColumns. Decide keepUnmapped antes de ejecutarlo. Revisa la nueva fila de encabezados y conserva el archivo original; la salida del mapeo es un XLSX nuevo.
Usa xlsx-json-transformer en modo xlsx_to_json cuando la hoja mapeada tenga los encabezados en la primera fila. Mantén constantes el nombre de la hoja y el separador de rutas. restoreTypes puede convertir texto con aspecto de número, booleano, null, array u objeto en otros valores JSON, y los blancos se omiten en modo XLSX a JSON. Compara filas representativas, campos, tipos, blancos y claves duplicadas. Las herramientas no deciden por ti las reglas de duplicados ni los tipos de negocio.
Acepta solo un resultado cuyas diferencias estén explicadas y que no haya introducido requisitos de lotes, entradas externas, varios libros, SQL, Parquet o warehouse en esta entrega de un solo libro.
Guía de flujo de trabajo
Crea una copia de trabajo, registra la hoja y sus límites y ejecuta xlsx-range-extractor. Usa records para una vista JSON de filas u objetos y cell_objects para conservar pruebas de fila, columna y dirección. Si el rango es una sección de una hoja más grande, no presentes las otras herramientas como si aplicaran ese rango automáticamente.
Ejecuta xlsx-column-mapper en la copia con el headerRow correcto. Aplica reglas explícitas de renombrado o alias, fija el orden canónico, elimina únicamente columnas documentadas y decide si conservar los campos sin mapear. Comprueba la fila de encabezados del XLSX generado antes de continuar.
Ejecuta xlsx-json-transformer con mode xlsx_to_json sobre la hoja mapeada. Selecciona el nombre de hoja, mantén estable el separador de rutas de las claves anidadas y activa restoreTypes solo si el consumidor debe interpretar ese texto. Espera un array de objetos de fila; los blancos no se emiten en esta dirección.
Usa xlsx-range-extractor con un rango A1 o nombrado. Elige records para obtener objetos por fila basados en encabezados o cell_objects cuando importen las direcciones. El mapeador y el transformador leen una hoja, no un rango arbitrario; si el rango es solo una parte de una hoja mayor, usa el resultado del extractor para inspección o como ruta final de registros.
Usa xlsx-column-mapper cuando la tabla pueda tratarse como una sola hoja. Configura headerRow, aplica nombres canónicos con renameMapJson o aliasMapJson, define el orden con reorderColumns, elimina solo columnas documentadas con removeColumns y decide keepUnmapped según el contrato. Conserva aparte el original porque la herramienta escribe un XLSX nuevo.
Usa xlsx-json-transformer en modo xlsx_to_json cuando la hoja mapeada tenga los encabezados en la primera fila. Elige restoreTypes con cuidado: puede interpretar texto con aspecto de número, booleano, null, array u objeto. En esta dirección los blancos se omiten y la detección de duplicados sigue siendo una revisión contra la clave o la fila esperada.
Vuelve a revisar las filas seleccionadas y los encabezados mapeados con las tres salidas. Compara cantidad de filas, campos, valores representativos, blancos y claves duplicadas; conserva la fuente y el XLSX intermedio y detén o documenta cualquier diferencia inexplicada.