OpenIAPカテゴリー: 3.3. Configuring OpenRPA

OpenRPA の設定はsettings.jsonという名前のファイルにローカルに保存され、ユーザーのDocumentsOpenRPAフォルダー（またはフルパスC:\Users@YOUR_USER}Documents@OpenRPA） に常に配置されます¹。このファイルには、GUIからアクセスできないものも含め、OpenRPAのすべての設定パラメータが含まれています。

しかし、OpenRPAのGUIレイアウト設定は、layout.configという別のファイルに保存されています。layout.configを削除しても、ユーザーのレイアウト設定（パネルのサイズ、順序、位置など）が失われるだけなので、特に問題はありません。

OpenRPAの実行中に、いずれかのファイル（settings.json/layout.config）を編集しても効果はなく、アプリケーションを終了すると、変更した値は失われ、上書きされます。そのため、設定を変更する場合は、必ずOpenRPAが起動していない状態で行ってください。

さらにこのセクションでは、OpenRPAのコンフィギュレーション設定を支配するすべてのパラメーターに関するドキュメントをご覧いただけます。

OpenRPA のローカル一時ファイル（ワークフロー、設定）を保存するディレクトリを指定することはできま せん。

これらのパラメータは、settings.jsonから設定するか、Windowsレジストリエディタ内にキーを追加することで設定できます。

OpenRPAのローカルユーザーインスタンスのパラメータを設定したい場合は、ComputerHKEY_USERSのレジストリキーに移動し、変更したいパラメータごとにエントリを追加します。ここで、キーの名前はパラメータの名前に対応し、その値は値に対応します。

Windowsレジストリエディタを使用して、ocr_languageパラメータをローカルにrusに設定する手順を以下に示します。

まず、ComputerHKEY_USERSのレジストリキーComputerHKEY_USERSのレジストリキーに移動します。

Windowsレジストリエディタのウィンドウで、空の領域内をマウスの右ボタンでクリックします。

次に、「新規作成」→「文字列 値」をクリックし、「ocrlanguage」と入力してENTERキーを押します。

最後に、新しく設定したレジスタのエントリと目的のレジスタの値（ここではロシア語に対応するrus）をダブルクリックします。

ここでOpenRPAを再起動し、変更が正しく行われたことを確認します。

[DEPRECATED] これは “layout.config“ファイルに置き換わったので、もう必要ない。

Toolbox、Design、Propertiesのサイズや位置など、OpenRPAのデフォルトのUI要素を設定するパラメータです。

デフォルト値は空文字列「"」で、これらの要素が調整されず、元の場所にあることを意味します。

このパラメータは、継承されたクラス設定のセットです。これは、OpenRPAの実行時にロードされるアドオン設定のリストで、動的に作成されます。新しいプラグインの場合、その設定はこのリストのグローバル設定に追加することができます。各パラメータの最初の単語は、設定されるプラグインの名前であることに注意してください。

このパラメータは、ユーザーが独自のプラグインを設定することができるため、重要なパラメータです。

これらの設定は、OpenRPAGUIのRecorder pluginsの Settingsタブからアクセスすることも可能です。

IE_enable_xpath_support–IE での実験的な XPath サポートを有効にする。デフォルトはtrue です。

NM_unique_xpath_ids– XPath セレクタを作成するための一意な ID のリストです。

NM_debug_console_output– ブラウザのコンソールにデバッグ情報を書き込む。デフォルトはfalseです。

NM_wait_for_tab_after_set_value– 値を設定した後、タブの状態がレディになるまで待ちます。デフォルトはfalse です。

NM_wait_for_tab_click– ボタンをクリックした後、タブの状態がレディになるのを待つ。デフォルトはfalseです。

NM_compensate_for_old_addon– 古いアドオンのピクセル補正を追加します。デフォルトはfalseです。

Script_csharp_intellisense– C#スクリプトのIntellisenseを有効にします。デフォルトはtrueです。

Script_vb_intellisense– Visual BasicスクリプトのIntellisenseを有効にする。デフォルトはtrueです。

Script_use_embedded_python–OpenRPAにはPythonが組み込まれていますが、無効にするとデフォルトのシステムPythonが使用されます。デフォルト値はtrueです。

Script_py_create_no_window– Pythonスクリプトを新しいウィンドウで起動するかどうかを指定します。デフォルトはtrueです。

Windows_allow_child_searching– セレクタ内の要素が見つからない場合、自動的にすべての子要素を検索して一致させる。デフォルトはfalse です。

Windows_allow_multiple_hits_mid_selector– セレクタ内の要素セレクタが複数の子を見つけることを可能にします。デフォルトはfalse です。

Windows_enum_selector_properties– 各セレクタ要素について、必要最小限のプロパティをテストします。デフォルトはtrue です。

Windows_get_elements_in_different_thread– セレクタがロボットを見つけた場合にロックを避けるために、GetElementは検索中に別のスレッドを使用します。デフォルトはtrue。

