UIA Pro アドイン

アドインのベータ版では以下が提供されます。 

• パフォーマンスの大幅な向上

• テストの安定性の向上

UI Automation アプリケーションには，深いオブジェクト階層構造が存在することがよくあります。機能拡張されたアドインは，階層内のすべてのオブジェクトへの完全なアクセスと操作をサポートします。

新しいメソッドにより，テスト・オブジェクト・ツリーの包括的かつ柔軟なスキャンが可能です。

• すべてのレベルから子オブジェクトまたは親オブジェクトを取得したり，取得するオブジェクトのレベル数を指定したりできます。

• 取得する子オブジェクトまたは親オブジェクトのタイプの記述を指定することもできます。

詳細については，『Object Model Reference』の「UIA Pro」セクションにある次のメソッドを参照してください。

GetAncestors，GetChildren，GetDescendants，GetParent。後方互換性のために ChildObjects メソッドも引き続きサポートされていますが，ChildObjects メソッドではなくこれらのメソッドを使用してください。

実行セッション中に GetCell メソッドなどで取得されたオブジェクトでは，共通メソッドとプロパティがサポートされます。

新たにサポートされるメソッドは，Exist，GetROProperty，GetTOProperty，SetTOProperty，Highlight，RefreshObject，ToString，CheckProperty，WaitProperty です。

これにより，実行時にアプリケーションのオブジェクト階層内で検出されたオブジェクトを操作できる堅牢なテストが可能になります。

たとえば，次のステートメントは機能拡張されたベータ版アドインではサポートされていますが，従来のアドインではサポートされていません。 

UIAProDataGrid("dataGrid").GridPattern.GetCell(1,1).Highlight

補足プロパティがサポートされており，最適化されたテスト・オブジェクトの記述を作成できます。

従来の UIA Pro アドインでは，すべてのオブジェクト認識プロパティがすべての UIA Pro テスト・オブジェクトの記述に含まれています。

ベータ版アドインでは，［オブジェクトの認識］ダイアログ・ボックスで，各タイプの UIA Pro テスト・オブジェクトに対して考慮されるプロパティを確認できます。詳細については，テスト・オブジェクト・クラスに対するオブジェクト認識の設定を参照してください。

現在，このプロパティのリストは編集できませんが，テスト・オブジェクトをオブジェクト・リポジトリに追加した後で，その記述を編集し，テスト・オブジェクトの認識に使用されるプロパティのリストとその値を変更できます。

以下の既知の問題が修正されました。

• アプリケーション内でオブジェクトを一意に識別するためのオブジェクト・インデックスが正しく使用されていませんでした。

• Highlight，GetROProperty，RefreshObject などの一部のステップが実行結果レポートに含まれていませんでした。

• アプリケーション内で一時的にアクセスできなくなっていたオブジェクトが再び利用可能になったときに，そのオブジェクトに対するテスト・ステップが失敗していました。

• 一部の状況で，OpenText Functional Testing が応答しなくなることがありました。これらのケースの一部では，お客様がいくつかのレジストリ・キーを再適用する必要がありました。

• 一部のケースで，オブジェクト・リポジトリのオブジェクトの強調表示が機能しないことがありました。

• OpenText Functional Testing のユーザ・インタフェースで，テスト実行のステップごとの進行状況が明確に表示されず，停止したように見えることがありました。

• オブジェクトが識別できない場合，ステップは失敗し，見つからなかったオブジェクトがレポートに示されます。一部のケースで，レポートにテスト・オブジェクトの階層内のオブジェクトの 1 つが示されているものの，見つからないオブジェクトが示されていないことがありました。

Object Model Reference の次の変更により，従来の UIA Pro アドインと機能拡張されたベータ版アドインを切り替える際に，テストの調整が必要になる場合があります。

機能拡張されたベータ版アドイン：

• WaitForInputIdle メソッドが，ウィンドウがアイドル状態であるか，またはタイムアウトが経過したかを示すブール値を返します。従来のアドインでは，このメソッドは値を返しませんでした。

