実行のトラブルシューティング

大きすぎるメッセージによる失敗やプロセスの実行時間の問題など、ロボットの実行エラーの解決策です。

メッセージが大きすぎて処理できない

説明

大量のデータを処理するオートメーションが、次のエラーで失敗することがあります。「メッセージ: ジョブの実行結果を取得できませんでした。メッセージが大きすぎて処理できなかったことが原因である可能性があります。例外の型: System.Exception」

潜在的な問題

オートメーションによって生成されるデータが、uipath.config ファイルの maxMessageSizeInMegabytes パラメーターの値を超えています。

解決策

出力引数を使用するのではなく、Orchestrator のストレージ バケットまたは Data Service に出力を保存するようにオートメーションを設定します。

UI Automation アクティビティを使用した無人オートメーションが機能しない

説明

UI Automation アクティビティを使用した無人オートメーションが機能しない

潜在的な問題

サーバー マネージャーなどの、スタートアップ時に起動するよう設定されたプログラムで Windows ユーザー アカウント制御 (UAC) のプロンプトが表示される場合、ロボットはユーザー インターフェイスを操作できません。

解決策

ユーザー アカウント制御 (UAC) のプロンプトをトリガーするプログラムを特定し、そのプログラムを自動的に起動しないように設定します。

Robot が実行を開始できない

説明

ロボットがオートメーションの実行を開始できず、次のエラーが表示されます。「Executor start process failed, reason System.Runtime.InteropServices.COMException: A specified logon session does not exist. It may already have been terminated. (Executor の起動プロセスが失敗しました。理由: System.Runtime.InteropServices.COMException: 指定されたログオン セッションが存在しません。すでに終了している可能性があります。)」

潜在的な問題: ロボット端末に十分なリソースがありません

ロボット端末に十分なリソース (CPU、RAM、ディスクスペースなど) がないため、Robot Executor がオートメーションを開始できません。

解決策

• ロボット端末に十分なリソース (CPU、RAM、ディスク スペースなど) があることを確認します。
• mstsc コマンド ライン機能を使用して接続時間を確認します。60 秒以下の場合はエラーが表示されます。

潜在的な問題: ログオン セッションを作成できません

ログオン セッションを作成できません。これは、次の状況で発生する可能性があります。

• 高密度 (HD) ロボットの [コンソールへログイン] プロパティが true に設定されています。この場合、Robot サービスは現在のコンソール セッションにアタッチします。一度にアクティブにできるコンソール セッションは 1 つのみであるため、この設定は高密度ロボットには推奨されません。
• デスクトップ版の Windows (サーバーではない) で複数の RDP セッションを使用している。デスクトップ版の Windows では、マシンごとに一度に 1 つの RDP セッションしか処理できません。Windows Server のバージョンは、複数の RDP セッションを処理できます。

解決策

この場合、次のいずれかを実行する必要があります。

• [コンソールへログイン] が [false] に設定されています。これは、Robot サービスがロボット端末からそれ自体への RDP 接続を開始し、アタッチすることを意味します。これは、高密度ロボットに推奨される方法です。
• Windows のバージョンを確認してください。Windows Server である必要があります。
• Studio と Robot のバージョンが 2018.1.3 より新しいかどうかを確認します。
• サーバーのシステム環境変数である UIPATH_SESSION_TIMEOUT の値を増やします。既定値は 60 秒ですが、パフォーマンスが低い一部のマシンでは不十分な場合があります。この変数を変更した後、Robot サービスを再起動してください。
• サーバーでリモート デスクトップ ライセンスがアクティブになっているかどうかを確認します。
• Robot が適切なグループに属しているかどうかを確認します。ローカル ユーザーは同じリモート デスクトップ グループに属している必要があります。
• ロボット端末への RDP 接続のユーザー名が、構成済みのユーザー名と一致しているかを確認します。このエラーを回避するには、ロボット端末上のすべての RDP 接続をサインオフします。

パスワードが入力されていない

説明

オートメーションを Orchestrator または Assistant から開始すると、次のエラー メッセージが表示されます。「Executor start process failed, reason System.UnauthorizedAccessException: Access is denied. (Executor の起動プロセスが失敗しました。理由: System.UnauthorizedAccessException: アクセスが拒否されました。)」

潜在的な問題: ロボット アカウントがパスワードなしで作成されました

解決策

Orchestrator でロボット アカウントを編集し、次の値を指定します。

• ドメイン\ユーザー名* - Robot がインストールされている端末への接続に使用しているユーザー名です。ユーザーがドメインに属している場合は、DOMAIN\UserName の形式で指定する必要があります。
• パスワード - Windows のログイン パスワードです。

潜在的な問題: Robot サービスが非アクティブです

解決策

