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.

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.

Procedure

To capture an object using the object play mode, do the following:

  1. Drag or double-click the Object Cloning command.
    The Object Cloning dialog box appears.
  2. Select the application or website you want to use from the Select Window list.
  3. Click Capture to capture an object.
  4. Hover the pointer over the object you want to capture.
    A red highlight appears around the object and its properties are captured.
  5. Select the Object play mode.
  6. 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.
  7. Click the Expand Search Criteria option to select more object properties for the search.
  8. 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 for Path and DOMXPath.
  9. 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 as true. By default, the value is set to false.
      Note: If the value of allowspecialcharacters is set as true, 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.
  10. 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, you can also switch between standard and HTML configurations based on the requirements. Use the Select Technology menu to choose the configuration. Ensure that you install the appropriate plug-ins and configure the settings for HTML, Flex, and Java. See Using plug-in settings and Java Settings.

    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.

  11. 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.
  12. Click Save.