Windows_traverse_selector_both_ways– UI ツリーを両方向に走査し、ゴースト セレクタ要素を除外します。デフォルトはtrue です。

Windows_cache_timeout": "00:05:00– 要素のキャッシュのためのタイムアウト。デフォルト値はtrueです。

Windows_enable_cache– RAMを犠牲にして、より高速な自動化のためにElementsのキャッシュを有効にするものです。デフォルト値はtrueです。

Windows_search_descendants– すべての子孫を検索します。これはロボットの速度を遅くするので、より単純なセレクタにこのオプションを使用することをお勧めします。デフォルトはfalse です。

Recording Overlayチェックボックス（OpenRPAリボン内の設定タブでも設定可能）は、録画中にマウスオーバーしたエレメントをハイライト表示するために使用されます。このパラメータをtrueに設定すると、CPUのパフォーマンスに影響を与える可能性があるため、falseに設定し、デバッグやプレゼンテーションの時のみ変更することをお勧めします。

デフォルトはtrueである。

OpenRPAのアクティビティがOpenFlowのAPIを使用してMondoDBと通信している場合に、MongoDBクエリあたりの最大結果数を設定するパラメーターです。

各クエリにはそれ自体のコストがあり、さらにデータ転送 (querypagesize) にもコストがかかります。querypagesizeの値が大きいと、MongoDBのクエリーの回数は少なくなりますが、それぞれのクエリーの負荷は高くなります。

このパラメータに完全な値はありませんが、違いを知ることで、OpenRPA ワークフローのニーズに応じて特定のシナリオを最適化することができます。

初期値は 50 です。

これらのパラメータは、ロボットの起動時に行われるアップデートチェックに関連しています。新しいアップデートが見つかった場合、ユーザーにメッセージが表示され、アップデートをインストールするかどうか判断してもらうことができます。

lastupdatecheckは、ロボットが最後に更新を確認したときのログです。

updatecheckintervalは、更新チェックの間隔を設定します。デフォルト値は “1.00:00:00″（すなわち1日）です。

doupdatecheckは、ロボットが更新を探すべきかどうかを示すブーリアン値である。デフォルトはtrue。

このパラメータは、アップデータ自身が自動更新を行うかどうかを設定します。true の場合、ユーザーへのメッセージは表示されずにアップデートが実行されます。

デフォルトはtrueである。

以下のパラメータは、ワークフローのすべての出力、およびエラーまたは例外メッセージを保存するために作成されたログファイルについてです。このファイルには、Output バーのLoggingセクションよりも多くの情報が含まれます。このセクションに多くの情報を表示すると、ロボットの動作が遅くなるためです。これらのパラメータのいくつかは、GUI の上部リボン、Settingsタブで設定することができま す。

レベル」は、ユーザーが取得したい情報の種類を意味します。低い数値はより重要な情報を意味し、高い数値はより重要でない情報を意味します。言い換えると、ユーザーが最小値と最大値を例えば1と2に設定した場合、最も重要な情報のみがログに記録されます。一方、ユーザーが1と7に設定した場合、より重要度の低い情報がログファイルに追加されます。

最低レベルから最高レベルまでの範囲が広ければ広いほど、より多くの情報を取得することができます。この操作では、より多くの処理が必要となるため、ロボットの動作が遅くなることに注意してください。

log_to_file– ユーザーがログを有効にした場合、ロボットは.txtログファイルを作成し、ロボットのルートフォルダに保存します。デフォルトはfalseです。

log_file_level_minimum– デフォルト値は “2 “です。

log_file_level_maximum– デフォルト値は “5 “です。

log_verbose– このパラメータは、冗長モード、つまり人間が読みやすくするためにログファイルに多くの単語を追加することを有効にします。デフォルトはfalseです。

log_activity–trueに設定すると、OpenRPAの実行中にユーザーが行ったアクティビティ（Designerへの変更など）のログが追加されるパラメータです。デフォルトはfalseです。

log_debug– ログ・ファイルにデバッグに関する情報を追加します。デフォルトはfalseです。

log_selector–セレクタの動作に関するログを追加します。デフォルトはfalse です。

log_selector_verbose– このパラメータは、セレクタのログを冗長モードにすることができます。デフォルトはfalse です。

log_information– このパラメータは、ロボットの操作にとって基本的ではないが、人間が意識したり記録を取ったりするのに重要な情報をログに記録することを可能にする。デフォルト値はtrueである。

log_output–Outputタブに表示されたメッセージと、WritelineActivityからのメッセージを追加します。デフォルトはtrueです。

log_warning– ログファイルに警告メッセージを追加します。つまり、プラットフォームまたはロボットに影響を与えたが、実行を妨げなかった問題です。デフォルト値はtrueです。

