Настройка сервера приложений¶
Библиотека gs-automation требует специальной настройки сервера приложений.
Если вы используете локальный сервер приложений, то вам необходимо самостоятельно выполнить его настройку.
Если вы подключаетесь к серверу приложений, размещенному на отдельном стенде, то настройку должен выполнить администратор.
В конфигурационном файле сервера приложений должны быть установлены параметры клиента автоматизации и определены роли пользователей, от имени которых библиотека будет управлять пользовательскими сеансами.
Note
Библиотека выполняет завершение пользовательского сеанса в случае аварийного завершения тестов.
Библиотека предоставляет возможность завершить пользовательский сеанс, если это нужно в рамках тестового сценария.
See also
Спецификация: Требования к серверу приложений
Справочник API:
SessionServiceClient#kill()
Справочник API:
SessionsServiceClient#kill()
Параметры клиента автоматизации¶
Взаимодействие библиотеки с сервером приложений регулируется тремя параметрами конфигурации сервера приложений:
Тип значений параметров — Boolean, значение по умолчанию — false
.
metaDataAttributes¶
Этот параметр управляет внедрением служебных меток (data-атрибутов
) в
веб-интерфейс приложения.
Служебные метки помогают библиотеке находить ключевые элементы интерфейса на отображаемых страницах и взаимодействовать с ними.
Если значение параметра равно false
, библиотека не сможет взаимодействовать
с интерфейсом.
Attention
Установка значения true
обязательно для использования библиотеки.
See also
jexlExecution¶
Этот параметр разрешает библиотеке отправку jexl-скриптов на сервер приложений.
Если значение равно true
, сервер приложений добавляет в интерфейс пользователя
специальные механизмы, обеспечивающие:
Передачу текста jexl-скрипта на сервер.
Ожидание завершения выполнения jexl-скрипта.
Получение результата выполнения jexl-скрипта.
Эта функция библиотеки не обязательна и значение параметра выбирается исходя из требований конкретной задачи.
See also
Руководство пользователя: Аннотации
operExecution¶
Этот параметр разрешает библиотеке запрашивать выполнение бизнес-операций.
Если значение равно true
, сервер приложений добавляет в интерфейс пользователя
специальные механизмы, обеспечивающие:
Инициировать запросы на выполнение бизнес-операций по их названию.
Ожидать завершения выполнения бизнес-операций.
Получать результат выполнения бизнес-операций.
Эта функция библиотеки не обязательна и значение параметра выбирается исходя из требований конкретной задачи.
See also
Руководство пользователя: Аннотации
Пример¶
Значения параметров клиента автоматизации задаются в конфигурации сервера
в разделе Configuration.Client.Automation
:
<client>
<automation metaDataAttributes="true"
jexlExecution="true"
operExecution="true"
/>
</client>
Здесь показаны значения параметров сервера приложений, разрешающих библиотеке взаимодействовать с интерфейсом, выполнять jexl-скрипты и бизнес-операции.
Роль для управления пользовательскими сеансами¶
Библиотека позволяет управлять пользовательскими сеансами.
Для этого в конфигурации сервера
в разделе Configuration.Security
в подразделе Configuration.Users
соответствующему пользователю Configuration.Users.User
должна быть
назначена роль http-monitor
.
Пример назначения роли:
<security>
<users>
<user name="admin" password="admin" roles="system,http-monitor"/>
</users>
</security>
Пользователю admin
назначена требуемая роль http-monitor
.
Такие пользователи регистрируются в процессе создания объекта клиента.
See also
Версия сервера приложений¶
Работа библиотеки зависит от функциональности, предоставляемой сервером приложений. Версии библиотеки коррелируют с версиями сервера приложений.
При подключении к серверу приложений библиотека проверяет его версию и прекращает работу, если обнаруживает несоответствие версий (функциональность сервера не соответствует внутренним требованиям библиотеки).
See also
Спецификация: Версионирование