- Release Notes
- Getting Started
- Setup and Configuration
- Automation Projects
- Dependencies
- Types of Workflows
- File Comparison
- Automation Best Practices
- Source Control Integration
- Debugging
- The Diagnostic Tool
- Workflow Analyzer
- About Workflow Analyzer
- ST-NMG-001 - Variables Naming Convention
- ST-NMG-002 - Arguments Naming Convention
- ST-NMG-004 - Display Name Duplication
- ST-NMG-005 - Variable Overrides Variable
- ST-NMG-006 - Variable Overrides Argument
- ST-NMG-008 - Variable Length Exceeded
- ST-NMG-009 - Prefix Datatable Variables
- ST-NMG-011 - Prefix Datatable Arguments
- ST-NMG-012 - Argument Default Values
- ST-NMG-016 - Argument Length Exceeded
- ST-DBP-002 - High Arguments Count
- ST-DBP-003 - Empty Catch Block
- ST-DBP-007 - Multiple Flowchart Layers
- ST-DBP-020 - Undefined Output Properties
- ST-DBP-023 - Empty Workflow
- ST-DBP-024 - Persistence Activity Check
- ST-DBP-025 - Variables Serialization Prerequisite
- ST-DBP-026 - Delay Activity Usage
- ST-DBP-027 - Persistence Best Practice
- ST-DBP-028 - Arguments Serialization Prerequisite
- Variables
- Arguments
- Imported Namespaces
- Recording
- UI Elements
- Control Flow
- Selectors
- Object Repository
- Data Scraping
- Image and Text Automation
- Automating Citrix Technologies
- RDP Automation
- SAP Automation
- VMware Horizon Automation
- Logging
- The ScaleCoordinates Migration Tool
- Best Practices and Limitations
- Example of Using the ScaleCoordinates Migration Tool
- The ScreenScrapeJavaSupport Tool
- The WebDriver Protocol
- StudioPro
- Extensions
- Troubleshooting
Example of Using the ScaleCoordinates Migration Tool
Scaling in Windows can behave differently based on the affected application. This can cause inconsistencies in workflows that deal with UI automation, especially those which contain activities with the CursorPosition and ClippingRegion properties, such as Click, Hover, Type Into, Click Text, and others. However, this only applies to workflows created with a Studio version prior to 2018.2. Workflows created prior to this version need to be migrated with the ScaleCoordinates tool to be executed by DPI-aware Robots (v2018.2).
In order to provide the required flexibility to efficiently use old workflows with 2018.2, the ScaleCoordinates tool can migrate either individual or all workflow files inside a given path. No changes need to be made to workflows created prior to Studio 2018.2 if executed with DPI-aware Robots, as well as with new workflows you want to execute with Robots that are not DPI-aware after using this tool.
Regardless of the type of migration you want to perform, you first need to:
- Open a Command Prompt instance.
- Navigate to the UiPath Platform installation directory, where the ScaleCoordinates migration tool is located.
-
Use one of the following commands:
UiPath.ScaleCoordinates <input_xaml_file_path> <output_xaml_file_path> (--normalize_from | --denormalize_to)=<scaling_percentage>
to migrate a single.xaml
file.UiPath.ScaleCoordinates <folder_path> (--normalize_from | --denormalize_to)=<scaling_percentage>
to migrate all projects inside a particular folder.
Keep in mind that you can normalize workflows to be executed in Studio 2018.2, as well as to adapt a normalized project to work with old Robots on a non-standard DPI. Below are examples of these situations for both a single and multiple projects.
ProcessingInvoicesInSAP.xaml
, at 150% scale percentage on DPI-aware Robots. The workflow is designed in a Studio version older than 2018.2, therefore
it needs to be normalized to run at the specified scale percentage by using the following command:
UiPath.ScaleCoordinates C:\Accounting\Automations\ProcessingInvoicesInSAP.xaml C:\Accounting\Automations\NormProcessingInvoicesInSAP.xaml
-normalize_from=150
C:\Accounting\Automations
folder under the NormProcessingInvoicesInSAP
name. The original workflow file is not removed upon migration. The NormProcessingInvoicesInSAP
workflow can now be executed at 150% scale percentage, on DPI-aware Robots (v2018.2).
C:\Accounting\Automations
directory, and want them to be executed at 150% scale factor, then the command looks like this:
UiPath.ScaleCoordinates C:\Accounting\Automations -normalize_from=150
C:\Accounting\Automations
directory can now be executed at 150% scale percentage by DPI-aware Robots (v2018.2).
Since 2018.2 Robots are DPI-aware, the DPI at which workflows are created in Studio 2018.2 does not affect workflow execution. However, executing them at a non-standard DPI on older Robots can cause inconsistent element detection. To prevent this, you can use the ScaleCoordinates tool to migrate the workflows to run at a specified scale percentage on old Robots.
Just like normalizing workflows, denormalizing can be performed either on a single workflow file or multiple ones found in a specified path.
ProcessingInvoicesInSAP.xaml
workflow in Studio 2018.2 and want to run it at 150% scale percentage on DPI-unaware Robots, the following command needs
to be used to migrate the workflow:
UiPath.ScaleCoordinates C:\Accounting\Automations\ProcessingInvoicesInSAP.xaml C:\Accounting\Automations\DenormProcessingInvoicesInSAP.xaml
-denormalize_to=150
DenormProcessingInvoicesInSAP.xaml
workflow is now ready to be executed at 150% scale percentage on Robots prior to the 2018.2 version.
Similarly, multiple workflows meeting the same design conditions can be migrated to be executed at 150% scale percentage on DPI-unaware Robots. Remember that the original files are overwritten, so be sure to create a backup before migrating them. The necessary command, in this case, looks like this:
UiPath.ScaleCoordinates C:\Accounting\Automations -denormalize_to=150
C:\Accounting\Automations
directory on DPI-unaware Robots at 150% scale percentage.