3. Функции UIWeb

Общее

Здесь представлено описание всех функций, необходимых для максимально эффективного управления web интерфейсами различных приложений.

Описание функций

Описание каждой функции начинается с обозначения L+,W+, что означает, что функция поддерживается в ОС Linux (L) и Windows (W)

Functions:

BrowserChange(inBrowser)

L+,W+: Выполнить смену активного браузера (при необходимости).

BrowserChromeStart([inDriverExePathStr, ...])

L+,W+: Выполнить запуск браузера Chrome.

BrowserClose()

L+,W+: Закрыть браузер

BrowserFocus()

L+,W+: Выполнить фокусировку на окно браузера

MouseSearchChild()

L+,W+: Инициировать визуальный поиск UIO объекта с помощью указателя мыши.

MouseSearchChildTree([inWaitBeforeSec])

L-,W+: Получить список уровней UIO объекта с указнием всех имеющихся атрибутов.

PageClose([inIndexInt])

L+,W+: Закрыть текущую вкладку или вкладку, расположенную по индексу inIndexInt.

PageCount()

L+,W+: Вернуть количество открытых вкладок в браузере

PageJSExecute(inJSStr, *inArgList)

L+,W+: Отправить на выполнение на сторону браузера код JavaScript.

PageNew([inURLStr])

L+,W+: Открыть новую вкладку в браузере

PageOpen(inURLStr)

L+,W+: Открыть страницу inURLStr в браузере и дождаться ее загрузки.

PagePrint()

L+,W+: Открыть окно печати браузера.

PageScrollTo([inVerticalPxInt, ...])

L+,W+: Выполнить прокрутку страницы (по вертикали или по горизонтали)

PageSwitch(inTabIndexInt)

L+,W+: Переключить вкладку по индексу inTabIndexInt

SelectorConvert(inSelector, inToTypeStr)

L+,W+: Перевести селектор в заданный тип.

UIOAttributeDictGet(inUIO)

L+,W+: Получить словарь атрибутов UI объекта.

UIOAttributeGet(inUIO, inAttributeStr)

L+,W+: Получить обычный (нестилевой) атрибут у UI элемента.

UIOAttributeRemove(inUIO, inAttributeStr)

L+,W+: Удалить обычный (нестилевой) атрибут у UI элемента.

UIOAttributeSet(inUIO, inAttributeStr, inValue)

L+,W+: Установить обычный (нестилевой) атрибут у UI элемента.

UIOAttributeStyleGet(inUIO, inAttributeStr)

L+,W+: Получить стилевой атрибут у UI элемента.

UIOAttributeStyleRemove(inUIO, inAttributeStr)

L+,W+: Удалить стилевой атрибут у UI элемента.

UIOAttributeStyleSet(inUIO, inAttributeStr, ...)

L+,W+: Установить стилевой атрибут у UI элемента.

UIOChildListAttributeDictGet(inUIO)

L+,W+: Получить список словарь атрибутов для детей UI объекта inUIO.

UIOClick(inUIO)

L+,W+: Выполнить нажатие по элементу inUIO.

UIOHighlight(inUIO[, inIsFirst, ...])

L+,W+: Выполнить подсвечивание UI элемента с UIO.

UIOMouseSearchInit()

L+,W+: Инициализирует процесс поиска UI элемента с помощью мыши.

UIOMouseSearchReturn([inStopSearchBool])

L+,W+: Возвращает UIO объект, над которым находится указатель мыши.

UIOSelectorActivityArgGet(inUIOSelector, ...)

L+,W+: Сформировать преднастроенный список/словарь аргументов, передаваемый в функцию inActionStr, которая будет вызываться у объекта UIO, полученного по inUIOSelector

UIOSelectorActivityListGet(inUIOSelector)

L+,W+: Получить список доступных действий/функций по UIO селектору inUIOSelector.

UIOSelectorActivityRun(inUIOSelector, ...[, ...])

L+,W+: Выполнить активность inActionName над UIO объектом, полученным с помощью UIO селектора inUIOSelector.

UIOSelectorChildListAttributeDictGet([...])

L+,W+: Получить список словарей атриботов детей UI объекта, определенного по inUIOSelector

UIOSelectorClick(inUIOSelectorStr)

L+,W+: Выполнить нажатие по элементу с селектором inUIOSelectorStr.

UIOSelectorDetect(inUIOSelectorStr)

L+,W+: Идентифицировать стиль селектора (CSS или XPATH или UIO)

UIOSelectorFirst([inUIOSelectorStr, inUIO])

L+,W+: Получить UIO объект по UIO селектору.

UIOSelectorFocusHighlight(inUIOSelectorStr)

L+,W+: Выполнить подсвечивание UI элемента с селектором inUIOSelectorStr.

UIOSelectorHighlight(inUIOSelectorStr[, ...])

L+,W+: Выполнить подсвечивание UI элемента с селектором inUIOSelectorStr.

UIOSelectorLevelInfoList(inUIOSelector)

L+,W+: Получить список свойств всех уровней до UI объекта, обнаруженного с помощью селектора inUIOSelector.

UIOSelectorList([inUIOSelectorStr, inUIO])

L+,W+: Получить список UIO объектов по UIO селектору.

UIOSelectorListAttributeDictGet([inUIOSelector])

L+,W+: Получить словарь атрибутов для UI объектов, которые удовлетворяют inUIOSelector селектору

UIOSelectorSetValue(inUIOSelectorStr, inValue)

L+,W+: Установить значение элемента с селектором inUIOSelectorStr.

