Спецификация

Назначение

Библиотека включает набор классов, представляющих элементы пользовательского интерфейса, и обеспечивает взаимодействие с ними. Используется библиотека Selenium и её реализация протокола удалённого управления браузерами WebDriver API.

Note

  • Список поддерживаемых браузеров и их версий определяется библиотекой Selenium.

  • Библиотека Selenium требует Java 21 или новее.

Библиотека может использоваться:

  • В составе самостоятельных приложений

  • В составе UI-тестов

Возможности

  • Выполнение аутентификации

    Вход и выход пользователя из системы.

    Warning

    Реализована только передача учётных данных (логин и пароль) через URL.

  • Выбор приложения

    Запуск выбранного прикладного решения.

    Warning

    Реализован только выбор приложения через сегмент URL-адреса.

  • Взаимодействие с меню и панелью инструментов

    Выбор пунктов главного меню и нажатие на кнопки панели инструментов.

    Warning

    Иногда клик по кнопке панели инструментов не обрабатывается с первого раза после ввода значения в карточку.

  • Взаимодействие с вкладками выборки и MDI-формами

    Переключение между вкладками выборки. Переключение между открытыми MDI-формами.

  • Ожидание форм

    Ожидание открытия на интерфейсе форм или диалогов.

    Added in version 1.2.1: Поиск открытого диалога без ожидания его появления.

  • Поиск выборок

    Поиск или ожидание появления одной или нескольких выборок в интерфейсе.

  • Ввод данных.

    Ввод значений в поля карточек и редактируемых таблиц.

  • Взаимодействие с кнопками редакторов

    Открытие выпадающих диалогов и форм редакторов.

  • Взаимодействие с выпадающими диалогами редакторов

    Ввод значений в поля выпадающих диалогов редакторов. Выбор значений в выпадающих диалогах с табличным представлением.

    Added in version 1.2.1: Получение даты, выбранной в выпадающем календаре. Поиск отображаемого выпадающего списка поля без ожидания его появления.

  • Взаимодействие с табличными представлениями

    Эмуляция кликов кнопками мыши в элементы табличного представления. Выделение/выбор строки таблицы. Выбор ячейки таблицы по порядковому номеру строки и порядковому номеру столбца либо названию атрибута столбца.

    Added in version 1.1.3: Выбор строки таблицы в карточном режиме по названию и по наименоваанию атрибута.

    Added in version 1.2.1: Получение строки группы таблицы по заголовку группы, сворачивание и разворачивание группы, проверка, свёрнута ли группа.

  • Эмуляция клавиатуры

    Эмуляция нажатий клавиш клавиатуры (включая комбинации клавиш).

  • Ожидание ответа сервера

    Ожидание, пока у выборки не останется запросов к серверу, ответ на которые ещё не применён к интерфейсу.

    Added in version 1.2.1: Клик, перетаскивание, ввод значения и нажатие клавиш выполняются только после того, как у ближайшей выборки элемента завершены запросы к серверу. Явное ожидание доступно методом Selection#waitRequestCompleted().

  • Выполнение Jexl

    Выполнение Jexl-скриптов в контексте выборки с возможностью возврата строкового результата.

    Changed in version 1.2.1: Результат возвращается после того, как применены изменения интерфейса из ответа сервера на скрипт.

  • Выполнение операции

    Выполнение операции выборки по имени с возможностью возвращения строкового результата.

  • Управление пользовательским сессиями.

    Принудительное завершение пользовательских сессий.

  • Тестовые данные автотестов

    Создание данных теста jexl-скриптом с маркером, по которому выборка показывает только данные теста, поэтому одновременные прогоны одного теста на одной базе данных не видят данные друг друга. Тест данные не удаляет. Их удаляет системное задание очистки сервера CleanupJob (системное имя задания очистки таблиц в менеджере заданий Btk_JobGroup), в котором тест регистрирует удаление записей автотестов своей сущности если они были созданы более чем 24 часа назад.

    Сервис вынесен в отдельный модуль gs-automation-service для собственных тестов сервера приложений, потому что требует своего onRefresh в выборке (см. Тестовые данные автотестов).

    Требуется адаптация выборки сущности. Представление с данными автотестов заводится в выборке самой сущности, объявляет строковую переменную для маркера и отбирает записи, у которых значение атрибута начинается с маркера. Без маркера выборка будет пустой. Маркер, как из примера sTestDataMarker, это уникальный набор символов определяемый самой выборкой.

    override protected def onLoadMeta(): Unit = {
      super.onLoadMeta()
      addVar("sTestDataMarker", None.ns, FieldType.ftString)
    }
    
    override protected def onRefresh: Recs = {
      val marker = getSelfVar("sTestDataMarker").asString()
      val condition = if (marker != null && "gsauto-[A-Za-z0-9-]+-".r.matches(marker))
        s"t.sCode like '$marker%'" else "1 = 0"
      s"select t.* from Gs3_HugeSelection t where $condition"
    }
    

    Added in version 1.2.1.

  • Интеграция с ScalaTest

    Окружение для тестов прикладных решений на Scala. Трейт подмешивается в класс тестов ScalaTest, поднимает браузер и входит в приложение перед тестами класса, выходит и закрывает браузер после них. Модуль gs-automation-app собирается под Scala 2.13 и Scala 3.

    Added in version 1.2.1.

  • Работа в режиме offline

    В составе библиотеки содержатся web-драйверы основных браузеров (включая браузер Yandex). Включение web-драйверов в состав библиотеки позволяет использовать ее в “закрытом контуре” без доступа к сети Интернет.

Примеры использования

Added in version 1.1.1: Демонстрационные проекты доступны в виде архива в репозитории https://repo.global-system.ru