KOT for 1C 3.0.0

3.0.0

Крупное обновление относительно 2.7.1: от редактирования исходников до сборки, выполнения и отладки тестов в одной рабочей области VS Code.

Коротко о главном

• Новая рабочая область: боковые панели Менеджера тестов, Библиотеки и Информационных баз, а также Свойства теста рядом с редактором.
• Два формата СППР и самостоятельные feature: единый YAML или scen.feature + meta.yaml, главные и вложенные процессы, преобразования между форматами и видами сценариев.
• Управление Vanessa из VS Code: запуск через MCP, F11, выполнение выделения и запуск с шага, точки останова, запись действий, результаты и переменные сеанса.
• Расширенная Библиотека: встроенные шаги нужной версии Vanessa, экспортные сценарии и пользовательские BSL-шаги со сборкой EPF.
• Настройки для каждого проекта: отдельные профили сборки и запуска, общие каталоги и группы, мастер первой настройки.
• Учебная мастерская и новое руководство: примеры, упражнения, снимки интерфейса и видео для знакомства с возможностями KOT.

Рабочая область и начало работы

• Менеджер тестов, Библиотека и Информационные базы доступны в боковых панелях; для подробной работы сохранены полноразмерные представления.
• Добавлена панель Свойств теста: шапка, метаданные, параметры, вложенные сценарии, шаги процесса, теги, настройки запуска и вложения. Из неё можно сохранить и запустить тест, открыть его исходники и выполнить преобразование.
• Для самостоятельной feature доступны свойства заголовка и сценариев, теги, группа, описание и JSON запуска. При открытии собранной feature можно перейти к свойствам её исходника.
• Менеджер тестов разделяет главные сценарии, главные процессы и самостоятельные feature. Доступны групповой выбор, фильтры состояния, настройка порядка групп, подсветка зависимостей и показ связанных тестов.
• Добавлен мастер для нового проекта, существующего проекта СППР или Vanessa и перехода с прежних версий KOT. Перед применением он показывает план создания файлов, настроек и переноса данных; подключение выполнения можно отложить.
• При применении мастер показывает текущий этап и количество обработанных файлов, сохраняя прокрутку страницы. Подготовка Vanessa выполняется отдельно после сохранения настроек; при неудаче её можно повторить.
• Настройки собраны на отдельной странице KOT: поиск, тематические разделы, выбор области VS Code, наследуемые значения, черновик изменений и переход в нативные настройки. Пути выбираются через диалоги; расположения внутри проекта могут сохраняться относительно его корня.

Исходники СППР, процессы и преобразования

• Добавлен формат scen.feature + meta.yaml: текст шагов хранится отдельно от шапки, параметров и служебных данных. Оба документа участвуют в подсказках, диагностике, навигации, синхронизации параметров и вложенных вызовов, сохранении и сборке.
• Поддержаны главные и вложенные процессы СППР: создание, редактирование свойств, параметры и теги, добавление, удаление и перестановка шагов. Процесс с настройками запуска можно собирать и выполнять самостоятельно.
• Самостоятельные feature Vanessa включены в Менеджер тестов и Библиотеку. Для них доступны создание по русскому или английскому шаблону, организация по группам, подготовка JSON запуска и выполнение без компиляции СППР.
• Добавлены преобразования YAML ↔ feature + meta, главный ↔ вложенный сценарий или процесс, вложенный ↔ экспортный сценарий. Доступные варианты собраны в меню преобразований Свойств теста, Библиотеки и редактора.
• Преобразования сохраняют идентичность теста и переносимые данные, обновляют распознаваемые вызовы и передаваемые аргументы. Несовместимые конструкции и конфликты проверяются до записи. Экспорт можно сохранить в новый файл или добавить в существующую feature библиотеки.
• После преобразования формата, в том числе при сохранении YAML, Свойства теста переключаются на новые исходники, сохраняя выбранные настройки запуска и закрепление панели.
• Добавлено массовое преобразование YAML-сценариев в feature + meta из меню «Обслуживание»: выбор тестов, прогресс, отмена между файлами и итоговый отчёт. Есть отдельная настройка преобразования YAML при сохранении.

Библиотека и работа в редакторе

