オブジェクト認識センターの使用
テクニカル・プレビュー。UFT One バージョン 15.0.2 以降でサポート
関連:GUI テストおよびコンポーネント
オブジェクト認識センター(OIC)は、開いているアプリケーション内のオブジェクトについて一意で明確な記述を作成できるツールです。
概要
OIC を使用すると、アプリケーション内のオブジェクトをスパイし、それらのオブジェクトを識別する方法を決定し、オブジェクトをテストおよびオブジェクト・リポジトリに追加できます。
OIC によって、次のことが可能になります。
- 1 つまたは複数のオブジェクトをスパイする
- カスタマイズされたオブジェクトの記述を作成する
- 1 つまたは複数のオブジェクトをオブジェクト・リポジトリに追加する
- 1 つまたは複数のオブジェクトをテストにドラッグして、ステップを作成する
- オブジェクトの記述をコピーして、プログラム的記述で使用する
- アプリケーション内のオブジェクトの画像をキャプチャする
注意: UFT One 15.0.2 では、OIC が標準のスパイです。スパイされたオブジェクトのネイティブ・プロパティとメソッドを確認するには、オブジェクト・スパイを使用します。詳細については、「 オブジェクト・スパイの使用」を参照してください。
Web ベースのアプリケーションをスパイするための前提条件
Web ベースのアプリケーションをスパイする前に、次の手順を確認してください。
- ブラウザが UFT One と連携するように設定されていることを確認します。詳細については、「特定のブラウザでの Web アプリのテスト」を参照してください。
-
UFT One を開いてからブラウザを開きます。
UFT One では、UFT One を起動する前に開いていたブラウザ・ウィンドウでスパイ、記録、またはテストを実行することはできません。
- (オプション)UFT One がオブジェクトを識別する方法を設定します。詳細については、「テスト・オブジェクト・クラスに対するオブジェクト認識の設定」を参照してください。
OIC へのアクセス
OIC へアクセスするには、次の手順を実行します。
-
GUI テストまたはテスト・アクションを開きます。
-
UFT ツールバーで[オブジェクト認識センター]ボタンをクリックします。
[記録]ツールバー、[AIレコード]ツールバー、[オブジェクト リポジトリ]ウィンドウ・ツールバー、および[オブジェクト リポジトリ マネージャ]ウィンドウ・ツールバーから OIC にアクセスすることもできます。
ヒント: UFT One の使用中は、OIC を常に開いたままにしておきます。
スパイの前に
OIC には、オブジェクトを一度に 1 つずつスパイするシングル・オブジェクト・スパイ・モードと、一度に複数のオブジェクトをスパイするマルチ・オブジェクト・スパイ・モードの 2 つのスパイ・モードがあります。
スパイを実行する前に、使用するスパイ・モードを決定してください。マルチ・オブジェクト・スパイ・モードを有効にするには、[マルチオブジェクトスパイ]ボタンをオンに切り替えます。このボタンのオンとオフを切り替えることで、2 つのスパイ・モードを簡単に切り替えることができます。
スパイを容易にするには、[ホバーモード]ボタンをオンに切り替えて、オブジェクトにカーソルを合わせてスパイします。[設定]ボタンをクリックして、ホバー・モードのその他の設定を編集できます。
- ホバー・モードの強調表示:このオプションを有効にすると、アプリケーションでスパイするオブジェクトが強調表示されます。
- ホバー・モードのタイムアウト:このオプションを使用して、オブジェクトにカーソルを合わせる時間を決定します。標準設定値は 1.3 秒です。
注意: 選択したスパイ・モードとホバー・モードの設定は、次に OIC を開いたときにも維持されます。
アプリケーション内のオブジェクトのスパイ
開いているアプリケーションのスパイを開始して、スパイしたオブジェクトの記述プロパティを取得します。OIC を使用して、アプリケーション内のオブジェクトを表すために使用できる AI オブジェクトを作成することもできます。
1 つまたは複数のオブジェクトをスパイするには:
-
次のいずれかを実行して、アプリケーションのスパイを開始します。
-
シングル・オブジェクト・スパイ:OIC ウィンドウで、[スパイの開始]ボタンをクリックします。
OIC ウィンドウが最小化されます。開いているアプリケーションからオブジェクトを選択すると、OIC ウィンドウが再び開きます。
-
マルチ・オブジェクト・スパイ:OIC ウィンドウで、[マルチオブジェクトスパイ]ボタンをオンにし、[スパイの開始]ボタンをクリックします。
OIC ウィンドウが、OIC ウィジェットに変わります。テスト・オブジェクトを選択したら、ウィジェットをクリックして OIC ウィンドウに戻ります。
-
-
アプリケーション内の 1 つまたは複数のオブジェクトをクリックします。
クリックしたオブジェクトが強調表示されます。ツールヒントには、アドイン名、オブジェクト名、必須の記述プロパティなど、オブジェクトの基本情報が表示されます。
ホバー・モードを使用していて、スパイ中にアプリケーション内でポイントするオブジェクトを強調表示する場合は、[設定]で[ホバーモードの強調表示]を有効にします。詳細については、「スパイの前に」を参照してください。
ヒント: マルチ・オブジェクト・スパイ・モードでは、OIC ウィジェットにキャプチャされたオブジェクトの数が表示されます。別のオブジェクトを選択するには、OIC ウィジェットのスピナーの回転が止まるまで待ちます。
注意:
- スパイ操作を一時的に一時停止して別のアプリケーションにフォーカスするには、Ctrl キーを長押しします。
- スパイ操作を停止またはキャンセルするには、Esc キーを押します。
シングル・オブジェクト・スパイ・モードでは、OIC がオブジェクトをスパイし、編集モードでオブジェクトを直接表示します。
マルチ・オブジェクト・スパイ・モードでは、スパイの完了後に OIC ウィジェットをクリックすると、OIC ウィンドウが開き、スパイしたオブジェクトのリストが表示されます。
-
目的のオブジェクトがあることを確認するには、オブジェクトにカーソルを合わせ、[強調表示]ボタンをクリックして強調表示します。
-
リストから複数のオブジェクトを削除するには、最初に[すべてクリア]ボタンをクリックしてから、削除する行を選択し、[削除]ボタンをクリックします。
-
現在のリストにオブジェクトを追加するには、[追加のオブジェクトのスパイ]ボタンをクリックします。
-
新しいスパイ・セッションを開始するには、[削除]ボタンをクリックしてすべてのオブジェクトを削除してから、[スパイの開始]ボタンをクリックします。
-
テスト・オブジェクトの詳細を表示するには、オブジェクトにカーソルを合わせ、[編集]ボタンをクリックします。
マルチ・オブジェクト・スパイ・モードで以下の手順を実行します。
AI オブジェクトを識別するには
GUI モバイルおよび Web テストのみ
OIC を使用すると、スパイしたオブジェクトが AI によって識別可能かどうかを確認し、アプリケーション内のすべての AI オブジェクトを識別できます。
AI を使用して単一のオブジェクトを識別するには
OIC は、標準設定で[AI 自動検査]が有効になっています。Web オブジェクトまたはモバイル・オブジェクトのスパイが完了すると、テストでオブジェクトを表すために使用できる AI オブジェクトが OIC の編集ビューで提案されます。
AI を使用してアプリケーション内のすべてのオブジェクトを識別するには
-
OIC ウィンドウで、[検査]をクリックします([AI 自動検査]がオンになっている場合に使用できます)。
OIC ウィンドウで[検査]が使用できない場合は、[設定]ボタンをクリックし、[AI 自動検査]を選択します。
-
AI 識別ビューウィンドウを使用して、アプリケーションを検査し、その中のすべての AI オブジェクトを識別します。
既知の問題
表示倍率の確認 |
UFT One がオブジェクトの場所を正しく認識できない場合、ページを拡大または縮小せず 100% で表示していることを確認してください。 たとえば、90% または 120% の倍率でページを表示すると、オブジェクトの右側または左側の部分をクリックまたは選択しないとオブジェクトが認識されない場合があります。 |
Insight テスト・オブジェクトとテキスト・テスト・オブジェクト | OIC は、Insight テスト・オブジェクトとテキスト・テスト・オブジェクトをサポートしていません。 |
マルチ・オブジェクト・スパイ・セッションの AI オブジェクト | マルチ・オブジェクト・スパイ・モードでは、OIC 編集ビューですべてのオブジェクトについて同じ AI オブジェクトの提案が表示されます。これは、最後にスパイしたオブジェクトの AI オブジェクトです。 |
オブジェクトの記述の表示と編集
初期設定では、OIC は、推奨されるプロパティと値のセットを自動的に選択して、オブジェクトの識別に使用します。これらの提案をオーバーライドして、カスタマイズされたオブジェクトの記述を作成できます。
オブジェクトの記述を編集するには:
-
シングル・オブジェクト・スパイ・モードの場合、OIC は自動的に編集ビューで開きます。
マルチ・オブジェクト・スパイ・モードでは、オブジェクト・リスト・ビューでオブジェクトにカーソルを合わせ、[編集]をクリックして編集ビューに入ります。
編集ビューでは、左側のペインにオブジェクトの階層が表示されます。オブジェクトの階層で別のオブジェクトを選択してオブジェクト・リスト・ビューに戻ると、選択したオブジェクトがスパイしたオブジェクトのリストに含まれるオブジェクトになります。
右側のペインには、選択したオブジェクトでサポートされる記述プロパティの完全なリストと、アプリケーションからキャプチャされた現在の値が表示されます。右側のペインの星印は、UFT One がオブジェクトを識別するために推奨するプロパティを示しています。
- プロパティを選択し、必要に応じて値を編集します。
文字列プロパティに正規表現値を入力するには、値ボックスの右側にある[正規表現で設定]の星印をクリックします。
- [選択のクリア]ボタンと[推奨される認識を適用]ボタンを使用すると、UFT One が推奨する認識を簡単にクリアまたは適用できます。
-
[検証]ボタンを使用して、新しいオブジェクト認識を検証します。
OIC ウィンドウにメッセージが表示され、記述に一致するオブジェクトの数が示されます。
オブジェクトが識別されなかった場合、または複数のオブジェクトが識別された場合は、選択したプロパティのセットとその値を調整して、一意の認識を作成し、再度検証します。
オブジェクト・リポジトリへのオブジェクトの追加
スパイしたオブジェクトを、現在開いているテストに関連付けられているオブジェクト・リポジトリまたは外部オブジェクト・リポジトリに追加します。
スパイする前にテストを開くと、OIC は、開いているテストに関連付けられているローカル・リポジトリと共有オブジェクト・リポジトリをオブジェクト・リポジトリ・リストに自動的に表示します。スパイされたオブジェクトを外部オブジェクト・リポジトリに追加するには、最初にリポジトリをリストに追加する必要があります。
オブジェクト・リポジトリ・リストを編集するには、次の手順を実行します。
- OIC ウィンドウの[オブジェクトの追加]ドロップダウン・リストをクリックします。
- [新規オブジェクトリポジトリの追加]ボタンをクリックして、既存の外部オブジェクト・リポジトリを追加するか、新しいリポジトリを作成します。
オブジェクトをオブジェクト・リポジトリに追加するには、次の手順を実行します。
-
ソリューション・エクスプローラで既存のテストを開き、テストに関連するアプリケーションを開きます。
-
UFT ツールバーで、[オブジェクト認識センター]ボタンをクリックします。
-
「アプリケーション内のオブジェクトのスパイ」の説明に従って、アプリケーション内のオブジェクトをスパイします。
-
オブジェクトを追加する準備ができたら、[オブジェクトの追加]ドロップダウン・リストをクリックして、オブジェクト・リポジトリを選択します。
テストに関連付けられているローカル・リポジトリと共有リポジトリが自動的にリストに表示されます。外部オブジェクト・リポジトリを追加するには、「オブジェクト・リポジトリ・リストを編集するには、次の手順を実行します。」を参照してください。
-
[オブジェクトの追加]ボタンをクリックします。
- オブジェクトを外部オブジェクト・リポジトリに追加すると、そのオブジェクトは自動的に追加されます。
- オブジェクトをローカル・オブジェクト・リポジトリに追加する場合は、テストを保存してから、オブジェクトをリポジトリに追加します。
- 共有オブジェクト・リポジトリにオブジェクトを追加すると、[オブジェクト リポジトリ マネージャ]ウィンドウが開きます。オブジェクトをリポジトリに正常に追加するには、ウィンドウで追加の保存操作を実行する必要があります。
UFT One 15.0.2:OIC でスパイした UIA オブジェクトをオブジェクト・リポジトリに追加すると、各オブジェクトは新しい親の下に追加されます。1 つの親の下に同じ親オブジェクトに属する複数の UIA オブジェクトを追加する場合は、オブジェクト・スパイを使用します。
新しくスパイを実行したオブジェクトを使用した複数のステップの追加
OIC を使用して、スパイを実行した複数のオブジェクトをテストに追加し、複数のテスト・ステップを作成して、ローカル・オブジェクト・リポジトリを更新します。
新しくスパイを実行したオブジェクトで新しいステップを追加するには、次の手順を実行します。
- エディタでテストのアクションを開きます。
- OIC を使用してオブジェクトをスパイします。詳細については、「アプリケーション内のオブジェクトのスパイ」を参照してください。
-
スパイしたオブジェクトを OIC ウィンドウからエディタにドラッグ・アンド・ドロップします。
UFT One によって、テストに新しいステップが作成され、オブジェクトがローカル・オブジェクト・リポジトリに追加されます。
- OIC ウィンドウでテスト・オブジェクト名を変更してから、テスト・オブジェクトをテストにドラッグすると、テスト・オブジェクト名がテストとローカル・オブジェクト・リポジトリで同時に更新されます。
- 他のテストでも使用されているテスト・オブジェクトの名前を変更する場合は、それらのテストでテスト・オブジェクトの名前を手動で変更する必要があります。
- スパイしたオブジェクトが AI オブジェクトの場合、OIC ウィンドウのテキスト・ボックスに AI ベースのスクリプトが入力されます。[スクリプトにドラッグアンドドロップ]ボタンをクリックして、スクリプトをエディタにコピーします。
ヒント: ドラッグ・アンド・ドロップを実行する前に、すべてのオブジェクトが選択されていることを確認してください。
クリップボードへの記述プロパティのコピー
OIC を使用して、記述プロパティをクリップボードにコピーしてから、プログラム的記述の任意のドキュメントにコピーします。
記述プロパティをクリップボードにコピーするには、次の手順を実行します。
-
シングル・オブジェクト・スパイ・モードでは、OIC ウィンドウの[コードのコピー]ボタンをクリックします。
-
マルチ・オブジェクト・スパイ・モードでは、対応するプロパティと値を生成するオブジェクトをリストから 1 つ選択し、編集モードに入り、OIC ウィンドウの[コードのコピー]ボタンをクリックします。
注意: オブジェクトの記述プロパティは、一度に 1 つしかコピーできません。
コピーしたプロパティと値は、プログラム的記述の標準的な構文にフォーマットされ、プロパティと値のペアごとに改行されます。
例:
"Class Name:=Image",
"abs_x:=585",
"abs_y:=573",
"alt:=Specials",
詳細については、「 プログラム的記述」を参照してください。
オブジェクトの画像のキャプチャ
オブジェクト階層ツリーで現在選択されているオブジェクトに対応するアプリケーション内のオブジェクトの画像をキャプチャし、その画像をファイル・システムに保存します。これは、画像の検証に役立ちます。
注意:
- 一度に 1 つのオブジェクトの画像のみをキャプチャできます。
- 画像のキャプチャの実行中は、他のアプリケーションによって隠れている部分がないことを確認してください。
オブジェクトの画像をキャプチャするには、次の手順を実行します。
-
シングル・オブジェクト・スパイ・モードで、[オブジェクトの画像をキャプチャ]ボタンをクリックします。
-
マルチ・オブジェクト・スパイ・モードでは、リストからオブジェクトを選択し、編集モードに入り、OIC ウィンドウで[オブジェクトの画像をキャプチャ]ボタンをクリックします。
- 表示されたダイアログ・ボックスで、画像ファイルに名前を付けます。
- ファイルを保存します。
その他の参照項目:
- 既知の問題:「スパイ」