• GetSupportedPatterns メソッドが，配列ではなくパターンのコレクションを返します。したがって，スクリプトで UBound(<戻り値>) を使用していた場合は，<戻り値>.Count に置き換えてください。

• ToString メソッドが，従来のアドインとは若干異なる値を返す場合があります。

  たとえば， UIAProProgressBar.ToString メソッドが文字列 ProgressBarTO progressbar を返しますが，従来のアドインでは，追加のスペースを含む文字列  ProgressBarTO progress bar を返します。

• 次のメソッドが列挙文字列を返しますが，従来のアドインでは数値を返します。

  GetExpandCollapseState，GetRole，GetState，GetPrimaryTraversalDirection，GetSupportedSelectionMode，GetToggleState，GetWindowInteractionState，GetWindowVisualState。

  詳細については，『Object Model Reference』の「UIA Pro」セクションを参照してください。

• Activate および ActivateCell メソッドの代わりに，DoubleClick および DoubleClickCell メソッドを使用できます。Activate メソッドは，後方互換性のために引き続きサポートされています。

• アプリケーションから取得したプロパティ値の先頭と末尾のスペースは切り捨てられなくなりました。これは，オブジェクトをスパイする場合や，テスト・オブジェクト・メソッドを使用してプロパティを取得する場合に当てはまります。
  

  テスト・オブジェクトがオブジェクト・リポジトリに追加された場合は，必須プロパティの先頭と末尾のスペースは引き続き切り捨てられることに注意してください。

• ツールヒント・オブジェクトは，UIAProToolTip テスト・オブジェクトとして正しく識別されます。従来の UIA Pro では，これらは一般的な UIAProObject として識別されていました。

1. OpenText Functional Testing が閉じていることを確認します。

2. 管理者として，<Installdir>\dat\DisableLegacyUIAPro.bat バッチ・ファイルを実行します。

標準設定の UIA Pro アドインの機能に戻すために，標準設定のアドインをオンにする。

1. OpenText Functional Testing が閉じていることを確認します。

2. 管理者として，<Installdir>\dat\EnableLegacyUIAPro.bat バッチ・ファイルを実行します。

UIA Pro テスト・ステップでパラメータ値を入力するときは，列挙文字列ではなく整数値を使用してください。

UI Automation アプリケーションには，深いオブジェクト階層構造が存在することがよくあります。このアドインは，含まれるオブジェクトへのアクセスが制限されています。

オブジェクト認識センターには，スパイした UIA Pro オブジェクトについて限られた階層のみが表示されます。全体の階層を表示するには，オブジェクト・スパイを使用します。

実行セッション中に取得されたオブジェクトでは，ほとんどの共通メソッドとプロパティがサポートされていません。

OIC では，オブジェクトのスパイ，強調表示，オブジェクト・リポジトリへの追加のみが行えます。

［オブジェクトの認識］ダイアログ・ボックスにリストされているプロパティに基づいて，テスト・オブジェクトの記述が作成されます。ただし，OIC ではどのプロパティが含まれているかは示されず，チェックボックスを使用して選択内容を変更することもできません。

オブジェクト・スパイの使用時には，次の既知の問題が発生します。

• テストが開かれていないオブジェクトをスパイすると，テスト・オブジェクトのアイコンが表示されない。

• ［比較］機能がサポートされていない。

次のメソッドは，UIA Pro テスト・オブジェクトではサポートされていません。 

• CaptureBitmap

• GetAllROProperties

• GetAllTOProperties

• Output

• SetSecureValue

実行結果レポートに関連する既知の問題は次のとおりです。

• レポート内の画像が現在サポートされていない。

• エラーが発生すると，CheckProperty および WaitProperty メソッドのレポート・ステップでは，プロパティ値を指定するのではなく，一般的なエラー・メッセージが表示される。

• GetAncestors，GetChildren，および GetDescendants メソッドのレポート・ステップに，テストで指定されていた場合でも記述引数が含まれていない。