この章では、イメージベース バリデーションの簡単な例をとりあげます。この章を進める前に、⇢ テストのバリデーション を確認してください。

この章の構成

• サンプル ソリューションのダウンロード
• テストの定義
• レコーディングの準備
• テストのレコーディング
• イメージベース バリデーション
• レコーディングの完了
• 結果

チュートリアルを実施するため、以下からサンプル ソリューションをダウンロードしてください。

サンプル ソリューション

---

Theme: Build a test
Time: 15 minutes

Download sample file

インストール:

1. 任意のフォルダーに解凍します。

2. スタート を起動し、RxDatabase.rxsln を開きます。 オープン 解決ファイル ImagebasedValidation.rxsln

テストのレコーディングを開始する前にテストを定義します。テストは 5 つのステップで構成されます。

1. Demo Application を起動します。

2. Image-based automation タブをクリックします。

3. 対象の画像が画面に表示された状態にします。

4. イメージが表⽰されていることを確認します。

5. Demo Application を終了します。

1. ソリューション ウィザードを使⽤して、デスクトップ テスト ソリューションを作成します。ウィザードの 2 つ⽬の画⾯で、テスト対象アプリとして Demo Application を選択します。

1. テスト対象アプリとして選択された Demo Application と、⾃動起動オプション

2. ソリューション ウィザードを完了後、Ranorex Studio で Recording1 タブをクリックします。

1. Recording1 のレコーディング モジュール ビューで、RECORD をクリックする。Ranorex Studio がタスクバーに⾃動的に最⼩化され、Recorder control center が表⽰され、レコーディングが開始されます。

2. テスト対象アプリにフォーカスします。Image-based automation タブをクリックします。

3. イメージを表⽰するために、Show image チェックボックスをクリックします。

この例におけるバリデーションの⽬的は、チェックボックスをクリックした際に、猫の画像が表⽰されるかを確認することです。画像を検証する必要があるため、イメージベース バリデーションを使⽤します。

以下の⼿順でおこないます。

イメージベース バリデーションの有効化

1. Recorder control center で、イメージベース レコーディング を有効化します。

2. Validate をクリックします。レコーディングが⼀時停⽌され、バリデーション モードに切り替わります。

バリデーション要素の選択

3. バリデーション要素を選択します。

• 猫の画像にマウス オーバーします。マウスの動きに合わせて 紫色の枠 が表示されます。
• 紫⾊の枠が、バリデーション対象となる要素を⽰します。
• 猫の画像にフォーカスし、クリックします。

バリデーション要素の確認

4. UI 要素を確認し、次へ をクリックします。

1. GUI 内の UI 要素の位置

• UI 要素ツリーは、アプリケーションの階層的な GUI 構造を表しています。
• 必要に応じて、他の UI 要素を選択することもできます。

2. UI 要素の状態と属性
   

• 選択中の UI 要素のすべての属性が表⽰されます。

3. UI要素のスクリーンショット
   

• 選択している UI 要素が正しいか、スクリーンショットで確認できます。

バリデーション属性の定義

5. バリデーションで使⽤するイメージを定義します。今回の例では、すべてデフォルトの設定で OK をクリックします。

1. バリデーション ダイアログで、Attributes タブの代わりに Image タブが選択されています。

2. バリデーション モードとして “Contains” を選択する場合には、イメージの範囲を矩形で選択します。

3. いくつかのバリデーション モードが選択できます。
   

• None: イメージ バリデーションを無効化します。
• Contains: 指定の画像が、期待する画像に含まれているかをチェックします。
• Compare: 指定の画像が、期待する画像と⼀致するかをチェックします。

バリデーションの設定が完了すると、Ranorex はレコーディングを⾃動的に再開します。次のステップで、レコーディングを停⽌します。

1. Recorder control center で Stop をクリックしてレコーディングを停⽌します。

レコーディングを停⽌すると Ranorex Studio に戻ります。アクション テーブルには、記録された 3 つのアクションが含まれます。アクション #3 がバリデーションです。

1. バリデーションの種類

• 実⾏されるバリデーションの種類です。
• 9つの種類があります。

さらに読む

---

バリデーションの種類の詳細については、Ranorex Studio 基礎 > アクション > ⇢ アクションのプロパティ を参照してください。

2. テスト実⾏中の実際のイメージと⽐較するバリデーション スクリーンショットを表します。

3. アクションにリンクされているリポジトリ アイテム、つまり、バリデーションが実⾏される UI 要素を表します。

バリデーションの解説

このバリデーションは以下のように解釈できます。

もし Screenshot1 が、リポジトリ アイテム TheCat で参照されるUI要素に含まれる (ContainsImage)場合に、 TheCatバリデーションが成功(True)