Recorder package

Recorder Paket 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 Aktionen performed on application objects such as a text box, button, table, radio button, combo box, and list view.

Automation 360 extension setting

If the Bot execution takes longer when you use the Recorder to automate a static page running on the Google Chrome or Microsoft Edge browser, then follow these steps to enable the setting in the Automation 360 extension:

Click the extensions icon at the top right corner of the browser window.
Click the vertical ellipses next to the Automation 360 plugin and select Manage extension.
Enable the Allow access to file URLs option.
Restart the browser and run the Bot.

Benefits of using Recorder Paket instead of SAP Paket

We recommend that you use the Recorder to automate SAP applications. When you use the Recorder to automate SAP applications, you have the following benefits:

You can automate objects without creating a session. When you use the SAP Paket you must create a session.
You can automate the object directly without generating the field paths or having any prior knowledge of the field paths. When you use the SAP Paket, the Paket will execute Aktionen directly on control field paths when properties in the search criteria match the object that the Bot searches during execution.
If the Recorder runtime window overlaps the object that you want to automate, then the Recorder hides the runtime window before you automate the object.
Recorder supports actions in the Wenn, Schleife, and Warten Pakete that enables you to check if an object exists in the specific browser or window.

Anmerkung: When compared to the Recorder Paket, the SAP Paket enables you to automate an application without activating the application window.

Capture using Recorder

Use the Capture Aktion to capture an interaction with a user interface (UI) object. This Aktion enables you to add a single interaction when you are building a Bot.

Anmerkung:

The Capture Aktion 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 Aktionen accurately.

Verwendung der Funktion „Aktion erfassen“

When you are automating web pages running on Google Chrome and Microsoft Edge browsers, the Recorder > Capture Aktion no longer scrolls down the web page if the target object is visible on the screen. This improves the user experience and the reliability of automation when there is a fixed top pane on the web page and if some physical actions such as mouse clicks do not work as expected.

Supported applications

You can automate the following applications running on Microsoft Edge Chromium with IE mode:

Java web applications
Applications that are accessed through the Citrix Workspace app.
Citrix Virtual Apps

Anmerkung:

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.
When automating an Electron application, the Recorder captures specific controls on the application using the Microsoft UI Automation (COM) technology by default. This enables you to automate Electron applications seamlessly without having to recapture the object with a specific technology.

Supported control types

You can automate the following control types when you are automating a web page on a Google Chrome, Microsoft Edge Chromium, or Mozilla Firefox browser:

Pop-up windows
Alert dialog boxes
Confirmation dialog boxes
Prompt dialog boxes

Anmerkung: When you want to automate an alert dialog box on a web page, we recommend that you add a delay before the Recorder > Capture Aktion because sometimes, the alert dialog box appears after a delay on the application window.

Cross-domain support

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.

Capture using FrameDOMXPath property

The new FrameDOMXPath property identifies the frame in which the object is located. You must select this property to run the Bot successfully to automate objects on a cross-domain IFrame.

Anmerkung:

When you select the FrameDOMXPath property from the search criteria, do not change the value of this property.
If you clear the FrameDOMXPath property from the search criteria, the Recorder fails to identify the frame.

Wichtig: In the Google Chrome browser, you can capture and automate objects inside a cross-domain and use multiple frames with the same frame source.

Automate applications running as an admin user

You can capture objects on applications that are running as an administrator by selecting the Capture and run with admin privileges option from the Bot Editor.

<span>Capture objects using Capture and run with admin privileges option</span>

Before you automate applications running as an admin user, ensure the following:

Bot-Agent is installed in system profile.
Bot Creators and Bot Runners have admin rights on the device to automate the applications.

When you select the Start recording option in the Bot Editor to record multiple applications, and switch applications running in elevated and non-elevated mode, the Bot might not be able to identify the change between modes. In such cases, for all captures on applications in elevated mode, select the Capture and run with admin privileges option and then re-capture the object.

Anmerkung: Elevated mode gives you permission to run applications as an administrator.

Wichtig: When you try to automate any Java or SAP application that is non-elevated by using the Recorder in elevated mode, the Bot encounters an error.

To avoid this error, de-select the Capture and run with admin privileges option from the Bot Editor and run the Recorder in non-elevated mode to capture Java or SAP applications.

Object properties

When you select an object to capture, the Universal Recorder collects data on the object's properties in order to identity the object during run time. You can do the following with the object properties:

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 Get property Aktion 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 arrow.
For example, to retrieve the text of a link, use the Get property Aktion 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 Paket 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.

Anmerkung: This functionality is available for the bots you create using the 2.4.0-20211016-070100 version of the Recorder Paket starting from Automation 360 v.23. If you have created Bots using a previous version of the Recorder Paket, you must recapture the objects to use this functionality.

Actions performed on captured objects

After capturing the object, specify the action for the Bot to perform on the object at run time. For example, when you capture a hyperlink, you can select to click the link or to retrieve the link text. To see table of all objects and possible actions, see Aktionen für mit dem Universal Recorder erfasste Objekte.

Anmerkung: If you encounter an error when running a Bot that captures an object from Internet Explorer and the error message is about Google Chrome, see Ihr Chrome Plug-in ist entweder nicht installiert oder deaktiviert (Anmeldung bei A-People erforderlich).

Hintergrundverarbeitung

Die Hintergrundverarbeitung ermöglicht es, dass eine Automatisierung, bei der eine Interaktion mit einer Anwendung im Vordergrund stattfindet (z. B. Mausklicks), im Hintergrund ausgeführt wird. Es wird empfohlen, die Option zur Ausführung im Hintergrund zu verwenden, um die Sichtbarkeit des Zielobjekts zu erhöhen und die Bot-Genauigkeit zu verbessern. Folgende Aktionen unterstützen die Hintergrundverarbeitung:

Klick
Text festlegen
Text abrufen

Secure recording

When secure recording mode is enabled, Bots do not display the target object images after capture. This ensures that sensitive data is not shown.

Anmerkung: Although the Bots do not display the target images after capture, the images are still stored in the Control Room because they are required to run the Bots.

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. See Settings.

Proxy support

If your device is configured with a proxy, all outbound requests from this Paket are routed through the proxy server. See Den Bot-Agent mit einem Gerät mit Proxy verbinden.

Use cases on how to use recorder

Use these example tasks to become familiar with the use of the recorder in building Bots.