Проверка форм в клиенте
Проверка форм EPF, ERF и сохраненных объектов конфигурации через TestClient платформы: JSON-сценарии, фактические значения и снимки экрана.
edt-bridge-mcp test-form открывает управляемую форму в настоящем клиенте тестирования
1С:Предприятия, выполняет действия в интерфейсе и записывает наблюдаемый результат.
JSON-сценарий проверяет представления полей, ячейки табличного документа и сообщения
пользователю. Дополнительная сессия проверяет состояние после повторного открытия той же цели.
Команда работает независимо от EDT. Она создает временную базу менеджера и запускает отдельные процессы TestManager и TestClient. Настольный клиент работает с выбранной файловой базой. Команды интерфейса могут менять ее данные. При использовании веб-клиента команда публикует временную копию.
Подготовка окружения
- Использовать изолированное Linux-окружение с полной установкой платформы, содержащей
1cv8иibcmd, лицензией платформы,XvfbиlibX11. - Подготовить одноразовую файловую базу с
1Cv8.1CD, нужной конфигурацией и тестовыми данными. Для проверки расширения заранее установить.cfe. Командаtest-formне устанавливает расширения и не обновляет конфигурацию целевой базы. - Подготовить тестового пользователя, под которым клиент запускается без диалога входа.
Параметр
--userзадает имя; пароль и ответы на диалоги входа CLI не принимает. - Разрешить запуск выбранных внешних файлов в тестовом окружении. CLI не отключает защиту платформы от опасных действий и не подтверждает ее предупреждение, но проверяет ее настройку до запуска клиента (см. ниже).
Для edt_test_form после создания или обновления тестовой базы один раз открыть
ее в клиенте 1С:Предприятия. Дождаться открытия приложения, закрыть клиент и
указать каталог базы в EDT_BRIDGE_TEST_INFOBASE. Каждый вызов копирует
1Cv8.1CD из этого каталога. Если исходную базу еще не открывали в клиенте,
первый запуск займет больше времени у каждой копии.
Для автоматического запуска в одноразовом окружении владелец стенда может настроить
защиту до начала проверки. В Linux-установке платформы, выбранной через --platform-bin,
используется файл <platform-bin>/conf/conf.cfg. Например, ограничить настройку базами
в каталоге /srv/test-bases/:
DisableUnsafeActionProtection=.*/srv/test-bases/.*
Это POSIX Basic Regular Expression для строки соединения с информационной базой,
а не для пути внешнего файла. Настройка отключает защиту для всех пользователей
подходящих баз. Применять ее только в одноразовом тестовом окружении; при замене
каталога в примере сохранить окружающие .*. Файл conf.cfg на Windows-хосте не
настраивает Linux-платформу внутри контейнера. Если предупреждение осталось, проверка
оставляет его на экране и сохраняет снимок, когда экран клиента доступен.
До запуска клиента test-form читает <platform-bin>/conf/conf.cfg, каталог, названный в его
ConfLocation, и conf/conf.cfg корня установки (/opt/1cv8/conf/conf.cfg для
/opt/1cv8/x86_64/<версия>); настройка берется из первого файла, где она есть. Собственный файл
пользователя ~/.1cv8/1C/1cv8/conf/conf.cfg не учитывается: проверка запускает клиент со своим
домашним каталогом.
Если проверяется .epf или .erf без --user и ни один из этих файлов не задает
DisableUnsafeActionProtection, команда останавливается со статусом client_environment до
запуска процессов платформы. Сообщение называет настройку, файл и шаблон для этой базы. Если
шаблоны заданы, но ни один не подходит, проверка выполняется и записывает warning. Шаблоны
сопоставляются по правилам платформы так, как их понимает проверка: POSIX Basic Regular
Expression со всей строкой соединения File="<тестовая база>";. Путь без окружающих .* не
подходит: с таким шаблоном платформа 8.5.1.1529 оставила предупреждение безопасности. С --user
защиту может отключать флажок Защита от опасных действий самого пользователя, поэтому проверка
выполняется и записывает примечание. edt_test_form работает с копией тестовой базы во
временном каталоге edt-bridge-form-run-* внутри TMPDIR; шаблон .*/edt-bridge-form-run-.*
подходит к любой копии.
Что сказано в файлах, результат показывает в clientEnvironment: прочитанные файлы,
строку соединения, шаблоны и подошедший шаблон, значение SystemLanguage. Параметр
SystemLanguage задает язык интерфейса платформы. На этом языке подписи штатных форм
платформы, например кнопки стандартной формы отчета, поэтому его стоит задать, например
SystemLanguage=RU, если сценарий нажимает такую кнопку по подписи.
Служебная база – пустая база с загруженным драйвером теста – одинакова для всех проверок на
одной сборке платформы. Первая проверка сборки сохраняет ее файл данных в кэше
~/.cache/edt-bridge/test-manager (внутри $XDG_CACHE_HOME, если он задан), а следующие
копируют его вместо запуска ibcmd и конфигуратора; каждая проверка по-прежнему работает со
своей копией. EDT_BRIDGE_TEST_CACHE задает другой каталог, например заполненный при сборке
образа стенда, или выключает кэш значением off. Писать в каталог кэша должен только
доверенный пользователь: запись – это служебная база следующей проверки, и обвязка создает каталог
доступным только владельцу. Запись сверяется с sha256 из ее манифеста,
поврежденная строится заново; подготовка, упавшая на базе из кэша, повторяется с новой базой.
Что произошло, результат показывает в managerCache: status – hit, stored, rebuilt
(с reason), storeFailed (с error, проверка продолжается), miss (подготовка остановилась до
сохранения новой базы, reason говорит, почему ее строили) или off.
Выбор цели
Для каждого запуска обязательны --platform-bin, --test-infobase, --scope,
--form и --output-dir; --form-title необязателен. Выбрать ровно одну цель:
| Параметр | Цель |
|---|---|
--epf FILE |
Существующая внешняя обработка и ее основная управляемая форма, например ExternalDataProcessor.Check.Form.Main. |
--erf FILE |
Существующий внешний отчет с назначенной основной формой или основной схемой компоновки данных. |
--navigation-link LINK |
Существующий документ или элемент справочника в выбранной базе. Требует --scenario. |
Для EPF или ERF с назначенной основной формой укажите ее полное имя, например
ExternalReport.PlannedShipments.Form.Main. Для ERF с основной схемой компоновки
данных и без назначенной формы используйте ExternalReport.PlannedShipments.Form.
Платформа создаст штатную форму.
Для объекта конфигурации укажите полное имя формы, например
Document.CustomerOrder.Form.Main или Catalog.Items.Form.Main. Принимаются
русские имена, например ВнешнийОтчет.PlannedShipments.Форма.
Без --form-title проверка ждет форму по полному имени и берет ее, если открыта одна форма
с таким именем. В --form-title передается заголовок окна в клиенте. Окно формы объекта
дописывает к заголовку формы представление объекта: форма с заголовком “Контроль отгрузки”
открывается окном “Контроль отгрузки: КонтрольОтгрузки”, и точный заголовок формы не совпадет;
передавать шаблон вида 'Контроль отгрузки*'. Платформа считает * любой
последовательностью символов, а ? – одним символом, поэтому заголовок с датой или
номером можно задать шаблоном, например 'Заказ покупателя 7 от *'. Дата в
заголовке документа следует региональным установкам сеанса, и точный заголовок,
снятый при другой локали, не совпадет. Форма по-прежнему выбирается по полному имени:
окна, подходящие под шаблон, но с другим именем формы, пропускаются, а два подходящих
окна с одним именем формы дают ambiguous_form. Заголовок только из знаков
подстановки отклоняется. --button остается точным заголовком кнопки.
При form_not_found JSON перечисляет открытые формы в observedForms, а их
заголовки – в observedTitles. Найденная форма записывается в observedForm и
observedTitle.
Ссылка на объект конфигурации имеет следующий вид:
e1cib/data/Document.CustomerOrder?ref=0123456789abcdef0123456789abcdef
Использовать ссылку реального объекта из одноразовой базы. Идентификатор содержит
32 шестнадцатеричных символа; тип и имя объекта метаданных должны совпадать с --form.
Принимаются только внутренние ссылки e1cib/data/ на документы и элементы справочников.
Внешние ссылки, ссылки на команды и дополнительные параметры отклоняются.
Параметр --scope записывает заявленную вызывающим область проверки: empty, fixture
или application. Команда не исследует базу, чтобы подтвердить эту классификацию.
Параметр --output-dir должен указывать новый каталог вне базы; недостающие родительские
каталоги создаются. Предел --timeout составляет 1–900 секунд, по умолчанию 120; он включает
подготовку и все фазы сценария. Для завершения процессов предусмотрен отдельный короткий
срок. Все параметры приведены в справочнике CLI.
ERF открывается фиксированной временной обработкой в том же клиенте через
ExternalReports.Connect и OpenForm с SafeMode=True. Тестовый пользователь должен иметь
разрешение на запуск этой обработки. Такой программный маршрут проверяет выполнение
отчета и доступ к данным; право на интерактивную команду открытия файла требует
отдельной проверки.
Существующая проверка одной кнопки
Профиль EPF по-прежнему принимает --epf, --button и --expect-message. После нажатия
число вхождений ожидаемого сообщения должно увеличиться. Без --expect-message
результат – command_observed, ok=false, код возврата 2. Для точного числа сообщений,
проверки их отсутствия или проверки данных использовать --scenario. Параметры
--button и --scenario взаимоисключающие; --expect-message со сценарием не применяется.
Сценарий, примеры и результаты
Остальные части руководства вынесены на отдельные страницы:
- Формат сценария – шаги JSON-сценария и их ограничения.
- Примеры сценариев – внешний отчет, установленное расширение и сохраненные значения.
- Результаты – статусы результата, журнал регистрации и диагностика неудачного запуска.