UiPath Studio

UiPath Studio 指南

ScaleCoordinates 迁移工具用法示例

根据受影响的应用程序,Windows 中的缩放行为可能有所不同。这可能导致处理用户界面自动化的工作流不一致,特别是那些包含具有“光标位置”和“剪切区域”属性的活动的工作流,例如“单击”、“悬停”、“键入”、“单击文本”等等。但是,这只适用于使用 2018.2 之前的 Studio 版本创建的工作流。在此版本之前创建的工作流需要使用 ScaleCoordinates 工具进行迁移才能由 DPI 感知机器人执行 (v2018.2)。

为了提供高效率将旧工作流与 2018.2 配合使用所需要的灵活性,ScaleCoordinates工具可以迁移给定路径中的单独或全部工作流文件。如果使用 DPI 感知机器人来执行,那么不需要对 Studio 2018.2 之前创建的工作流进行任何更改。而且,在使用该工具之后,对于您希望使用非 DPI 感知的机器人执行的工作流,也不需要进行任何更改。

重要提示:

在 v2018.2 之前的 Studio 版本中,请在以非标准 DPI 设计的用户界面自动化工作流中使用 ScaleCoordinates 工具。以常规 DPI 创建的工作流不需要在 DPI 感知的机器人上执行迁移。

无论要执行何种类型的迁移,首先需要执行以下操作:

  1. 打开命令提示符实例。
  2. 导航到 UiPath 平台安装目录,也就是 ScaleCoordinates 迁移工具的所在位置。
  3. 使用以下命令之一:
    3.1.UiPath.ScaleCoordinates <input_xaml_file_path> <output_xaml_file_path> (--normalize_from | --denormalize_to)=<scaling_percentage>,用于迁移单个 .xaml 文件。
    3.2.UiPath.ScaleCoordinates <folder_path> (--normalize_from | --denormalize_to)=<scaling_percentage>,用于迁移特定文件夹中的所有项目。

切记,您可以将要在 Studio 2018.2 中执行的工作流规范化,并调整规范化项目以在非标准 DPI 上适用于旧机器人。下面的例子介绍了针对单个和多个项目的情况。

针对 DPI 感知机器人规范化旧工作流

让我们假设您需要使用现有的工作流,例如 ProcessingInvoicesInSAP.xaml,在 DPI 感知的机器人上使用 150% 的比例。该工作流是在一个低于 2018.2 的 Studio 版本中设计的,因此需要使用以下命令将其规范化,以便以指定的比例百分比运行:

UiPath.ScaleCoordinates C:\Accounting\Automations\ProcessingInvoicesInSAP.xaml C:\Accounting\Automations\NormProcessingInvoicesInSAP.xaml -normalize_from=150

迁移的工作流将在 C:\Accounting\Automations 文件夹中导出,名称为 NormProcessingInvoicesInSAP。迁移后不会删除原始工作流文件。NormProcessingInvoicesInSAP 工作流现在可以在 DPI 感知机器人上以 150% 的比例执行 (v2018.2)。

现在假设您希望迁移多个工作流,以便以 150% 的比例执行。对多个文件上运行以上命令是一项繁琐的任务,因此建议使用从整个文件夹迁移文件的命令。如果您需要迁移的文件位于 C:\Accounting\Automations 目录中,并且希望它们以 150% 的比例系数执行,那么命令如下所示:

Note:

批量规范化不会将工作流文件导出到输出文件夹,这意味着指定文件夹中的文件将被替换。建议先创建备份。

UiPath.ScaleCoordinates C:\Accounting\Automations -normalize_from=150

C:\Accounting\Automations 目录中的所有文件现在都可以由 DPI 感知的机器人以 150% 的比例执行 (v2018.2)。

针对无法感知 DPI 的机器人去规范化新工作流

由于 2018.2 机器人具备 DPI 感知能力,Studio 2018.2 中创建工作流所采用的 DPI 不会影响工作流执行。然而,在旧机器人上以非标准 DPI 执行工作流可能会导致不一致的元素检测。若要避免此问题,您可以使用“ScaleCoordinates”工具迁移工作流,以便在旧版机器人中以指定的缩放百分比运行。

就像规范化工作流一样,可以对指定路径中的单个工作流文件上或多个工作流文件执行去规范化。

假设您在 Studio 2018.2 中设计了 ProcessingInvoicesInSAP.xaml 工作流,并希望在无法感知 DPI 的机器人上以 150% 的比例运行,则需要使用以下命令来迁移工作流:

UiPath.ScaleCoordinates C:\Accounting\Automations\ProcessingInvoicesInSAP.xaml C:\Accounting\Automations\DenormProcessingInvoicesInSAP.xaml -denormalize_to=150

DenormProcessingInvoicesInSAP.xaml 工作流现在可以在 2018.2 版本之前在机器人上以 150% 的比例执行。

类似地,可以迁移满足相同设计条件的多个工作流,在在无法感知 DPI 的机器人以 150% 比例执行。切记,原始文件将被覆盖的,所以在迁移之前务必要创建备份。在此情况下,必要的命令如下所示:

UiPath.ScaleCoordinates C:\Accounting\Automations -denormalize_to=150

现在,您可以在无法感知 DPI 的机器人上以 150% 比例执行 C:\Accounting\Automations 目录中的工作流文件。

Updated 8 months ago


ScaleCoordinates 迁移工具用法示例


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.