.. _gsauto_ug_usage:

Использование
=============


При использовании библиотеки требуется выполнять определенную
последовательность действий.

Создание клиента
----------------

Использование библиотеки начинается с создания экземпляра строителя :java:type:`ClientBuilder <ru.bitec.gs.automation.client.ClientBuilder>` и
построения экземпляра клиента веб-браузера :java:type:`Client <ru.bitec.gs.automation.client.Client>`.
Клиент веб-браузера декорирует экземпляр
:java:type:`org.openqa.selenium.remote.RemoteWebDriver`, запускающего и управляющего процессом веб-браузера.

При построении клиента определяются:

- Конкретная реализация RemoteWebDriver (:java:type:`ChromeDriver <org.openqa.selenium.chromium.ChromeDriver>`, :java:type:`EdgeDriver <org.openqa.selenium.edge.EdgeDriver>` и т.п.).
- Адрес сервера приложений Global ERP.
- Стратегия входа в систему и выбора приложения :java:type:`LoginStrategy <ru.bitec.gs.automation.client.login.LoginStrategy>` .
- Стратегия закрытия приложения и выхода из системы :java:type:`LogoutStrategy <ru.bitec.gs.automation.client.logout.LogoutStrategy>`.
- Учётные данные пользователя и администратора.

.. seealso::
   - API: :java:type:`ru.bitec.gs.automation.client.Client <ru.bitec.gs.automation.client.Client>`
   - Руководство пользователя: :ref:`gsauto_ug_app`

Подключение клиента
-------------------

В начале работы с клиентом необходимо вызвать метод :java:meth:`Client#login() <ru.bitec.gs.automation.client.Client.login()>`.
Метод выполнит запуск веб-браузера, подключение к
системе и открытие приложения. После успешного выполнения этих действий, будет возвращён объект типа
:java:type:`Application <ru.bitec.gs.automation.client.ui.Application>`.

.. seealso::

   - API: :java:type:`ru.bitec.gs.automation.client.ui.Application <ru.bitec.gs.automation.client.ui.Application>`
   - Руководство пользователя: :ref:`gsauto_ug_application`

Выполнение действий
-------------------

На этом этапе вы выполняете требуемые действия и проверки, используя классы и методы библиотеки.

.. seealso::
   - Руководство пользователя: :ref:`gsauto_ug_app`
   - Руководство пользователя: :ref:`gsauto_ug_junit`
   - Руководство пользователя: :ref:`gsauto_ug_objects`

Закрытие клиента
----------------

В завершении работы с клиентом необходимо вызвать метод :java:meth:`Client#logout() <ru.bitec.gs.automation.client.Client.logout()>`.
Метод выполнит закрытие приложения, завершит пользовательскую сеанс на сервере и закроет веб-браузер.

.. seealso::
   - API: :java:type:`ru.bitec.gs.automation.client.Client <ru.bitec.gs.automation.client.Client>`
   - Руководство пользователя: :ref:`gsauto_ug_app`

.. toctree::
   :maxdepth: 1
   :includehidden:
   :titlesonly:
   :hidden:

   use_app.rst
   use_junit.rst