Extension pour Java

Remarque : pour Java 9+, l'extension UiPath pour Java fonctionne sur les éditions Windows Enterprise et non Enterprise avec des applications ouvertes avec Java JDK. Pour les applications ouvertes avec Java JRE, l'extension UiPath pour Java ne fonctionne que sur les éditions Windows non-Enterprise. Pour en savoir plus, consultez le guide de résolution des problèmes de l'extension Java.

De Studio et de la ligne de commande

L'extension UiPath pour Java est installée en procédant comme suit :

1. D'abord, fermez les applications Java en cours. Lancez Studio et accédez à l'onglet Outils (Tools) depuis le Mode Backstage de Studio (Studio Backstage View). Les extensions que vous pouvez installer s'affichent. Cliquez sur le bouton Extensions Java (Java Extensions). Un message de confirmation s'affiche et vous informe que l'extension a été installée.
2. Exécutez cette commande C:\Program Files (x86)\UiPath\Studio\UiPath\SetupExtensions.exe /Java dans une fenêtre d'invite de commande avec des droits d'administrateur.

Studio et UI Explorer vous demandent également d'installer l'extension UiPath pour Java si vous tentez de sélectionner un contrôle dans une application Java, et lorsque le pont n'est pas détecté. Remarque : si vous choisissez d'installer l'extension UiPath pour Java à l'invite d'UI Explorer, les fichiers Java Bridge ne seront déployés que dans le répertoire JDK, qui a lancé l'application Java cible au lieu du répertoire JDK.

Remarque : il est nécessaire de disposer de droits d'administrateur pour installer cette extension.

Pour vérifier si l'extension présente des dysfonctionnements, ouvrez UIExplorer et essayez de sélectionner les contrôles dans une application Java. Si la fenêtre entière est sélectionnée, cela signifie que l'extension ne fonctionne pas correctement.

Vous pouvez savoir si l'extension est correctement installée ou non par les sélecteurs générés pour les contrôles Java.

• Sélecteur non valide pour les contrôles Java : <wnd app=”...” /><java role=”...” />
• Sélecteur non valide pour les contrôles Java : <wnd app=”...” /><ctrl role=”client” />

Remarque : l'extension UiPath pour Java n'est compatible qu'avec les applications AWT (par ex. Java Swing, Oracle Forms, Fujitsu JBK), tandis que les applications SWT sont automatisées avec Active Accessibility. Pour détecter le type de votre application Java, vérifiez l'attribut cls (nom de la classe de fenêtre) dans UI Explorer. Le nom de la classe doit être similaire à SunAwtFrame ou javax.swing.

Les processus peuvent interagir avec les applications Java quelle que soit leur échelle DPI.

Vous pouvez également installer l'extension UiPath pour Java à l'aide de l'outil ScreenScrapeJavaSupport.

Installation de l'extension dans un dossier personnalisé

Pour Java 8 ou version antérieure

Pour que l'extension UiPath pour Java soit installée dans un emplacement personnalisé, les étapes suivantes doivent être suivies :

1. Créez un dossier sur la machine sur laquelle vous souhaitez installer l'extension UiPath pour Java (par exemple, C:\UiPathJavaExt) et copiez les fichiers suivants :
   1. UiPathBridge.jar - situé dans le répertoire %UserProfile%\.nuget\packages\uipath\20.xx.xxxx\build\UiPath\JavaSupport.
   2. UiPathJavaBridgeV8.dll et UiPathJavaBridgeV8_x64.dll situés dans le répertoire %UserProfile%\.nuget\packages\uipath\20.xx.xxxx\build\UiPath. Il n'est pas nécessaire de copier les deux fichiers, mais cela peut éviter les problèmes qui peuvent survenir en raison d'une mauvaise concordance des versions entre le JRE et le UiPathJavaBridge.
