Формат сценария
JSON-сценарий test-form: шаги, проверки, чтение значений и их ограничения.
Передать UTF-8 JSON-файл через --scenario. Верхний уровень содержит version: 1,
массив steps и необязательный массив reopen либо вместо них version: 1 и
scenarios. В каждой фазе от 1 до 128 шагов;
после последнего действия в интерфейсе должна следовать проверка или чтение. Неизвестные поля
и повторяющиеся JSON-ключи отклоняются; отказ называет шаг, его лишние и недостающие ключи и
ключи, которые принимает его действие, например Invalid 'input' step 1 in steps: unexpected value; missing text; input takes action, field, text. Схема edt_test_form описывает каждый вид шага. Предел размера файла – 1 МиБ.
Шаги
Каждый шаг содержит обязательные поля из таблицы ниже. Поле field задает
внутреннее имя видимого элемента формы. В шаге click укажите одно из двух полей.
button задает точный видимый заголовок, а button_name – внутреннее имя элемента
кнопки. Если заголовок встречается у нескольких кнопок, используйте button_name.
Селектор должен находить ровно один элемент. Маски отклоняются.
Шаг click также может содержать expect_error_dialog или expect_warning.
Заголовок, совпавший с несколькими кнопками, отклоняется с matchedButtons: у каждой кнопки
name и title, и следующий запуск нажимает нужную по button_name; заголовок, не совпавший
ни с одной, перечисляет кнопки формы в observedButtons. edt_test_form проверяет шаги до
копирования базы, поэтому отклоненный шаг не стоит запуска.
action |
Остальные обязательные поля | Операция |
|---|---|---|
input |
field, text |
Заменяет текст поля ввода и переводит фокус на следующий элемент формы. Пустой текст вызывает штатное действие Clear(). |
click |
button или button_name |
Нажимает доступную кнопку. Читает панель сообщений до и после нажатия, если его результат проверяет assert_messages. |
assert_field |
field, equals |
Читает GetDataPresentation() и сравнивает возвращенную строку. |
assert_cell |
field, cell, equals |
Читает одну ячейку табличного документа, например "cell": "R3C6", и сравнивает ее текст. |
assert_table |
field, equals |
Читает прямоугольник от R1C1 до последней заполненной строки и колонки или все строки таблицы формы; сравнивает полный массив строк. Для таблицы формы результат называет и колонки. |
assert_table_size |
field, rows, columns |
Сравнивает номера последней заполненной строки и колонки табличного документа или число строк и видимых колонок таблицы формы. |
assert_messages |
text, count |
Проверяет точное число вхождений сообщения после предшествующего нажатия при нулевом числе до него. |
read_form |
– | Возвращает значения всей формы: каждое видимое поле с name, title и presentation, каждую видимую таблицу формы с columns и rows, каждое поле табличного документа строками. Ничего не сравнивает. |
read_table |
field |
Возвращает одну таблицу формы вместе с колонками или одно поле табличного документа строками. Ничего не сравнивает. |
Значения text и одиночного equals – строки, в том числе для дат и чисел. Их длина
ограничена 4096 символами. Сравнение учитывает регистр, пробелы и форматирование.
Использовать фактический формат ввода и представления тестового клиента. API не возвращает
исходное типизированное значение реквизита. Если возвращенное представление не содержит
времени, такое сравнение не позволяет доказать его сохранность.
Проверка assert_cell работает только с полем табличного документа. assert_table,
assert_table_size и read_table находят таблицу одинаково и принимают поле табличного документа или таблицу формы, в том
числе динамический список, по имени элемента. Таблица формы читается тестовым клиентом
построчно с первой строки: текст ячейки каждой видимой колонки. Действие assert_table принимает прямоугольный массив строк:
до 200 строк и 50 колонок. Если фактический документ больше, проверка завершается ошибкой.
В результат входят шапки, итоги и пустые ячейки внутри прямоугольника. Действие
assert_table_size на табличном документе измеряет границы заполненной области, а не количество
записей данных; строки таблицы формы считаются до 200.
Значение rows – от 0 до 999999, columns – от 0 до 99999. В адресе cell номера
строки и колонки положительные, в тех же пределах. Пустой табличный документ можно
проверить через "equals": [].
Проверка сообщений
Перед assert_messages должен быть click без промежуточного input. Используются
снимки панели до и после этого нажатия, даже если между ним и проверкой есть другие
проверки. Поле count содержит целое число от 0 до 10000: сколько сообщений с точно
таким текстом добавило нажатие; ноль проверяет, что не добавило ни одного. Сообщения,
которые уже были в панели, не считаются, поэтому второе нажатие той же команды снова
проверяется с count 1. Команда дописывает сообщения после прежних, а очистка панели
убирает их все: если прежние сообщения больше не стоят в начале панели, она была
очищена, и новым считается все, что в ней есть. Поле panel в проверке говорит, что
произошло: appended, cleared или unchanged. Если панель не изменилась, а текст в
ней уже был, результат – message_baseline_not_empty: команда либо ничего не написала,
либо очистила панель и написала те же сообщения заново, и различить это нельзя. Если
команда очищает панель перед записью, дайте повторному сообщению отличающийся текст или
проверяйте его отдельным запуском. Проверяется панель сообщений,
а не модальные предупреждения или кратковременные оповещения. Прочитать сообщения до
закрытия формы: команда “Записать и закрыть” может убрать панель.
Чтение значений
Шаги read_form и read_table кладут прочитанное в reads результата с номером шага, а
оценку оставляют вызывающему. actual у read_table – массив строк, каждая – массив текстов
ячеек, рядом columns для таблицы формы; actual у read_form – объект с fields, tables,
spreadsheets и truncated. Тестовый клиент видит только элементы формы: реквизит без
элемента на форме не читается, скрытый элемент пропускается. Чтобы проверить такое значение,
его нужно вывести на форму, например полем только для просмотра. Поле, представление которого
прочитать не удалось, содержит error вместо presentation. Чтение отбрасывает то, что не
укладывается в пределы (500 элементов формы, 200 строк и 50 колонок таблицы), и ставит truncated
у формы, таблицы или шага. assert_table при превышении пределов отказывает: он сравнивает только
полные таблицы. Таблица формы читается с первой строки вниз. Неудачный переход к следующей строке
считается концом таблицы, только если курсор стоит на последней строке; иначе шаг завершается
ошибкой, и сбой чтения не выглядит как короткая таблица.
Именованные сценарии
Большую часть запуска занимает старт клиента и менеджера тестирования, около минуты, а шаги
сценария идут секунды. scenarios проигрывает несколько сценариев за один старт: это список из
1–20 объектов с уникальным name и своими steps, которые проверяются по тем же правилам, что и
steps. Перед каждым сценарием после первого форма открывается заново, поэтому каждый начинается
на новой форме.
{"version": 1, "scenarios": [
{"name": "Пустой период", "steps": [{"action": "click", "button": "Сформировать"},
{"action": "read_table", "field": "Результат"}]},
{"name": "Две организации", "steps": [{"action": "input", "field": "Организация", "text": "Вторая"},
{"action": "click", "button": "Сформировать"},
{"action": "read_table", "field": "Результат"}]}
]}
- .epf или .erf открывает обработка-загрузчик, которая остается за формой. Перед следующим
сценарием закрываются окна, оставшиеся от предыдущего: сама форма, окно над ней и открытая ею
форма. Затем загрузчик открывает форму заново. .epf подключается в небезопасном режиме, как
клиент запускает .epf, открытую им самим. У формы, открытой по
--navigation-link, загрузчика нет, поэтому именованным сценариям нужен .epf или .erf. - Все сценарии одного запуска работают в одной копии базы: записанное одним сценарием видит следующий. Сценарий, которому нужны чистые данные, запускается отдельно.
- У каждого сценария свой итог в
scenarios, в порядке файла. Отказ сценария не останавливает следующий. Форма, которую не удалось открыть заново, останавливает запуск: этот сценарий получаетreopen_failed, следующие –not_run. reopenсscenariosне сочетается.
Порядок выполнения
Менеджер записывает наблюдения; Python сравнивает ожидания после завершения всей фазы.
Несовпадение промежуточной проверки не останавливает последующие действия в той же фазе.
Ошибка выполнения действия останавливает фазу. После неуспешных проверок фаза reopen
не запускается. Сценарий не содержит произвольного BSL или собственного условия успеха.