BAS: управление XML-проектами
Beta в Cronopus 1.2.0.0: модуль находится в разработке, не полностью протестирован и готов, может содержать ошибки. Пометка Beta относится только к BAS; остальные модули сохраняют стабильный статус.
Откройте BAS в доке или /bas.html, чтобы запускать сохранённые XML-проекты BrowserAutomationStudio локально или на сохранённых Windows-узлах Remote Tasker. Premium, публикация в облаке и ручная компиляция не требуются. Предварительная версия доступна в релизе 1.2.0.0 Beta.
Запуск проекта
- Выберите Local или сохранённое HTTPS-подключение. Подключения настраиваются в Config → Remote Tasker.
- Нажмите New, затем Choose XML. Локально откроется диалог Windows, удалённо — файловый браузер выбранного узла с папками и XML-файлами. Путь и предлагаемое имя заполняются автоматически; имя можно изменить. Отмена не меняет текущий выбор.
- Ресурсы загружаются из XML на выбранном узле. From XML обновляет форму после внешнего редактирования файла. Меняйте поля ресурсов; сохраняются только переопределения. Use XML default возвращает значение из XML. Исходный файл не изменяется.
- Сохраните проект и нажмите Run. Число потоков и лимиты BAS определяются самим XML.
- Проверяйте Runs и Log. Stop останавливает дерево процессов этого проекта, не затрагивая другие проекты и редакторы BAS.
У сохранённого проекта одновременно может быть один активный запуск. Разные проекты могут выполняться параллельно. Один процесс запуска не означает один нативный поток BAS.
Поддерживаются переопределения FixedString, RandomString, FixedInteger с объявленными границами, LinesFromFile с путём и одиночный Select. Варианты Select берутся из Values; индекс Selected в рабочей копии начинается с нуля. Неизвестные имена ресурсов, необъявленные варианты и неподдерживаемые типы переопределений отклоняются. Остальные типы ресурсов сохраняют исходные настройки XML.
Select с двумя вариантами true/false отображается переключателем On/Off с управлением кликом или пробелом. Сохраняются исходные строки вариантов BAS. Другие списки остаются выпадающими.
Форма использует Description, подсказки, значения по умолчанию, числовые границы, Visible, Enabled, IsAdvanced, многострочность, обязательность и условия видимости ресурсов. Скрытые ресурсы не выводятся, расширенные доступны через Advanced; отключённые и неподдерживаемые поля доступны только для чтения. Поля password/token/secret маскируются.
Редактор JSON overrides синхронизирован с формой; {} означает значения XML по умолчанию. Пустая строка — явное переопределение пустым значением, а не сброс. Save сохраняет форму до того, как Run использует настройки. Смена XML очищает старые переопределения; устаревшие ответы после смены проекта или узла игнорируются.
Ресурсы читаются через GET /bridge/v1/bas/resources?projectPath=... на выбранном узле с существующей проверкой ключа и сертификата.
Исходный XML не перезаписывается. Движок получает копию; относительные пути LinesFromFile разрешаются от каталога исходного XML. Прямые вызовы project_path() в исполняемом коде указывают на исходный XML, позволяя искать родительские каталоги Essentials и data. Строки, комментарии и метаданные полотна сохраняются. Другие относительные пути зависят от семантики BAS; для внешних файлов используйте абсолютные пути.
Движок и процессы
При первом запуске по HTTPS скачивается unprotected engine для EngineVersion из XML и проверяется SHA-1, предоставленный издателем. Архив и чистый движок кешируются на узле по версии. У проектов отдельные рабочие каталоги; крупные исполняемые файлы используют жёсткие ссылки NTFS, где это возможно, иначе копируются.
Клонирование сохраняет пустые служебные каталоги BAS. Старые рабочие каталоги исправляются при следующей подготовке без повторной загрузки и замены настроек. Отсутствие таких папок может приводить к пустому результату JavaScript в браузере при успешной навигации.
Запускается FastExecuteScript.exe --silent. Авторизация опубликованного скрипта, имя функции и Premium control API не используются. Нативные логи, результаты и bas_reports сохраняются в отдельный каталог запуска.
Release runtime останавливает проект, освобождает его состояние и очищает историю запусков и логов в памяти. Перед редактированием сохранённого проекта освободите runtime. Delete доступна без активного выполнения и автоматически освобождает runtime перед удалением записи проекта; исходный XML не удаляется. Кеш движка сохраняется. Изменения исходного XML читаются при новом запуске; смена EngineVersion требует освобождения и новой подготовки runtime.
Дерево процессов принадлежит Cronopus через Windows Job Object. Отмена или закрытие панели завершает его. После перезапуска Cronopus прерванные XML-проекты автоматически не возобновляются.
Результаты и неопределённость сети
Run подтверждает принятие команды, а не завершение. Одного кода выхода 0 недостаточно: Cronopus требует нативный отчёт с успешным финальным сообщением и без ошибок. Без отчёта выполнение отмечается как неподтверждённое.
Удалённый запуск использует HTTPS, закреплённые сертификаты, ключи, отзыв доступа и журнал операций Remote Tasker. Если ответ команды потерян, Check command читает исходную запись журнала без повторной отправки. pending и outcome_unknown не подтверждают ни успех, ни ошибку.
Если доступный узел не содержит записи команды, проверьте запуски и после выяснения результата нажмите Dismiss pending. Кнопка очищает только отметку в браузере и не повторяет команду.
Настройки проектов хранятся в закрытом BridgeStore с Windows DPAPI. JSON-переопределения могут содержать секреты; события и ошибки маскируют значения ресурсов с password/token/secret в имени. Авторизованный оператор может читать сохранённые переопределения. Содержимое логов выводится как текст, включая строки, похожие на HTML.
История ограничена 250 запусками и 500 событиями на загруженный проект, 16 КиБ на событие и 256 КиБ в браузерном просмотре лога. Нативные файлы хранятся в пределах 30 каталогов запусков и 1 ГиБ на проект. Перед запуском старые каталоги очищаются; выполнение останавливается при превышении 512 МиБ вывода. Отчёты API ограничены 256 КиБ.
Маркеры цвета нативных логов BAS отображаются с учётом темы. Время, поток/тип и сообщение разделены по колонкам; путь исходного файла виден при наведении. Одинаковые последовательные сообщения сворачиваются со счётчиком и временем последнего повтора. Нативные файлы сохраняют полный вывод.
Интеграция C#
BasControlClient: подготовка XML, владение процессами, чтение логов и проверка нативного отчёта.BasXmlProject: разбор XML, проверка ресурсов и сохранность исходника.BasControlService: сохранённые проекты, ревизии, состояния, отмена и ограниченная история.BridgeHost.InvokeBasAsync: журналируемые команды/bridge/v1/bas/; локальная страница использует защищённые/bridge-local/маршруты.
Проверки разработчика
rtk dotnet run --project tests/Bas.Integration/Bas.Integration.csproj
rtk dotnet run --project tests/Bas.Integration/Bas.Integration.csproj -- --live
Обычный набор использует изолированное хранилище и имитацию выполнения поверх настоящего HTTPS с проверкой сертификата. --live запускает безопасный XML-пример в BAS 31.1.0 и проверяет отчёт и неизменность исходника. CRONOPUS_BAS_TEST_ENGINE позволяет указать тестовый движок без новой загрузки. Эти проверки не означают полной готовности модуля Beta.
Для проверки браузерного интерфейса запустите набор с --serve, затем rtk python tests/bas_browser.py <BAS_BROWSER_URL>. Сервер печатает фактический URL, предпочитая порт 39761.