|
|
||
|---|---|---|
| .. | ||
| archive | ||
| README.md | ||
| alt-link_logo.svg | ||
| settings.toml | ||
| Данные_ВО.xlsx | ||
| Данные_КЖ_сети.xlsx | ||
| Данные_КЖ_электропроводки.xlsx | ||
| Данные_СО.xlsx | ||
| Шаблон_ВО.docx | ||
| Шаблон_КЖ.docx | ||
| Шаблон_СО.docx | ||
README.md
Обработка документов КЖ
Скрипт src/process_kj_docs.py формирует DOCX- и PDF-файлы кабельно-трубных журналов на основании данных из XLSX и шаблона Word.
Запуск
Запуск с параметрами по умолчанию:
python src\process_kj_docs.py --type электропроводки
По умолчанию используются:
Настройки: kj\settings.toml
Шаблон DOCX: kj\Шаблон_КЖ.docx
MDR: ref\mdr_reference.md
Каталог вывода: output\kj
Обязательный параметр --type задает ключ типа из kj\settings.toml. В этом файле для каждого типа описаны:
| Поле | Назначение |
|---|---|
type |
Ключ типа (значение --type) |
data_file |
Имя файла данных XLSX |
journal_name |
Название журнала (строка, с которой начинается наименование документа в MDR) |
template |
Имя файла шаблона DOCX в каталоге kj (по умолчанию Шаблон_КЖ.docx) |
section_rules |
Флаг true/false: правила оформления секций для типов ВО/СО (см. ниже). По умолчанию false |
Глобальное поле revision задает суффикс ревизии: <номер>_<ревизия> (по умолчанию C).
Файл данных ищется как kj\<data_file>. Шаблон по умолчанию kj\Шаблон_КЖ.docx от типа не зависит и может быть переопределен через --template.
Для запуска необходимы Python, openpyxl, python-docx, pywin32 и установленный Microsoft Word. Word используется для экспорта DOCX в PDF.
Источник XLSX
Скрипт читает активный лист книги.
Структура используемых колонок:
| Колонка | Назначение |
|---|---|
| B–L | Значения строк таблицы документа |
| M | Дисциплина (код дисциплины, например СПД, КСБ) |
| N | Шифр (шифр шкафа или номер документа) |
| O | Этап (номер титула, например 110900) |
По умолчанию обработка начинается со строки 4 (первые 3 строки — заголовки таблицы). Пустые строки пропускаются. Строки группируются по тройке:
(Дисциплина, Шифр, Этап)
Одна такая группа формирует один комплект DOCX/PDF.
Определение имени файла
Имя выходного документа (номер документа) определяется по колонке «Дисциплина»:
-
Если «Дисциплина» пустая — номер документа берется из колонки «Шифр» (N) как есть.
-
Если «Дисциплина» не пустая — в ней указана дисциплина, а в колонке «Шифр» указан шифр шкафа. Номер документа ищется в таблице «Список листов ОКРЧ из MDR» файла
ref/mdr_reference.md:- из «Дисциплины» берется первое слово как дисциплина;
- находится строка, в которой дисциплина совпадает, наименование документа начинается со строки
journal_nameизkj/settings.tomlи заканчивается шифром шкафа из колонки «Шифр»; - если колонка «Этап» (O) заполнена, номер титула в строке MDR должен совпадать с ней;
- номер документа берется из колонки «Номер документа» этой строки.
Если такая строка не найдена, выводится предупреждение, и документ для группы не генерируется.
Диапазон строк
Параметр --rows задает строки XLSX для обработки:
python src\process_kj_docs.py --type электропроводки --rows 4
Обработать только строку 4.
python src\process_kj_docs.py --type электропроводки --rows 4-30
Обработать строки с 4 по 30 включительно.
Если параметр не указан, обрабатываются строки с 4-й до последней.
Фильтр по дисциплинам
Параметр --codes позволяет обрабатывать только заданные коды из колонки M («Дисциплина»). Значения перечисляются через запятую:
python src\process_kj_docs.py --type электропроводки --codes КСБ,СПД
Совместно с диапазоном строк:
python src\process_kj_docs.py --type электропроводки --rows 4-30 --codes КСБ,СПД
Сравнение кодов выполняется без учета регистра. Если --codes не указан, обрабатываются все дисциплины.
Фильтр по документу
Параметр --doc позволяет обрабатывать только один документ с заданным номером из колонки N («Шифр»):
python src\process_kj_docs.py --type электропроводки --doc 01_B590.110900.1.6-СПД-КЖ08
Совместно с диапазоном строк:
python src\process_kj_docs.py --type электропроводки --rows 4-30 --doc 01_B590.110900.1.6-СПД-КЖ08
Если документ не найден, скрипт выводит ошибку. Если --doc не указан, обрабатываются все документы.
Поддерживаемые параметры командной строки
| Параметр | Назначение |
|---|---|
--type TYPE |
Ключ типа из kj/settings.toml (обязательный) |
--source PATH |
Путь к исходному XLSX, по умолчанию файл данных из настроек для типа |
--template PATH |
Путь к шаблону DOCX, по умолчанию kj\Шаблон_КЖ.docx |
--output-root PATH |
Корневой каталог результатов |
--mdr PATH |
Путь к mdr_reference.md |
--rows N |
Обработать одну строку XLSX |
--rows N-M |
Обработать диапазон строк XLSX |
--codes CODE,... |
Обрабатывать только указанные дисциплины (через запятую) |
--doc NUMBER |
Обрабатывать только один документ (колонка N, «Шифр») |
--dry-run |
Показать план без создания DOCX/PDF |
--extract |
Извлечь данные из docx файлов input/ в Excel (только типы во/со) |
--input PATH |
Каталог с входными docx для --extract (по умолчанию input) |
Пример предварительной проверки:
python src\process_kj_docs.py --type электропроводки --rows 4-30 --codes КСБ,СПД --dry-run
Извлечение данных из DOCX (--extract)
Режим извлекает строки из таблиц docx файлов каталога input/ и сохраняет
их в Excel-таблицу по аналогии с Данные_КЖ_электропроводки.xlsx:
python src\process_kj_docs.py --type во --extract --dry-run
python src\process_kj_docs.py --type во --extract
python src\process_kj_docs.py --type со --extract
Поддерживаются только типы во и со (файлы Данные_ВО.xlsx,
Данные_СО.xlsx из settings.toml). Параметр --source задает выходной
файл, --input — каталог с входными docx.
По имени файла определяется шифр, дисциплина и этап: имя вида
01_B590.110900.1.6-СПД-ВО01_C.docx преобразуется в номер документа
01/B590.110900.1.6-СПД-ВО01, который ищется в таблице
«Список листов ОКРЧ из MDR». Оттуда берутся дисциплина (колонка 3) и этап —
номер титула (колонка 1). В Excel первая строка каждого документа несет
M (дисциплина), N (полный номер документа), O (этап).
Пустые строки пропускаются. Строка, в которой есть наименование, но нет
номера позиции (например, Оборудование), помечается спецзначением ЗАГ
в колонке позиции (B). При генерации по шаблону такие строки отделяются
пустыми строками и выводятся без нумерации.
Если номер документа из имени файла не найден в MDR, файл пропускается
и выводится предупреждение. Строки с / в колонке N при генерации
сопоставляются с MDR напрямую по полному номеру.
Заполнение таблицы DOCX
Используется первая таблица шаблона Шаблон_КЖ.docx.
Заполнение начинается с четвертой строки таблицы шаблона. Если таблица в шаблоне начинается с пустой строки (все ячейки пусты), эта строка пропускается — данные пишутся с первой непустой строки. Если таблица заканчивается пустой строкой, она сохраняется: новые строки вставляются перед ней, а очистка лишних строк её не затрагивает:
| Столбец таблицы | Источник |
|---|---|
| 1 | Порядковый номер строки |
| 2–12 | Колонки B–L XLSX |
Для шаблонов ВО/СО (узкая таблица до 9 колонок) при section_rules = true:
- целые позиции нумеруются сквозным счётчиком в рамках одного документа:
неправильные целые заменяются нашими (
6, 7, 8→11, 12, 13); - в дробных позициях целая часть заменяется на текущий счётчик, дробная
берётся из данных как есть (
5.5при счётчике6→6.5); дробная до первой целой оставляется как есть; - строки с
ЗАГвыводятся без номера (только наименование, по центру с подчеркиванием) и отделяются пустыми строками сверху и снизу, в том числе пустая строка ставится перед первым заголовком таблицы; - перед строкой с целой позицией (
1,2, ...), идущей после дробной (2.3, ...), вставляется пустая строка; - строка-раздел (целая позиция с пустыми «Ед. изм.» и «Кол-во», за которой следуют дробные позиции) подчеркивается без центрирования;
- таблица всегда заканчивается ровно одной пустой строкой.
Каждая замена позиции при генерации выводится предупреждением вида
<номер документа>: позиция '6' заменена на '11' (видны и в --dry-run).
Строки ЗАГ счётчик не сдвигают.
При section_rules = false (все типы КЖ) действует legacy-поведение:
сквозная нумерация первой колонки, cells[j] = values[j-1], без особых
правил пустых строк.
В режиме --extract для типов с section_rules = true действует правило
перенумерации: если предыдущая строка — целая позиция с заполненными
«Ед. изм.» и «Кол-во», а текущая — дробная (3.1), позиция заменяется на
prev + 1 (3.1 → 4), цепочки перенумеровываются последовательно
(3, 3.1, 3.2 → 3, 4, 5). Каждая замена выводится предупреждением вида
<файл>: позиция '3.1' заменена на '4' (видны и в --dry-run). Строки
ЗАГ и пустые строки сбрасывают отслеживание.
Если строк в шаблоне недостаточно, скрипт добавляет строки копированием оформленной строки шаблона.
При заполнении сохраняются свойства оформления ячеек и текста, в том числе:
- шрифт;
- размер шрифта;
- жирность, курсив и подчеркивание;
- цвет и другие свойства текста;
- выравнивание;
- границы и свойства ячейки;
- параметры абзаца.
Для числовых ячеек XLSX учитывается формат числа. Например, формат 0.0 переносит значения в DOCX как 1,8 и 2,0.
Подстановки в шаблоне
Поддерживаются варианты с пробелами и без пробелов внутри двойных фигурных скобок.
| Подстановка | Значение |
|---|---|
{{ DISCIPLINE }} |
Полное название дисциплины |
{{ DOC_NUM }} |
Номер документа из MDR |
{{ D }} |
Дата/значение 07.2026 |
{{ LOCAL_TITUL }} |
Название объекта из MDR |
{{ DOC_NAME }} |
Название документа из MDR |
{{ NAME_TITUL }} |
Наименование титула из MDR |
Примеры без пробелов также поддерживаются:
{{DISCIPLINE}}
{{DOC_NUM}}
{{D}}
{{LOCAL_TITUL}}
{{DOC_NAME}}
{{NAME_TITUL}}
Замены выполняются в основном тексте, таблицах, верхних и нижних колонтитулах, а также в XML-частях DOCX и пользовательских свойствах документа.
Получение LOCAL_TITUL, DOC_NAME и NAME_TITUL из MDR
Используются два раздела файла ref/mdr_reference.md:
## Список листов ОКРЧ из MDR
## Список шкафов
Для каждого DOC_NUM:
- В разделе
Список листов ОКРЧ из MDRищется строка с номером документа в 7-й колонке. - Наименование титула берется из 2-й колонки и подставляется в
NAME_TITUL. - Название документа берется из 8-й колонки и подставляется в
DOC_NAME. - Последнее слово названия документа считается кодом шкафа.
- В разделе
Список шкафовкод шкафа ищется во 2-й колонке. - Если код не найден, последнее слово считается словом, которое содержится в титуле в таблице шкафов (пунктуация игнорируется, регистр не важен), и строка ищется по нему.
- Название объекта берется из 5-й колонки и подставляется в
LOCAL_TITUL.
Если соответствующая запись в MDR не найдена, скрипт выводит выделенное предупреждение и продолжает обработку. В этом случае значения DOC_NAME, LOCAL_TITUL и NAME_TITUL остаются пустыми.
Выходные файлы
Для каждого документа создается структура:
output\kj\<корень документа>\
├── SRC\
│ └── <номер документа>_A.docx
└── PDF\
└── <номер документа>_A3.pdf
Например:
output\kj\01_B590.110900.1.6-СПД\SRC\01_B590.110900.1.6-СПД-КЖ08_A.docx
output\kj\01_B590.110900.1.6-СПД\PDF\01_B590.110900.1.6-СПД-КЖ08_A3.pdf
Проверка перед генерацией
Для просмотра списка документов без записи файлов:
python src\process_kj_docs.py --type электропроводки --rows 4-30 --dry-run
Для проверки только СПД и КСБ:
python src\process_kj_docs.py --type электропроводки --rows 4-30 --codes СПД,КСБ --dry-run