WinActor

2019.12.13
サンプルシナリオ 画像キャプチャ色判定
ウェブページ全体の画面キャプチャを保存するサンプルシナリオ

ウェブページ全体の画面キャプチャをファイルに保存するために、WinActorの画面キャプチャと画面スクロールが行えるライブラリを使用して、 ウェブページ全体の画面キャプチャを保存するサンプルシナリオとなります。

本コンテンツをダウンロードする前にこちらの利用条件を必ずご確認いただき、内容に同意をしたうえでダウンロードしてください。 また、"コンテンツの利用条件"は下のボタンからダウンロードし、お手元で保管してください。

サンプルシナリオ概要

ウェブページ全体の画面キャプチャを保存するサンプルシナリオ

ウェブページ全体の画面キャプチャを保存するサンプルシナリオ

はじめに

ウェブページ全体の画面キャプチャをファイルに保存するために、WinActorの画面キャプチャと画面スクロールが行えるライブラリを使用して、 ウェブページ全体の画面キャプチャを保存するサンプルシナリオ(以降、本サンプルシナリオ)について説明します。

本サンプルシナリオの概要

本サンプルシナリオは、以下の処理を行います。

  • ブラウザを起動し、指定のウェブページに遷移します。
  • 後判定繰り返しグループ内で以下を行います。
    • ウェブページで画面キャプチャを取得しファイルに保存します。
    • 画像マッチングでウェブページの末尾か判定し、判定結果を変数に格納します。
    • ウェブページを画面スクロールします。
    • ウェブページの末尾か判定した結果がTrueの場合は繰り返し処理を終了します。

使用するWinActorモジュール

本サンプルシナリオでは、以下のWinActorモジュールを使用します。

  • 04_自動記録アクション/エミュレーション.ums5
  • 07_文字列操作/03_連結/文字列の連結(2つ).ums5
  • 13_ファイル関連/05_ファイル名/フォルダパスとファイル名の連結.ums5
  • 16_画面キャプチャ色判定/画面キャプチャ(指定画面).ums5
  • 23_ブラウザ関連/ブラウザ起動.ums5
  • 23_ブラウザ関連/ページ表示.ums5
  • ノード/アクション/画像マッチング

動作確認環境

本サンプルシナリオは以下の環境で動作確認しています。

  • Windows 10
  • WinActor 5.3.1、WinActor 6.2.0
  • Google Chrome 78.0.3904.108

本サンプルシナリオの使い方

本サンプルシナリオの使い方は以下の通りです。

Step 1. サンプルシナリオの読み込み

ダウンロードしたZIPファイルを展開し、展開したフォルダに含まれている本サンプルシナリオをWinActorで読み込みます。

Step 2. 動作に必要な変数を設定

本サンプルシナリオを実行するために必要な値を、変数一覧で設定します。 事前に設定が必要な変数は以下の2つです。

事前に設定が必要な変数
事前に設定が必要な変数
  • URL
    • 操作対象のURLを指定してください。 ※添付のサンプル(sample.html)など、入力ファイルをウェブページとして使用する場合、絶対パスで指定してください。

      例) C:\winactor\sample.html

  • 出力先フォルダ
    • 出力先のフォルダを絶対パスで指定してください。

      例) C:\winactor\output

Step 3. サンプルシナリオの実行

WinActorで本サンプルシナリオを実行開始します。 ウェブページ全体の画面キャプチャが保存され、本サンプルシナリオは終了します。

Step 4. サンプルシナリオ実行終了後の確認

出力先フォルダで指定したフォルダにウェブページ全体分の画面キャプチャがファイルに保存されていることを確認してください。

トラブルシューティング

本サンプルシナリオでは、変数で誤った指定をした場合、エラーメッセージが出力されます。

詳細については、エラーメッセージ一覧を参照してください。

サンプルシナリオ解説

本サンプルシナリオで使用している実装テクニックについて説明します。

ウェブページ全体の画面キャプチャ

指定したウィンドウの画面キャプチャの保存は、「画面キャプチャ(指定画面).ums5」で行うことができます。

画面キャプチャとスクロール処理
画面キャプチャとスクロール処理

「画面キャプチャ(指定画面).ums5」では、現在表示されているウィンドウの画面キャプチャは取得できますが、 画面をスクロールしないと見えない位置の画面キャプチャを取得することができないため、 「エミュレーション.ums5」にて、ウェブページに対してキーボードのPageDownを擬似操作し、見えていない位置を表示させています。

画面キャプチャと画面スクロールを繰り返すことでウェブページ全体の画面キャプチャが取得できます。

繰り返しの終了判定

先述した「エミュレーション.ums5」を繰り返す事でウェブページの末尾に移動することはできますが、 ウェブページの末尾は、操作対象のページ毎に異なるため、 本サンプルシナリオでは、画像マッチングの状態チェックでウェブページの末尾か判定し、合致するまで繰り返す仕組みを取っています。

画像マッチングでは、マッチング対象画面の最下部で、かつ画面の途中に同一物が存在しない画像を指定しています。

また、本サンプルシナリオは、画像マッチングの状態取得結果がTrueで判定されない限り、繰り返し処理を抜けず無限ループします。 そのため、マッチングしない場合は、画像マッチングのマッチ率を下げるか、繰り返しグループで回数指定への変更等を検討してください。

繰り返し終了の条件
繰り返し終了の条件

画像マッチングの精度向上

画像マッチングは、ご利用の環境や解像度によってマッチしないケースがあるため、 よりマッチングの精度が向上するよう、本サンプルシナリオでは「sample.html」に画像ファイルを埋め込み、画像ファイルがマッチするか判定させています。 ※以下の画像の「キャプチャの終了部分」は、文字ではなく添付している画像(CaptureEnd.png)を表示しています。

画像マッチングプロパティ設定
画像マッチングプロパティ設定

本サンプルシナリオを基に、操作するウェブページを変更する場合、ご利用のシナリオに合わせてマッチング画像を変更するか、終了判定を行えるロジックに変更してください。 マッチング画像を変更した場合、以下のノードのウィンドウ識別名も併せて変更してください。

  • 画面キャプチャ(指定画面)
  • 画像マッチング
  • エミュレーション

変更履歴

日付 修正内容 版数
日付
2019/12/13
修正内容
初版
版数
1.0版
日付
2023/6/12
修正内容
・注意事項を削除
・ファイル名を「SS1912_8932_CaptureWithScrolling_1.0.1.zip」に変更
版数
1.1版

本コンテンツをダウンロードする前にこちらの利用条件を必ずご確認いただき、内容に同意をしたうえでダウンロードしてください。 また、"コンテンツの利用条件"は下のボタンからダウンロードし、お手元で保管してください。

サンプルシナリオ一覧へ戻る
当サイトでは、お客さまに最適なユーザー体験をご提供するためにCookieを使用しています。当サイトをご利用いただくことにより、お客さまがCookieの使用に同意されたものとみなします。詳細は、「プライバシーポリシー」をご確認ください。