Using object play mode
- Updated: 2021/03/30
Using object play mode
Use the object play mode to capture objects from an application or a browser. You can capture objects such as text boxes, radio buttons, text, and titles.
Prerequisites
Ensure that the application or website from which you want to capture objects is open.
Procedure
To capture an object using the object play mode, do the following:
-
Drag or double-click the
Object Cloning
command.
The Object Cloning dialog box appears.
- Select the application or website you want to use from the Select Window list.
- Click Capture to capture an object.
-
Hover the pointer over the object you want to capture.
A red highlight appears around the object and its properties are captured.
- Select the Object play mode.
-
From the Select search criteria section in the OBJECT tab,
select the object properties you want to use to search the object.
A binocular icon appears next to the object property that is selected for searching the object.
- Click the Expand Search Criteria option to select more object properties for the search.
-
In the Search Criteria dialog box, select and assign
values for the object properties that you want to include in the search
criteria.
A binocular icon appears next to the properties you have selected for the search criteria.
The Object Cloning command searches and plays the object based on the configured search criteria properties. If there are dynamic objects in the application, ensure that you do not apply Path Property. Configure Path Property when you use Object Cloning to capture static objects in an application.
Note: You can use the wild card character (*) when specifying values for all properties except forPath
andDOMXPath
. -
Select an option from the Select Action To Perform list
to specify the action to be performed on the captured object:
-
Get Property
When you use the Get property option with HTML technology in the Chrome browser and the extracted object includes special characters, the bot execution fails with a TYPE_014 error. You can set the value for special characters in the AA.settings file by selecting Player > Commands > accessibility > browser > communication and set
allowspecialcharacters
astrue
. By default, the value is set to false.Note: If the value ofallowspecialcharacters
is set astrue
, you might see the following display issue: when the HTML InnerText property is used to capture the data from the list object, the text is displayed in one line. - Get Total Items
- Get Selected Index
- Get Selected Text
- Select Item By Text
- Select Item By Index
-
Click
Note: Use the Click action to activate an on-click event in the browser when working with an HTML object.
Sometimes, the Object Cloning command finds the object but does not perform any action and stops responding in Internet Explorer. The Click action is not performed on the captured object when it is executed for Java, HTML, and standard technologies. Instead, use the Left Click action to capture the object.
- Left Click
- Right Click
- Double Click
Note: The options available in the list differ based on the type of the object captured. -
Get Property
-
Select the required technology option. Based on which Enterprise Client
version you are on, select an option.
- In versions earlier to Version 11.3.3, select the
Legacy Technology option when the target
application uses legacy applications or is a secure environment.
By Default, this option is selected when you capture an object using legacy technologies.
- In Version 11.3.3 and later, select an option from the Select Technology list to specify the technology of the target application.
Important: Depending on the type of technology used for creating the application, one or the other technology will be a better fit to detect the controls.- Default: Automatically tries to detect the technology to use for capturing an object.
- Legacy: Uses legacy technology to detect and capture an object.
- Standard: Uses MSAA technology to detect and capture an object.
-
Advanced: Uses UI Automation technology to detect
and capture an object.
You can capture objects based on UI Automation technology from the Google Chrome browser.
Note: You must enable the accessibility setting for Google Chrome. Type chrome://accessibility/ in the Google Chrome browser and select the following options:- Native accessibility API support
- Web accessibility
- Text metrics
- Screen reader support
- HTML
- Advanced - WPF: Uses the specially designed WPF application and UI Automation technology to detect and capture an object.
When you capture objects in HTML files, you cannot use symbols in the Inner Text Property files. You can use wildcard character (*) entries so that Object Cloning recognizes the symbol. When you capture objects from custom tables in web applications, ensure that you use Tag and Inner Text Property to select the rows. You can also create an alternate relative DOMXPath to extract information from the custom tables.
- In versions earlier to Version 11.3.3, select the
Legacy Technology option when the target
application uses legacy applications or is a secure environment.
-
Specify how much time the command should wait for an object to be available in
the Wait for the object to exist field.
This option enables you to specify the amount of time the command should wait for an object. The system will move on to the next command as soon as the object is available and does not wait for the entire time duration specified.
- Click Save.