- Install UI.Vision RPA
- Record a script using UI.Vision RPA
- Test the script in UI.Vision RPA
- Troubleshoot script issues using UI.Vision RPA
- Revise the script as necessary
- Upload the script to APM
Rather than manually entering all script commands, you can use a 3rd-party script recorder, such as UI.Vision RPA for Chrome (formerly Kantu), to record your interactions with a web application and automatically generate the Selenium script to mimic your interactions. UI.Vision RPA creates the script by recording your mouse clicks and key strokes as you interact with a web application - just like recording a macro.
As recording a script is just a starting point, it is likely that, once recorded, you will need to revise it manually. In particular, you may need to make web element locators more robust and you may need to manually add waits, assertions, or tests. For example, adding a command that waits for something to load, or checks that a certain label exists, or checks that something is visible. You may also need to resolve one or more common issues. Once you are happy with the script, you copy it from the recorder to the appropriate web app group workflow in APM and preview the script execution on a monitoring point.
The following steps describe how to use UI.Vision RPA (V5.3.17) to record your scripts. The steps are similar with other script recorders.
Install UI.Vision RPA
To install UI.Vision RPA:
- Open the Chrome browser.
- Go to the UI.Vision RPA for Chrome page.
- Click Add to Chrome.
- Click Add extension.
- The UI.Vision RPA is loaded into Chrome.
Record a script using UI.Vision RPA
Before recording, take some time to plan your steps through the app, and the results you expect to see from it. Start out small. Record a few lines and verify that they play back successfully before moving on.
To record a script using UI.Vision RPA:
- Open the Chrome browser.
- Navigate to the target URL (the URL of the web app you are creating the script for).
- Click the “UI.Vision RPA for Chrome” icon on the top right of the Chrome browser.
- Click + Macro.
- Specify the name of the new macro.
- Click Confirm.
- A new macro is created and selected.
- Click Record to start recording.
- Execute the planned workflow at the target URL.
- Confirm that your actions are being recorded in UI.Vision RPA.
- If an action can’t be recorded, move on and deal with it in the troubleshooting phase.
- Click Stop Record to stop recording.
- Click Save to save the recording.
Test the script in UI.Vision RPA
Once the script is recorded, play it back to make sure there are no errors.
To play the script in UI.Vision RPA:
- Click Play Macro.
- You will see the script executing the recorded commands in the Chrome browser.
- The Logs tab shows the commands being executed.
Troubleshoot script issues using UI.Vision RPA
Use the Logs tab at the bottom of UI.Vision RPA to review any error messages. Update the script accordingly and play it back again until there are no errors. Use the Resolving Common Issues page for assistance.
Revise the script as necessary
If you need to add commands to pause script execution or to test for things like the visibility or existence of various page elements, this is done by manually entering commands in the script.
To add a command to the script:
- Right-click the command above the one you want to insert and click Insert new line.
- In the Command field, select the command you want to add.
- In the Target field, enter the locator that identifies the target element the command is to act on (if applicable).
- In the Value field, enter a value required by the command (if applicable).
- Click Save.
Upload the script to APM
In order to run the script from your monitoring points, you need to upload it to the workflow of a web app group in APM.
To upload the script to APM:
- In UI.Vision RPA, in the left panel, right-click the name of the script you recorded and select Export as JSON.
- The JSON script file is downloaded to your computer.
- Follow the steps from Create a script but, rather than entering the commands manually, click the Source tab in the script editor and click Upload Recorded Script.
- Select the JSON script file downloaded to your computer.
- The script is uploaded to APM.
- Continue with the Selenium scripting workflow at Test the script.