1. [サービス] ウィンドウを開きます。
2. UiPathRobotSvc サービスを選択します。
3. 選択したサービスの [プロパティ] パネルを開きます。
4. [ログオン] タブで [ローカル システム アカウント] を選択します。
5. [適用] と [OK] を選択して、変更を確定し、ウィンドウを閉じます。これにより、確実に Robot サービスが実行され、オートメーションの実行に必要な特権がすべて付与されます。

潜在的な問題: ロボット端末に管理者権限がありません

解決策

Orchestrator でロボットを作成した際に使用した資格情報のセットを使用して、ロボット端末にログインします。プロセスが Assistant から開始できない場合は、ネットワーク管理者に連絡して、そのユーザー アカウントの管理者権限を許可する必要があります。

System.Collections.IEnumerable をシリアル化できない

説明

[タスク完了まで待機して再開] アクティビティでデータ テーブルを使用すると、「Exception: Type 'System.Collections.IEnumerable' cannot be serialized. (例外: 種類 'System.Collections.IEnumerable' をシリアル化できません。)」というエラーが表示されます。

潜在的な問題

データ テーブルの DataRow オブジェクトをシリアル化できないため、オブジェクトを永続化できず、問題やエラーが発生している可能性があります。

解決策

[フォーム タスクを作成] アクティビティを実行し、データ行をループ処理して出力を生成し、タスク オブジェクトのリストを作成します。その後、[並列繰り返し (コレクションの各要素)] アクティビティまたは [繰り返し (コレクションの各要素)] アクティビティを使用してタスク オブジェクトの出力リストに対してループ処理を行います。これらのループで、各タスク オブジェクトに対して [タスク完了まで待機し再開] アクティビティを実行します。

予期しない終了コードでジョブが停止した

説明

ジョブの実行が失敗し、「ジョブが予期しない終了コードで停止しました: 0x40010004」というエラー メッセージが Orchestrator に記録されます。

潜在的な問題

通常、このエラーは次の場合に発生します。

• プロセスの実行中に、ロボットが使用するユーザー アカウントが強制的にログオフされた
• プロセスの実行中に、ロボットが実行されているマシンが手動でシャットダウンまたは再起動された

解決策

このエラーを回避するには、目的のオートメーションの種類 (有人または無人) に合った Robot が正しくインストールされていることを確認します。ユーザー モードでインストールした Robot は無人オートメーションを実行できません。

さらに、使用する環境とビジネス ニーズに合わせてロボット セッションを設定します。

オートメーションが有人モードでは動作するが無人モードでは動作しない

説明

同じオートメーションが、有人モードで人間のユーザーがログインして監視している場合は期待どおりに動作しますが、無人モードでは失敗します。無人モードの潜在的な問題としては、ほかにも次のようなものがあります。

• ロボットが間違った場所をクリックする
• ランダムなウィンドウが予期せず開く
• ユーザーの入力なしにタスクバーの項目がアクティブ化される
• 対象のアプリケーションが予期しないステートになる

潜在的な問題: Robot サービスは、RDP 接続を介して Windows セッションを初期化します

無人オートメーションの場合、Robot サービスは RDP 接続を介して Windows セッションを初期化します。また、ディスプレイの解像度とスケールに関するシステム設定、またはロボットの設定に依存します。そのため、リモート セッションとローカル セッションで解像度とスケールが異なります。

Solutions (ソリューション)

重要:

テストの前に、ロボット ユーザーがロボット端末からログアウトしていることを確認します。これにより、ロボットはクリーンな環境で動作します。

ほとんどの場合、有人モードと無人モードの主要な違いは解像度の違いです。「解像度に関する問題を修正する」および「解像度のベスト プラクティス」をご覧ください。

解決策 1: スケール設定の確認

スケール設定は、Robot とユーザー インターフェイスが対話する方法に影響する可能性があります。 解像度を修正しても問題が解決しない場合は、Windows セッションのスケール設定を確認します。

1. 有人オートメーションを実行する場合と同じようにマシンにログインします。
2. PowerShell を開きます ([ファイル名を指定して実行] ダイアログを使用して「powershell」と入力します)。
3. 次のコマンドを実行します。

   (Get-ItemProperty 'HKCU:\Control Panel\Desktop\WindowMetrics' -Name AppliedDPI).AppliedDPI
   

4. 戻り値が 96 である必要があります。そうでない場合、Robot は非標準のスケールで開発されている可能性があります。「スケールを強制的に適用する」をご覧ください。

解決策 2: 問題のリアルタイムのキャプチャ

解決策 1 で問題が解決しない場合は、[ライブ ストリーミングとリモート制御] 機能を使用し、問題が発生したときに問題をキャプチャします。これらのツールを使用すると、マシンに直接ログインせずにロボットの動作を観察することができ、他の方法では確認できない問題を特定するのに役立ちます。