UIOSelectorWaitAppear(inUIOSelectorStr[, ...])

L+,W+: Ожидать появление UI элемента на веб странице (блокирует выполнение потока), заданного по UIO селектору inUIOSelectorStr.

UIOSelectorWaitDisappear(inUIOSelectorStr[, ...])

L+,W+: Ожидать исчезновение UI элемента с веб страницы (блокирует выполнение потока), заданного по UIO селектору inUIOSelectorStr.

UIOSelector_To_XPATH([inUIOSelector])

L+,W+: Выполнить конвертацию селектора из UIO в XPATH

UIOTextGet(inUIO)

L+,W+: Получить текст UI элемента.

XPATH_To_UIOSelector([inXPATHSelector])

L+,W+: Выполнить конвертацию селектора из XPATH в UIO
pyOpenRPA.Robot.UIWeb.BrowserChange(inBrowser)[исходный код]

L+,W+: Выполнить смену активного браузера (при необходимости).

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
lBrowser1 = UIWeb.BrowserChromeStart()
UIWeb.BrowserChange(inBrowser=None)
lBrowser2 = UIWeb.BrowserChromeStart()
UIWeb.BrowserClose()
UIWeb.BrowserChange(inBrowser=lBrowser1)
UIWeb.BrowserClose()
Параметры

inBrowser (webdriver.Chrome) – Объект браузера

pyOpenRPA.Robot.UIWeb.BrowserChromeStart(inDriverExePathStr: Optional[str] = None, inChromeExePathStr: Optional[str] = None, inExtensionPathList: Optional[list] = None, inProfilePathStr: Optional[str] = None, inSaveAsPDFBool=False, inSavefileDefaultDirStr: Optional[str] = None, inUrlStr: Optional[str] = None, inModeStr: Optional[str] = None, inMaximizeBool: Optional[bool] = None) → WebDriver[исходный код]

L+,W+: Выполнить запуск браузера Chrome. Если вы скачали pyOpenRPA вместе с репозиторием, то будет использоваться встроенный браузер Google Chrome. Если установка pyOpenRPA производилась другим способом, то требуется указать расположение браузера Google Chrome и соответствующего WebDriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.BrowserClose()
Параметры

inDriverExePathStr (str, опционально) – Путь до компонента webdriver.exe, по умолчанию None (путь до webdriver.exe, который расположен в репозитории pyOpenRPA)

:param inChromeExePathStr:Путь до компонента chrome.exe, по умолчанию None (путь до chrome.exe, который расположен в репозитории pyOpenRPA) :type inChromeExePathStr: str, опционально :param inExtensionPathList: Список путей, по которым располагаются расширения Chrome, по умолчанию None :type inExtensionPathList: list, опционально :param inProfilePathStr: Путь, по которому выполнить сохранения профиля Chrome (история, куки и т.д.), по умолчанию None (профиль не сохраняется) :type inProfilePathStr: str, опционально :param inSaveAsPDFBool: Флаг, который обеспечивает настройки окна печати вэб-страницы как «Сохранить как PDF», по умолчанию False (настройки по умолчанию) :type inSaveAsPDFBool: bool, опционально :param inSavefileDefaultDirStr: Путь, по которому выполнить сохранения файла (после работы с окном печать вэб-страницы браузера) (история, куки и т.д.), по умолчанию None (файл не сохраняется) :type inSavefileDefaultDirStr: str, опционально :param inUrlStr: Путь к странице, которую требуется открыть. По умолчанию адреса нет :type inUrlStr: str, опционально :param inModeStr: Формат запуска браузера. Доступные варианты: «NORMAL», «APP», «KIOSK». По умолчанию «NORMAL» :type inModeStr: str, опционально :param inMaximizeBool: True - развернуть на весь экран. False (по умолчанию) - не разворачивать. :type inMaximizeBool: bool, опционально :return: Объект браузера Google Chrome :rtype: webdriver.Chrome

pyOpenRPA.Robot.UIWeb.BrowserClose()[исходный код]

L+,W+: Закрыть браузер

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
UIWeb.BrowserClose()
pyOpenRPA.Robot.UIWeb.BrowserFocus()[исходный код]

L+,W+: Выполнить фокусировку на окно браузера

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.BrowserFocus()
pyOpenRPA.Robot.UIWeb.MouseSearchChild()[исходный код]

L+,W+: Инициировать визуальный поиск UIO объекта с помощью указателя мыши. При наведении указателя мыши UIO объект выделяется зеленой рамкой. Остановить режим поиска можно с помощью зажима клавиши ctrl left на протяжении нескольких секунд. После этого в веб окне студии будет отображено дерево расположения искомого UIO объекта.

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
import time
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIO = MouseSearchChild()
UIWeb.BrowserClose()
Результат

UIO объект или None (если UIO не был обнаружен)

pyOpenRPA.Robot.UIWeb.MouseSearchChildTree(inWaitBeforeSec=0.0)[исходный код]

L-,W+: Получить список уровней UIO объекта с указнием всех имеющихся атрибутов.

!ВНИМАНИЕ! ДАННАЯ ФУНКЦИОНАЛЬНОСТЬ В АВТОМАТИЧЕСКОМ РЕЖИМЕ ПОДДЕРЖИВАЕТ ВСЕ РАЗРЯДНОСТИ ПРИЛОЖЕНИЙ (32|64), КОТОРЫЕ ЗАПУЩЕНЫ В СЕСИИ. PYTHON x64 ИМЕЕТ ВОЗМОЖНОСТЬ ВЗЗАИМОДЕЙСТВИЯ С x32 UIO ОБЪЕКТАМИ, НО МЫ РЕКОМЕНДУЕМ ДОПОЛНИТЕЛЬНО ИСПОЛЬЗОВАТЬ ИНТЕРПРЕТАТОР PYTHON x32 (ПОДРОБНЕЕ СМ. ФУНКЦИЮ Configure())

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
import time
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIO = MouseSearchChildTree()
UIWeb.BrowserClose()
Параметры

