順序識別子

関連:GUI テストおよびコンポーネント

UFT One は,順序識別子を使用して,複数の同じオブジェクトの中から特定のオブジェクトを一意に識別します。

概要

[オブジェクトの認識]ダイアログ・ボックスで指定した必須プロパティと補足プロパティを学習するのに加え,UFT One は予備的に各テスト・オブジェクトの順序識別子も学習できます。[順序識別子]は,同じ記述を持つオブジェクト(必須および補足プロパティ・リストで指定されているすべてのプロパティの値が同じオブジェクト)を区別するために,ほかのオブジェクトとの相対的な順番を表す数値を割り当てます。この順位の値によって UFT One は,必須および補足プロパティでは一意の記述を作成するのに不十分な場合でも,一意の記述を作成できます。

割り当てられた順序プロパティ値は相対的な値であり,UFT One がオブジェクトを学習したときに表示されるほかのオブジェクトとの関連でのみ正確です。そのため,アプリケーション・ページまたは画面のレイアウトや構成が変わると,オブジェクト自体には少しも変化がなくても,その値が変わってしまう可能性があります。そのため,UFT One はすべての利用可能な必須および補足プロパティを使っても一意の記述を作成できない場合にだけ,このバックアップ順序識別子の値を学習します。

さらに,UFT One が順序識別子を学習しても,実行セッション中にその識別子を使うのは,次の場合のみです。

  • 学習した記述およびスマート認識メカニズムが十分ではなく,アプリケーションのオブジェクトを識別できない場合。

  • テスト・オブジェクトに対してビジュアル関係識別子が定義されていない場合。詳細については,ビジュアル関係識別子を参照してください。

先頭に戻る

インデックスの識別子

オブジェクトの学習中,UFT One はオブジェクトを一意に識別できるように,テスト・オブジェクトの Index プロパティに値を割り当てることができます。この値は,ソース・コード内のオブジェクトの順番に基づいています。最初の番号は 0 です。

Index プロパティの値は,各オブジェクトに固有の値です。したがって,ある WebEdit テスト・オブジェクトを記述するのに Index:=3 を使用すると,UFT One はページ内の 4 番目の WebEdit を検索します。一方,WebElement オブジェクトを記述するのに Index:=3 を使用すると,WebElement オブジェクトはすべての Web オブジェクトに該当するため,UFT One はタイプに関係なくページ内の 4 番目の Web オブジェクトを検索します。

たとえば,次のオブジェクトを含んだ次のページがあるとします。

  • Apple という名前の画像

  • UserName という名前の画像

  • UserName という名前の WebEdit オブジェクト

  • Password という名前の画像

  • Password という名前の WebEdit オブジェクト

次のステートメントは,リストの 3 番目の項目を参照します。その項目が,ページ内で UserName という名前を持つ最初の WebEdit オブジェクトだからです。

WebEdit("Name:=UserName", "Index:=0")

一方,次のステートメントは,リストの 2 番目の項目を参照します。その項目が,UserName という名前を持つ最初の任意のタイプ(WebElement)のオブジェクトだからです。

WebElement("Name:=UserName", "Index:=0")

先頭に戻る

場所の識別子

オブジェクトの学習中,UFT One はオブジェクトを一意に識別できるように,テスト・オブジェクトの Location プロパティに値を割り当てることができます。この値は,ウィンドウ,フレーム,ダイアログ・ボックス内に現れる同じプロパティを持つほかのオブジェクトとの相対的な順番に基づいて決まります。最初のオブジェクトの場合,値は 0 です。値はカラム内で上から下に,そして左から右への順序で割り当てられます。

次の例では,ダイアログ・ボックス内のラジオ・ボタンは,Location プロパティに従って番号が付けられています。

Location プロパティの値は,各オブジェクトに固有の値です。したがって,ある WinButton テスト・オブジェクトを記述するのに Location:=3 を使用すると,UFT One は 4 番目の WinButton をページ内の上から下,左から右に検索します。一方,WinObject オブジェクトを記述するのに Location:=3 を使用すると,WinObject オブジェクトはすべての標準オブジェクトに該当するので,UFT One はタイプに関係なくページ内の 4 番目の標準オブジェクトをページ内の上から下,左から右に検索します。

作成時刻の識別子

ブラウザ・オブジェクトの学習中に,UFT OneCreationTime に値を割り当てます。この値は,開いているほかのブラウザに対して,そのブラウザが開かれた相対的な順番を示します。最初に開かれたブラウザは,CreationTime = 0 という値を受け取ります。

実行セッション中,テスト・オブジェクトの記述だけに基づいて Browser オブジェクトを一意に識別できないとき,UFT One はブラウザが開いた順番を確認し,CreationTime プロパティを使用して正しいブラウザ・オブジェクトを識別します。

Example: たとえば,9:01 pm,9:03 pm,9:05 pm に開かれたブラウザを学習し,CreationTime 値を次のように割り当てたとします。CreationTime = 0 を 9:01 am のブラウザ,CreationTime = 1 を 9:03 am のブラウザ,CreationTime = 2 を 9:06 am のブラウザ。

10:30 pm にこれらのブラウザ・オブジェクトに関するテストまたはコンポーネントを実行するとし,ブラウザが 10:31 pm,10:33 pm,10:34 pm に開くとします。10:31 pm のブラウザは UFT OneCreationTime = 0 が割り当てられたブラウザ・オブジェクト,10:33 pm のブラウザは CreationTime = 1 が割り当てられたブラウザ・オブジェクト,10:34 pm のブラウザは CreationTime = 2 が割り当てられたブラウザ・オブジェクトでそれぞれ識別されます。

特定の CreationTime 値のブラウザ・オブジェクトを対象にステップが作成されても,実行セッションでこの CreationTime 値のブラウザが開いていないと,そのステップは CreationTime 値の最も高いブラウザで実行されます。たとえば,ステップが CreationTime = 6ブラウザ・オブジェクトを対象に作成されても,実行セッションで CreationTime = 0CreationTime = 1 の 2 つのブラウザしか開いていないと,そのステップは最後に開いたブラウザで実行されます。この例では,CreationTime = 1 のブラウザになります。

注: セッション中の特定の時間に使用できる CreationTime 値は連番になっていない可能性があります。たとえば,記録または実行セッション中に 6 つのブラウザを開いたとして,セッション中にそのうち 2 番目と 4 番目のブラウザ(CreationTime 値 1 と 3)を閉じたとすると,セッションの最後で開いているブラウザは CreationTime 値が 0,2,4,5 のブラウザになります。

先頭に戻る