Recorder package captures a series of tasks in a process and then automates them. You can automate your business applications (for example, desktop, Web, SAP, and Java applications) using the Recorder to capture actions performed on application objects such as a text box, button, table, radio button, combo box, and list view.
- The Capture action replaces the Object Cloning command from Version 11.3.
- If you open a window in any of the supported browsers with a user account that is different from the one used to log in to the computer, the Recorder might not capture and play the control actions accurately.
You can capture and automate objects inside a cross-domain IFrame that has multiple IFrames with same frame source and IFrames that are loaded dynamically during runtime in Google Chrome and Microsoft Edge Chromium browsers. After you have captured an object inside a cross-domain IFrame, the frame path is stored in the FrameDOMXPath property, by default.
You can automate Java web applications running on Microsoft Edge Chromium with IE mode and applications that are accessed through the Citrix Workspace app.
- When you want to automate an alert dialog box on a web page, we recommend that you add a delay before the action because sometimes, the alert dialog box appears after a delay on the application window.
- To accurately capture or
automate objects on SAP applications, we recommend that you enable
scripting. If scripting is not enabled, the following prompt message is
displayed below the bot runtime window:
SAP scripting disabled: Enable scripting for more reliable captures
If you do not enable scripting, instead of using SAP technology, the Recorder uses MSAA technology for capturing objects.
- Verify that the captured object properties match your intended object.
For example, when capturing a table from a website, ensure the Control Type and HTML Tag values are TABLE.
- Retrieve a property value. Use the
action and enter the name of the property in the
Property name field or select an object
property from the list of available properties. The list includes
suggested property values from the search criteria in the
Object Properties table. To select an object
property from the list of properties, move the mouse pointer to the
right of the Property name field and click the
For example, to retrieve the text of a link, use the Get property action and enter HTML InnerText in the Property name field or select HTML InnerText from the list of properties.
- You can select a combination of properties for the bot to search the object in your business application window uniquely.
The search algorithm for the Recorder package ensures that when you run a bot an object is captured only if its properties match the exact search criterion that you selected in the Object properties table. If the properties of the object do not match the search criterion exactly, then the bot fails with an error message. However, if the search criterion includes a wildcard character, then the bot captures the first object that matches the criterion.
For example, to capture a text box from an application that has three text boxes named firstname1, firstname2, and firstname3, if you select HTML name as the search criterion, enter the value firstname in the HTML name field, and run the bot, then the bot fails with an error message because a text box with the HTML name firstname does not exist. However, in the HTML name field, if you enter firstname*, and run the bot, then the bot captures the first text box that matches the criterion.
Actions performed on captured objects
- Set Text
- Get Text
When you record a task in secure recording mode, the Preview window temporarily shows an image of the captured area. This image is hidden after you navigate away from the Bot editor window or refresh it.
A user with admin privileges must enable this setting.