(Adobe® Flex™ 2 プラグイン for Mercury™ Quick Test Pro)
パッケージmx.automation
public class AutomationID
継承AutomationID Inheritance Object

Flex のオートメーションフレームワークは、AutomationID クラスを使用して、QTP が使用できるオブジェクト ID を構築します。AutomationID は多くの AutomationIDParts で構成されています。各パートは階層内のオブジェクトを識別します。AutomationID は、マップの配列の直列化形式を定義します。このクラスを使用すると、階層内の各オブジェクトのプロパティを記述するセグメントを使用して階層を表すことができます。ID の直列化形式は、次のとおりです。
property_1_name{property_1_value property_1_type}property_2_name{property_2_value property_2_type}|property_1_name{property_1_value property_1_type}property_2_name{property_2_value property_2_type}

次のような階層を持つ Flex アプリケーションを考えてみます。

Application -- > Accordion -- > HBox -- > Button

ボタンの AutomationID は、アプリケーション用、Accordion 用、HBox 用、および Button 用の 4 つの AutomationIDParts で構成されます。AutomationIDPart は、プロパティ名とそれらの値のテーブルです。プロパティと値の組は、オブジェクトのタイプによって異なります。これらのプロパティと値の組を使用して、オブジェクトを固有に識別できます。

AutomationID は、リーフ子オブジェクトの親階層内を検索し、検出された各オブジェクトの AutomationIDPart を作成することにより作成されます。showInAutomationHierarchyfalse に設定されている親はスキップされます。そのような親の子は、次に高い階層にある、showInAuto フラグが true に設定されている親の子と見なされます。記録中、この AutomationID は QTP に渡されます。QTP はこの情報を解析して、その OR を更新します。

再生中に、オブジェクトを検出するために QTP が AutomationID を提供すると、Display オブジェクト階層は、トップの Application オブジェクトから下に検索されます。各レベルで、最も近い AutomationIDPart に一致する子が、すべての子のリストから選択されます。複数の子が条件に一致する場合は、エラーがスローされます。ユーザーは、一意な automationName を提供することにより、またはオブジェクトを一意なものにする新しいプロパティを識別することにより、この種の競合を解決する必要があります。

QTP では、AutomationID を OR 内に保存することで AutomationID を永続的なものにします。その他のエージェントでは、永続性が必要な場合はオブジェクト情報を保存する必要があります。AutomationID には、オブジェクトをストリング表現に変換し、それを戻すための toString() メソッドおよび parse() メソッドがあります。

IAutomationManager.createAutomationID() および IAutomationManager.resolveAutomationID() メソッドを使用して、それぞれ AutomationID オブジェクトを作成および解決できます。

IAutomationObjectHelper.helpCreateIDPart() および IAutomationObjectHelper.helpResolveIDPart() メソッドを使用して、親の中で、AutomationIDPart に一致する子を識別できます。



パブリックプロパティ
 プロパティ定義
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  length : int
[read-only] この ID 内のパーツの数です。
AutomationID
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
パブリック Methods
 メソッド定義
  
コンストラクタです。
AutomationID
  
ID の先頭にパーツを追加します。
AutomationID
  
ID の末尾にパーツを追加します。
AutomationID
  
この ID を別の ID と連結します。
AutomationID
  
このオブジェクトと、指定された AutomationID を比較します。
AutomationID
 Inherited
指定されたプロパティがオブジェクトに定義されているかどうかを示します。
Object
  
ID に追加パーツがあるかどうかを示します。
AutomationID
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
  
[static] ストリングを解析して ID を返します。
AutomationID
  
ID 内の最初のオブジェクトを返します。
AutomationID
  
ID 内の最後のオブジェクトを返します。
AutomationID
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
  
この ID から最初のオブジェクトを削除します。
AutomationID
  
この ID から最後のオブジェクトを削除します。
AutomationID
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
  
ID を直列化してストリングにします。
AutomationID
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
プロパティの詳細
lengthプロパティ
length:int  [read-only]

この ID 内のパーツの数です。

実装
    public function get length():int
コンストラクタの詳細
AutomationID()コンストラクタ
public 関数 AutomationID()

コンストラクタです。

メソッドの詳細
addFirst()メソッド
public function addFirst(p:AutomationIDPart):void

ID の先頭にパーツを追加します。

パラメータ
p:AutomationIDPart — プロパティのマップです。
addLast()メソッド 
public function addLast(p:AutomationIDPart):void

ID の末尾にパーツを追加します。

パラメータ
p:AutomationIDPart — プロパティのマップです。
concat()メソッド 
public function concat(other:AutomationID):AutomationID

この ID を別の ID と連結します。新しい ID を返し、このインスタンスは変更しません。

パラメータ
other:AutomationID — 連結する ID です。

戻り値
AutomationID — この ID は別の ID と連結されています。
equals()メソッド 
public function equals(other:AutomationID):Boolean

このオブジェクトと、指定された AutomationID を比較します。

パラメータ
other:AutomationID — 比較する必要がある AutomationID オブジェクトです。

戻り値
Boolean — 等しい場合は true、等しくない場合は false です。
isEmpty()メソッド 
public function isEmpty():Boolean

ID に追加パーツがあるかどうかを示します。

戻り値
Boolean — ID に追加パーツがない場合は true 、ある場合は false です。
parse()メソッド 
public static function parse(s:String):AutomationID

ストリングを解析して ID を返します。

パラメータ
s:StringtoString() メソッドで提供された ID の直列化形式です。

戻り値
AutomationID — 解析された ID。
peekFirst()メソッド 
public function peekFirst():AutomationIDPart

ID 内の最初のオブジェクトを返します。

戻り値
AutomationIDPart — ID 内の最初のオブジェクトです。
peekLast()メソッド 
public function peekLast():AutomationIDPart

ID 内の最後のオブジェクトを返します。

戻り値
AutomationIDPart — ID 内の最後のオブジェクトです。
removeFirst()メソッド 
public function removeFirst():AutomationIDPart

この ID から最初のオブジェクトを削除します。

戻り値
AutomationIDPart — この ID の最初のオブジェクトです。
removeLast()メソッド 
public function removeLast():AutomationIDPart

この ID から最後のオブジェクトを削除します。

戻り値
AutomationIDPart — この ID の最後のオブジェクトです。
toString()メソッド 
public function toString():String

ID を直列化してストリングにします。

戻り値
String — 直列化された ID です。