Desktop Automation サービスの設定
この章では、Desktop Automation サービスの設定について説明します。
Desktop Automation の前提条件
Desktop Automation の要件および前提条件については、すべて『Kofax RPA Installation Guide』(Kofax RPA インストールガイド) の「Dependencies and Prerequisites」(依存関係と要件) の章に記載されています。
Desktop Automation エージェントの設定
コンピュータが Desktop Automation に必要な要件をすべて満たすと、Desktop Automation エージェントをインストールおよび構成することができます。
- Java アプリケーションを自動化する必要がある場合、Java 32 ビット (JRE または JDK) をリモート デバイスにインストールし、Java Access Bridge がデバイスで有効になっていることを確認します。詳細については、Java Access Bridge の確認を参照してください。
- Kofax RPA Desktop Automation インストーラをデバイスにダウンロードし、実行します。
- Desktop Automation サービスをスタート メニューから開始します。サービスが開始すると、そのステータスを通知領域のアイコンで確認できます。
アイコン
ステータス
Desktop Automation サービスが開始し、設定されている Management Console に接続しようとしています。
Desktop Automation サービスが実行中で、設定に応じて Management Console に接続されているか、またはシングル ユーザー モードで実行中です。
Desktop Automation サービスが実行中で、RoboServer または Design Studio によって使用中です。
Desktop Automation サービスは実行していません。
Desktop Automation サービスはエラーのため実行していません。
- Desktop Automation サービス オプションを編集するには、通知領域の Desktop Automation サービス アイコンを右クリックし、[設定] を選択します。これにより、Desktop Automation サービス ウィンドウが開きます。オプションを変更したら、[保存して再起動] をクリックします。
オプションを手動で編集するには、オートメーション デバイスの server.conf ファイルを開きます。ファイルは [ユーザー] > [ユーザー名] > [AppData] > [ローカル] > [Kofax RPA 10.7.0] フォルダにあります。ユーザー名はサービスが実行されているユーザーの名前です。
以下の Desktop Automation サービス オプションの表を参照してください。 -
タブでデバイスが Management Console に登録されていることを確認します。
以下は、Desktop Automation サービス構成ウィンドウです。
![デバイス オートメーション サービス設定ダイアログ ボックス](../../All_Images/dasoptionsdialog.png)
次の表に、利用可能な Desktop Automation サービス オプションを一覧表示します。
設定ウィンドウ オプション |
server.conf オプション |
値と説明 |
---|---|---|
[シングル ユーザー] クリア (デフォルト) Design Studio からオートメーション デスクトップへの直接接続、または RDP 接続 の使用時に選択します。 |
"singleUser" |
false (デフォルト) true false に設定すると、Desktop Automation サービスが指定された Management Console に自動的に登録されます。 オートメーション デスクトップへの直接接続の場合、true に設定し、トークンを指定します。* |
[ホスト名] |
"hostName" |
Desktop Automation サービスを実行しているコンピュータの名前または IP アドレス。 コンピュータに複数の名前または IP アドレスがある場合、RoboServer と Design Studio がこの Desktop Automation エージェントと通信するものを指定します。つまり、ホスト名または IP アドレスは RoboServer と Design Studio から接続可能である必要があります。 |
[コマンド ポート] |
"commandPort" |
49998 (デフォルト) 必要に応じて、このポートをオートメーション デスクトップに再割り当てします。 |
[ストリーム ポート] |
"streamPort" |
49999 (デフォルト) このポートは、Design Studio と Desktop Automation サービス間のデータ送信に使用されます。streamPort が "0" に設定されると、Desktop Automation サービスではランダムにポート番号が選択されます。 Design Studio とオートメーション デスクトップの間にファイアウォールがある場合、streamPort を再割り当てする必要があることがあります。 |
[CA ファイル] |
"caFile" |
空 (デフォルト) SSL を使用して Management Console と通信できます。node.js のデフォルトの証明書が使用されない場合、このパラメータを使用して別の証明書へのパスを指定できます。これを動作させるにはルート証明書が必要であります。Google Chrome ブラウザからルート証明書をファイルに保存するには、次のようにします。
これで、エクスポートされた証明書を含むファイルへのパスを指定できるようになります。 |
[タイムアウト] |
"commandTimeout" |
このオプションでは、コマンド実行のタイムアウトを秒単位で指定します。コマンドはオートメーション デスクトップに送信される命令です。マウス ボタンのクリック、アプリケーションを開く、location found ガードの場合追加などです。コマンドが指定した時間内に完了できない場合、サービスによって通知が送信され、ロボットの実行が停止します。 Location Found (ロケーションが見つかった場合)ガードの場合、この設定はワークフローでのガードの呼び出しに適用されますが、ガードが満たされるまでの待機はこのタイムアウトとは無関係のため、無制限に待機し続ける可能性があります。マウス移動 ステップと抽出ステップの使用時に、同様の状況が発生します。コマンドはフィールドで指定されたタイムアウト以内にデバイスで呼び出される必要がありますが、ロボットはコマンドの完了を最大 240 秒間待機します。 Desktop Automation ワークフローでの端末の自動化、または Web サイトのブラウズに対するコマンド タイムアウトは、Design Studio でのワークフロー実行の場合は [Design Studio 設定] ウィンドウの [Desktop Automation] タブ、RoboServer 実行の場合は [RoboServer 設定] ウィンドウの [セキュリティ] タブの Desktop Automation セクションで設定します。 |
[シングル ユーザー] タブの [トークン] |
"token" |
空 (デフォルト) "singleUser" オプションが false に設定されている場合、このオプションは空のままにします。オートメーション デスクトップ ("singleUser": true) への直接接続を使用する場合、トークンを指定します。定義されたどのトークンでもかまいません。 |
[証明書] タブ |
"tlsServerConfig" |
Kofax RPA では、オートメーション デスクトップと RoboServer、または Design Studio との間の TLS 通信を提供しています。通信には、通信を暗号化するための証明書が使用されます。以下は、server.conf ファイル コードの抽出です。詳細については、TLS コミュニケーションを使用を参照してください。
|
[Windows] タブ |
"automationnative" |
|
[OCR] タブ |
"ocrConfig" |
"defaultLanguage": "eng" OCR 操作を実行する言語を指定します。デフォルトで、Kofax RPA では英語がインストールされます。言語のインストール手順については、デフォルトの OCR 言語の変更を参照してください。 |
[システム] タブ |
このタブでは、ログ ファイルを開いてエラーを調べることができ、サービス ファイルのバージョンと場所が表示されます。このタブを使用して、サービスが実行されているコンピュータに Java Access Bridge が適切にインストールされているかどうかを確認できます。 |
|
Management Console オプション | ||
[MC パス] 接続プロトコル、名前または IP アドレス、ポート番号、およびデバイス パスを登録する必要がある Management Console 。形式は次のとおりです。 http://10.10.0.136:50080. |
"hostName" |
デバイスを登録する必要がある Management Console の名前または IP アドレス。 |
"port" |
指定した Management Console の接続ポート。 |
|
"schema" |
指定した Management Console の接続プロトコル。 |
|
"path" |
空 (デフォルト) ポート番号の後のスタンドアロン Management Console へのパスの部分。たとえば、Management Console が Tomcat ( http://computer.domain.com:8080/ManagementConsole/) で展開されている場合、このパラメータで "/ManagementConsole/" を指定します。埋め込み Management Console インストールの場合、このパラメータを空のままにします。 |
|
[ユーザー名] |
"user" |
空 (デフォルト) 指定された Management Console で認証するためのユーザー名。 |
[パスワード] |
"password" |
空 (デフォルト) 指定された Management Console で認証するためのパスワード。 |
[クラスタ] |
"cluster" |
プロダクション (デフォルト) 指定した Management Console のクラスタ名。 |
[ラベル] |
"labels" |
"label1,label2" (デフォルト) オートメーション デバイスを区別するためのラベル。 |
[ping 間隔 (ms)] |
"pingInterval" |
5000 (デフォルト) Desktop Automation サービスが Management Console に ping 送信する時間間隔。 |
[プロキシを使用して Management Console に接続] |
"useProxy" |
このオプションを Desktop Automation サービスに選択し、Management Console への接続時にプロキシを使用します。必要なパラメータはすべて次のフィールドで指定されます。 ![]() Linux の場合、server.conf ファイルの managementConsole セクションでプロキシ パラメータを設定できます。
|
* オートメーション デスクトップへの直接接続は、Design Studio でのロボットの作成とデバッグ、および RDP 接続との使用にお勧めします。
Desktop Automation サービスのロギング
Kofax RPA はサービス パフォーマンスを向上するために、特定の Desktop Automation サービス イベントの使用情報を収集します。
-
Desktop Automation サービスが Management Console に接続している場合、イベントはRoboServer Log Databaseに保存されます 。Management Console の RoboServer ログデータベースに保存されます。イベントを表示するには、[ログ ビュー] タブで [DAS] を選択します。
注 Management Console の接続パラメータが Desktop Automation サービスの設定ウィンドウで指定されている場合、[シングル ユーザー] モードが選択されていても、イベントは常に Management Console にログ記録されます。つまり、自動化デスクトップへの接続は Management Console がなくても直接確立されます。 -
もし Desktop Automation サービスが Management Console に接続できない場合 (Management Console が設定されていないため)、次の場所にある Desktop Automation Service Usage.csv のログ ファイルにイベントが書き込まれます。{path}\AppData\Local\Kofax RPA\<バージョン番号>\Logs\
ファイルの場所は、log4net.xml ファイルで設定できます。
各イベントの情報には次が含まれています。
- イベントが発生した時間 (UTC)。
-
イベントの種類:開始、停止、接続、切断、中断、スクリーン ロック。
-
Desktop Automation サービスの識別。host:port フォームの ID、サービスを実行しているユーザー アカウント、サービスに定義されたラベルを含みます。
-
ロボットの名前と実行 ID (接続と切断の場合のみ)。
-
重要度の表示 (常に「情報」)。
-
メッセージ (常に空)。
Desktop Automation でのプロキシ サーバーの設定
すべての Desktop Automation サービス ロボットは Kofax RPA グローバル プロキシ設定を使用できます。Desktop Automation サービスは、Design Studio および Management Console と同じプロキシ設定を使用します。プロキシ サーバーの設定を構成するには、2 つの方法があります。
-
Desktop Automation サービスで実行しているすべてのロボットに対して、[Design Studio 設定] ダイアログ ボックスの [プロキシ サーバー] タブで、次のプロキシ サーバーの詳細を入力します。
-
ホスト
-
ポート番号
-
ユーザー名
-
パスワード
-
除外ホスト名
-
-
展開されたすべてのロボットに対して、[Management Console] > [クラスタ設定] > [プロキシ サーバー] タブで、[プロキシ サーバーを追加] を選択し、次のプロキシ サーバーの詳細を入力します。
-
ホスト名
-
ポート番号
-
ユーザー名
-
パスワード
-
除外ホスト名
-
Java Access Bridge の確認
Java Access Bridge は、Java アプリケーションを自動化する際に不可欠なコンポーネントです。Java のバージョンによっては、必要なファイルの一部がシステム フォルダ内にないことがあるため、Java Access Bridge は Desktop Automation サービスがインストールされているコンピュータで無効になっている場合があります。Java Access Bridge のインストール状態を確認するには、以下の手順を実行します。
- 通知領域で Desktop Automation アイコンを右クリックし、[設定] を選択します。
-
[システム] タブをクリックし、[Java Access Bridge ファイルの確認] をクリックします。
[Java Access Bridge] ダイアログ ボックスが開き、インストールされている Java のバージョンと、各バージョンの Java Access Bridge のインストール ステータスが表示されます。[JAB インストール] 列、[Java Access Bridge の Windows システム フォルダへのインストール]、[Java Access Bridge の有効化] に [はい] と表示されている場合、Java Access Bridge はコンピュータ上に適切にインストールされ、有効にされています。
-
[Java ホーム ディレクトリ] の下に Java の実装が表示されない場合、[フォルダの追加] をクリックし、Java ファイルがインストールされているホーム フォルダを指定します。
-
[JAB インストール] 列に [いいえ] が表示されるなど、見つからないファイルがある場合は、[見つからないファイルの表示] をクリックします。
[Java Access Bridge の見つからないファイル] ダイアログ ボックスに指定したフォルダにコピーする必要のあるファイルが表示されます。[見つからないファイルのインストール] をクリックして、Kofax RPA から提供されている最新バージョンの Java Access Bridge ファイルを Desktop Automation サービスのインストール フォルダにインストールします。
-
[Java Access Bridge の有効化] に [いいえ] と表示されている場合は、[Java Access Bridge の有効化] をクリックします。
デフォルトの OCR 言語の変更
Kofax RPA では、Tesseract OCR エンジンを使用して、テキストをイメージからキャプチャします。デフォルトで、Kofax RPA には OCR の言語として英語がインストールされます。ロボットが 画像からテキスト抽出 でテキスト認識を実行するとき、Kofax RPA では Desktop Automation サービス ウィンドウの [OCR] タブで選択した言語が使用されます。OCR のデフォルトの言語を変更するには、次のステップを実行します。
- 必要な言語の .traineddata ファイルを https://github.com/tesseract-ocr/tessdata からダウンロードします。たとえば、フランス語のファイルは fra.traineddata です。
- ダウンロード済みのトレーニングしたデータ ファイルを ProgramData フォルダの Kofax RPA\<version>\lib\tessdata にコピーします。例:
C:\ProgramData\Kofax RPA\10.7.0_110\lib\tessdata
- 通知領域で Desktop Automation アイコンを右クリックし、[設定] を選択します。
- [OCR] タブをクリックし、[デフォルトの OCR 言語] リストで言語を選択します。[保存して再起動] をクリックします。
TTF フォントまたは UI スクリーンショットのいずれかを使用して、Tesseract が文字セットを認識できるようにトレーニングすることができます。詳細については、Tesseract のトレーニングを参照してください。