Инструмент для пакетного сканирования атрибутов NX (*.prt) файлов
с сохранением результатов в Excel.
Поддерживает:
- 🔍 Рекурсивный поиск *.prt
- 📦 Кэширование через SQLite
- 📊 Экспорт в Excel (EPPlus)
- 🗂 Группировку по папкам
- 🖥 GUI + headless режим (через run_journal.exe)
Команды и изоляция синтетических .prt: fixture-generation.
Фактические результаты: среда,
исходный baseline, сравнение reader,
производительность, план разработки.
Тестовые данные и результаты создаются в игнорируемом .stage00/; производственные документы не используются.
В этапе 01A исправлено сохранение индексов и типов по всей цепочке NX Open → SQLite → Excel;
результаты и ограничения описаны в отчёте 01A.
Известный исследовательский FAIL UF/reject-invalid остаётся открытым; production reader использует NX Open.
Новые БД имеют формат v2. Существующая v1 не мигрируется автоматически:
нужен явный вызов CacheRepository.MigrateV1ToV2(dbPath) при остановленных scanner/GUI writers
либо новая БД с повторным извлечением. Миграция создаёт SQLite backup с учётом WAL,
сохраняет настройки и исходные строки v1, помечает старые результаты для повторного чтения .prt.
Неизвестные индексы и типы старым строкам не присваиваются. Пользовательские БД в рамках испытаний не мигрировались.
- Siemens NX (поддерживался NX 1899)
- .NET Framework 4.7.2
- Доступ к
run_journal.exe
- Соберите проект
NxPrtAttributeScannerGUI - Запустите
NxPrtAttributeScannerGUI.exe - Укажите:
- Папку NX
- Корневую папку с *.prt
- Путь сохранения Excel
- Нажмите Запустить
ScanAndExport запускается через внешний NxScanCoordinator.exe: окончательная
публикация разрешена только после фактического exit 0 NX и проверки результата задания.
Пример:
[Scan]
Root=D:\Data\PRT
; Явное разрешение обхода всего ROOT, если листы не настроены:
AllowRootScan=1
Mode=ScanAndExport
DbPath=.\cache\parts.db
IncludeFolderName=Кронштейны
IncludeFolderName=Корпуса
[Excel]
Out=.\reports\Parts.xlsx
GroupMode=FirstLevel.\NxScanCoordinator\bin\Release\NxScanCoordinator.exe config="D:\Job\scan.ini" nx="D:\Program Files\Siemens\NX1899"По умолчанию существующий отчёт не заменяется. Для явно разрешённой замены добавьте
replace=true; GUI запрашивает разрешение перед запуском. Поддержана публикация на
локальном фиксированном NTFS без reparse points. При изменении SHA-256 назначения
после принятия задания замена запрещается. Предыдущий отчёт сохраняется в
.nxscan-<Job ID>\previous.xlsx рядом с назначением.
При блокировке Excel после успешного NX снимите блокировку и повторите только публикацию:
.\NxScanCoordinator\bin\Release\NxScanCoordinator.exe retry="D:\Job\.nxscan-<Job ID>\job.json"Retry использует сохранённое подтверждение завершения процесса; ненулевой exit,
отмена, изменённый результат или отсутствующий prepared XLSX запрещают публикацию.
Каталоги заданий сохраняются для диагностики и retry, автоматической очистки нет.
Новые задания 03C также требуют согласованного outcome.json; retry разрешён
только после отказа публикации при подтверждённых Success/exit 0/Validated.
Отсутствующий итог, отмена, timeout и прежний Published нельзя превращать в успех retry.
После сбоя во время замены требуется осмотр назначения и backup; наличие XLSX
само по себе не подтверждает успешное задание. Ошибка любого выбранного .prt
запрещает весь отчёт, подтверждённые транзакции SQLite сохраняются.
В 03B пустой набор листов/папок означает пустую выборку. Обход ROOT без листов
требует явного AllowRootScan=1 в [Scan]; назначенная отсутствующая папка
завершает задание ошибкой. Пустая строка назначения также ошибочна; . явно
назначает ROOT листу. GUI использует назначенные листам каталоги.
ROOT должен совпадать с meta.root_path БД; для новой БД он привязывается при
первом запуске. Перенос ROOT требует явного изменения привязки.
IncludeFolderName и включённые правила таблицы filters поддерживают * и ?
без учёта регистра. Имя сопоставляется с любым сегментом папок внутри ROOT
(включая имя самого ROOT); шаблон с разделителями — с префиксом пути папки
относительно ROOT. * не пересекает разделитель. Исключения имеют приоритет;
группа INI include и группа DB include, если заданы обе, применяются совместно.
При пересечениях первый лист в порядке sort_order, id получает файл один раз.
Смена фильтров и листов сохраняет кеш вне выборки. Очистка допускается только после полного успешного обхода, для отсутствующих файлов текущей выборки, с дополнительной проверкой доступности родительской области. Ошибки обхода, доступа и отмена запрещают очистку и новый отчёт. Reparse points не обходятся; UNC допускается для входов, публикация Excel по-прежнему требует локального NTFS. Подробности и результаты: этап 03B.
В 03C GUI и CLI используют один координатор жизненного цикла. Итог задания, результат сканирования, Excel и exit процесса показаны отдельно. Только подтверждённый exit 0 вместе с полным успешным результатом допускает публикацию. Start блокируется до завершения координации; Stop сначала фиксирует отмену, затем ждёт безопасную границу и при необходимости завершает только собственный процесс. Закрытие GUI после выбора остановки ждёт подтверждения выхода NX. Ctrl+C в CLI означает отмену. Коды CLI: 0 — успех, 1 — ошибка, 2 — отмена, 3 — timeout.
Настройки ожидания задаются секцией [Execution] исходного INI. В GUI эта секция
читается из необязательного scan.ini рядом с exe; остальные настройки GUI
фиксируются из полей формы. Значения — целые секунды, до 2592000; для
KillWaitSeconds предел 2147483 из-за int-диапазона Process.WaitForExit в миллисекундах:
[Execution]
StartupTimeoutSeconds=180
DeadlineSeconds=0
NoProgressWarningSeconds=120
CancellationGraceSeconds=5
KillWaitSeconds=30DeadlineSeconds=0 отключает общий deadline, NoProgressWarningSeconds=0 —
предупреждение о тишине. Startup/KillWait должны быть положительными; grace может
быть 0. Отсутствие прогресса само по себе не подтверждает зависание.
Прогресс различает найденные, прочитанные, сохранённые, извлечённые и кешированные
файлы. Saved/Extracted растут только после commit; после Kill без worker-result
это последний подтверждённый прогресс, а не доказанный полный объём работы.
Журналы stdout.txt, stderr.txt, result.json, process.json, owner.json
и outcome.json находятся в каталоге Job ID.
Одинаковые БД и назначения Excel защищены кооперативными leases. Файлы
*.nxscan.owner.json удерживают PID/StartTime для восстановления после сбоя
координатора. Живой прежний процесс не завершается новым заданием. Если регистрация
процесса оборвана (LaunchPending), новый запуск запрещён до ручной проверки
соответствующего Job ID и отсутствия его процессов; автоматического восстановления
такой записи нет. Удалять запись при живом worker нельзя. Новое сканирование всегда
создаёт новый NX-процесс; автоматический restart/retry повреждённого Part не выполняется.
Координатор управляет только прямым созданным процессом, не деревом по именам.
БД и координационные файлы поддерживаются на локальном фиксированном NTFS;
сетевые входные .prt сохраняют policy 03B.
Подробности и приёмка: этап 03C.
Прямой запуск любого RunScanner.cs без задания координатора разрешает только
ScanOnly. В режиме экспорта worker формирует только временный файл. Подробности,
испытания и ограничения: этап 03A.
NxPrtAttributeScanner/
│
├── NxPrtAttributeScanner/ # DLL проект (ядро)
├── NxPrtAttributeScannerGUI/ # GUI
├── RunScanner.cs # NX journal loader
├── sample.scan.ini # пример конфигурации
Программа использует SQLite базу для:
- предотвращения повторного чтения неизменённых файлов
- хранения атрибутов
- отслеживания ошибок
Удалённые файлы очищаются по policy 03B: только внутри текущей явной выборки, после полного обхода и подтверждения отсутствия. Полностью пустая успешная область также очищается; прежний отчёт при этом сохраняется как результат предыдущего задания. Кеш вне текущих листов и фильтров сохраняется.
Сканирует и создаёт Excel
Только обновляет кэш
FirstLevel— группировка по первой папке относительно RootAllInOne— один лист Excel
Расширенный локальный набор .NET desktop инструментов находится в offline-dev.
Состав, системные требования, проверка SHA-256, сборка из VS Code/cmd.exe и
создание чистой копии для переноса описаны в инструкции.
Большой каталог offline-dev/payload хранится на диске вне Git; используйте
offline-dev\make-transfer.cmd для копирования проекта вместе с инструментами.