- Release notes
- UI-ANA-016 - Pull Open Browser URL
- UI-ANA-017 - ContinueOnError True
- UI-ANA-018 - List OCR/Image Activities
- UI-DBP-006 - Container Usage
- UI-DBP-013 - Excel Automation Misuse
- UI-DBP-030 - Forbidden Variables Usage In Selectors
- ST-DBP-021 - Hardcoded Timeout
- UI-PRR-001 - Simulate Click
- UI-PRR-002 - Simulate Type
- UI-PRR-003 - Open Application Misuse
- UI-PRR-004 - Hardcoded Delays
- UI-REL-001 - Large Idx in Selectors
- UI-SEC-004 - Selector Email Data
- UI-SEC-010 - App/Url Restrictions
- UI-USG-011 - Non Allowed Attributes
- SY-USG-013 - Private File Invoke
- SY-USG-014 - Incorrect Execution Template Placeholders
- Applications and technologies automated with UI Automation
- UiPath Browser Migration Tool
- Computer Vision Recorder
- Click
- Hover
- Type Secure Text
- Send Hotkey
- Type Into
- Check
- Select Item
- Select Multiple Items
- Get Text
- Set Text
- Activate
- Highlight
- Set Focus
- Anchor Base
- Context Aware Anchor
- Find Relative Element
- Indicate On Screen
- Element Exists
- Find Element
- Wait Element Vanish
- Find Children
- Get Ancestor
- Element Scope
- Get Attribute
- Set Clipping Region
- Get Position
- Take Screenshot
- Wait Attribute
- On Element Appear
- On Element Vanish
- Click Text
- Hover Text
- Find Text Position
- Get Full Text
- Get Visible Text
- Extract Structured Data
- Text Exists
- Click OCR Text
- Hover OCR Text
- Get OCR Text
- Find OCR Text Position
- Microsoft OCR
- Microsoft Project Oxford Online OCR
- Microsoft Azure Computer Vision OCR
- Tesseract OCR
- Google Cloud Vision OCR
- OCR Text Exists
- Click Image
- Hover Image
- Find Image Matches
- Image Exists
- Find Image
- Wait Image Vanish
- On Image Appear
- On Image Vanish
- Load Image
- Save Image
- Attach Browser
- Close Tab
- Go Back
- Go Forward
- Go Home
- Inject JS Script
- Navigate To
- Open Browser
- Refresh Browser
- Set Web Attribute
- Attach Window
- Close Window
- Get Active Window
- Hide Window
- Maximize Window
- Minimize Window
- Move Window
- Restore Window
- Show Window
- Export UI Tree
- Invoke ActiveX Method
- Inject .NET Code
- Click Trigger
- Key Press Trigger
- Click Image Trigger
- System Trigger
- Hotkey Trigger
- Mouse Trigger
- Get Event Info
- Monitor Events
- Get Source Element
- Replay User Event
- Block User Input
- Use Foreground
- Element Attribute Change Trigger
- Element State Change Trigger
- Callout
- Copy Selected Text
- Get From Clipboard
- Set To Clipboard
- Close Application
- Open Application
- Start Process
- Get Password
- Tooltip
- Click Picture on Screen
- Click Toolbar Button
- Read Statusbar
- Select Dates in Calendar
- Select Menu Item
- Expand Tree
- Call Transaction
- SAP Logon
- SAP Login
- Table Cell Scope
- SAP Session Attributes Change Trigger
- Expand ALV Tree
- Expand ALV Hierarchical Table
- Use Application/Browser
- Check App State
- Check/Uncheck
- Click
- Extract Table Data
- Get Text
- Get URL
- Go to URL
- Highlight
- Hover
- Keyboard Shortcuts
- Navigate Browser
- Select Item
- Take Screenshot
- Type Into
- Get Attribute
- Get Browser Data
- Set Browser Data
- Mouse Scroll
- Inject Js Script
- Drag and Drop
- For Each UI Element
- Application Event Trigger
- Click Event Trigger
- Keypress Event Trigger
- Set Text
- Check Element
- Perform browser search and retrieve results using UI Automation APIs
- Web Browsing
- Find Images
- Click Images
- Trigger and Monitor Events
- Create and Override Files
- HTML Pages: Extract and Manipulate Information
- Window Manipulation
- Automated List Selection
- Find and Manipulate Window Elements
- Manage Text Automation
- Load and Process Images
- Manage Mouse Activated Actions
- Automate Application Runtime
- Automated Run of a Local Application
- Browser Navigation
- Web Automation
- Trigger Scope Example
- Release Notes
- Project Compatibility
- Get Log Types
- Get Logs
- Get Page Source
- Get Device Orientation
- Get Session Identifier
- Install App
- Manage Current App
- Manage Other App
- Open DeepLink
- Open URL
- Mobile Device Connection
- Positional Swipe
- Press Hardware Button
- Set Device Orientation
- Take Screenshot
- Take Screenshot Part
- Element Exists
- Execute Command
- Get Attribute
- Get Selected Item
- Get Text
- Set Selected Item
- Set Text
- Swipe
- Tap
- Type Text
- Draw Pattern
UiPath Browser Migration Tool
The UiPath Browser Migration Tool is a standalone tool that converts the workflows using a target browser such as Internet Explorer, Chrome, Edge, or Firefox, making them target another browser, such as Chrome, Edge, or Firefox. This tool can be helpful when migrating workflows from the legacy Internet Explorer browser to newer browsers, or simply when you want to adapt your workflow to using another browser.
This tool is compatible with any XAML files generated with any Studio or UI Automation version.
<wnd…
, since those identify UI elements rendered differently by IE in comparison with Edge/Chrome/Firefox. These selectors have
to be manually updated.
How the UiPath Browser Migration Tool Works
In order to migrate the workflows from using one browser to another, there are a list of things that are done, as follows:
- The
<html...>
selectors are migrated by updating theirapp
property. - The BrowserType property of the Open Browser and Attach Browser activities is modified accordingly.
- Any Kill Process activity targeting the Source Browser is updated to target the Target Browser.
-
The Object Repository items defined in the Source Browser are converted to use the Target Browser.
Note: The migration tool does not have a 100% success rate. To get closer to such a rate, it is recommended to perform validation on the migrated workflows.
Installing the UiPath Browser Migration Tool
First, download the zipped tool from the Resource Center in the Automation Cloud portal (the help menu > Downloads > UiPath Tools > Browser Migration Tool).
Next, unzip the archive in a folder of your choice.
Running the UiPath.ConversionTool.exe
executable opens the UiPath Conversion Tool.
Configuring the UiPath Browser Migration Tool
The UiPath Browser Migration Tool can be configured by editing the Settings.json
file present in the installation folder.
The following parameters can be edited:
"Folder": ""
- specifies the target folder where you want to migrate the XAML files."SourceBrowser": "IE"
- Specifies the source browser. The possible options areIE
,Chrome
,Edge
,Firefox
."DestinationBrowser": "Chrome"
- Specifies the destination browser, The possible options areChrome
,Edge
,Firefox
."PreviewChanges": false
- If set totrue
, the original files are not modified, only a change log is generated. If set tofalse
, the updates are applied to the source XAML files."ReplaceNullBrowserType": true
- If set totrue
, if found, theBrowserType = null
is updated toBrowserType = targetBrowser
. If set tofalse
, these cases are ignored."IncludeSubfolders": true
- If set totrue
, modifies all the XAML files from the specified folder and its subfolders. If set tofalse
, it modifies only the files in the target parent folder."CreateBackupFiles": true
- If set totrue
, it creates backup files (.bak
) before updating the original ones. The backup files can be found at{SourceFolder}/.conversion_backup
. If set tofalse
, backup files are not created."EnableLogging": true
- If set totrue
, creates a log file. If set tofalse
, no log file is created.
Using the UiPath Browser Migration Tool
From the UI
To use the tool, you must first provide the path to the workflow that you want to migrate in the Project Folder section.
Next, select the browser you have created the automation with in the Source Browser drop-down menu and the browser you want to migrate to in the Destination Browser drop-down menu.
The Preview Changes button runs the tool in preview changes mode. This scans all the .xaml
files and outputs the changes that would be applied in the UiPath.ConversionTool_log.json
log file which is generated in the target folder. No changes are applied to the actual workflow and no backup files are created.
The Start button performs the migration on the specified workflow, making it compatible with the browser of your choice.
From the Command Line
To use the tool with the settings configured in the Settings.json
file, run the command {ConversionToolInstallationFolder}/UiPath.ConversionTool.exe settings.json
Post Migration Verification Keys
Once used, the UiPath Browser Migration Tool creates a log file named
UiPath.ConversionTool_log
in the project folder. The file
provides an overview of the process under the "GlobalStatistics"
parameter and full update details per each XAML file under the
"FileChanges/FileName/Statistics"
parameter.
Other Migration Aspects
If you plan to migrate the automations to Edge (Chromium), this can be done starting with:
- Studio version v19.10.5 and UiPath.UIAutomation.Activities v19.11.3
- Studio version v20.4.1 and UiPath.UIAutomation.Activities v20.4.1
If you plan to run after migrating under Edge Chromium with IE Mode activated, this is available starting with UiPath.UIAutomation.Activities v20.10 and above.
Please note that running automations on Chrome, Edge, or Firefox requires the proper UiPath Extension to be installed.