UiPath Studio Guide

The ScaleCoordinates Migration Tool

The ScaleCoordinates migration tool is a command line utility which is used to normalize coordinates in existing projects so they work on any DPI in 2018.2.

It is automatically deployed with UiPath Platform and can be found in the installation directory by the name of UiPath.ScaleCoordinates.exe.

Prior to 2018.2, a workflow created at a particular DPI had to be executed at the same DPI. In 2018.2, you can execute a workflow regardless of the DPI it was created at.

The tool comes in handy when having to deal with non-standard DPI. Any other scaling than 100% is considered to be non-standard.

However, to run a workflow in Studio in 2018.2 which was designed at a non-standard DPI in a previous version of Studio, you need to use the ScaleCoordinates tool to migrate it. Since workflows that were designed at standard DPI should work out of the box, the need for this tool is rare.

This tool normalizes the CursorPosition and ClippingRegion properties of the recorded automation.

The ScaleCoordinates tool can process either a single XAML file or all projects inside a particular path. The required syntaxes are as follows:

  1. A single XAML file: ScaleCoordinates <input_xaml_file_path> <output_xaml_file_path> (--normalize_from | --denormalize_to)=<scaling_percentage>, where:
    • <input_xaml_file_path> - The path of the XAML file you want to process.
    • <output_xaml_file_path> - The path of the processed XAML file.
    • --normalize_from - Normalizes a workflow designed in Studio versions older than 2018.2 to run at the specified <scaling_percentage> with DPI-aware Robots.
    • --denormalize_to - Denormalizes workflows designed in Studio 2018.2 to run at the DPI specified by <scaling_percentage> with Robots that are not DPI-aware (prior to 2018.2).
    • <scaling_percentage> - The DPI at which the target workflow needs to be executed.
  2. An entire folder path: ScaleCoordinates <folder_path> (--normalize_from | --denormalize_to)=<scaling_percentage>, where:
    • <folder_path> - The folder path of the XAML files you want to process.
    • --normalize_from - Normalizes a workflow designed in Studio versions older than 2018.2 to run at the specified <scaling_percentage> with DPI-aware Robots.
    • --denormalize_to - Denormalizes workflows designed in Studio 2018.2 to run at the DPI specified by <scaling_percentage> with Robots that are not DPI-aware (prior to 2018.2).
    • <scaling_percentage> - The DPI at which the target workflow needs to be executed.

The main purpose of the ScaleCoordinates tool is to make it easier to execute old workflows in Studio 2018.2 without making any changes to it. However, the tool can also be used to adapt a normalized project to work with old Robots on a non-standard DPI.

The ScaleCoordinates Migration Tool