- Overview
- UI Automation
- Applications and technologies automated with UI Automation
- Project compatibility
- 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
- 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
- UX-SEC-010 - App/Url Restrictions
- UX-DBP-029 - Insecure Password Use
- UI-PST-001 - Audit Log Level in Project Settings
- UiPath Browser Migration Tool
- Clipping region
- Computer Vision Recorder
- Activate
- Anchor Base
- Attach Browser
- Attach Window
- Block User Input
- Callout
- Check
- Click
- Click Image
- Click Image Trigger
- Click OCR Text
- Click Text
- Click Trigger
- Close Application
- Close Tab
- Close Window
- Context Aware Anchor
- Copy Selected Text
- Element Attribute Change Trigger
- Element Exists
- Element Scope
- Element State Change Trigger
- Export UI Tree
- Extract Structured Data
- Find Children
- Find Element
- Find Image
- Find Image Matches
- Find OCR Text Position
- Find Relative Element
- Find Text Position
- Get Active Window
- Get Ancestor
- Get Attribute
- Get Event Info
- Get From Clipboard
- Get Full Text
- Get OCR Text
- Get Password
- Get Position
- Get Source Element
- Get Text
- Get Visible Text
- Go Back
- Go Forward
- Go Home
- Google Cloud Vision OCR
- Hide Window
- Highlight
- Hotkey Trigger
- Hover
- Hover Image
- Hover OCR Text
- Hover Text
- Image Exists
- Indicate On Screen
- Inject .NET Code
- Inject Js Script
- Invoke ActiveX Method
- Key Press Trigger
- Load Image
- Maximize Window
- Microsoft Azure Computer Vision OCR
- Microsoft OCR
- Microsoft Project Oxford Online OCR
- Minimize Window
- Monitor Events
- Mouse Trigger
- Move Window
- Navigate To
- OCR Text Exists
- On Element Appear
- On Element Vanish
- On Image Appear
- On Image Vanish
- Open Application
- Open Browser
- Refresh Browser
- Replay User Event
- Restore Window
- Save Image
- Select Item
- Select Multiple Items
- Send Hotkey
- Set Clipping Region
- Set Focus
- Set Text
- Set To Clipboard
- Set Web Attribute
- Show Window
- Start Process
- System Trigger
- Take Screenshot
- Tesseract OCR
- Text Exists
- Tooltip
- Type Into
- Type Secure Text
- Use Foreground
- Wait Attribute
- Wait Element Vanish
- Wait Image Vanish
- Application Event Trigger
- Check/Uncheck
- Check App State
- Check Element
- Click
- Click Event Trigger
- Close Popup
- Drag and Drop
- Extract Table Data
- For Each UI Element
- Get Attribute
- Get Browser Data
- Get Text
- Get URL
- Go to URL
- Highlight
- Hover
- Inject Js Script
- Keyboard Shortcuts
- Keypress Event Trigger
- Mouse Scroll
- Navigate Browser
- Select Item
- Set Browser Data
- Set Runtime Browser
- Set Text
- Take Screenshot
- Type Into
- Use Application/Browser
- 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
- Computer Vision Local Server
- Mobile Automation
- 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
- Directional Swipe
- Draw Pattern
- 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
- Terminal
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.
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 theirappproperty. - 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.
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.
UiPath.ConversionTool.exe executable opens the UiPath Conversion Tool.
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 = nullis 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.
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.
.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
Settings.json file, run the command {ConversionToolInstallationFolder}/UiPath.ConversionTool.exe settings.jsonPost Migration Verification Keys
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.
