★アクションの説明、概要
JobAutoでロボットの実行内容や処理結果を ログへ出力する方法について説明します。
「ログ出力」アクションでは、 任意の文字やJobAutoの変数、 システム値などをログへ出力できます。
出力したログは、 スケジュール実行後にROBOWEBのログから確認できます。
また、 ログを出力した時点のデスクトップ画面を スクリーンショットとして記録したり、 ログをエラーとして出力したりすることもできます。
ロボットがどこまで処理されたか確認したい場合や、 処理結果の記録、 エラー原因の調査、 業務処理の証跡を残したい場合などに使用します。
★アクションの作成方法
★アクションの設定画面について
アクション設定画面の設定項目についての説明は以下の通りです。
１．基本設定
１－１．入力値
ログ出力する内容を設定します。変数参照可能です。またシステム値を使用可能です。システム値の説明はこちら。
１－２．ログにスクリーンショットを含める ※0.10.4から追加
ログ出力したときのスクリーンショットをとる場合は、チェックを入れます。
こちらにチェックが入っていると、ログ出力したときのデスクトップ画面がスクリーンショットされROBOWEBのログで確認することができます。
※ロボロックを実行しておくか、モニタが移っている状態である必要があります
１－３．エラーとして出力する
ログをエラーとして出力する場合にチェックを入れてください。エラーとして出力すると、ROBOWEBのスケジュールやログのステータスがエラーありとなります。またスケジュールの設定がエラー時にメール送信するとなっている場合は、メールが送信されます。
１－４．ログ出力時に座標も含める ※０．１０．１１から
ログを出力するときに、ログ出力アクションの座標も含む場合はチェックを入れます。ロボットのどこのログ出力アクションから出力したログなのか、わかります。
２．高度な設定
２－１．アクション有効
このアクションを無効にする場合は、チェックを外します。
３．エラー発生時の対応
３－１． エラー時の処理
エラーが発生したときの設定を行います。詳細はこちらをご確認ください。
３－２．基点となる条件分岐
エラー時の処理で条件分岐の次のフローに移動を選択したときに、設定することができます。アクションでエラーが発生した場合、移動先の条件分岐を選択します。
３－３． エラー時にログ出力
エラーが発生したときにログに出力するか設定します。スケジュール実行したときのログへ出力されます。エラーとして扱わない場合は、チェックを外します。詳細はこちらをご確認ください。
JobAutoの処理内容をログへ出力する場合
ロボットがどこまで処理されたか確認したい場合や、 処理した内容を記録しておきたい場合は、 「ログ出力」アクションを使用します。
「入力値」に設定した内容がログへ出力され、 スケジュール実行後に ROBOWEBのログから確認できます。
変数の値をログへ出力する場合
「入力値」には、 JobAutoの変数を使用できます。
処理中に取得した値や、 処理件数、ファイル名、顧客コードなどを 変数へ格納しておくことで、 実際に処理した内容をログへ記録できます。
システム値をログへ出力する場合
「入力値」では、 JobAutoのシステム値も使用できます。
実行日時、プロジェクト名、ロボット名、 繰り返し回数、エラー件数、実行時間などを ログへ出力することができます。
固定文字と変数やシステム値を組み合わせることで、 あとから確認しやすいログを作成できます。
処理の証跡として画面をログへ残す場合
ログを出力した時点の画面も記録したい場合は、 「ログにスクリーンショットを含める」 にチェックを入れます。
アクション実行時のデスクトップ画面が記録され、 ROBOWEBのログ詳細から確認できます。
システムへデータを登録する処理などで、 登録前後の画面を証跡として残したい場合にも利用できます。
エラー原因を調査するために画面を残す場合
ロボットがエラーになったときに 画面の状態を確認できるようにしたい場合は、 処理の重要な箇所へログ出力を配置し、 スクリーンショットを記録しておく方法があります。
ログの内容とその時点の画面を確認することで、 エラー発生時の状況を調査しやすくなります。
ログをエラーとして出力する場合
ロボットの処理上はアクションエラーになっていなくても、 業務上はエラーとして扱いたい場合は、 「エラーとして出力する」にチェックを入れます。
エラーとしてログを出力すると、 ROBOWEBのスケジュールやログのステータスが 「エラーあり」となります。
スケジュールでエラー時のメール送信が設定されている場合は、 エラー通知メールも送信されます。
ログを出力した場所を確認する場合
同じようなログ出力アクションが ロボット内に複数ある場合は、 「ログ出力時に座標も含める」を使用できます。
ログ出力アクションの座標も記録されるため、 アクションフローのどの位置から ログが出力されたのか確認しやすくなります。
「スクリーンショット」と「ログ出力」の違い
| 方法 | 用途 |
|---|---|
| スクリーンショット | デスクトップやアプリ画面を 指定した保存先へ画像ファイルとして保存します。 |
| ログ出力でスクリーンショットを含める | ログ出力時のデスクトップ画面を記録し、 ROBOWEBのログ詳細から確認します。 |
ログへ出力しておくと確認しやすい情報
- ロボットの処理を開始したこと
- 処理対象となったファイル名やデータ
- 処理した件数
- 条件分岐でどの処理へ進んだか
- システムへ登録する内容
- 処理が正常に完了したこと
- 業務上のエラーや確認が必要な内容
ロボットの重要な処理ポイントでログを残しておくと、 スケジュール実行後の確認や エラー発生時の原因調査を行いやすくなります。
ログのスクリーンショットを確認できない場合
- 「ログにスクリーンショットを含める」に チェックが入っているか確認します。
- ロボットを実行しているPCで デスクトップ画面が表示できる状態か確認します。
- モニターを使用している場合は、 モニターが接続され画面が表示されているか確認します。
- モニターを使用しない環境では、 robo_lock.exeが起動しているか確認します。
- ROBOWEBのログ詳細から 対象となるログ出力箇所を確認します。
ログが想定どおり出力されない場合の確認順序
- 「入力値」に 出力したい内容が設定されているか確認します。
- 変数を使用している場合は、 実行時に変数へ想定した値が 格納されているか確認します。
- システム値を使用している場合は、 指定しているシステム値を確認します。
- 「高度な設定」の「アクション有効」に チェックが入っているか確認します。
- ROBOWEBで対象となる プロジェクト、スケジュール、ロボットのログを確認します。
- ログの表示量が多い場合は、 ログファイルをダウンロードして確認します。
[…] ・%%USER_LOG%% 処理中のロボットが出力するように設定したログです。 その他のログ出力アクションで設定したものを取得できます […]
[…] ログ出力アクションを使うと、スケジュール実行のときのログにさまざまなログを出力することができます。そのときの画面ショットも出力できます。出力したらよいものをいくつかご紹介します。手順：ログ出力 […]