Selection

public class Selection extends AbstractUiElement

New in version 1.1.0: Добавлен методы locate(Map) и locate(Map, LocateOption[]), добавлены методы ожидания выборки, имена и сигнатуры методов приведены к соглашению по именам.

Выборка.

Не имеет графического представления на экране, но обладает элементом в дереве html-элементов браузера.

Constructors

Selection

protected Selection(BrowserContext browserContext, WebElement webElement)

Selection

protected Selection(AbstractUiElement parent, WebElement webElement)

Methods

executeJexl

public Object executeJexl(String jexlScript)

New in version 1.1.0: Добавлено ожидание появления признака окончания выполнения jexl-скрипта по состоянию маркера Attributes.DATA_SELECTION_JEXL_INPROGRESS.

Отправляет Jexl-скрипт на сервер, где он выполняется в контексте текущей выборки.

Для возможности выполнения скриптов, в конфигурации сервера должна быть активирована опция. `<client><automation jexlExecution="true"/><client/>`

Parameters:

  • jexlScript – Текст Jexl-скрипта.

Throws:

  • AutomationException – если возникли проблемы при вызове операции на выполнение.

Returns:

Результат выполнения Jexl-скрипта, возвращённый из скрипта выражением return “результат”;.

executeOperation

public Object executeOperation(String name)

Отправляет на сервер команду выполнения операции по имени.

Для возможности выполнения скриптов, в конфигурации сервера должна быть активирована опция `<client><automation operExecution="true"/><client/>`

Parameters:

  • name – Имя операции.

Throws:

  • AutomationException – если возникли проблемы при вызове операции на выполнение.

Returns:

Строка с результатом выполнения операции, если операция возвращает результат.

find

public static Optional<Selection> find(AbstractUiElement parent, String name)

New in version 1.1.0: Сигнатура приведена к соглашению по именам (ранее возвращалась выборка, теперь возвращается опциональная выборка).

Метод ищет первый html-элемент, соответствующий выборке с именем name и отображением “Default”, во множестве дочерних html-элементов элемента parent.

Parameters:

  • parent – родительский html-элемент

  • name – имя выборки

Returns:

Опциональная выборка

find

public static Optional<Selection> find(AbstractUiElement parent, String name, String representation)

New in version 1.1.0: Сигнатура приведена к соглашению по именам (ранее возвращалась выборка, теперь возвращается опциональная выборка).

Метод ищет первый html-элемент, соответствующий выборке с именем name и отображением representation, во множестве дочерних html-элементов элемента parent.

Parameters:

  • parent – родительский html-элемент

  • name – имя выборки

  • representation – отображение

Returns:

Опциональная выборка

find

public static Optional<Selection> find(AbstractUiElement parent, Name name)

New in version 1.1.0: Сигнатура приведена к соглашению по именам (ранее возвращалась выборка, теперь возвращается опциональная выборка).

Метод ищет первый html-элемент, соответствующий выборке с именем и отображением указанным в name, во множестве дочерних html-элементов элемента parent.

Parameters:

  • parent – родительский html-элемент

  • name – имя и отображение выборки

Returns:

Опциональная выборка

findAll

public static Selection[] findAll(BrowserContext browserContext)

Метод ищет на странице все html-элементы, соответствующие выборкам.

Parameters:

  • browserContext – Контекст браузера

Returns:

Массив выборок

findAll

public static Selection[] findAll(AbstractUiElement parent)

Метод ищет все html-элементы, соответствующие выборкам, во множестве дочерних html-элементов элемента parent.

Parameters:

  • parent – родительский html-элемент

Returns:

массив выборок

findBySimpleName

static Optional<Selection> findBySimpleName(AbstractUiElement parent, String simpleName, String representation)

New in version 1.1.0: Сигнатура приведена к соглашению по именам (ранее возвращалась выборка, теперь возвращается опциональная выборка).

Метод ищет первый html-элемент, соответствующий выборке с именем завершающимся simpleName и отображением representation, во множестве дочерних html-элементов элемента parent.

