通知を受け取る

UiPath Studio

UiPath Studio ガイド

Java 向け拡張機能

📘

注:

Java 9+ の場合、UiPath Java 拡張機能は、Java JDK でアプリケーションを開いた Windows Enterprise および非 Enterprise エディションで動作します。Java JRE で開かれたアプリケーションの場合、UiPath Java 拡張機能は非エンタープライズ Windows エディションでのみ機能します。詳細については、「Java 拡張機能のトラブルシューティングガイド」を参照してください。

Studio およびコマンド ラインから

次の手順で UiPath Java 拡張機能をインストールします。

  1. まず、実行中の Java アプリケーションをすべて閉じます。Studio を起動して、Studio の Backstage ビューから [ツール] タブにアクセスします。インストールする拡張機能が表示されます。[Java 拡張機能] ボタンをクリックします。拡張機能がインストールされたことを知らせる確認メッセージが表示されます。
  2. 管理者権限にて、コマンド プロンプト ウィンドウで C:\Program Files (x86)\UiPath\Studio\UiPath\SetupExtensions.exe /Java コマンドを実行します。

Studio と UI Explorer は、Java アプリ内でコントロールを選択しようとしたときにブリッジが検出されないと UiPath Java 拡張機能をインストールするように要求します。UI Explorer によってプロンプトが表示されたときに UiPath 拡張機能をインストールすることを選択すると、Java Bridge ファイルは JDK ディレクトリではなくターゲット Java アプリケーションを起動した JRE ディレクトリにのみデプロイされます。

📘

注:

この拡張機能をインストールするには、管理者権限が必要です。

拡張機能が正しく動作していないかどうかを確認するには、UI Explorer を開き、Java アプリケーション内のコントロールを選択してください。ウィンドウ全体が選択されている場合は、拡張機能が正しく機能していないことを意味しています。

Java コントロール向けに生成されたセレクターによって、拡張機能が適切にインストールされているかどうかを確認できます。

<wnd app=”...” /><java role=”...” />
<wnd app=”...” /><ctrl role=”client” />

📘

注:

UiPath Java 拡張機能は、AWT アプリ (Java Swing、Oracle Forms、Fujitsu JBK など) にのみ対応しており、SWT アプリは、Active Accessibility で自動化されます。Java アプリケーションの種類を検出するには、UI Explorer の cls 属性 (ウィンドウ クラス名) を確認します。クラス名は、SunAwtFrame または javax.swing のようになっているはずです。

プロセスは、その DPI スケーリングに関係なく、Java アプリケーションを操作できます。

UiPath Java 拡張機能のインストールは、ScreenScrapeJavaSupport ツールを使用して行うこともできます。

カスタム フォルダーに拡張機能をインストールする

Java 8 以前

UiPath Java 拡張機能のインストール場所をカスタマイズするには、以下の手順を実行する必要があります。

  1. UiPath Java 拡張機能をインストールするコンピューター上に新しいフォルダーを作成し (例: C:\UiPathJavaExt)、そこに以下のファイルをコピーします。
    1.1. UiPathBridge.jar - %UserProfile%\.nuget\packages\uipath\20.xx.xxxx\build\UiPath\JavaSupport ディレクトリにあります。
    1.2. UiPathJavaBridgeV8.dllUiPathJavaBridgeV8_x64.dll - %UserProfile%\.nuget\packages\uipath\20.xx.xxxx\build\UiPath ディレクトリにあります。両方のファイルをコピーする必要はありませんが、両方コピーすることで、JRE と UiPathJavaBridge 間のバージョンの不適合によって発生する恐れのある問題を予防できます。
  2. UiPath が拡張機能をインストールするときに使用する Java 拡張機能セットアップ メカニズムでは、Java のインストール ディレクトリ (通常は C:\Program Files (x86)\Java\jre1.8.0_xx) に、UiPathBridge.jaraccessibility.properties ファイルをデプロイします。カスタム フォルダーから UiPath Java 拡張機能を使用するには、次の手順に従い、これらのファイルの依存関係を緩める必要があります。
    2.1. UiPathBridge.jar ファイルについては、拡張機能を使用する Java アプリケーションを開始する際に、UiPathBridge.jar および UiPathJavaBridgev8.dll ファイルをコピーしたフォルダー (C:\UiPathJavaExt など) を指定する必要があります。引数 -Djava.ext.dirs = C:\UiPathJavaExt を使用して指定します。
    2.2. accessibility.properties ファイルについては、次の 2 つの方法があります。
    • %userprofile% ディレクトリにある、グローバル設定ファイル accessibility.propertiesassistive_technologies=UiPath.UiPathBridge パラメーターを追加します。このファイルは、UiPath Java 拡張機能によってデプロイされるものとは異なり、その設定は Java のインストールによる設定よりも優先されることに注意してください。
    • 対象の Java アプリケーションを実行するときに、引数 -Djavax.accessibility.assistive_technologies=UiPath.UiPathBridge を使用します。

