Extension pour Silverlight

La première étape consiste à désinstaller tout runtime Silverlight précédent en votre possession et à installer Silverlight Developer Runtime version 5.1.50918.0.

Remarque : une automatisation utilisant Silverlight est uniquement compatible avec la version de Developer Runtime qui a été installée.

Pour automatiser les applications Silverlight sans fenêtre, vous devez activer l'extension UiPath pour Silverlight. La méthode la plus simple pour installer l'extension de pont est d'ouvrir Studio, d'accéder à Outils (Tools) > Extensions UiPath (UiPath Extensions) et de sélectionner Silverlight > Installer (Install).

Vous pouvez également installer l'extension UiPath pour Silverlight en utilisant une invite de commande ouverte avec des droits d'administrateur, et en exécutant l'une des commandes suivantes :

• C:\Program Files\UiPath Studio\v8\UiPath\SetupExtensions.exe /silverlight
• C:\Program Files\UiPath Studio\v8\UiPath\slinject.exe /install : cette commande permet d'afficher plus d'informations au niveau de la console.
• C:\Program Files\UiPath Studio\v8\UiPath\slinject.exe /uninstall : cette commande permet de désinstaller l'extension. Elle supprime également toutes les entrées liées à l'extension dans la section Ajout/Suppression de programmes du Panneau de configuration (Control Panel Add/Remove Programs).

Remarque : il est indispensable de disposer de privilèges administrateur dans tous les cas. Si le contrôle de compte d'utilisateur (UAC) est désactivé, le fichier SetupExtensions.exe peut alors échouer au cours d'une installation en mode silencieux (dans les anciennes versions de Studio, tout du moins).

La fonction de mise à jour automatique de Windows est capable de mettre à jour Silverlight runtime en mode silencieux. Il est recommandé de décocher l'option Activer Microsoft Update à la dernière étape de l'assistant d'installation de Silverlight ou de configurer les mises à jour Silverlight en utilisant :

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

Suivez les instructions ci-dessous pour vérifier la configuration du paramètre sans fenêtre avec l'outil UiExplorer :

• Recherchez la balise <param name=”windowless” /> sous l'élément <object /> correspondant.
• Utilisez l'explorateur DOM (DOM Explorer) dans Internet Explorer (appuyez sur la touche F12 pour l'ouvrir).

Résolution des problèmes

Les applications de navigateur Silverlight peuvent uniquement être employées avec Internet Explorer car les autres navigateurs principaux ont cessé d'utiliser NPAPI (une API utilisée par le plugin Silverlight pour navigateur). Il existe également des applications Silverlight autonomes qui peuvent être utilisées en mode hors navigateur.

Important :

Une mise à jour majeure de Windows, qui modifie la version de Windows en 20H2, peut interrompre les interactions Silverlight. Pour résoudre ce problème, vous devez effectuer les actions suivants :

• Désinstallez Silverlight Developer Runtime et l'extension UiPath pour Silverlight.
• Installer Silverlight Developer Runtime version 5.1.50918.0.
• Installer l'extension UiPath pour Silverlight.

Les applications Silverlight sont intégrées aux pages Web à l'aide de la balise HTML <object> qui peut spécifier un paramètre sans fenêtre. Si l'application cible Silverlight contient le paramètre windowless=false (qui est la valeur par défaut), il n'est alors pas nécessaire d'activer l'extension UiPath pour Silverlight, car Active Accessibility et UIA sont déjà disponibles. Cela s'applique également aux applications Silverlight qui sont utilisées en mode hors navigateur.

Vous pouvez vérifier le paramètre sans fenêtre, comme suit :

• Pour les applications Internet Explorer Silverlight : utilisez l'Explorateur DOM (DOM Explorer) dans Internet Explorer pour rechercher la balise <param name=”windowless” /> sous l'élément <object /> correspondant.
• Pour les applications Silverlight hors du navigateur : utilisez UIExplorer pour rechercher la balise <param name=”windowless” /> sous l'élément <object /> correspondant.
  Remarque : une automatisation utilisant Silverlight est uniquement compatible avec la version de Developer Runtime qui a été installée.

En cas de problèmes d'automatisation avec l'extension pour Silverlight, les manipulations suivantes sont recommandées :

1. Vérifiez que vous possédez la version de développement Silverlight Developer Runtime et non la version ordinaire. Si un des fichiers suivants est présent, il s'agit d'une version de développement :

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

2. Vérifiez la version de runtime de Silverlight. La version doit être 5.1.50918.0 et vous la trouverez aux emplacements suivants :

   • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Silverlight (64 bits) - dans l'éditeur du Registre Windows ;
   • HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Silverlight (32 bits) - dans l'éditeur du Registre Windows ;
   • La fenêtre Paramètres > Applications et fonctionnalités (Settings > Apps & features);
   • L'onglet Détails (Details) des Propriétés du fichier d'installation de Silverlight.
3. Accédez à la clé de registre HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Deskover\UiPath et recherchez la valeur SLInstalled, qui est utilisée par UiPath pour suivre l'installation. Si la valeur est 0, l'extension pour Silverlight est désactivée.
4. Vérifiez que la commande slinject.exe /install a bien créé le fichier de configuration requis : C:\Program Files (x86)\Microsoft Silverlight\5.1.50918.0\System.Windows.ini. Celui-ci doit contenir les paramètres suivants : GenerateTrackingInfo=1 et AllowOptimize=0
5. Il faut qu'au moins une instance du processus sllauncher.exe /overwrite /emulate:"SLBroker.xap" /origin:"https://www.uipath.com/SLBroker.xap" existe au moment du lancement d'une automatisation d'applications Silverlight. Vous pouvez trouver ce processus grâce à l'outil Process Explorer.
6. Si jamais une des étapes précédentes n'a pas été mise en place automatiquement au moment de l'installation de l'extension, essayez de terminer la manipulation manuellement.
7. Collectez des traces tout en essayant de sélectionner des contrôles dans l'application Silverlight comme expliqué sur ce lien. Pour les traces ETL régulières, vous pouvez également définir la variable d'environnement UIPATH_SLHOOK_CONSOLE_LOGGING sur 1 ou true (insensible à la casse). Cela active les messages de journal et autres informations de débogage dans la fenêtre de la console du navigateur (F12 pour ouvrir). Ces messages sont générés par l'application Silverlight cible et ils sont enregistrés uniquement dans la console du navigateur en raison de limitations techniques et de performances.
   Remarque : vous devez définir la variable d'environnement avant d'effectuer une UI Automation. Assurez-vous de redémarrer UiPath et l'application cible Silverlight.