• Добавлена полная Библиотека с поиском, категориями, избранным, предпросмотром определения и его параметров. В ней объединены шаги Vanessa, пользовательские BSL-шаги, экспортные сценарии, вложенные сценарии и процессы СППР.
• Встроенные шаги выбираются из версионного каталога Vanessa. Версия определяется по её поставке; предусмотрены явный выбор и резервный локальный каталог.
• Подсказки, поиск по смыслу через !, ховеры, диагностика и переходы используют общий каталог определений для YAML и feature. Контекст аргумента учитывается отдельно от текста шага; имена элементов, таблиц, колонок и значения могут поступать из активной формы 1С.
• F12 работает по всей строке вызова. В собранной feature доступен переход к исходной строке или окружающему вложенному сценарию по карте сборки. Ссылки и подсветка связей учитывают прямые и косвенные зависимости.
• Добавлены создание и переименование экспортных сценариев с обновлением вызовов, а также создание пользовательских шагов. EPF-библиотеку можно собрать из проекта обработки или создать из отдельного BSL; готовую EPF можно выгрузить в исходники через Конфигуратор.
• Для пользовательских шагов отображается состояние библиотеки. Несобранные и требующие пересборки шаги доступны для изучения, но исключаются из IntelliSense, копирования, вставки и перетаскивания до успешной сборки.
• Согласована подсветка параметров, переменных и Gherkin-таблиц в YAML и feature. При удалении целой ячейки шапки вместе с разделителем удаляется соответствующий столбец таблицы; очистка названия сохраняет столбец.
• Действия редактора сгруппированы в контекстных меню. Расширена русская и английская локализация панелей, подсказок и сообщений; подписи переменных согласованы с Vanessa Automation.

Выполнение и отладка в Vanessa Automation

• Добавлены запуск управляемого MCP-сеанса через служебную базу KOT и подключение к уже работающей Vanessa. Поддержаны обнаружение локального сеанса, автоматическое подключение и опциональный автозапуск; состояние соединения видно в строке состояния VS Code.
• Из Менеджера тестов, Свойств теста и редактора доступны запуск feature, выполнение одного шага по F11, выполнение выделенных обычных шагов, запуск с выбранной строки, остановка и продолжение с точки останова.
• Во время прогона кнопка записи в редакторе заменяется кнопкой остановки. Она остаётся доступной при временной потере состояния Vanessa; повторное нажатие отключено на время подтверждения остановки.
• Шаги исходника СППР можно выполнять по карте собранной feature. Для простого обычного шага YAML доступна проба через служебную feature без полной компиляции.
• Добавлены точки останова в редакторе и отображение подтверждённых результатов строк. Данные MCP дополняются журналом выполнения; управляемый сеанс получает постоянный журнал, используемый при запуске разных feature. Ховер ошибки содержит её текст и доступные переходы к журналу и исходнику.
• Перед действием сверяется содержимое feature в VS Code и Vanessa. Подготовленный файл переиспользуется при пошаговой работе; несохранённые изменения в редакторе Vanessa защищены от перезаписи.
• Добавлена запись действий в клиенте тестирования с последующей вставкой шагов у каретки в YAML или feature. Вставку можно отменить одним Undo.
• Добавлена панель локальных и глобальных переменных Vanessa с автообновлением, записью строковых значений и удалением локальных переменных.
• Доступны поиск шагов и проверка синтаксиса в работающем сеансе, чтение состояния и результатов, журналы, снимки клиента и сохранение диагностического ZIP. Стандартные секретные поля скрываются в текстовом отчёте; пакет не отправляется автоматически.

Form Explorer и информационные базы

• Form Explorer получает данные через MCP Vanessa наряду с прежним мостом. Доступны выбор окна, дерево групп, элементов и колонок, поиск, фильтры и подробности выбранного элемента.
• Для выбранного элемента можно получать нативные шаги Vanessa, а для текущей формы — готовые проверки. Результаты можно копировать и вставлять в сценарий; дополнительные инструменты доступны по возможностям подключённого сеанса.
• Информационные базы объединяют сохранённые подключения KOT и фактических клиентов текущей Vanessa. Для одной базы поддерживаются несколько клиентов с разными пользователями и параметрами подключения.
• Из панелей баз доступны добавление, редактирование, подключение и отключение клиента. Клиента, существующего только в Vanessa, можно сохранить в KOT. Сохранённые подключения могут автоматически добавляться в работающую Vanessa без запуска клиентов и перезаписи конфликтующих записей.
• Добавлены индикация работы базы и клиентов, выбор клиента для открытия с Vanessa и Form Explorer, восстановление из установленного DT-шаблона и обновление из CF-шаблона.

