OPEN_RPA_PUBLIC
/
ORPA-pyOpenRPA
2
0
Fork 1
Code Issues 2 Pull Requests Packages Projects Releases Wiki Activity

docs

Browse Source
dev-linux
Ivan Maslov 3 years ago
parent 87ca9a3401
commit 7866c29480
3 changed files with 58 additions and 43 deletions
Show Stats Download Patch File Download Diff File

15
Sources/pyOpenRPA/Robot/README.md
Unescape View File

@ -43,16 +43,5 @@ Resources\WPy64-3720\python-3.7.2.amd64\python.exe
] ]
# Open RPA Wiki
- [Home](https://gitlab.com/UnicodeLabs/OpenRPA/wikis/home) Created by pyOpenRPA LLC (Ivan Maslov)
- [04. Desktop app access (win32 & ui automation)](https://gitlab.com/UnicodeLabs/OpenRPA/wikis/04.-Desktop-app-access-(win32-&-ui-automation))
#Dependencies
* Python 3 x32 [psutil, pywinauto, wmi, PIL, keyboard, pyautogui, win32api (pywin32), selenium, openCV, tesseract, requests, lxml, PyMuPDF]
* Python 3 x64 [psutil, pywinauto, wmi, PIL, keyboard, pyautogui, win32api (pywin32), selenium, openCV, tesseract, requests, lxml, PyMuPDF]
* pywinauto (Windows GUI automation)
* Semantic UI CSS framework
* JsRender by https://www.jsviews.com (switch to Handlebars)
* Handlebars
Created by Unicode Labs (Ivan Maslov)

85
Sources/pyOpenRPA/Robot/UIDesktop.py
Unescape View File

@ -29,7 +29,7 @@ import copy
#TODO В перспективе нужно реализовать алгоритм определения разрядности не в Robot.py, а в UIDesktop.py, тк начинают появляться функции, на входе в которые еще неизвестна разрядность элемента + селектор может охватить сразу два элемента из 2-х разных разрядностей - обрабатываться это должно непосредственно при выполнении #TODO В перспективе нужно реализовать алгоритм определения разрядности не в Robot.py, а в UIDesktop.py, тк начинают появляться функции, на входе в которые еще неизвестна разрядность элемента + селектор может охватить сразу два элемента из 2-х разных разрядностей - обрабатываться это должно непосредственно при выполнении
#################################### ####################################
#Info: GUI module of the Robot app (OpenRPA - Robot) #Info: GUI module of the Robot app (pyOpenRPA - Robot)
#################################### ####################################
# GUI Module - interaction with Desktop application # GUI Module - interaction with Desktop application
@ -99,19 +99,27 @@ mDefaultPywinautoBackend="win32"
# "rich_text" - наименование rich_text # "rich_text" - наименование rich_text
# } # }
#] #]
################
#return: List of UI Object #old:PywinautoExtElementsGet
#inElement - Входной элемент - показатель, что не требуется выполнять коннект к процессу
#inFlagRaiseException - Флаг True - выкинуть ошибку в случае обнаружении пустого списка
#old name - PywinautoExtElementsGet
def UIOSelector_Get_UIOList (inSpecificationList,inElement=None,inFlagRaiseException=True): def UIOSelector_Get_UIOList (inSpecificationList,inElement=None,inFlagRaiseException=True):
''' '''
Get the UIO list by the selector Получить список UIO объектов по UIO селектору
.. code-block:: python
:param inSpecificationList: UIO Selector # UIDesktop: Взаимодействие с UI объектами приложений
:param inElement: Входной элемент - показатель, что не требуется выполнять коннект к процессу from pyOpenRPA.Robot import UIDesktop
:param inFlagRaiseException: Флаг True - выкинуть ошибку в случае обнаружении пустого списка # 1С: UIO Селектор выбора базы
:return: lDemoBaseUIOSelector = [{"title":"Запуск 1С:Предприятия","class_name":"V8TopLevelFrameTaxiStarter","backend":"uia"},{"title":"DEMO", "depth_start": 5, "depth_end": 5}]
lDemoBaseUIOList = UIDesktop.UIOSelector_Get_UIOList(lDemoBaseUIOSelector) #Получить список UIO объектов, которые удовлетворяют требованиям UIO селектора. В нашем примере либо [], либо [UIO объект]
:param inSpecificationList: UIO Селектор, который определяет критерии поиска UI элементов
:type inSpecificationList: list, обязательный
:param inElement: Родительский элемент, от которого выполнить поиск UIO объектов по заданному UIO селектору. Если аргумент не задан, платформа выполнит поиск UIO объектов среди всех доступных приложений windows, которые запущены на текущей сессии
:type inElement: UIO объект, опциональный
:param inFlagRaiseException: True - формировать ошибку exception, если платформа не обнаружина ни одного UIO объекта по заданному UIO селектору. False - обратный случай. По умолчанию True
:type inFlagRaiseException: bool, опциональный
:return: Список UIO объектов, которые удовлетворяют условиям UIO селектора
''' '''
#Создать копию входного листа, чтобы не менять массив в других верхнеуровневых функциях #Создать копию входного листа, чтобы не менять массив в других верхнеуровневых функциях
inSpecificationList=copy.deepcopy(inSpecificationList) inSpecificationList=copy.deepcopy(inSpecificationList)
@ -235,20 +243,26 @@ def UIOSelector_Get_UIOList (inSpecificationList,inElement=None,inFlagRaiseExcep
raise pywinauto.findwindows.ElementNotFoundError("Robot can't find element by the UIOSelector") raise pywinauto.findwindows.ElementNotFoundError("Robot can't find element by the UIOSelector")
return lResultList return lResultList
################################################################################################# #old:PywinautoExtElementGet
#Get first (in more than one) UIO (UI Object)
#inSpecificationList - UIOSelector
#inElement - Входной элемент - показатель, что не требуется выполнять коннект к процессу
#inFlagRaiseException - Флаг True - выкинуть ошибку в случае обнаружении пустого списка
#old name - PywinautoExtElementGet
def UIOSelector_Get_UIO (inSpecificationList,inElement=None,inFlagRaiseException=True): def UIOSelector_Get_UIO (inSpecificationList,inElement=None,inFlagRaiseException=True):
''' '''
Get the pywinauto object by the UIO selector. Получить список UIO объект по UIO селектору. Если критериям UIO селектора удовлетворяет несколько UIO объектов - вернуть первый из списка
.. code-block:: python
:param inSpecificationList: # UIDesktop: Взаимодействие с UI объектами приложений
:param inElement: from pyOpenRPA.Robot import UIDesktop
:param inFlagRaiseException: # 1С: UIO Селектор выбора базы
:return: lDemoBaseUIOSelector = [{"title":"Запуск 1С:Предприятия","class_name":"V8TopLevelFrameTaxiStarter","backend":"uia"},{"title":"DEMO", "depth_start": 5, "depth_end": 5}]
lDemoBaseUIOList = UIDesktop.UIOSelector_Get_UIO(lDemoBaseUIOSelector) #Получить 1-й UIO объект, которые удовлетворяет требованиям UIO селектора. В нашем примере либо None, либо UIO объект
:param inSpecificationList: UIO Селектор, который определяет критерии поиска UI элементов
:type inSpecificationList: list, обязательный
:param inElement: Родительский элемент, от которого выполнить поиск UIO объектов по заданному UIO селектору. Если аргумент не задан, платформа выполнит поиск UIO объектов среди всех доступных приложений windows, которые запущены на текущей сессии
:type inElement: UIO объект, опциональный
:param inFlagRaiseException: True - формировать ошибку exception, если платформа не обнаружина ни одного UIO объекта по заданному UIO селектору. False - обратный случай. По умолчанию True
:type inFlagRaiseException: bool, опциональный
:return: UIO объект, которые удовлетворяют условиям UIO селектора, или None
''' '''
lResult=None lResult=None
#Получить родительский объект если на вход ничего не поступило #Получить родительский объект если на вход ничего не поступило
@ -259,17 +273,25 @@ def UIOSelector_Get_UIO (inSpecificationList,inElement=None,inFlagRaiseException
if lResult is None and inFlagRaiseException: if lResult is None and inFlagRaiseException:
raise pywinauto.findwindows.ElementNotFoundError("Robot can't find element by the UIOSelector") raise pywinauto.findwindows.ElementNotFoundError("Robot can't find element by the UIOSelector")
return lResult return lResult
#################################################################################################
#Check if UIO exist (Identified by the UIOSelector) #old:-
#!!!!!Safe call is included (you can set activity and UIDesktop will choose the bitness and return the result)!!!!!
#UIOSelector
#old name - -
def UIOSelector_Exist_Bool (inUIOSelector): def UIOSelector_Exist_Bool (inUIOSelector):
''' '''
Check if object is exist by the UIO selector. Проверить существование хотя бы 1-го UIO объекта по заданному UIO селектору
!ВНИМАНИЕ! ДАННАЯ ФУНКЦИОНАЛЬНОСТЬ В АВТОМАТИЧЕСКОМ РЕЖИМЕ ПОДДЕРЖИВАЕТ ВСЕ РАЗРЯДНОСТИ ПРИЛОЖЕНИЙ (32|64), КОТОРЫЕ ЗАПУЩЕНЫ В СЕСИИ. PYTHON x64 ИМЕЕТ ВОЗМОЖНОСТЬ ВЗЗАИМОДЕЙСТВИЯ С x32 UIO ОБЪЕКТАМИ, НО МЫ РЕКОМЕНДУЕМ ДОПОЛНИТЕЛЬНО ИСПОЛЬЗОВАТЬ ИНТЕРПРЕТАТОР PYTHON x32 (ПОДРОБНЕЕ СМ. ФУНКЦИЮ Configure())
.. code-block:: python
:param inUIOSelector: # UIDesktop: Взаимодействие с UI объектами приложений
:return: True - Object is exist. False - else case from pyOpenRPA.Robot import UIDesktop
# 1С: UIO Селектор выбора базы
lDemoBaseUIOSelector = [{"title":"Запуск 1С:Предприятия","class_name":"V8TopLevelFrameTaxiStarter","backend":"uia"},{"title":"DEMO", "depth_start": 5, "depth_end": 5}]
lDemoBaseUIOExistBool = UIDesktop.UIOSelector_Exist_Bool(lDemoBaseUIOSelector) # Получить булевый результат проверки существования UIO объекта
:param inUIOSelector: UIO Селектор, который определяет критерии поиска UIO объектов
:type inUIOSelector: list, обязательный
:return: True - существует хотя бы 1 UIO объект. False - не существует ни одного UIO объекта по заданному UIO селектору
''' '''
lResult=False lResult=False
#Check the bitness #Check the bitness
@ -294,6 +316,8 @@ def UIOSelector_Exist_Bool (inUIOSelector):
else: else:
lResult = lPIPEResponseDict["Result"] lResult = lPIPEResponseDict["Result"]
return lResult return lResult
################################################################################################# #################################################################################################
#Wait for UIO is appear (at least one of them or all at the same time) #Wait for UIO is appear (at least one of them or all at the same time)
#inSpecificationListList - List of the UIOSelector #inSpecificationListList - List of the UIOSelector
@ -303,6 +327,7 @@ def UIOSelector_Exist_Bool (inUIOSelector):
#old name - - #old name - -
#####Внимание##### #####Внимание#####
##Функция ожидания появления элементов (тк элементы могут быть недоступны, неизвестно в каком фреймворке каждый из них может появиться) ##Функция ожидания появления элементов (тк элементы могут быть недоступны, неизвестно в каком фреймворке каждый из них может появиться)
def UIOSelectorsSecs_WaitAppear_List (inSpecificationListList,inWaitSecs,inFlagWaitAllInMoment=False): def UIOSelectorsSecs_WaitAppear_List (inSpecificationListList,inWaitSecs,inFlagWaitAllInMoment=False):
''' '''
Wait for many UI object will appear in GUI for inWaitSecs seconds. Wait for many UI object will appear in GUI for inWaitSecs seconds.

1
changelog.md
Unescape View File

@ -14,6 +14,7 @@ AGT - AGENT
- - Keyboard, В каждую функцию добавил обработку пост ожидания, если это необходимо для стабилизации робота - - Keyboard, В каждую функцию добавил обработку пост ожидания, если это необходимо для стабилизации робота
- - Mouse, Дополнил примеры в описание каждой функции - - Mouse, Дополнил примеры в описание каждой функции
- - Mouse, В каждую функцию добавил обработку пост ожидания, если это необходимо для стабилизации робота - - Mouse, В каждую функцию добавил обработку пост ожидания, если это необходимо для стабилизации робота
- - UIDesktop, Переведен и дополнен
[1.2.12] [1.2.12]

Write Preview
Loading…
Cancel
Save