システム プロパティを適切に対象の Java アプリケーションに渡す必要があります。それには、いくつかの方法があります。

  • _JAVA_OPTIONS 環境変数に、-Djava.ext.dirs=C:\UiPathJavaExt -Djavax.accessibility.assistive_technologies=UiPath.UiPathBridge システム プロパティを含めます。JRE が環境変数のプロパティ、および対象のアプリケーションに読み込まれた UiPath Java 拡張機能のプロパティを読み込みます。
  • コマンド プロンプトで 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 コマンドを使用します。UiPath Java 拡張機能が正常に読み込まれたことを確認するメッセージが表示されます。
  • JAVA_TOOL_OPTIONS 環境変数に、-Djava.ext.dirs=C:\UiPathJavaExt -Djavax.accessibility.assistive_technologies=UiPath.UiPathBridge システム プロパティを含めます。この方法は、Java 5 以降にしか使用できないことに注意してください。

プロパティを Java アプレットに渡すには、次のいずれかの方法を使用します。

  1. appletviewer.exe アプリケーションを使用する

この方法では、はじめに %userprofile% フォルダー内に .java.policy ファイルを作成し、そこに以下の記述を含める必要があります。

grant { 

    permission java.net.URLPermission "url_of_the_Java_applet", "*:*"; 

};

それが完了したら、対象のアプレットを次のコマンドとともに appletviewer.exe から起動する必要があります。

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

  1. JRE で提供される Java コントロール パネルを使用します。

Java コントロール パネルでは、登録した JRE ごとにランタイム パラメーターを指定できます。そのため、対象のアプレットに
-Djava.ext.dirs=C:\UiPathJavaExt -Djavax.accessibility.assistive_technologies=UiPath.UiPathBridge
パラメーターを指定する必要があります。これにより、Java アプレットが起動するたびに UiPath Java 拡張機能が読み込まれます。

下表は、上記で使用した方法と、Java のバージョンや各種 Java アプリケーションの間の互換性を示したものです。

Application Type

_JAVA_OPTIONS

JAVA_TOOL_OPTIONS

Command Line Parameters

Java Control Panel - Runtime Parameters

Java Desktop Application

Java 3 to Java 8

Java 5 to Java 8

Java 3 to Java 8

Not Supported

Java Contained Application (.exe)

Java 3 to Java 8

Java 5 to Java 8

Java 3 to Java 8 (1)

Not Supported

Java Applet

Java 3 to Java 8

Java 5 to Java 8

Not Supported

Java 3 to Java 8

Java Oracle Forms

Not Supported

Not Supported

Not Supported

Not Supported

(1) - 使用するコマンド ライン ツールによっては、環境変数を介して他にもパラメーターを渡す必要が生じる場合があります。

Java 9 以降

Java 9 以降、Java 拡張機能のメカニズムは廃止されました。これは、Java 9 以降のアプリケーションでは、-Djava.ext.dirs 引数を使用できないことを意味します。このため、以下の手順を実行する必要があります。

  1. UiPath Java 拡張機能をインストールするコンピューター上に新しいフォルダーを作成し (例: C:\UiPathJavaExt)、そこに以下のファイルをコピーします。
    1.1.UiPathBridge.jarUiPathJavaServiceProvider.jar - %UserProfile%\.nuget\packages\uipath\20.xx.xxxx\build\UiPath\JavaSupport ディレクトリにあります。
    1.2. UiPathJavaBridgeV8.dllUiPathJavaBridgeV8_x64.dll - %UserProfile%\.nuget\packages\uipath\20.xx.xxxx\build\UiPath ディレクトリにあります。両方のファイルをコピーする必要はありませんが、両方コピーすることで、JRE と UiPath Java Bridge 間のバージョンの不適合によって発生する恐れのある問題を予防できます。
  2. 先ほど作成したフォルダーをターゲット Java アプリケーションのクラス パスに追加します。-cp, -classpath コマンドを使用して追加できます。今回の例では、SwingSet2 を対象の Java アプリケーションとします。
    C:\Program Files (x86)\Java\jre1.9.0_xx \bin\java.exe -cp SwingSet2.jar; C:\UiPathJavaExt -Djavax.accessibility.assistive_technologies=UiPathJavaServiceProvider SwingSet2

アプリケーション スケーリングのサポート

パラメーターにより、Java 9 以降のアプリケーションでスケーリングが完全にサポートされます。スケーリングのサポートを有効にするために、自動化する Java アプリケーションに以下のパラメーターを追加することを検討してください。

  • sun.java2d.uiScale.enabled - 未使用の場合または「true」の正確な文字列値に設定されている場合は true と見なされ、以下のスケーリング設定が考慮されます。「true」以外の値 (TruefalseFalseabc など) に設定すると、false と見なされ、追加のスケーリング調整は行われません。
  • sun.java2d.uiScale - 値は以下の 3 つの形式で渡されます。
    • 率 (0.5、2.3、1.5)
    • パーセンテージ (100%、150%)
    • DPI 値 (96dpi、120dpi)。スケーリングが有効な場合に考慮されます。両方の軸でスケーリングを変更します。
  • sun.java2d.win.uiScaleX, sun.java2d.win.uiScaleY - sun.java2d.uiScale パラメーターの場合に値を渡すことができます。どちらも Java アプリケーションで考慮されなければならない、不可欠な値です。これらはスケーリングの一般的な設定よりも具体的な値であり、3 つのパラメーターがすべて設定されている場合は、これらの値だけが考慮されます。

4 か月前に更新


Java 向け拡張機能


改善の提案は、API リファレンスのページでは制限されています

改善を提案できるのは Markdown の本文コンテンツのみであり、API 仕様に行うことはできません。