Elysia Tools
Navegação
Workflow Playbook
Um fluxo focado em uma pasta de trabalho ou uma planilha: selecione um intervalo, mapeie cabeçalhos, converta a tabela limpa para JSON e revise fonte, tipos, nulos e duplicatas sem avançar para ingestão em lote ou entrega ao warehouse.
Temas
Este fluxo atende analistas, equipes de operações e desenvolvedores que preparam uma única pasta de trabalho ou planilha para um consumidor JSON. Preserve uma cópia intacta e produza um array JSON revisado ou uma prévia de intervalo delimitado. Ingestão em lote, entrada por API ou S3, união de várias pastas e entrega em SQL, Parquet ou warehouse não fazem parte deste caminho.
Anote o nome da planilha, o intervalo A1 ou nomeado, a linha de cabeçalho e a quantidade esperada de linhas. Use xlsx-range-extractor em modo records quando cada linha deve virar um objeto, ou cell_objects quando endereços e coordenadas forem evidências. Só remova vazios se eles não tiverem significado para a revisão. O limite é importante: o mapeador e o transformador leem a planilha, não um intervalo arbitrário.
Em uma cópia de trabalho, use xlsx-column-mapper com a linha de cabeçalho real. Coloque nomes canônicos em renameMapJson, aliases em aliasMapJson, a sequência desejada em reorderColumns e remoções intencionais em removeColumns. Decida keepUnmapped antes de executar. Confira a nova linha de cabeçalho e mantenha o original; a saída do mapeamento é um novo XLSX.
Use xlsx-json-transformer no modo xlsx_to_json quando a planilha mapeada tiver os cabeçalhos na primeira linha. Mantenha estáveis o nome da planilha e o separador de caminhos. restoreTypes pode converter textos parecidos com número, booleano, null, array ou objeto em outros valores JSON, enquanto células vazias são omitidas no modo XLSX para JSON. Compare linhas representativas, campos, tipos, vazios e chaves duplicadas. As ferramentas não decidem as regras de duplicata nem os tipos de negócio.
Aceite somente um resultado com todas as diferenças explicadas e sem introduzir requisitos de lotes, entradas externas, várias pastas, SQL, Parquet ou warehouse nesta entrega de uma única pasta.
Guia de fluxo de trabalho
Faça uma cópia de trabalho, registre a planilha e seus limites e execute xlsx-range-extractor. Use records para uma prévia JSON em formato de linhas ou cell_objects para manter evidências de linha, coluna e endereço. Se o intervalo for uma seção de uma planilha maior, não apresente as outras ferramentas como se aplicassem esse intervalo automaticamente.
Execute xlsx-column-mapper na cópia com o headerRow correto. Aplique regras explícitas de renomeação ou alias, fixe a ordem canônica, remova apenas colunas documentadas e decida se os campos não mapeados devem permanecer. Confira os cabeçalhos do XLSX gerado antes de continuar.
Execute xlsx-json-transformer com mode xlsx_to_json sobre a planilha mapeada. Selecione o nome da planilha, mantenha consistente o separador de caminhos das chaves aninhadas e use restoreTypes apenas quando esses textos devem ser interpretados. Espere um array de objetos de linha; células vazias não são emitidas nessa direção.
Use xlsx-range-extractor com um intervalo A1 ou nomeado. Escolha records para obter objetos por linha a partir dos cabeçalhos ou cell_objects quando os endereços forem importantes. O mapeador e o transformador leem uma planilha, não um intervalo arbitrário; se o intervalo for apenas parte de uma planilha maior, use a saída do extrator como caminho de inspeção ou de registros final.
Use xlsx-column-mapper quando a tabela puder ser tratada como uma única planilha. Configure headerRow, aplique nomes canônicos com renameMapJson ou aliasMapJson, defina a ordem com reorderColumns, remova apenas colunas documentadas com removeColumns e escolha keepUnmapped conforme o contrato. Mantenha a fonte separada, pois a ferramenta grava um novo XLSX.
Use xlsx-json-transformer no modo xlsx_to_json quando a planilha mapeada tiver cabeçalhos na primeira linha. Escolha restoreTypes com cuidado: textos parecidos com número, booleano, null, array ou objeto podem ser interpretados. Nessa direção, células vazias são omitidas, e a detecção de duplicatas continua sendo uma revisão contra a chave ou a regra de linha esperada.
Revise novamente as linhas selecionadas e os cabeçalhos mapeados usando as três saídas. Compare quantidade de linhas, campos, valores representativos, tratamento de vazios e chaves duplicadas; preserve a fonte e o XLSX intermediário e pare ou documente qualquer diferença sem explicação.