WinActorEyeを触ってみた

###はじめに###
この記事は私自身の備忘録になっています。
2年ほどWinActorから離れており、現在Ver6.3.1でリハビリ中です。
私が以前、利用していた時(Ver5から6に変わった頃)に無かった
「WinActorEye」を触ってみたので簡単な設定方法です。

###今回使用したWinActor###
・バージョン：6.3.1

###処理概要###
・フォルダ内の保存されている複数のPDFから社員番号と氏名を抽出。
　抽出した内容をExcelへ転記を行い、全て転記後にExcelを保存する。
　PDFのフォーマットとExcelのフォーマットは下記の通りです。
　<b>なお、PDFに記載の氏名や訪問先は架空のものになっております。</b>
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/971fdd8a-ef3a-99f6-13e9-52101a4be935.png)

###WinActorEyeの設定###
・WinActorより「ツール＞WinActorEye」をクリック。

・WinActorEyeが起動。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/0372bb49-604e-c286-b189-6207dadd8430.png)
・初期化のために「設定＞全リソースクリア」をクリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/f18b16a2-aca0-e4d5-4a57-07b99f82e4b2.png)
・PDFの読み取り設定準備のために「表示＞WinActorEye マクロ編集」をクリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/688aed7a-137f-4cc6-a587-b935618bdea2.png)
・WinActorEye マクロ編集が表示。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/45c8cbc7-c94f-bf3c-0101-60f413d9fd89.png)
・WinActorEye マクロ編集に前回の情報が残っている場合「新規作成」をクリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/d5b50b9b-e8f3-af8c-f0da-7a3c47f1f967.png)
・コマンド等に何も表示されていないことを確認し「記録」をチェック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/6f6159a3-16a5-e6e3-f345-83787e9d6bf2.png)
・WinActorEyeに戻り、読み取りたいPDFを開く。
　<font color=red>その際、WinActorでPDFを開いても同じウィンドウ状態になるよう処理を行うこと。
　例：「ウィンドウの最大化」や「ウィンドウ全体に表示」など</font>

・読み取りたいPDFが開いている状態で
　WinActorEyeの「入力＞スナップショット」をクリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/5cc8e9df-a700-2050-ed00-ae517e9b3664.png)
・スナップショットの画面が表示。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/c6c1a7f2-48ca-4805-a9ec-47d727a76931.png)
・WinActorEyeへの取り込み対象物を設定し「実行」をクリック。
　設定方法はWinActorと同様ターゲットボタンから選択する方法と
　ウィンドウタイトル名を指定する方法がある。
　今回は複数のPDFを読み取りたいためウィンドウタイトル名で「を含む」を選択した。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/771c9556-e112-cdc8-affb-fe6e221df0c7.png)
・WinActorEyeにPDFが取り込まれたことを確認。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/c8587dc9-216e-5ca7-a45a-2c4e2dafaeec.png)
・読み取り対象を設定するために「画像加工＞トリム」をクリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/aada9ce9-fb8b-d217-9673-5d9fe54fd500.png)
・トリムの画面が表示。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/084ec851-e866-25c5-08a1-db6d72dcdafe.png)
・WinActor Eyeの画面で読み取り箇所をドラッグ＆ドロップすると赤線で範囲が選択される。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/4c781177-afa3-714f-9a61-23c21fb00590.png)
　その際にトリムが消えた場合は、再度「画像加工＞トリム」をクリック。
　トリムに加工前の画像リソース
　(先ほどスナップショットで設定したウィンドウタイトル名)、
　加工後の画像リソース名を入力し「実行」をクリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/6cfc02c8-5ca5-eaff-cf52-6c65a5ed1e88.png)

・読み取り箇所が表示されたことを確認。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/d80d3ec4-9d2d-0c18-68d2-a3469782b8ef.png)
・OCRの設定のため「ツール＞OCRツール」をクリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/05da4a86-fba8-d514-eec2-122ff13da4e0.png)
・OCRツールの画面が表示。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/6db59d90-f4dd-a435-7148-e487945766de.png)
・入力の画像リソース(先ほどトリムで設定した画像リソース名)、
　出力のリソース名を入力し「実行」をクリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/d16a18f6-a103-84a6-82d0-502522dcabc0.png)
・WinActorEyeで赤線で囲われ認識していることを確認。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/7c448851-d9b1-4d9c-456f-0a8d55a6093f.png)
・設定した内容を保存するため「表示＞WinActorEye マクロ編集」をクリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/5743fee6-c795-d463-7c48-8058e500e1a6.png)
・WinActorEyeの画面が開き「保存」をクリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/7966bc58-b433-6000-57de-cee676dd99ea.png)
・任意の場所に「.json」ファイルを保存。
　同様に「氏名」を読み取る設定も行い、
　作業終了後に開いているWinActorEye関連のウィンドウを閉じる。

###WinActorのシナリオ###
・今回、作成したシナリオは下図の通り。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/9e395817-7526-978e-8d8d-061972dcb833.png)
　シナリオ全体の説明は割愛。気になった3か所(フロー内の赤枠)のみ記載。
　１．WinActorEyeで読み取り設定した状態と同じようにするため
　　　PDFのウィンドウを最大化とウィンドウ全体に
　　　PDFを表示するようエミュレーションを設定。

　２．「Eye:マクロ読込み実行」のノードで保存した読み取り設定を実行。
　　　実行した結果はクリップボードに保存されるため、
　　　「クリップボード」のノードを使用して変数へコピー。
　　　WinActorEyeで読み取った内容は半角スペースが多く含まれているため
　　　「文字列置換」のノードで半角スペースを削除と
　　　念のため「トリム」のノードで文字列の前後に改行コード削除を設定。

　３．Excelの転記へ転記するとPDFのウィンドウが後面に移るため
　　　「ウィンドウの前面化」のノードを使用してPDFのウィンドウの前面化を設定。
　　　ウィンドウが後面にあるとWinActorEyeで値を取得できなかった。　　

###シナリオの実行結果###
3つのPDFで社員番号、氏名の2か所を読み取った結果を待機ボックスに表示。
(氏名の間の半角スペースは置換しているため待機ボックスには出力されない)
1つ目のPDF
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/11d045b1-84bd-1078-3e89-eb323bbec451.png)
2つ目のPDF
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/c38f1ff7-ba3a-71aa-c4e5-3fd4e0f88b69.png)
3つ目のPDF
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/70d341e3-168a-9d62-fffd-e9bca1aa29af.png)
今回用意したPDFの読み取りに成功。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2127851/f203d7ba-2063-5585-ee72-1d2d16497804.png)


###WinActorEyeを触ってみての感想###
・認識率が高いように感じた。

・WinActorEyeの読み取りは座標で記憶なので
　WinActorで読み取り対象物を開く際には
　WinActorEyeで読み取り設定したサイズに開くことが必要。
　⇒対策：ノード「ウィンドウの表示変更」や「エミュレーション」など

・WinActorEyeの読み取り対象物が前面化されていないと
　正しく読み取れないため読み取り対象のウィンドウの前面化が必要。
　⇒対策：ノード「ウィンドウの前面化」

長文になりましたが、以上です。