2. Le mécanisme d’installation de l’extension Java utilisé par UiPath pour installer l’extension déploie les fichiers UiPathBridge.jar et accessibility.properties dans le répertoire d’installation Java (généralement C:\Program Files (x86)\Java\jre1.8.0_xx). Pour que l’extension UiPath pour Java puisse être utilisée depuis un dossier personnalisé, la dépendance de ces fichiers doit être assouplie, comme suit :
   1. Pour le fichier UiPathBridge.jar, vous devez spécifier le dossier dans lequel vous avez copié UiPathBridge.jar et UiPathJavaBridgev8.dll (tel que C:\UiPathJavaExt) lorsque vous démarrez l'application Java qui utilise l'extension. Cela se fait via l’argument -Djava.ext.dirs = C:\UiPathJavaExt.
   2. Pour le fichier accessibility.properties, il existe deux méthodes :
      • Ajouter le paramètre assistive_technologies=UiPath.UiPathBridge au fichier de configuration globale accessibility.properties situé dans le répertoire %userprofile%. Notez que ce fichier est différent de celui déployé par l'extension UiPath pour Java, et que ses paramètres ont la priorité sur ceux définis par l'installation de Java.
      • Utiliser l'argument -Djavax.accessibility.assistive_technologies=UiPath.UiPathBridge lorsque vous exécutez l'application Java cible.

Les propriétés du système doivent être correctement transmises à l'application Java cible par l'un des moyens suivants :

• Inclure la propriété système -Djava.ext.dirs=C:\UiPathJavaExt -Djavax.accessibility.assistive_technologies=UiPath.UiPathBridge dans la variable d'environnement _JAVA_OPTIONS. Le JRE charge les propriétés de la variable d'environnement ainsi que l'extension UiPath pour Java chargée dans l'application cible.
• Utiliser la commande C:\Program Files (x86)\Java\jre1.8.0_xx\bin\java.exe -Djavax.ext.dirs=C:\UiPathJavaExt -Djavax.accessibility.assistive_technologies=UiPath.UiPathBridge -jar SwingSet2.jar dans l'invite de commande. Un message de confirmation apparaît indiquant que l'extension UiPath pour Java a été chargée avec succès.
• Inclure la propriété du système -Djava.ext.dirs=C:\UiPathJavaExt -Djavax.accessibility.assistive_technologies=UiPath.UiPathBridge dans la variable d'environnement JAVA_TOOL_OPTIONS. Notez que cette méthode ne fonctionne qu'avec Java 5 ou supérieur.

La transmission des propriétés à une applet Java se fait par l'un des moyens suivants :

1. À l'aide de l’application appletviewer.exe.
   Cette méthode vous oblige à d’abord créer le fichier .java.policy dans le dossier %userprofile% et doit contenir les éléments suivants :

   grant { 
       permission java.net.URLPermission "url_of_the_Java_applet", "<em>:</em>"; 
   };

   Une fois cette opération effectuée, l'applet cible doit être démarrée via appletviewer.exe avec cette commande :

   C:\Program Files (x86)\Java\jre1.8.0_xx\bin\appletviewer.exe -J-Djava.ext.dirs=C:\UiPathJavaExt -J-Djavax.accessibility.assistive_technologies=UiPath.UiPathBridge url_of_the_java_applet

2. À l'aide du panneau de contrôle Java livré avec le JRE.

   Le panneau de configuration Java vous permet de spécifier les paramètres d'exécution de chaque JRE enregistré. En tant que tel, vous devez spécifier le

   -Djava.ext.dirs=C:\UiPathJavaExt -Djavax.accessibility.assistive_technologies=UiPath.UiPathBridge

   paramètre de l'applet cible. Cela permet à l'extension UiPath pour Java de se charger à chaque démarrage de l'applet Java.

Le tableau ci-dessous présente la compatibilité des méthodes utilisées ci-dessus, les versions Java et les différents types d'applications Java :