log_error– ログファイルにエラーメッセージを追加します。つまり、ロボットによって処理できなかった問題や、ロボットの実行を妨げた問題です。デフォルト値はtrueです。

録音中にTrueに設定すると、このパラメータは、ユーザーが一度に1つのキーをタイプすることを模倣します。falseに設定すると、レコーダーは、選択したアプリケーションのコントロールを直接変更し、テキスト全体を一度に適用しようとします。アプリケーションやコントロールの反応はそれぞれ異なるため、このパラメータは有用です。

このパラメータは、OpenRPAのリボンから設定タブでアクセスすることも可能です。

デフォルトはfalseである。

上記と同じ処理を行いますが、ComputerComputerのレジストリキーであるComputerHKEY_LOCAL_MACHINE↪SOFTWARE↩OpenRPAを使用して、マシンの範囲内でグローバルにパラメータを強制します。これは、ユーザーがこれらのパラメータを上書きできないことを意味します。

OpenRPAは、実際にマウスでクリックするのではなく、Virtual Clickを行おうとします。詳しくは、Virtual Clickをご覧ください。

デフォルトはtrueである。

録画したシークエンスを再生すると、カーソルが位置を変えながら表示されます。記録した動作がイメージしやすくなる。また、RPAのプレゼン資料の作成にも活用できます。

このパラメータは、OpenRPAのリボンから設定タブでアクセスすることも可能です。

デフォルトはtrueである。

このパラメータは、post_waitプロパティを持つすべてのActivityのデフォルト値を設定します。

つまり、ロボットはこれらのActivityの後にそれぞれこの時間だけ待って、コンピュータが反応することを確認してから次のActivityに移るということです。

各アクティビティにオーバーヘッドが発生するため、ワークフロー実行時にロボットのパフォーマンスを低下させる。このパラメータは必要ないが、極めて特殊なケースでは既に実装されているので、便利に使えるかもしれない。

初期値は “00:00:00 “である。

このパラメータは、ロボットの実行時にOpenRPAUIを最小化するか否かを定義します。

パフォーマンスを最適化するために、このパラメータはtrueに設定する必要があります。実行中、ロボットはデスクトップにアクセスし、開いているすべてのウィンドウをチェックして、必要なウィンドウを探します。そのため、自分自身のウィンドウをチェックする必要はありません。

デバッグ時にウィンドウを最大化しておくと、実行中に何が起こっているのかがわかりやすくなります。

デフォルトはtrueである。

デザイナーに 直接記録チェックボックス（設定タブのOpenRPAリボン内で設定）は、ユーザーが記録中にデザイナーに挿入されるアクティビティを確認したい場合に使用します。

このパラメータを有効にすると、開発時やデバッグ時に便利ですが、入力の遅延が発生する可能性がありますのでご注意ください。無効の場合、レコーダーはアクティビティを記憶し、録音終了後に挿入します。

デフォルトはtrueである。

OpenRPAが OpenFlowに接続して動作しているときに、ロボットがローカルファイルを再読み込みするために使用する時間間隔。

ロボットはOpenFlow に ワークフローと Detectorのリストを問い合わせ、それらの最終更新時刻をローカルコピーの時刻と比較します。もし変更があれば、ファイルを再読み込みします。

WorflowまたはDetectorがすでにDesignerで開かれている場合、OpenRPAはユーザーに警告を発し、新しいバージョンを読み込むかどうかを尋ねます。新しいファイルが見つかったり、ファイルが削除されたりした場合、OpenRPAは自動的にローカルディレクトリにファイルを作成または削除する処理を行います。

また、OpenRPAUIのリボン上部のGeneralタブで、いつでもRealodingできるようになっています。

デフォルトは “00:05:00 “です。00:00:00 “に設定した場合、再読み込みされることはない。

録画したSequenceを再生する際、ウィンドウの動きをアニメーションで表示するかどうかを選択することができます。アクティビティのプロパティメニューで設定できます。

move_animation_run_time– このパラメータは、アニメーションの各ステップ間の時間量を設定します。デフォルト値は “00:00:00.5000000 “です。

move_animation_steps– このパラメータは、アニメーションが何ステップで行われるかを設定します。1に設定された場合、ウィンドウは新しい位置に直接移動するため、動きは見えません。ステップ数が多ければ多いほど、動きはより滑らかになります。デフォルト値は “20 “です。

ロボットがアプリケーションのGUI、キーボード、マウスに依存するワークフローを実行していて、ワークフローの並列実行が矛盾するアクションになる場合、これらのパラメータはOpenFlow/ Node-REDが一度に所定の数のワークフローしか起動しないよう制限を設定します。

remote_allow_multiple_running– このパラメータは、ロボットが同時に追加のワークフローを実行する許可を設定します。デフォルト値はfalse です。

remote_allow_multiple_running_max– 同時に実行可能なワークフローの最大数を設定します。デフォルト値は “2 “です。