Ejemplo de utilización de la herramienta de migración ScaleCoordinates

El escalado en Windows puede tener un comportamiento diferente en función de la aplicación afectada. Esto puede causar inconsistencias en los flujos de trabajo que se ocupan de la automatización de la interfaz de usuario, en especial los que contienen actividades con las propiedades CursorPosition y ClippingRegion, como Click, Hover, Type Into, Click Text y otras. Sin embargo, esto solo es aplicable a los flujos de trabajo creados con una versión de Studio anterior a la 2018.2. Los flujos de trabajo creados con anterioridad a esta versión necesitan ser migrados con la herramienta ScaleCoordinates para ser ejecutados por los Robots DPI-aware (v2018.2).

A fin de proporcionar la flexibilidad necesaria que permita utilizar eficazmente los flujos de trabajo antiguos con la versión 2018.2, la herramienta ScaleCoordinates puede migrar archivos de flujo de trabajo individuales e incluso todos ellos dentro de una ruta determinada. No es necesario realizar cambios en los flujos de trabajo creados antes de Studio 2018.2 si son ejecutados con Robots compatibles con DPI, al igual que con los nuevos flujos de trabajo que desee ejecutar con Robots que no sean compatibles con DPI después de utilizar esta herramienta.

Nota: Usa la herramienta de migración ScaleCoordinates en flujos de trabajo de automatización de la interfaz de usuario diseñados con un DPI no estándar, en una versión de Studio anterior a la v2018.2. Los flujos de trabajo creados en un DPI regular no requieren una migración para ser ejecutados en Robots con DPI.

Sea cual sea el tipo de migración que quieras realizar, primero tienes que hacer lo siguiente:

1. Abre una instancia del símbolo del sistema.
2. Ve al directorio de instalación de la plataforma UiPath, donde se encuentra la herramienta de migración ScaleCoordinates.

3. Utiliza uno de los siguientes comandos:

   1. UiPath.ScaleCoordinates <input_xaml_file_path> <output_xaml_file_path> (--normalize_from | --denormalize_to)=<scaling_percentage> para migrar un solo archivo .xaml.
   2. UiPath.ScaleCoordinates <folder_path> (--normalize_from | --denormalize_to)=<scaling_percentage> para migrar todos los proyectos dentro de una carpeta determina.

Debes tener en cuenta que puedes normalizar los flujos de trabajo para que sean ejecutados en Studio 2018.2, así como adaptar un proyecto normalizado para que funcione con Robots antiguos en un DPI no estándar. A continuación se presentan ejemplos de estas situaciones, tanto en un solo proyecto como en varios.

Normalizar los flujos de trabajo antiguos para los robots con conciencia de DPI

Supongamos que necesitas usar un flujo de trabajo existente, como por ejemplo ProcessingInvoicesInSAP.xaml, a un porcentaje de escala del 150 % en Robots con DPI. El flujo de trabajo está diseñado en una versión de Studio anterior a la 2018.2, por lo tanto, es necesario normalizarlo para que funcione con el porcentaje de escala especificado utilizando el siguiente comando:

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

El flujo de trabajo migrado es exportado en la carpeta C:\Accounting\Automations con el nombre NormProcessingInvoicesInSAP. El archivo de flujo de trabajo original ya no se elimina tras la migración. Ahora el flujo de trabajo NormProcessingInvoicesInSAP puede ejecutarse con un porcentaje de escala del 150 %, en Robots con DPI (v2018.2).

Digamos ahora que quieres migrar varios flujos de trabajo que se ejecuten a un porcentaje de escala del 150 %. Ejecutar el comando anterior en varios archivos resulta una tarea tediosa, de modo que se recomienda utilizar el comando que migra los archivos de una carpeta completa. Si los archivos que necesitas migrar se encuentran en el directorio C:\Accounting\Automations, y quieres que se ejecuten con un factor de escala del 150 %, entonces el comando se ve así:

Nota: La normalización masiva no exporta los archivos de flujo de trabajo a una carpeta de salida, lo que significa que los archivos en la carpeta especificada se reemplazan. Es recomendable crear primero una copia de seguridad.

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

Ahora todos los archivos del directorio C:\Accounting\Automations pueden ser ejecutados a un porcentaje de escala del 150 % por los Robots con DPI (v2018.2).

Desnormalización de nuevos flujos de trabajo para Robots sin DPI

Desde la 2018.2 En Studio 2018.2, los Robots son conscientes de los DPI, por lo que los DPI con los que se crean los flujos de trabajo no afectan a la ejecución de los mismos. Sin embargo, si se ejecutan con un DPI no estándar en los Robots más antiguos, pueden causar una detección de elementos inconsistente. Para evitar esto, puedes usar la herramienta ScaleCoordinates para migrar los flujos de trabajo para ejecutarlos a un porcentaje de escala especificado en los Robots antiguos.

De la misma manera que la normalización de los flujos de trabajo, la desnormalización se puede realizar en un solo archivo de flujo de trabajo o en varios que se encuentran en una ruta especificada.

En el supuesto de que hayas diseñado el flujo de trabajo ProcessingInvoicesInSAP.xaml en Studio 2018.2 y quieras ejecutarlo con un porcentaje de escala del 150 % en Robots sin DPI, es necesario usar el siguiente comando para migrar el flujo de trabajo:

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

El flujo de trabajo DenormProcessingInvoicesInSAP.xaml está ahora listo para ser ejecutado con un porcentaje de escala del 150 % en los Robots antes de la versión de 2018.2.

De igual forma, pueden migrarse varios flujos de trabajo que reúnan las mismas condiciones de diseño para que se ejecuten a un porcentaje de escala del 150 % en Robots sin DPI. Recuerda que los archivos originales se sobrescriben, por lo que debes asegurarte de crear una copia de seguridad antes de migrarlos. El comando necesario, en este caso, se ve así:

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

Ahora, puedes ejecutar los archivos de flujo de trabajo en el directorio C:\Accounting\Automations en Robots sin DPI a un porcentaje de escala del 150 %.