Exemple d'utilisation de l'outil de migration ScaleCoordinates

Le comportement de la mise à l'échelle dans Windows peut être différent selon l'application concernée. Cela peut entraîner des incohérences dans les workflows qui gèrent UI Automation, surtout ceux qui contiennent des activités avec les propriétés Position du curseur (CursorPosition) et Région de détourage (ClippingRegion), telles que Cliquer (Click), Pointer (Hover), Saisir dans (Type Into), Cliquer sur le texte (Click Text), etc. En revanche, cela ne s'applique qu'aux workflows créés avec une version de Studio antérieure à 2018.2. Les workflows créés avant cette version doivent être migrés à l'aide de l'outil Mise à l'échelle des coordonnées (ScaleCoordinates) pour être exécutés par les Robots compatibles DPI (v2018.2).

Afin de fournir la flexibilité requise pour utiliser efficacement les anciens workflows à l'aide de 2018.2, l'outil Mise à l'échelle des coordonnées (ScaleCoordinates) peut migrer les fichiers de workflow individuellement ou tous les fichiers de workflows à l'intérieur d'un chemin donné. Aucune modification ne doit être apportée aux workflows créés avant Studio 2018.2 s'ils sont exécutés avec des Robots compatibles DPI, ainsi que de nouveaux workflows à exécuter avec des Robots non compatibles DPI, après avoir utilisé cet outil.

Remarque : utilisez l'outil de migration ScaleCoordinates sur les workflows d'automatisation de l'interface utilisateur conçus à un PPP non standard, dans une version de Studio antérieure à v2018.2. Les workflows créés à une résolution standard (DPI) ne nécessitent pas l'exécution d'une migration sur les Robots compatibles DPI.

Indépendamment du type de migration à effectuer, vous devez d'abord effectuer les opérations suivantes :

1. Ouvrir une instance d'invite de commandes.
2. Accéder au répertoire d'installation de la plate-forme UiPath, où l'outil de migration Mise à l'échelle des coordonnées (ScaleCoordinates) se trouve.

3. Utilisez l’une des commandes suivantes :

   1. UiPath.ScaleCoordinates <input_xaml_file_path> <output_xaml_file_path> (--normalize_from | --denormalize_to)=<scaling_percentage> pour migrer un seul fichier .xaml.
   2. UiPath.ScaleCoordinates <folder_path> (--normalize_from | --denormalize_to)=<scaling_percentage> pour migrer tous les projets dans un dossier particulier.

Gardez à l'esprit que vous pouvez normaliser des workflows pour qu'ils soient exécutés dans Studio 2018.2, ainsi qu'adapter un projet normalisé afin d'utiliser des anciens Robots sur un DPI non standard. Vous trouverez ci-dessous des exemples de ces situations pour un ou plusieurs projets.

Normalisation des anciens workflows pour les Robots compatibles DPI

Supposons que vous devez utiliser un workflow existant, tel que ProcessingInvoicesInSAP.xaml, au pourcentage d'échelle de 150 % sur des robots compatibles DPI. Le workflow est conçu dans une version de Studio antérieure à 2018.2. Il doit donc être normalisé pour s'exécuter au pourcentage d'échelle spécifié en utilisant la commande suivante :

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

Le workflow migré est exporté dans le dossier C:\Accounting\Automations sous le nom NormProcessingInvoicesInSAP. Le fichier de workflow d'origine n'est pas supprimé lors de la migration. Le workflow NormProcessingInvoicesInSAP peut désormais être exécuté à un pourcentage d'échelle de 150 %, sur des robots compatibles DPI (v2018.2).

Maintenant, disons que vous voulez migrer plusieurs workflows afin qu'ils soient exécutés au pourcentage d'échelle de 150 %. L'exécution de la commande ci-dessus sur plusieurs fichiers est une tâche fastidieuse. Il est donc recommandé d'utiliser la commande qui migre les fichiers à partir d'un dossier entier. Si les fichiers à migrer se trouvent dans le répertoire C:\Accounting\Automations, et que vous voulez qu'ils soient exécutés au facteur d'échelle de 150 %, la commande ressemble à ceci :

Remarque : la normalisation par lot n'exporte pas les fichiers de workflow vers un dossier de sortie, ce qui signifie que les fichiers du dossier spécifié sont remplacés. Il est recommandé de créer d'abord une sauvegarde.

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

Tous les fichiers du répertoire C:\Accounting\Automations peuvent à présent s'exécuter au pourcentage d'échelle de 150 % par des Robots compatibles DPI (v2018.2).

Dénormalisation des nouveaux workflows pour les Robots incompatibles DPI

Étant donné que les Robots 2018.2 sont compatibles PPP, le PPP auquel les workflows sont créés dans Studio 2018.2 n'affecte pas l'exécution du workflow. En revanche, leur exécution à un PPP non standard sur des Robots plus anciens peut entraîner une détection d'éléments incompatibles. Pour éviter cela, vous pouvez utiliser l'outil Mise à l'échelle des coordonnées (ScaleCoordinates) pour migrer les workflows afin qu'ils s'exécutent à un pourcentage d'échelle spécifié sur des Robots anciens.

Tout comme la normalisation des workflows, la dénormalisation peut être effectuée sur un ou plusieurs fichiers de workflow disponibles dans un chemin spécifié.

En supposant que vous avez conçu le workflow ProcessingInvoicesInSAP.xaml dans Studio 2018.2 et que vous voulez l'exécuter au pourcentage d'échelle de 150 % sur des Robots incompatibles DPI, la commande suivante doit être utilisée pour migrer le workflow :

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

Le workflow DenormProcessingInvoicesInSAP.xaml est à présent prêt pour être exécuté au pourcentage d'échelle de 150 % sur des Robots de version antérieure à 2018.2.

De la même manière, plusieurs workflows répondant aux mêmes conditions de conception peuvent être migrés afin d'être exécutés au pourcentage d'échelle de 150 % sur des Robots incompatibles DPI. N'oubliez pas que les fichiers d'origine sont écrasés. Veillez ainsi à créer une sauvegarde avant de les migrer. La commande nécessaire, dans ce cas, ressemble à ceci.

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

À présent, vous pouvez exécuter les fichiers de workflow dans le répertoire C:\Accounting\Automations sur des Robots incompatibles DPI-au pourcentage d'échelle de 150 %.