パッケージ	mx.automation
クラス	public class AutomationID
継承	AutomationID Object

Flex のオートメーションフレームワークは、AutomationID クラスを使用して、エージェントが使用できるオブジェクト 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 を作成することによって作成されます。 showInAutomationHierarchy が false に設定されている親はスキップされます。そのような親の子は、次に高い階層にある、showInAuto フラグが true に設定されている親の子と見なされます。 記録中、エージェントはこの AutomationID を保存できます。

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

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

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

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

---