Exemplo de uso da ferramenta de migração ScaleCoordinates

O dimensionamento no Windows pode se comportar de maneira diferente com base no aplicativo afetado. Isso pode causar inconsistências em fluxos de trabalho que lidam com a Automação de interface gráfica, especialmente os que contêm atividades com as propriedades PosiçãoDoCursor e RegiãoDeRecorte, como Click, Hover, Type Into, Click Text e outros. No entanto, isso se aplica apenas a fluxos de trabalho criados com uma versão do Studio anterior à 2018.2. Fluxos de trabalho criados antes dessa versão precisam ser migrados com a ferramenta ScaleCoordinates, a ser executada por robôs com reconhecimento do DPI (v2018.2).

Para fornecer a flexibilidade necessária para usar com eficiência fluxos de trabalho antigos com a versão 2018.2, a ferramenta ScaleCoordinates pode migrar arquivos de fluxo de trabalho individuais ou todos eles dentro de um determinado caminho. Nenhuma alteração precisa ser feita nos fluxos de trabalho criados antes do Studio 2018.2, se forem executados com Robots com reconhecimento de DPI, bem como com novos fluxos de trabalho que você deseja executar com Robots sem reconhecimento de DPI após usar essa ferramenta.

Observação: use a ferramenta de migração ScaleCoordinates em fluxos de trabalho de automação de interface gráfica criados em DPI fora do padrão, em uma versão do Studio anterior a v2018.2. Fluxos de trabalho criados em um DPI regular não necessitam de uma migração a ser executada em robôs com reconhecimento de DPI.

Independentemente do tipo de migração desejada, você primeiro precisa:

1. Abrir uma instância do promotor de comando.
2. Navegar até o diretório de instalação da plataforma Quipata, onde a ferramenta de migração ScaleCoordinates está localizada.

3. Use um dos seguintes comando:

   1. UiPath.ScaleCoordinates <input_xaml_file_path> <output_xaml_file_path> (--normalize_from | --denormalize_to)=<scaling_percentage> para migrar um único arquivo .xaml.
   2. UiPath.ScaleCoordinates <folder_path> (--normalize_from | --denormalize_to)=<scaling_percentage> para migrar todos os projetos dentro de uma pasta específica.

Lembre-se de que você pode normalizar fluxos de trabalho para serem executados no Studio 2018.2, além de adaptar um projeto normalizado para trabalhar com Robots antigos em DPI não padrão. Veja abaixo exemplos dessas situações para um único e vários projetos.

Normalização de fluxos de trabalho antigos para robôs com recolhimento de DPI

Vamos supor que você precise usar um fluxo de trabalho existente, como ProcessingInvoicesInSAP.xaml, no percentual de escala de 150% em Robots com reconhecimento de DPI. O fluxo de trabalho foi projetado em uma versão do Studio mais antiga que a 2018.2 e, portanto, ele precisa ser normalizado para funcionar no percentual de escala especificado usando o seguinte comando:

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

O fluxo de trabalho migrado é exportado na pasta C:\Accounting\Automations sob o nome NormProcessingInvoicesInSAP. O arquivo de fluxo de trabalho original não é removido após a migração. O fluxo de trabalho NormProcessingInvoicesInSAP agora pode ser executado em percentual de escala de 150% em robôs com reconhecimento de DPI (v2018.2).

Agora digamos que você queira migrar vários fluxos de trabalho para serem executados em um percentual de escala de 150%. A execução do comando acima em vários arquivos é uma tarefa de tediosa, portanto é recomendável usar o comando que migra arquivos de uma pasta inteira. Se os arquivos que você precisa migrar estiverem no diretório C:\Accounting\Automations, e os quiser que sejam executados em um fator de escala 150%, então o comando será assim:

Observação: a normalização em lote não exporta os arquivos do fluxo de trabalho para uma pasta de saída, o que significa que os arquivos na pasta especificada são substituídos. É recomendável criar um backup primeiro.

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

Todos os arquivos no diretório C:\Accounting\Automations agora podem ser executados em uma porcentagem da escala de 150% por robôs que reconhecem DPI (v2018.2).

Desanimalização de novos fluxos de trabalho para robôs sem reconhecimento de DPI

Como os Robots 2018.2 têm reconhecimento de DPI, o DPI no qual os fluxos de trabalho são criados no Studio 2018.2 não afeta a execução do fluxo de trabalho. Entretanto, a sua execução em um DPI não padrão em Robots mais antigos pode causar uma detecção inconsistente de elementos. Para evitar isso, é possível usar a ferramenta ScaleCoordinates para migrar os fluxos de trabalho para serem executados em um percentual de escala especificado em Robots antigos.

Assim como a normalização de fluxos de trabalho, a desanimalização pode ser executada em um único arquivo de fluxo de trabalho ou vários os encontrados em um caminho especificado.

Supondo que você projetou o fluxo de trabalho ProcessingInvoicesInSAP.xaml no Studio 2018.2 e deseja executá-lo em uma porcentagem de escala de 150% em Robots sem reconhecimento de DPI, o seguinte comando precisa ser usado para migrar o fluxo de trabalho:

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

O fluxo de trabalho DenormProcessingInvoicesInSAP.xaml agora está pronto para ser executado na escala de 150% em robôs antes da 2018.2 versioná.

De forma similar, vários fluxos de trabalho que atendem as mesmas condições de projeto podem ser migrados para serem executados em uma escala de 150% em robôs que não reconhecem DPI. Lembre-se de que os arquivos originais são substituídos; portanto, faça um backup antes de migrá-los. O comando necessário, neste caso, será assim:

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

Agora, é possível executar os arquivos de fluxo de trabalho no diretório C:\Accounting\Automations em robôs sem reconhecimento de DPI em um percentual de escala de 150%.