解決策 3: UiPath のサポート

前の手順で問題を特定できない場合は、UiPath に問い合わせてサポート チケットを起票してください。

ロボットが間違った場所をクリックする

ロボットが間違った場所をクリックする場合、通常は [クリック] アクティビティで [カーソルの位置] オプションが有効化されています。

Studio でレコーディング機能を使用している場合、[カーソルの位置] プロパティが誤って設定されることがあります。間違った場所をクリックしたアクティビティを特定し、このオプションが意図的に有効化されているかどうかを確認します。ほとんどの場合、このプロパティは不要です。

解決策 1: 解像度に関する問題を修正する

1. 有人オートメーションを実行する場合と同じようにマシンにログインします。
2. PowerShell を開きます ([ファイル名を指定して実行] ダイアログを使用して「powershell」と入力します)。
3. 次のコマンドを実行します。

   [void][Reflection.Assembly]::LoadWithPartialName("System.Windows.Forms")
   [System.Windows.Forms.SystemInformation]::PrimaryMonitorSize
   

4. 返された Width と Height の値を書き留めます。これらの値は手順 7b で必要になります。
5. フォント スムージングを確認します。
   • [スタート] メニューから [システムの詳細設定の表示] を開きます。
   • [詳細設定] タブで、[パフォーマンス] の [設定] を選択します。
   • [スクリーンフォントの縁を滑らかにする] が有効化されているかどうかを確認します。
6. ビットの深度やフォント スムージングが必要な場合は、ロボット端末に接続するローカル マシンの表示設定を確認します。
   • [ディスプレイ] 設定に移動します。
   • [ディスプレイの詳細設定] に移動して、ビットの深度の情報を確認します。
7. オートメーションを実行するロボット アカウントの [ロボットの設定] セクションにアクセスします (Orchestrator > [テナント] > [アクセス権を管理] > [アクセス ルール] > [ロボット アカウント])。
   1. [コンソールへログイン] オプションを [いいえ] に設定します。これにより、無人オートメーションに RDP セッションを使用するようロボットに指示します。
   2. [解像度の幅] と [解像度の高さ] の値を設定します。手順 3 で返された値と同じ値を使用します。
   3. [解像度の階調] を 32 に設定します。
   4. 画像ベースのオートメーションの場合は、さらに [フォント スムージング] を [はい] に設定します。
8. [更新] を選択します。

解決策 2: スケールを強制的に適用する

スケールを 100% に設定した開発環境でオートメーションを再設計するのが最適です。以下の手順は、一時的な回避策を意図しています。ロボットが RDP セッション で実行されていることを確認します ( [コンソールへログイン ] オプションが [ いいえ] に設定されている)。

1. レジストリ エディターを開き、HKEY_CURRENT_USER\Control Panel\Desktop\LogPixels に移動します。

2. レジストリ値 LogPixels を検索します。値が存在しない場合は、32-DWORD 値として作成します。使用可能な十進値については、次の一覧をご覧ください。

   DPI (解像度)	スケール係数 (%) (LogPixels の値)
   96	100 (スケールなし)
   120	125 (ディスプレイ上のすべての項目を 25% 拡大)
   144	150 (ディスプレイ上のすべての項目を 50% 拡大)
   192	200 (ディスプレイ上のすべての項目を 2 倍に拡大)

3. 次に、HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations\ に移動します。

4. レジストリ値 IgnoreClientDesktopScaleFactor を検索します。このレジストリ キーは、ロボット端末のスケールを無視するかどうかをリモート接続に指示します。値が存在しない場合は、32-DWORD 値として作成します。使用可能な十進値については、次の一覧をご覧ください。

   1. 1 - ロボット端末のスケールを無視します。
   2. 0 - ロボット端末のスケールを考慮します。

解像度のベスト プラクティス

• こちらで UI Automation のガイドラインを確認します。
• 解像度を重要な設計要件にします。
• 開発環境と運用環境の解像度とスケールが同一であることを確認します。
• 解像度を指定しない場合、システムの既定値が適用されることに注意します。このため、アプリケーションがサポートしない低い解像度になる場合があります。UI 要素が画面の外にはみ出たり、視覚的に歪んだりすることがあります。
• 解像度に依存する以下のアクティビティを見落とさないようにします。
  • [画像を探す] などの画像ベースのアクティビティや OCR アクティビティ。
  • クリッピング領域が有効化されている UI Automation アクティビティ。
  • [表示されるまで待つ] オプションが有効化されている UI Automation アクティビティ。
  • [ウィンドウ メッセージ] や [シミュレート] の入力メソッドを使用しない「クリック」系アクティビティ。[カーソルの位置] プロパティについては、「ロボットが間違った場所をクリックする」をご覧ください。