Elysia Tools
Навигация
Workflow Playbook
Узкий процесс для одной книги или одного листа: выбрать диапазон, сопоставить заголовки, преобразовать очищенную таблицу в JSON и проверить источник, типы, null и дубликаты, не переходя к пакетному приёму или передаче в хранилище.
Темы
Этот процесс предназначен для аналитиков, операционных команд и разработчиков, которые готовят одну книгу или один лист для потребителя JSON. Сохраните неизменённую копию и создайте проверенный JSON-массив либо просмотр ограниченного диапазона. Пакетный приём, вход через API или S3, объединение книг и передача в SQL, Parquet или хранилище сюда не входят.
Запишите имя листа, диапазон A1 или именованный диапазон, строку заголовков и ожидаемое число строк. Используйте xlsx-range-extractor в режиме records, когда каждая строка должна стать объектом, или cell_objects, когда адреса служат доказательством. Удаляйте пустые ячейки только если они не важны для проверки. Граница существенна: mapper и transformer читают лист, а не произвольный диапазон.
На рабочей копии запустите xlsx-column-mapper с фактической строкой заголовков. Поместите канонические имена в renameMapJson, псевдонимы в aliasMapJson, нужную последовательность в reorderColumns, а намеренные удаления в removeColumns. До запуска решите, каким будет keepUnmapped. Проверьте новую строку заголовков и сохраните исходник: результат сопоставления является новым XLSX.
Используйте xlsx-json-transformer в режиме xlsx_to_json, когда заголовки сопоставленного листа находятся в первой строке. Не меняйте имя листа и разделитель путей. restoreTypes может превратить текст, похожий на число, boolean, null, массив или объект, в другое JSON-значение; при преобразовании XLSX в JSON пустые ячейки пропускаются. Сравните показательные строки, поля, типы, пустые значения и дублирующиеся ключи. Инструменты не принимают за вас решения о дубликатах и бизнес-типах.
Принимайте результат только после объяснения каждого расхождения и проверки, что требования пакетной обработки, внешнего входа, нескольких книг, SQL, Parquet или хранилища не проникли в передачу одной книги.
Руководство по рабочему процессу
Создайте рабочую копию, запишите лист и границы, затем запустите xlsx-range-extractor. Используйте records для просмотра JSON в виде строк или cell_objects, чтобы сохранить свидетельства о строках, столбцах и адресах. Если диапазон является частью большого листа, не представляйте другие инструменты как автоматически работающие только в этом диапазоне.
Запустите xlsx-column-mapper на копии с правильным headerRow. Примените явные правила переименования или псевдонимов, задайте канонический порядок, удаляйте только документированные столбцы и решите, сохранять ли несопоставленные поля. Перед продолжением проверьте заголовки созданного XLSX.
Запустите xlsx-json-transformer с mode xlsx_to_json для сопоставленного листа. Выберите имя листа, сохраняйте единый разделитель путей вложенных ключей и включайте restoreTypes только при необходимости интерпретировать похожий на тип текст. Результатом ожидается массив объектов строк; в этом направлении пустые ячейки не выдаются.
Используйте xlsx-range-extractor с диапазоном A1 или именованным диапазоном. Выберите records для объектов строк по заголовкам или cell_objects, если важны адреса ячеек. Mapper и transformer читают лист, а не произвольный диапазон; если нужен только фрагмент большого листа, используйте результат extractor как путь проверки или как итоговый набор записей.
Используйте xlsx-column-mapper, если таблицу можно обработать как один лист. Задайте headerRow, примените канонические имена через renameMapJson или aliasMapJson, порядок через reorderColumns, удаляйте только документированные столбцы через removeColumns и выберите keepUnmapped по контракту. Сохраняйте исходник отдельно: инструмент записывает новый XLSX.
Используйте xlsx-json-transformer в режиме xlsx_to_json, когда заголовки сопоставленного листа находятся в первой строке. Осторожно выбирайте restoreTypes: текст, похожий на число, boolean, null, массив или объект, может быть интерпретирован. В этом направлении пустые ячейки пропускаются, а проверка дубликатов по-прежнему выполняется сравнением с ожидаемым ключом или правилом строки.
Повторно проверьте выбранные строки и сопоставленные заголовки по результатам всех трёх инструментов. Сравните число строк, поля, показательные значения, обработку пустых ячеек и дублирующиеся ключи; сохраните источник и промежуточный XLSX, а необъяснимое расхождение остановите или зафиксируйте как исключение.
Format Conversion
Переименовывает/переставляет/удаляет столбцы по правилам