Метод относится к системным и не вынесен в public намеренно. Не полные имена могут быть только у главных выборок приложений.

Parameters:

  • parent – родительский html-элемент

  • simpleName – Краткое имя выборки

  • representation – отображение

Returns:

Опциональная выборка

findBySimpleName

static Optional<Selection> findBySimpleName(AbstractUiElement parent, Name name)

New in version 1.1.0: Сигнатура приведена к соглашению по именам (ранее возвращалась выборка, теперь возвращается опциональная выборка).

Метод ищет первый html-элемент, соответствующий выборке с именем, завершающимся Name.getSimpleName(), и отображением Name.getRepresentation(), во множестве дочерних html-элементов элемента parent.

Метод относится к системным и не вынесен в public намеренно. Не полные имена могут быть только у главных выборок приложений.

Parameters:

  • parent – родительский html-элемент

  • name – Краткое имя и отображение выборки

Returns:

Опциональная выборка

get

public static Selection get(AbstractUiElement parent, String name)

New in version 1.1.0.

Метод возвращает первый html-элемент, соответствующий выборке с именем name и отображением “Default”, во множестве дочерних html-элементов элемента parent.

Parameters:

  • parent – родительский html-элемент

  • name – имя выборки

Throws:
Returns:

Выборка

get

public static Selection get(AbstractUiElement parent, String name, String representation)

New in version 1.1.0.

Метод возвращает первый html-элемент, соответствующий выборке с именем name и отображением representation, во множестве дочерних html-элементов элемента parent.

Parameters:

  • parent – родительский html-элемент

  • name – имя выборки

  • representation – отображение

Throws:
Returns:

Выборка

get

public static Selection get(AbstractUiElement parent, Name name)

New in version 1.1.0.

Метод возвращает первый html-элемент, соответствующий выборке с именем и отображением указанным в name, во множестве дочерних html-элементов элемента parent.

Parameters:

  • parent – родительский html-элемент

  • name – имя и отображение выборки

Throws:
Returns:

Выборка

getBySimpleName

static Selection getBySimpleName(AbstractUiElement parent, String simpleName, String representation)

New in version 1.1.0.

Метод возвращает первый html-элемент, соответствующий выборке с именем завершающимся simpleName и отображением representation, во множестве дочерних html-элементов элемента parent.

Метод относится к системным и не вынесен в public намеренно. Не полные имена могут быть только у главных выборок приложений.

Parameters:

  • parent – родительский html-элемент

  • simpleName – Краткое имя выборки

  • representation – отображение

Throws:
Returns:

выборка

getBySimpleName

static Selection getBySimpleName(AbstractUiElement parent, Name name)

New in version 1.1.0.

Метод возвращает первый html-элемент, соответствующий выборке с именем, завершающимся Name.getSimpleName(), и отображением Name.getRepresentation(), во множестве дочерних html-элементов элемента parent.

Метод относится к системным и не вынесен в public намеренно. Не полные имена могут быть только у главных выборок приложений.

Parameters:

  • parent – родительский html-элемент

  • name – Краткое имя и отображение выборки

Throws:
Returns:

Выборка

getId

public String getId()

Возвращает идентификатор выборки в виде строкового представления.

Returns:

Идентификатор

getJexlSelectionLocateScript

protected static String getJexlSelectionLocateScript(Map<String, Object> propertyMap, Selection.LocateOption[] locateOptions)

Конструирование простого запроса вида “selection.locate”

Parameters:

  • propertyMap – простая карта параметров.

  • locateOptions – массив опций запроса

Returns:

строка, которую можно передать в метод executeJexl

getName

public String getName()

Возвращает полное имя.

Returns:

полное имя.

getQualifiedName

public Name getQualifiedName()

Возвращает квалифицированное имя формы Name.

Returns:

Квалифицированное имя.

getRepresentation

public String getRepresentation()

Возвращает отображение.

Returns:

отображение.

layout

public Layout layout()