inWaitBeforeSec (float, необязательный) – Время ожидания перед началом поиска и перефокусировки. Данный аргумент может быть полезен для отображения полезной информации перед инициализацией режима поиска

Результат

list, список атрибутов на каждом уровне UIO объекта

pyOpenRPA.Robot.UIWeb.PageClose(inIndexInt=None)[исходный код]

L+,W+: Закрыть текущую вкладку или вкладку, расположенную по индексу inIndexInt. После выключения вкладки вернуть на текущую активную вкладку.

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.PageClose(inTabIndexInt=1)
Параметры

inIndexInt – Индекс вкладки, которую требуется закрыть

Type

int

pyOpenRPA.Robot.UIWeb.PageCount()[исходный код]

L+,W+: Вернуть количество открытых вкладок в браузере

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
tab_count_int = UIWeb.PageCount()
Результат

Количество открытых вкладок в браузере

Тип результата

int

pyOpenRPA.Robot.UIWeb.PageJSExecute(inJSStr, *inArgList)[исходный код]

L+,W+: Отправить на выполнение на сторону браузера код JavaScript.

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

!ВНИМАНИЕ! Данная функция поддерживает передачу переменных в область кода JavaScript (*inArgList). Обратиться к переданным переменным из JavaScript можно с помощью ключевого слова: arguments[i], где i - это порядковый номер переданной переменной

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
UIWeb.PageJSExecute(alert('arguments[0]);", "hello world!")
UIWeb.BrowserClose()
Параметры

  • inJSStr (str) – Код JavaScript, отправляемый на сторону браузера

  • *inArgList –

    Перечисление аргументов, отправляемых на сторону браузера

Результат

Результат отработки кода JavaScript, если он заканчивался оператором «return»

Тип результата

str | int | bool | float

pyOpenRPA.Robot.UIWeb.PageNew(inURLStr: str = '')[исходный код]

L+,W+: Открыть новую вкладку в браузере

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.PageNew("https://pyopenrpa.ru")
Параметры

inURLStr (str, опциональный) – URL адрес страницы, по умолчанию страница пустая, «»

pyOpenRPA.Robot.UIWeb.PageOpen(inURLStr: str)[исходный код]

L+,W+: Открыть страницу inURLStr в браузере и дождаться ее загрузки.

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
UIWeb.BrowserClose()
Параметры

inURLStr (str) – URL адрес страницы

pyOpenRPA.Robot.UIWeb.PagePrint()[исходный код]

L+,W+: Открыть окно печати браузера.

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
import time
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
time.sleep(1)
UIWeb.PagePrint()
UIWeb.BrowserClose()
pyOpenRPA.Robot.UIWeb.PageScrollTo(inVerticalPxInt=0, inHorizontalPxInt=0)[исходный код]

L+,W+: Выполнить прокрутку страницы (по вертикали или по горизонтали)

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
UIWeb.PageScrollTo(inVerticalPxInt=100)
UIWeb.BrowserClose()
Параметры

  • inVerticalPxInt (int, опционально) – Величина вертикальной прокрутки страницы в пикселях, по умолчанию 0

  • inHorizontalPxInt (int, опционально) – Величина горизонтальной прокрутки страницы в пикселях, по умолчанию 0

pyOpenRPA.Robot.UIWeb.PageSwitch(inTabIndexInt: int)[исходный код]

L+,W+: Переключить вкладку по индексу inTabIndexInt

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.PageSwitch(inTabIndexInt=1)
Параметры

inTabIndexInt (int) – Индекс вкладки, на которую требуется переключиться

pyOpenRPA.Robot.UIWeb.SelectorConvert(inSelector, inToTypeStr)[исходный код]

L+,W+: Перевести селектор в заданный тип. Доступно: UIO, CSS и XPATH

# UIWeb: Взаимодействие с UI объектами браузера
from pyOpenRPA.Robot import UIWeb
lToType = "XPATH"
lUIOSelector = [{}]
lXPATHSelector = UIDesktop.Selector_Convert_Selector(inSelector=lUIOSelector, inToTypeStr=lToType)
Параметры

  • inSelector (str или list, обязательный) – Селектор, который необходимо преобразовать

  • inToTypeStr (str, обязательный) – Тип, в который необходимо преобразовать селектор

Результат

Селектор

pyOpenRPA.Robot.UIWeb.UIOAttributeDictGet(inUIO)[исходный код]

L+,W+: Получить словарь атрибутов UI объекта. title - наименование тэга, class_list, style_dict

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lUIO = UIWeb.UIOSelectorFirst(inUIOSelectorStr = lUIOSelectorStr)
UIWeb.UIOAttributeDictGet(lUIO)
Параметры

inUIO (WebElement) – UIO элемент. Получить его можно с помощью функций UIOSelectorList или UIOSelectorFirst

Результат

Пример: {„class_list“: [], „lang“: „ru“, „style_dict“: {„–ph-color-background-accent“: None,“width“: «100%»,“color“: «black»}, „title“: „html“, «nodeName»: null}

Тип результата

dict

pyOpenRPA.Robot.UIWeb.UIOAttributeGet(inUIO, inAttributeStr) → str[исходный код]

L+,W+: Получить обычный (нестилевой) атрибут у UI элемента.

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lUIO = UIWeb.UIOSelectorList(inUIOSelectorStr = lUIOSelectorStr)[0]
UIWeb.UIOAttributeGet(inUIO=lUIO, inAttributeStr = "href")
UIWeb.BrowserClose()
Параметры

  • inUIO (WebElement) – UIO элемент. Получить его можно с помощью функций UIOSelectorList или UIOSelectorFirst

  • inAttributeStr (str) – Наименование обычного (нестилевого) атрибута

Результат

Значение обычного (нестилевого) атрибута

Тип результата

str

pyOpenRPA.Robot.UIWeb.UIOAttributeRemove(inUIO, inAttributeStr)[исходный код]

L+,W+: Удалить обычный (нестилевой) атрибут у UI элемента.

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lUIO = UIWeb.UIOSelectorList(inUIOSelectorStr = lUIOSelectorStr)[0]
UIWeb.UIOAttributeRemove(lUIO, "href")
UIWeb.BrowserClose()
Параметры

  • inUIO (WebElement) – UIO элемент. Получить его можно с помощью функций UIOSelectorList или UIOSelectorFirst

  • inAttributeStr (str) – Наименование обычного (нестилевого) атрибута

pyOpenRPA.Robot.UIWeb.UIOAttributeSet(inUIO, inAttributeStr, inValue)[исходный код]

L+,W+: Установить обычный (нестилевой) атрибут у UI элемента.

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lUIO = UIWeb.UIOSelectorList(inUIOSelectorStr = lUIOSelectorStr)[0]
UIWeb.UIOAttributeSet(inUIO=lUIO, inAttributeStr = "href", inValue = "https://mail.ru")
UIWeb.BrowserClose()
Параметры

  • inUIO (WebElement) – UIO элемент. Получить его можно с помощью функций UIOSelectorList или UIOSelectorFirst

  • inAttributeStr (str) – Наименование обычного (нестилевого) атрибута

  • inValue (str) – Устанавливаемое значение обычного (нестилевого) атрибута

pyOpenRPA.Robot.UIWeb.UIOAttributeStyleGet(inUIO, inAttributeStr) → str[исходный код]

L+,W+: Получить стилевой атрибут у UI элемента.

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lUIO = UIWeb.UIOSelectorList(inUIOSelectorStr = lUIOSelectorStr)[0]
UIWeb.UIOAttributeStyleGet(inUIO=lUIO, inAttributeStr = "href")
UIWeb.BrowserClose()
Параметры

  • inUIO (WebElement) – UIO элемент. Получить его можно с помощью функций UIOSelectorList или UIOSelectorFirst

  • inAttributeStr (str) – Наименование стилевого атрибута

Результат

Значение стилевого атрибута

Тип результата

str

pyOpenRPA.Robot.UIWeb.UIOAttributeStyleRemove(inUIO, inAttributeStr: str)[исходный код]

L+,W+: Удалить стилевой атрибут у UI элемента.

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lUIO = UIWeb.UIOSelectorList(inUIOSelectorStr = lUIOSelectorStr)[0]
UIWeb.UIOAttributeStyleRemove(lUIO, "color")
UIWeb.BrowserClose()
Параметры

  • inUIO (WebElement) – UIO элемент. Получить его можно с помощью функций UIOSelectorList или UIOSelectorFirst

  • inAttributeStr (str) – Наименование стилевого атрибута

pyOpenRPA.Robot.UIWeb.UIOAttributeStyleSet(inUIO, inAttributeStr, inValue)[исходный код]

L+,W+: Установить стилевой атрибут у UI элемента.

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lUIO = UIWeb.UIOSelectorList(inUIOSelectorStr = lUIOSelectorStr)[0]
UIWeb.UIOAttributeStyleSet(inUIO=lUIO, inAttributeStr = "color", inValue = "grey")
UIWeb.BrowserClose()
Параметры

  • inUIO (WebElement) – UIO элемент. Получить его можно с помощью функций UIOSelectorList или UIOSelectorFirst

  • inAttributeStr (str) – Наименование стилевого атрибута

  • inValue (str) – Устанавливаемое значение стилевого атрибута

pyOpenRPA.Robot.UIWeb.UIOChildListAttributeDictGet(inUIO)[исходный код]

L+,W+: Получить список словарь атрибутов для детей UI объекта inUIO. title - наименование тэга, class_list, style_dict

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lUIO = UIWeb.UIOSelectorFirst(inUIOSelectorStr = lUIOSelectorStr)
UIWeb.UIOAttributeDictGet(lUIO)
Параметры

inUIO (WebElement) – UIO элемент. Получить его можно с помощью функций UIOSelectorList или UIOSelectorFirst

Результат

Пример: {«ctrl_index»: 0, „class_list“: [], „lang“: „ru“, „style_dict“: {„–ph-color-background-accent“: None,“width“: «100%»,“color“: «black»}, „title“: „html“}

Тип результата

dict

pyOpenRPA.Robot.UIWeb.UIOClick(inUIO)[исходный код]

L+,W+: Выполнить нажатие по элементу inUIO.

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lUIO = UIWeb.UIOSelectorList(inUIOSelectorStr = lUIOSelectorStr)[0]
UIOClick(inUIO = lUIO)
UIWeb.BrowserClose()
Параметры

inUIO (WebElement) – UIO элемент. Получить его можно с помощью функций UIOSelectorList или UIOSelectorFirst

pyOpenRPA.Robot.UIWeb.UIOHighlight(inUIO, inIsFirst: bool = False, inDurationSecFloat: float = 3.0, inColorStr: str = 'green')[исходный код]

L+,W+: Выполнить подсвечивание UI элемента с UIO.

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lUIO = UIOSelectorFirst(lUIOSelectorStr)
UIWeb.UIOHighlight(inUIO = lUIO)
UIWeb.BrowserClose()
Параметры

  • inUIOSelectorStr (str) – XPATH или CSS селектор UI элемента на web странице. Подсказки по CSS: https://devhints.io/css Подсказки по XPath: https://devhints.io/xpath

  • inIsFirst (bool, опционально) – True - подсветить только первый элемент, который удовлетворяет селектору. По умолчанию False

  • inDurationSecFloat (float, опционально) – Длительность подсвечивания. По умолчанию 3.0 сек.

  • inColorStr (str, опционально) – Цвет подсвечания Варианты: «red», «blue», «grey», «yellow». По умолчанию «green» (зеленый)

pyOpenRPA.Robot.UIWeb.UIOMouseSearchInit()[исходный код]

L+,W+: Инициализирует процесс поиска UI элемента с помощью мыши. После инициализации необходимо переместить указатель мыши на искомый элемент. Для прекращения поиска необходимо использовать функцию: UIOMouseSearchReturn

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
import time
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
UIWeb.UIOMouseSearchInit()
time.sleep(3)
UIWeb.UIOMouseSearchReturn()
UIWeb.BrowserClose()
pyOpenRPA.Robot.UIWeb.UIOMouseSearchReturn(inStopSearchBool=True)[исходный код]

L+,W+: Возвращает UIO объект, над которым находится указатель мыши. Предварительно должна быть вызвана функция UIWeb.UIOMouseSearchInit

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
import time
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
UIWeb.UIOMouseSearchInit()
time.sleep(3)
UIWeb.UIOMouseSearchReturn()
UIWeb.BrowserClose()
Параметры

inStopSearchBool – True - остановить режим поиска

Результат

UIO объект

Тип результата

webelement

pyOpenRPA.Robot.UIWeb.UIOSelectorActivityArgGet(inUIOSelector, inActionStr)[исходный код]

L+,W+: Сформировать преднастроенный список/словарь аргументов, передаваемый в функцию inActionStr, которая будет вызываться у объекта UIO, полученного по inUIOSelector

!ВНИМАНИЕ! ДАННАЯ ФУНКЦИОНАЛЬНОСТЬ В АВТОМАТИЧЕСКОМ РЕЖИМЕ ПОДДЕРЖИВАЕТ ВСЕ РАЗРЯДНОСТИ ПРИЛОЖЕНИЙ (32|64), КОТОРЫЕ ЗАПУЩЕНЫ В СЕСИИ. PYTHON x64 ИМЕЕТ ВОЗМОЖНОСТЬ ВЗЗАИМОДЕЙСТВИЯ С x32 UIO ОБЪЕКТАМИ, НО МЫ РЕКОМЕНДУЕМ ДОПОЛНИТЕЛЬНО ИСПОЛЬЗОВАТЬ ИНТЕРПРЕТАТОР PYTHON x32 (ПОДРОБНЕЕ СМ. ФУНКЦИЮ Configure())

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lUIOArgDict = UIWeb.UIOSelectorActivityArgGet(inUIOSelector = lUIOSelectorStr, inActionStr="type_keys")

#Возвращаемый результат
{'Selector': [{'title': 'UIDesktop.py - ORPA - Visual Studio Code',
'class_name': 'Chrome_WidgetWin_1',
'backend': 'uia'}],
'ArgList': ['keys', None, False, False, False, True, True, True],
'ArgDict': {'keys': None,
'pause': None,
'with_spaces': False,
'with_tabs': False,
'with_newlines': False,
'turn_off_numlock': True,
'set_foreground': True,
'vk_packet': True}}
Параметры

  • inUIOSelector (list, обязательный) – UIO селектор, который определяет UIO объект, для которого будет представлен перечень доступных активностей.

  • inActionStr (str, обязательный) – Наименование метода, к которому выполнить подбор аргументов

pyOpenRPA.Robot.UIWeb.UIOSelectorActivityListGet(inUIOSelector)[исходный код]

L+,W+: Получить список доступных действий/функций по UIO селектору inUIOSelector. Описание возможных активностей см. ниже.

!ВНИМАНИЕ! ДАННАЯ ФУНКЦИОНАЛЬНОСТЬ В АВТОМАТИЧЕСКОМ РЕЖИМЕ ПОДДЕРЖИВАЕТ ВСЕ РАЗРЯДНОСТИ ПРИЛОЖЕНИЙ (32|64), КОТОРЫЕ ЗАПУЩЕНЫ В СЕСИИ. PYTHON x64 ИМЕЕТ ВОЗМОЖНОСТЬ ВЗЗАИМОДЕЙСТВИЯ С x32 UIO ОБЪЕКТАМИ, НО МЫ РЕКОМЕНДУЕМ ДОПОЛНИТЕЛЬНО ИСПОЛЬЗОВАТЬ ИНТЕРПРЕТАТОР PYTHON x32 (ПОДРОБНЕЕ СМ. ФУНКЦИЮ Configure())

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lActivityList = UIDesktop.UIOSelectorActivityListGet(lUIOSelectorStr) # Получить список активностей по UIO селектору.
Параметры

  • inUIOSelector (list, обязательный) – UIO селектор, который определяет UIO объект, для которого будет представлен перечень доступных активностей.

  • inFlagRaiseException (bool, опциональный) – True - формировать ошибку exception, если платформа не обнаружина ни одного UIO объекта по заданному UIO селектору. False - обратный случай (может привести к ошибочным результатам). По умолчанию True.

pyOpenRPA.Robot.UIWeb.UIOSelectorActivityRun(inUIOSelector, inActionName, inArgumentList=None, inkwArgumentObject=None)[исходный код]

L+,W+: Выполнить активность inActionName над UIO объектом, полученным с помощью UIO селектора inUIOSelector. Описание возможных активностей см. ниже.

!ВНИМАНИЕ! ДАННАЯ ФУНКЦИОНАЛЬНОСТЬ В АВТОМАТИЧЕСКОМ РЕЖИМЕ ПОДДЕРЖИВАЕТ ВСЕ РАЗРЯДНОСТИ ПРИЛОЖЕНИЙ (32|64), КОТОРЫЕ ЗАПУЩЕНЫ В СЕСИИ. PYTHON x64 ИМЕЕТ ВОЗМОЖНОСТЬ ВЗЗАИМОДЕЙСТВИЯ С x32 UIO ОБЪЕКТАМИ, НО МЫ РЕКОМЕНДУЕМ ДОПОЛНИТЕЛЬНО ИСПОЛЬЗОВАТЬ ИНТЕРПРЕТАТОР PYTHON x32 (ПОДРОБНЕЕ СМ. ФУНКЦИЮ Configure())

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lActivityResult = UIWeb.UIOSelectorActivityRun(lUIOSelectorStr, "click") # выполнить действие над UIO объектом с помощью UIO селектора.
Параметры

  • inUIOSelector (list, обязательный) – UIO селектор, который определяет UIO объект, для которого будет представлен перечень доступных активностей.

  • inActionName (str, обязательный) – наименование активности, которую требуется выполнить над UIO объектом

  • inArgumentList (list, необязательный) – список передаваемых неименованных аргументов в функцию inActionName

  • inkwArgumentObject (dict, необязательный) – словарь передаваемых именованных аргументов в функцию inActionName

Результат

возвращает результат запускаемой функции с наименованием inActionName над UIO объектом

pyOpenRPA.Robot.UIWeb.UIOSelectorChildListAttributeDictGet(inUIOSelector=None)[исходный код]

L+,W+: Получить список словарей атриботов детей UI объекта, определенного по inUIOSelector

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lUIO = UIWeb.UIOSelectorFirst(inUIOSelectorStr = lUIOSelectorStr)
UIWeb.UIOAttributeDictGet(lUIO)
Параметры

inUIOSelector (str) – XPATH или CSS селектор UI элемента на web странице. Подсказки по CSS: https://devhints.io/css Подсказки по XPath: https://devhints.io/xpath

Результат

Вернуть список детей [{„class_list“: [], „lang“: „ru“, „style_dict“: {„–ph-color-background-accent“: None,“width“: «100%»,“color“: «black»}, „title“: „html“}]

Тип результата

list

pyOpenRPA.Robot.UIWeb.UIOSelectorClick(inUIOSelectorStr: str)[исходный код]

L+,W+: Выполнить нажатие по элементу с селектором inUIOSelectorStr.

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
UIWeb.UIOSelectorClick(inUIOSelectorStr = lUIOSelectorStr)
UIWeb.BrowserClose()
Параметры

inUIOSelectorStr (str) – XPATH или CSS селектор UI элемента на web странице. Подсказки по CSS: https://devhints.io/css Подсказки по XPath: https://devhints.io/xpath

pyOpenRPA.Robot.UIWeb.UIOSelectorDetect(inUIOSelectorStr: str) → str[исходный код]

L+,W+: Идентифицировать стиль селектора (CSS или XPATH или UIO)

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
lUIOSelectorStr = "#grid > div.grid-middle > div.grid__main-col.svelte-2y66pa > div.grid_newscol.grid_newscol__more-pulse.svelte-1yvqfic > div.grid__ccol.svelte-1yvqfic > ul > li:nth-child(5) > div > a"
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lResultStr = UIWeb.UIOSelectorDetect(inUIOSelectorStr = lUIOSelectorStr)
Параметры

inUIOSelectorStr (str) – XPATH или CSS селектор UI объекта на web странице. Подсказки по CSS: https://devhints.io/css Подсказки по XPath: https://devhints.io/xpath

Результат

«CSS» или «XPATH» или «UIO»

Тип результата

str

pyOpenRPA.Robot.UIWeb.UIOSelectorFirst(inUIOSelectorStr=None, inUIO=None) → list[исходный код]

L+,W+: Получить UIO объект по UIO селектору.

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lUIO = UIWeb.UIOSelectorFirst(inUIOSelectorStr = lUIOSelectorStr)
UIWeb.BrowserClose()
Параметры

  • inUIOSelectorStr (str) – XPATH или CSS селектор UI объекта на web странице. Подсказки по CSS: https://devhints.io/css Подсказки по XPath: https://devhints.io/xpath

  • inUIO (WebElement, опционально) – Объект UIO, от которого выполнить поиск UIO объектов по селектору, по умолчанию None

Результат

Первый подходящий UIO объект

Тип результата

UIO объект

pyOpenRPA.Robot.UIWeb.UIOSelectorFocusHighlight(inUIOSelectorStr: str, inIsFirst: bool = False, inDurationSecFloat: float = 3.0, inColorStr: str = 'green')[исходный код]

L+,W+: Выполнить подсвечивание UI элемента с селектором inUIOSelectorStr.

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
UIWeb.UIOSelectorFocusHighlight(inUIOSelectorStr = lUIOSelectorStr)
UIWeb.BrowserClose()
Параметры

  • inUIOSelectorStr (str) – XPATH или CSS селектор UI элемента на web странице. Подсказки по CSS: https://devhints.io/css Подсказки по XPath: https://devhints.io/xpath

  • inIsFirst (bool, опционально) – True - подсветить только первый элемент, который удовлетворяет селектору. По умолчанию False

  • inDurationSecFloat (float, опционально) – Длительность подсвечивания. По умолчанию 3.0 сек.

  • inColorStr (str, опционально) – Цвет подсвечания Варианты: «red», «blue», «grey», «yellow». По умолчанию «green» (зеленый)

pyOpenRPA.Robot.UIWeb.UIOSelectorHighlight(inUIOSelectorStr: str, inIsFirst: bool = False, inDurationSecFloat: float = 3.0, inColorStr: str = 'green')[исходный код]

L+,W+: Выполнить подсвечивание UI элемента с селектором inUIOSelectorStr.

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
UIWeb.UIOSelectorHighlight(inUIOSelectorStr = lUIOSelectorStr)
UIWeb.BrowserClose()
Параметры

  • inUIOSelectorStr (str) – XPATH или CSS селектор UI элемента на web странице. Подсказки по CSS: https://devhints.io/css Подсказки по XPath: https://devhints.io/xpath

  • inIsFirst (bool, опционально) – True - подсветить только первый элемент, который удовлетворяет селектору. По умолчанию False

  • inDurationSecFloat (float, опционально) – Длительность подсвечивания. По умолчанию 3.0 сек.

  • inColorStr (str, опционально) – Цвет подсвечания Варианты: «red», «blue», «grey», «yellow». По умолчанию «green» (зеленый)

pyOpenRPA.Robot.UIWeb.UIOSelectorLevelInfoList(inUIOSelector)[исходный код]

L+,W+: Получить список свойств всех уровней до UI объекта, обнаруженного с помощью селектора inUIOSelector.

!ВНИМАНИЕ! ДАННАЯ ФУНКЦИОНАЛЬНОСТЬ В АВТОМАТИЧЕСКОМ РЕЖИМЕ ПОДДЕРЖИВАЕТ ВСЕ РАЗРЯДНОСТИ ПРИЛОЖЕНИЙ (32|64), КОТОРЫЕ ЗАПУЩЕНЫ В СЕСИИ. PYTHON x64 ИМЕЕТ ВОЗМОЖНОСТЬ ВЗЗАИМОДЕЙСТВИЯ С x32 UIO ОБЪЕКТАМИ, НО МЫ РЕКОМЕНДУЕМ ДОПОЛНИТЕЛЬНО ИСПОЛЬЗОВАТЬ ИНТЕРПРЕТАТОР PYTHON x32 (ПОДРОБНЕЕ СМ. ФУНКЦИЮ Configure())

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lUIOLevelList = UIWeb.UIOSelectorLevelInfoList(inUIOSelector = inUIOSelector)
Параметры

inUIOSelector (list, обязательный) – Селектор на UIO объект (CSS | XPATH | UIO).

Результат

список уровней UIO объектов

pyOpenRPA.Robot.UIWeb.UIOSelectorList(inUIOSelectorStr=None, inUIO=None) → list[исходный код]

L+,W+: Получить список UIO объектов по UIO селектору.

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lUIOList = UIWeb.UIOSelectorList(inUIOSelectorStr = lUIOSelectorStr)
UIWeb.BrowserClose()
Параметры

  • inUIOSelectorStr (str) – XPATH или CSS селектор UI объекта на web странице. Подсказки по CSS: https://devhints.io/css Подсказки по XPath: https://devhints.io/xpath

  • inUIO (WebElement, опционально) – Объект UIO, от которого выполнить поиск UIO объектов по селектору, по умолчанию None

Результат

Список UIO объектов

Тип результата

list

pyOpenRPA.Robot.UIWeb.UIOSelectorListAttributeDictGet(inUIOSelector=None)[исходный код]

L+,W+: Получить словарь атрибутов для UI объектов, которые удовлетворяют inUIOSelector селектору

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lAttributeList = UIWeb.UIOSelectorListAttributeDictGet(inUIOSelector = lUIOSelectorStr)
Параметры

inUIOSelector (str) – XPATH или CSS селектор UI элемента на web странице. Подсказки по CSS: https://devhints.io/css Подсказки по XPath: https://devhints.io/xpath

Результат

Список словарей UI объектов по селектору [{„class_list“: [], „lang“: „ru“, „style_dict“: {„–ph-color-background-accent“: None,“width“: «100%»,“color“: «black»}, „title“: „html“}]

Тип результата

list

pyOpenRPA.Robot.UIWeb.UIOSelectorSetValue(inUIOSelectorStr: str, inValue: str)[исходный код]

L+,W+: Установить значение элемента с селектором inUIOSelectorStr.

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://www.google.com/")
lUIOSelectorStr = "/html/body/div[1]/div[3]/form/div[1]/div[1]/div[1]/div/div[2]/input"
lValue = "pyOpenRPA"
UIWeb.UIOSelectorSetValue(inUIOSelectorStr = lUIOSelectorStr, inValue = lValue)
UIWeb.BrowserClose()
Параметры

  • inUIOSelectorStr (str) – XPATH или CSS селектор UI элемента на web странице. Подсказки по CSS: https://devhints.io/css Подсказки по XPath: https://devhints.io/xpath

  • inValue (str) – Значение, которое необходимо установить

pyOpenRPA.Robot.UIWeb.UIOSelectorWaitAppear(inUIOSelectorStr: str, inWaitSecFloat: float = 60, inWaitIntervalSecFloat: float = 1.0)[исходный код]

L+,W+: Ожидать появление UI элемента на веб странице (блокирует выполнение потока), заданного по UIO селектору inUIOSelectorStr. Выполнять ожидание на протяжении inWaitSecFloat (по умолчанию 60 сек.). Проверка производится с интервалом inWaitIntervalSecFloat (по умолчанию 1 сек.)

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lAppearUIOList = UIWeb.UIOSelectorWaitAppear(inUIOSelectorStr = lUIOSelectorStr)
UIWeb.BrowserClose()
Параметры

  • inUIOSelectorStr (str) – XPATH или CSS селектор UI элемента на web странице. Подсказки по CSS: https://devhints.io/css Подсказки по XPath: https://devhints.io/xpath

  • inWaitSecFloat (float, опциональный) – Время ожидания на исчезновение UI элемента, по умолчанию UIO_WAIT_SEC_FLOAT (60 сек)

  • inWaitIntervalSecFloat (float, опциональный) – Интервал проверки исчезновения, по умолчанию UIO_WAIT_INTERVAL_SEC_FLOAT (1 сек)

Исключение

Exception – Время ожидания превышено

Результат

Список UI элементов, которые удовлетворяют селектору и появились на странице

Тип результата

list

pyOpenRPA.Robot.UIWeb.UIOSelectorWaitDisappear(inUIOSelectorStr: str, inWaitSecFloat: float = 60, inWaitIntervalSecFloat: float = 1.0)[исходный код]

L+,W+: Ожидать исчезновение UI элемента с веб страницы (блокирует выполнение потока), заданного по UIO селектору inUIOSelectorStr. Выполнять ожидание на протяжении inWaitSecFloat (по умолчанию 60 сек.). Проверка производится с интервалом inWaitIntervalSecFloat (по умолчанию 1 сек.)

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
UIWeb.UIOSelectorWaitDisappear(inUIOSelectorStr = lUIOSelectorStr)
UIWeb.BrowserClose()
Параметры

  • inUIOSelectorStr (str) – XPATH или CSS селектор UI элемента на web странице. Подсказки по CSS: https://devhints.io/css Подсказки по XPath: https://devhints.io/xpath

  • inWaitSecFloat (float, опциональный) – Время ожидания на исчезновение UI элемента, по умолчанию UIO_WAIT_SEC_FLOAT (60 сек)

  • inWaitIntervalSecFloat (float, опциональный) – Интервал проверки исчезновения, по умолчанию UIO_WAIT_INTERVAL_SEC_FLOAT (1 сек)

Исключение

Exception – Время ожидания превышено

pyOpenRPA.Robot.UIWeb.UIOSelector_To_XPATH(inUIOSelector=None)[исходный код]

L+,W+: Выполнить конвертацию селектора из UIO в XPATH

# UIWeb: Взаимодействие с UI объектами вкладки
from pyOpenRPA.Robot import UIWeb
lUIOSelector = [{'depth_start': 1, 'depth_end': 99, 'id': 'grid'},
    {'ctrl_index': 2},
    {'depth_start': 1, 'depth_end': 99, 'title': 'div', 'ctrl_index': 2},
    {'title': 'div', 'ctrl_index': 3},
    {'title': 'div', 'ctrl_index': 1},
    {'title': 'ul'},
    {'title': 'li', 'ctrl_index': 5},
    {'title': 'div'},
    {'title': 'a'}]
lXPATHSelector = UIWeb.UIOSelector_To_XPATH(inUIOSelector=lUIOSelector)
Параметры

inUIOSelector (list, обязательный) – Селектор в формате UIO

pyOpenRPA.Robot.UIWeb.UIOTextGet(inUIO) → str[исходный код]

L+,W+: Получить текст UI элемента.

!ВНИМАНИЕ! Для работы необходимо проинициализировать webdriver

# UIWeb: Взаимодействие с ui web
from pyOpenRPA.Robot import UIWeb
UIWeb.BrowserChromeStart()
UIWeb.PageOpen("https://mail.ru")
lUIOSelectorStr = "//*[@id='grid']/div[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lUIO = UIWeb.UIOSelectorList(inUIOSelectorStr = lUIOSelectorStr)[0]
lTextStr = UIWeb.UIOTextGet(inUIO=lUIO)
UIWeb.BrowserClose()
Параметры

inUIO (WebElement) – UIO элемент. Получить его можно с помощью функций UIOSelectorList или UIOSelectorFirst

Результат

Текст UI элемента

Тип результата

str

pyOpenRPA.Robot.UIWeb.XPATH_To_UIOSelector(inXPATHSelector=None)[исходный код]

L+,W+: Выполнить конвертацию селектора из XPATH в UIO

# UIDesktop: Взаимодействие с UI объектами приложений
from pyOpenRPA.Robot import UIWeb
lXPATHSelector = "//*[@id='grid']/*[2]/div[2]/div[3]/div[1]/ul/li[5]/div/a"
lUIOSelector = UIDesktop.XPATH_To_UIOSelector(inXPATHSelector=lXPATHSelector)
Параметры

inUIOSelector (str, обязательный) – Селектор в формате XPATH