Type de demande (Application Type)	_JAVA_OPTIONS	JAVA_TOOL_OPTIONS	Paramètres de la ligne de commande	Panneau de configuration Java - Paramètres d'exécution (Java Control Panel - Runtime Parameters)
Application Java Desktop	Java 3 à Java 8	Java 5 à Java 8	Java 3 à Java 8	Non soutenu
Application contenue dans Java (.exe)	Java 3 à Java 8	Java 5 à Java 8	Java 3 à Java 8 (1)	Non soutenu
Java Applet	Java 3 à Java 8	Java 5 à Java 8	Non soutenu	Java 3 à Java 8
Java Oracle Forms	Non soutenu	Non soutenu	Non soutenu	Non soutenu

(1) – selon l'outil de ligne de commande que vous utilisez, des paramètres supplémentaires peuvent devoir être passés par les variables d'environnement.

Pour Java 9 ou version ultérieure

À partir de Java 9, le mécanisme d'extension de Java est supprimé, ce qui signifie que l'argument -Djava.ext.dirs ne peut pas être utilisé sur les applications Java 9 et supérieures. Les étapes suivantes doivent donc être suivies :

1. Créez un dossier sur la machine sur laquelle vous souhaitez installer l'extension UiPath pour Java (par exemple, C:\UiPathJavaExt) et copiez les fichiers suivants :
   1. UiPathBridge.jar et UiPathJavaServiceProvider.jar - situés dans le répertoire %UserProfile%\.nuget\packages\uipath\20.xx.xxxx\build\UiPath\JavaSupport.
   2. UiPathJavaBridgeV8.dll et UiPathJavaBridgeV8_x64.dll situés dans le répertoire %UserProfile%\.nuget\packages\uipath\20.xx.xxxx\build\UiPath. Il n'est pas nécessaire de copier les deux fichiers, mais cela peut prévenir les problèmes qui peuvent survenir en raison d'une mauvaise concordance de versions entre le JRE et le pont Java UiPath.
2. Ajouter le dossier créé précédemment au chemin de classe de l'application Java cible. Cette opération se réalise à l'aide de la commande -cp, -classpath. Pour les besoins de notre exemple, nous considérons SwingSet2 comme l'application Java cible :

   C:\Program Files (x86)\Java\jre1.9.0_xx \bin\java.exe -cp SwingSet2.jar;C:\UiPathJavaExt\* -Djavax.accessibility.assistive_technologies=UiPathJavaServiceProvider SwingSet2

Prise en charge de la mise à l'échelle des applications

La mise à l'échelle est entièrement prise en charge pour les applications Java 9+ via des paramètres. Pensez à ajouter les paramètres suivants à l'application Java que vous souhaitez automatiser afin d'activer la prise en charge de la mise à l'échelle :

• sun.java2d.uiScale.enabled : lorsqu'il n'est pas utilisé ou défini sur la valeur de chaîne exacte « true », il est considéré comme vrai et la configuration de mise à l'échelle suivante est prise en compte. Lorsqu'il est défini sur n'importe quelle autre valeur que « true » (par exemple, True, false, False, abc), il est alors considéré comme faux et aucun ajustement de mise à l'échelle supplémentaire n'est effectué.
• sun.java2d.uiScale : les valeurs peuvent être transmises sous trois formes :
  • En tant que ratio (0,5, 2,3, 1,5)
  • En pourcentages (100 %, 150 %)
  • Valeurs dpi (96 dpi, 120 dpi). Il est pris en compte si la mise à l’échelle est activée. Il modifie la mise à l’échelle sur les deux axes.
• sun.java2d.win.uiScaleX, sun.java2d.win.uiScaleY valeurs peuvent être transmises comme pour le paramètre sun.java2d.uiScale. Les deux sont nécessaires pour être pris en compte par l'application Java. Ils sont plus spécifiques que la configuration générale de la mise à l'échelle. À ce titre, si les 3 paramètres sont définis, seuls ceux-ci sont pris en compte.