locate

public Object locate(Map<String, Object> propertyMap)

New in version 1.1.0.

Метод, упрощающий написание вызова вида selection.executeJexl("selection.locate(asScala({'id': 353L}), asScala([...]))");. Собственно, именно такой вызов этот метод и делает.

Parameters:

  • propertyMap – простая карта параметров.

Returns:

результат

locate

public Object locate(Map<String, Object> propertyMap, Selection.LocateOption[] locateOptions)

New in version 1.1.0.

Метод, упрощающий написание вызова вида selection.executeJexl("selection.locate(asScala({'id': 353L}), asScala([new ru.bitec.app.gtk.gl.selection.locateoption.Up(), ...]))");. Собственно, именно такой вызов этот метод и делает, с учетом переданных :java:ref:`Selection.LocateOption <ru.bitec.gs.automation.client.ui.Selection.LocateOption>`[].

Parameters:

  • propertyMap – простая карта параметров.

  • locateOptions – массив опций для selection.locate

Returns:

результат

locateOptionArrayToString

protected static String locateOptionArrayToString(Selection.LocateOption[] locateOptions)

Конструирование строки опций для запроса вида “selection.locate”

Parameters:

  • locateOptions – массив опций

Returns:

строка

toString

public String toString()

wait

public static Selection wait(AbstractUiElement parent, String name)

New in version 1.1.0.

Метод ожидает появления на dom-модели первого html-элемента, соответствующего выборке с именем name и отображением “Default”, во множестве дочерних html-элементов элемента parent.

Parameters:

  • parent – родительский html-элемент

  • name – имя выборки

Returns:

Выборка

wait

public static Selection wait(AbstractUiElement parent, String name, String representation)

New in version 1.1.0.

Метод ожидает появления на dom-модели первого html-элемента, соответствующего выборке с именем name и отображением representation, во множестве дочерних html-элементов элемента parent.

Parameters:

  • parent – родительский html-элемент

  • name – имя выборки

  • representation – отображение

Returns:

Выборка

wait

static Selection wait(AbstractUiElement parent, Name name)

New in version 1.1.0.

Метод ожидает появления на dom-модели первого html-элемента, соответствующего выборке с именем и отображением указанным в name, во множестве дочерних html-элементов элемента parent.

Parameters:

  • parent – родительский html-элемент

  • name – имя и отображение выборки

Returns:

Выборка

wait

public static Selection wait(AbstractUiElement parent, Name name, Duration duration)

New in version 1.1.0.

Метод ожидает появления на dom-модели первого html-элемента, соответствующего выборке с именем и отображением указанным в name, во множестве дочерних html-элементов элемента parent.

Parameters:

  • parent – родительский html-элемент

  • name – имя и отображение выборки

  • duration – длительность ожидания

Returns:

Выборка

waitBySimpleName

static Selection waitBySimpleName(AbstractUiElement parent, Name name)

New in version 1.1.0.

Метод ожидает появления на dom-модели первого html-элемента, соответствующего выборке с именем, завершающимся Name.getSimpleName(), и отображением Name.getRepresentation(), во множестве дочерних html-элементов элемента parent.

Метод относится к системным и не вынесен в public намеренно. Не полные имена могут быть только у главных выборок приложений.

Parameters:

  • parent – родительский html-элемент

  • name – Краткое имя и отображение выборки

Returns:

Выборка

waitBySimpleName

static Selection waitBySimpleName(AbstractUiElement parent, Name name, Duration duration)

New in version 1.1.0.

Метод ожидает появления на dom-модели первого html-элемента, соответствующего выборке с именем, завершающимся Name.getSimpleName(), и отображением Name.getRepresentation(), во множестве дочерних html-элементов элемента parent.

Метод относится к системным и не вынесен в public намеренно. Не полные имена могут быть только у главных выборок приложений.

Parameters:

  • parent – родительский html-элемент

  • name – Краткое имя и отображение выборки

  • duration – Длительность ожидания

Returns:

Выборка