Extensão para Silveriense

A primeira etapa é desinstalar qualquer Silverlight Runtime anterior que você possa ter e instalar a versão 5.1.50918.0 do Silverlight Developer Runtime.

Observação: a automação do Silverlight funciona apenas com a versão Developer Runtime instalada.

Para automatizar aplicativos do Silverlight sem janela, é necessário habilitar a extensão da UiPath para o Silverlight. A maneira mais simples de instalar a extensão de ponte é abrindo o Studio, navegando até Ferramentas > UiPath Extensions e selecionando Silverlight > Instalar.

Você também pode instalar a extensão da UiPath para o Silverlight usando um prompt de comando aberto com direitos de administrador, e executando um dos seguintes comandos a seguir:

• C:\Program Files\UiPath Studio\v8\UiPath\SetupExtensions.exe /silverlight
• C:\Program Files\UiPath Studio\v8\UiPath\slinject.exe /install - Esse comando exibe mais informações no console.
• C:\Program Files\UiPath Studio\v8\UiPath\slinject.exe /uninstall - Esse comando desinstala a extensão. Ele também remove todas as entradas de extensão na seção Adicionar/Remover Programas do Painel de Controle.

Observe que em todos os casos os direitos de administrador são necessários. Se o UAC estiver desabilitado, SetupExtensions.exe pode falhar de forma silenciosa (pelo menos em versões mais antigas do Studio).

A atualização automática do Windows pode atualizar de forma silenciosa o runtime do Silverlight. É recomendável desmarcar a opção Habilitar o Microsoft Update na última etapa do assistente de instalação do Silverlight ou configurar as atualizações do Silverlight usando:

C:\Program Files (x86)\Microsoft Silverlight\5.1.50918.0\Silverlight.Configuration.exe

Você pode verificar o parâmetro sem janela usando a ferramenta UiExplorer da seguinte maneira:

• Pesquise pela tag <param name=”windowless” /> sob o elemento <object /> correspondente.
• Use o DOM Explorer no Internet Explorer (pressione F12 para abri-lo).

Solução de problemas

Os aplicativos de navegador do Silverlight podem ser abertos apenas no Internet Explorer, porque todos os outros navegadores mais importantes descontinuaram o NPAPI - uma API usada pelo plug-in de navegador do Silverlight. Existem também aplicativos independentes do Silverlight que podem ser usados fora do navegador.

Importante:

Uma grande atualização do Windows, que altere a versão do Windows para o 20H2, pode interromper interações do Silverlight. Para corrigir esse problema, você deve:

• Desinstalar o Silverlight Developer Runtime e o UiPath Extension for Silverlight.
• Instalar o Silverlight Developer Runtime versão 5.1.50918.0.
• Instalar o UiPath Extension for Silverlight.

Os aplicativos do Silverlight são incorporados em páginas web usando a tag HTML <object>, que pode especificar um parâmetro sem janela. Se o aplicativo de destino do Silverlight possuir o parâmetro windowless=false (que é o padrão), então não é necessário habilitar a extensão da UiPath para o Silverlight, pois o Active Accessibility e o UIA já estão disponíveis. Isso também se aplica aos aplicativos do Silverlight de fora do navegador.

Você pode verificar o parâmetro sem janela da seguinte maneira:

• Para os aplicativos do Silverlight para o Internet Explorer - Use o DOM Explorer no Internet Explorer para pesquisar a tag <param name=”windowless” /> sob o elemento <object /> correspondente.
• Para aplicativos do Silverlight de fora do navegador - Use o UIExplorer para pesquisar pela tag <param name=”windowless” /> sob o elemento <object /> correspondente.
  Observação: a automação do Silverlight funciona apenas com a versão Developer Runtime instalada.

Se você estiver com problemas para criar automação com a extensão para o Silverlight, é recomendável tentar o seguinte:

1. Certifique-se de ter o Silverlight Developer Runtime, e não a versão regular que não é para desenvolvedores. Você possui o runtime de desenvolvedor se um dos seguintes arquivos estiver presente:

   • C:\Program Files (x86)\Microsoft Silverlight\5.1.50918.0\agcore.debug.dll
   • C:\Arquivos de Programas (x86)\Microsoft Silverlight\5.1.50918.0\dbgshim.dll

2. Verifique a versão de runtime do Silverlight. A versão precisa ser a 5.1.50918.0, e você pode encontrar isso nos seguintes locais:

   • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Silverlight (64 bits) - no Editor do Registro do Windows;
   • HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Silverlight (32bits) - no Editor do Registro do Windows;
   • A janela Configurações > Aplicativos e recursos;
   • A guia Detalhes das propriedades do arquivo de instalação do Silverlight.
3. Vá até a chave de registro HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Deskover\UiPath e procure pelo valor SLInstalled, que é usado pela UiPath para manter o controle da instalação. Se o valor for 0, então a extensão para o Silverlight está desabilitada.
4. Verifique se o comando slinject.exe /install criou o arquivo de configuração necessário: C:\Program Files (x86)\Microsoft Silverlight\5.1.50918.0\System.Windows.ini. Ele precisa conter as seguintes configurações: GenerateTrackingInfo=1 e AllowOptimize=0
5. Pelo menos uma instância do processo sllauncher.exe /overwrite /emulate:"SLBroker.xap" /origin:"https://www.uipath.com/SLBroker.xap" precisa existir nas inicializações de automação de aplicativos do Silverlight. Você pode encontrar o processo usando a ferramenta Explorador de Processos.
6. Se algum dos passos anteriores não aconteceu automaticamente ao instalar a extensão, você pode tentar conclui-los manualmente.
7. Colete rastreamentos enquanto tenta selecionar os controles dentro do aplicativo Silverlight, conforme explicado neste link. Para rastreamentos ETL regulares, você também pode definir a variável de ambiente UIPATH_SLHOOK_CONSOLE_LOGGING como 1 ou true (sem diferença entre maiúsculas e minúsculas). Isso habilita as mensagens de log e outras informações de depuração na janela do console do navegador (F12 para abrir). Essas mensagens são geradas pelo aplicativo de destino do Silverlight, e são registradas apenas no console do navegador devido a limitações técnicas e de desempenho.
   Observação: você precisa definir a variável de ambiente antes de executar qualquer automação de Interface Gráfica. Certifique-se de reiniciar o UiPath e o aplicativo de destino do Silverlight.