Сборка, параметры и совместная работа

• Профили параметров СППР, дополнительные параметры Vanessa, начальные глобальные переменные и активный выбор привязаны к проекту. Относительные пути позволяют хранить проектные параметры без привязки к одному рабочему месту.
• Расширена поддержка контракта компилятора СППР: корни сценариев и процессов, параметры и их типы, таблицы, исходящие значения, варианты теста и фильтры. Обязательные пути и значения проверяются перед запуском компиляции.
• Сборка выполняется изолированными заданиями с ограниченной параллельностью и отменой. Общий отчёт показывает итог, ошибки со ссылками на исходные строки, результаты по настройкам запуска и раскрываемые технические подробности.
• Актуальность сборки учитывает исходник и его зависимости. Изменения вложенных и экспортных сценариев, парного feature и преобразования отражаются в состоянии собранных тестов.
• В Менеджере тестов и Библиотеке выделены «Собранные файлы». Поддерживаются результаты как в отдельном каталоге вложений, так и рядом с собранной feature.
• Формат проекта выбирается рабочей веткой: без явной метки KOT 3 сохраняются прежние YAML и встроенные метаданные для существующего CI. Настройка окружения отделена от перехода формата; при смене ветки заново сканируются тесты и Библиотека.
• Группы хранятся по одному файлу в .kot/groups/, принадлежность к группе, описания и категории — рядом с исходниками. Порядок показа групп и элементов остаётся личным и не создаёт Git-изменений. Перенос между группами меняет только запись переносимого теста. Добавлена команда разрешения конфликтов метаданных с выбором спорных полей и просмотром результата перед записью.
• Добавлены авторские серии нумерации тестов и проверка уникальности кодов для CI. Личные значения по умолчанию отделены от общих каталогов проекта.
• Сокращены повторные сканирования и фоновые запросы, добавлены общие индексы и кеши, отложенная загрузка и чтение новых данных журнала. Фоновые обновления сохраняют состояние панелей.

Руководство, примеры и разработка

• README и руководство переписаны: обзор возможностей, маршруты для СППР и Vanessa, работа с интерфейсом, практические задачи и решение проблем. Технические контракты, настройки и команды вынесены в отдельные справочники.
• Добавлена самостоятельная учебная мастерская examples/kot-workshop с упражнениями, обоими форматами СППР, процессами, feature, библиотеками и собственным профилем параметров. Мастер настройки может открыть её отдельную копию.
• Руководство дополнено снимками интерфейса и видео. Документация объединена в docs/, пользовательские руководства — в docs/guides/; добавлены общее оглавление и карта каталогов репозитория.
• В проверки проекта входят TypeScript, ESLint, локализация, автоматические тесты, целостность учебного проекта и ссылки документации. Проверяются прежние идентификаторы разделов руководства. Локальные базы, скачанные инструменты и результаты упражнений исключены из VSIX.

Что учитывать при обновлении

• Требуется VS Code 1.106 или новее. Редактирование и изучение тестов доступны без 1С; локальные компиляция, подготовка баз и запуск 1С рассчитаны на Windows.
• Формат новых сценариев СППР по умолчанию — scen.feature + meta.yaml. Для существующего scen.yaml включено преобразование при сохранении. Формат и автоматическое преобразование настраиваются отдельно.
• Прежние общие профили параметров доступны для явного копирования в проектные профили. Общие файлы .kot и метаданные рядом с исходниками следует сохранять вместе с тестами в системе контроля версий.
• Возможности управления зависят от версии и объявленных инструментов Vanessa. В проверенном API 1.2.043.45 нельзя применить весь JSON запуска к уже работающему менеджеру: при различии настроек KOT предупреждает об использовании параметров активного сеанса.
• Проба YAML не заменяет компиляцию сложных конструкций СППР. Отмена ожидания не всегда останавливает синхронную операцию Vanessa; часть данных результатов и операций с переменными ограничена её API. Для активного профиля компиляции во вторичной папке multi-root предусмотрено отдельное окно проекта.

Руководство · Совместимость и ограничения · Изменения для разработчиков