Skip to content

About

Batch NX PRT attribute scanner with SQLite caching and Excel export (GUI + headless)

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

NxPrtAttributeScanner

Инструмент для пакетного сканирования атрибутов NX (*.prt) файлов
с сохранением результатов в Excel.

Поддерживает:

  • 🔍 Рекурсивный поиск *.prt
  • 📦 Кэширование через SQLite
  • 📊 Экспорт в Excel (EPPlus)
  • 🗂 Группировку по папкам
  • 🖥 GUI + headless режим (через run_journal.exe)

Среда разработки и испытания (этап 00)

Команды и изоляция синтетических .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

🖥 GUI версия

  1. Соберите проект NxPrtAttributeScannerGUI
  2. Запустите NxPrtAttributeScannerGUI.exe
  3. Укажите:
    • Папку NX
    • Корневую папку с *.prt
    • Путь сохранения Excel
  4. Нажмите Запустить

⚙ Headless (без GUI)

ScanAndExport запускается через внешний NxScanCoordinator.exe: окончательная публикация разрешена только после фактического exit 0 NX и проверки результата задания.

1️⃣ Создайте файл scan.ini

Пример:

[Scan]
Root=D:\Data\PRT
; Явное разрешение обхода всего ROOT, если листы не настроены:
AllowRootScan=1
Mode=ScanAndExport
DbPath=.\cache\parts.db

IncludeFolderName=Кронштейны
IncludeFolderName=Корпуса

[Excel]
Out=.\reports\Parts.xlsx
GroupMode=FirstLevel

2️⃣ Запуск

.\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=30

DeadlineSeconds=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: только внутри текущей явной выборки, после полного обхода и подтверждения отсутствия. Полностью пустая успешная область также очищается; прежний отчёт при этом сохраняется как результат предыдущего задания. Кеш вне текущих листов и фильтров сохраняется.


Режимы

ScanAndExport

Сканирует и создаёт Excel

ScanOnly

Только обновляет кэш


Группировка

  • FirstLevel — группировка по первой папке относительно Root
  • AllInOne — один лист Excel

Переносной офлайн-комплект разработки

Расширенный локальный набор .NET desktop инструментов находится в offline-dev. Состав, системные требования, проверка SHA-256, сборка из VS Code/cmd.exe и создание чистой копии для переноса описаны в инструкции. Большой каталог offline-dev/payload хранится на диске вне Git; используйте offline-dev\make-transfer.cmd для копирования проекта вместе с инструментами.

About

Batch NX PRT attribute scanner with SQLite caching and Excel export (GUI + headless)

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages