ORPA-pyOpenRPA/Wiki/ENG_Guide/markdown/Robot/01_Robot.md

# 1. Description

pyOpenRPA Robot is the python package.

## pyOpenRPA Robot


### pyOpenRPA.Robot.UIDesktop.Get_OSBitnessInt()
Detect OS bitness.


* **Returns**

    int 32 or int 64



### pyOpenRPA.Robot.UIDesktop.PWASpecification_Get_PWAApplication(inControlSpecificationArray)
#Backend selection - attribute “backend” (“win32” || “uia”) in 1-st list element


* **Parameters**

    **inControlSpecificationArray** – List of dict, dict in pywinauto.find_windows notation



* **Returns**

    process application object



### pyOpenRPA.Robot.UIDesktop.PWASpecification_Get_UIO(inControlSpecificationArray)
#Backend def selection - attribute “backend” (“win32” || “uia”) in 1-st list element
#old name - GetControl


* **Parameters**

    **inControlSpecificationArray** – List of dict, dict in pywinauto.find_windows notation



* **Returns**

    list of UIO object



### pyOpenRPA.Robot.UIDesktop.UIOSelectorSecs_WaitAppear_Bool(inSpecificationList, inWaitSecs)
Wait for UI object will appear in GUI for inWaitSecs seconds.


* **Parameters**

    
    * **inSpecificationList** – UIOSelector. Example: [{“title”:”notepad”},{“title”:”OK”}]


    * **inWaitSecs** – Float value (seconds) for wait UI element appear in GUI



* **Returns**

    True - UI object will appear. False - else case



### pyOpenRPA.Robot.UIDesktop.UIOSelectorSecs_WaitDisappear_Bool(inSpecificationList, inWaitSecs)
Wait for UI object will disappear in GUI for inWaitSecs seconds.


* **Parameters**

    
    * **inSpecificationList** – UIOSelector.
    Example: [{“title”:”notepad”},{“title”:”OK”}]


    * **inWaitSecs** – Float value (seconds) for wait UI element disappear in GUI



* **Returns**

    True - UI object will disappear. False - else case



### pyOpenRPA.Robot.UIDesktop.UIOSelector_Exist_Bool(inUIOSelector)
Check if object is exist by the UIO selector.


* **Parameters**

    **inUIOSelector** – 



* **Returns**

    True - Object is exist. False - else case



### pyOpenRPA.Robot.UIDesktop.UIOSelector_Get_BitnessInt(inSpecificationList)
Detect process bitness by the UI Object UIO Selector.


* **Parameters**

    **inSpecificationList** – UIOSelector. Example: [{“title”:”notepad”},{“title”:”OK”}]



* **Returns**

    int 32 or int 64



### pyOpenRPA.Robot.UIDesktop.UIOSelector_Get_BitnessStr(inSpecificationList)
Detect process bitness by the UI Object UIO Selector.


* **Parameters**

    **inSpecificationList** – UIOSelector. Example: [{“title”:”notepad”},{“title”:”OK”}]



* **Returns**

    str “32” or str “64”



### pyOpenRPA.Robot.UIDesktop.UIOSelector_Get_UIO(inSpecificationList, inElement=None, inFlagRaiseException=True)
Get the pywinauto object by the UIO selector.


* **Parameters**

    
    * **inSpecificationList** – 


    * **inElement** – 


    * **inFlagRaiseException** – 



* **Returns**

    


### pyOpenRPA.Robot.UIDesktop.UIOSelector_Get_UIOList(inSpecificationList, inElement=None, inFlagRaiseException=True)
Get the UIO list by the selector


* **Parameters**

    
    * **inSpecificationList** – UIO Selector


    * **inElement** – Входной элемент - показатель, что не требуется выполнять коннект к процессу


    * **inFlagRaiseException** – Флаг True - выкинуть ошибку в случае обнаружении пустого списка



* **Returns**

    


### pyOpenRPA.Robot.UIDesktop.UIOSelector_SafeOtherGet_Process(inUIOSelector)
Safe get other process or None if destination app is the other/same bitness


* **Parameters**

    **inUIOSelector** – UIO Selector of the UI object



* **Returns**

    None or process (of the other bitness)



### pyOpenRPA.Robot.UIDesktop.UIOSelector_SearchChildByMouse_UIO(inElementSpecification)
UIOSelector (see description on the top of the document)
#old name - AutomationSearchMouseElement


* **Parameters**

    **inElementSpecification** – UIOSelector of the UI Object



* **Returns**

    pywinauto element wrapper instance or None



### pyOpenRPA.Robot.UIDesktop.UIOSelector_SearchChildByMouse_UIOTree(inUIOSelector)
!!!!Safe call is included (you can set activity and UIDesktop will choose the bitness and return the result)!!!!!


* **Parameters**

    **inUIOSelector** – UIOSelector of the UI Object



* **Returns**

    ?




### pyOpenRPA.Robot.UIDesktop.UIOSelectorsSecs_WaitAppear_List(inSpecificationListList, inWaitSecs, inFlagWaitAllInMoment=False)
Wait for many UI object will appear in GUI for inWaitSecs seconds.


* **Parameters**

    
    * **inSpecificationListList** – UIOSelector list.
    Example: [

    > [{“title”:”notepad”},{“title”:”OK”}],
    > [{“title”:”notepad”},{“title”:”Cancel”}]

    ]



    * **inWaitSecs** – Float value (seconds) for wait UI element appear in GUI


    * **inFlagWaitAllInMoment** – True - Wait all UI objects from the UIOSelector list to be appeared



* **Returns**

    List of index, which UI object UIO will be appeared. Example: [1] # Appear only UI object with UIO selector: [{“title”:”notepad”},{“title”:”Cancel”}]



### pyOpenRPA.Robot.UIDesktop.UIOSelectorsSecs_WaitDisappear_List(inSpecificationListList, inWaitSecs, inFlagWaitAllInMoment=False)
Wait for many UI object will disappear in GUI for inWaitSecs seconds.


* **Parameters**

    
    * **inSpecificationListList** – UIOSelector list.
    Example: [

    > [{“title”:”notepad”},{“title”:”OK”}],
    > [{“title”:”notepad”},{“title”:”Cancel”}]

    ]



    * **inWaitSecs** – Float value (seconds) for wait UI element disappear in GUI


    * **inFlagWaitAllInMoment** – True - Wait all UI objects from the UIOSelector list to be disappeared.



* **Returns**

    List of index, which UI object UIO will be disappeared. Example: [1] # Disappear only UI object with UIO selector: [{“title”:”notepad”},{“title”:”Cancel”}]



* **Returns**