RanoreXPath の例

この章では、特定のシナリオにおける RanoreXPath 式の詳細な例を説明します。

テストの定義

このセクションのすべての例は、Ranorex Studio Demo Application を使用しています。ほとんどの例で、このアプリの UI-element test area タブを使用しています。

Ranorex Studio Demo Application のダウンロード

以下のリンクからダウンロードできます。

シンプルなボタンの識別と RanoreXPath の汎化

ここでは、ユーザー インターフェースでシンプルなボタンを識別してから、対応する RanoreXPath 式が任意のボタンにマッチするように汎化します。

Ranorex Spy で、Demo Application の UI-element test are にある、Exit ボタンをトラッキングします。

トラッキング後の Spy の表示は、以下のようになります。

RanoreXPath の汎化

RanoreXPath の汎化は、詳細度を下げ、堅牢性を向上させることを意味します。

今回の例では、Exit ボタンが、button ロールによってのみ識別されるよう、RanoreXPath を汎化します。これは、ボタンの属性を削除することでおこないます。Exit ボタンは、要素ツリーのこのレベルにおいて、唯一のボタンであるため、属性を削除しても引き続き正しく識別され、その RanoreXPath は UI の変更に対してより堅牢になります。

Spy で、RanoreXPath 行をクリックし、[@controlname='RxButtonExit'] 属性を削除し、Enter を押下します。

Spy での表示は以下のようになります。

識別属性の変更

UI 要素をトラッキングすると、Ranorex Studio は RanoreXPath を自動的に生成し、その際に、識別に使用する属性も自動的に決定されます。当然のことながら、RanoreXPath で識別に使用する属性は変更できます。

Demo Application の UI-element test area にある、Exit ボタンをトラッキングします。
RanoreXPath 行をクリックし、パス エディターに切り替えます。
変更したい属性があるノード (例えば button ノード) を選択します。
任意の属性を選択/選択解除します。例えば、controlname 属性を選択解除し、代わりに controltext を選択します。RanoreXPath が自動的に変更されます。

ワイルドカード

ワイルドカードによって、RanoreXPath を UI 構造の変化に対してより堅牢にすることができます。

/? (any optional)

Demo Application の UI-element test area 全体をトラッキングします。

Ranorex Spy での表示は以下のようになります。

RanoreXPath の解釈

対象の要素 3 は、ルート要素 1 の子孫の要素であり、必須ではない最大 2 つ (0,1 または 2) の UI 要素 2 が間にあります。

// (any descendants)

UI の中から、”深さ” が分からない要素を識別する必要がある場合があります。any descendants ワイルドカードを使用することで、ルート ノードと最終ノードの間にある、すべての中間ノードを包括できます。

Ranorex Spy のツリー ブラウザーで、以下の RanoreXPath 式を入力します。

Spy での表示は以下のようになります。

/* (any)

識別したい要素の UI での “深さ” が分かっていて、中間ノードが無関係であることが分かっている場合には、RanoreXPath を堅牢にするために、any ワイルドカードが使用できます。

Spy での表示は以下のようになります。

RanoreXPath 式の詳細化

RanoreXPath 式が汎化されすぎていて、識別される UI 要素が多すぎる、あるいは正しくない場合があります。このような場合には、式を詳細化する必要があります。

汎化した RanoreXPath

この例ではまず、非常に汎化された RanoreXPath を作成します。Ranorex Studio Demo Application の UI-element test area タブにある、すべてのボタンを識別します。

Spy で以下の RanoreXPath を入力し、Enter を押下します。

詳細化の最初のステップ

17 個のボタンは明らかに多すぎるため、RanoreXPath を詳細化する必要があります。ここでは、ボタンに属性を追加します。非表示状態ではないボタンのみを識別するために、visible 属性を指定します。

RanoreXPath の最後の部分を以下のように変更し、Enter を押下します。

詳細化の次のステップ

ボタンの数が 2 つ減っただけなので、RanoreXPath をさらに詳細化する必要があります。and 演算子を使用して、さらに別の属性を組み合わせることができます。

RanoreXPath の最後の部分を以下のように変更し、Enter を押下します。

結果

詳細化した RanoreXPath 式によって、2 個のボタンのみが識別されるようになりました。

ツリー位置による UI 要素の選択

RanoreXPath が複数の要素を識別している場合、要素ツリー内の位置を指定することで、要素を選択できます。

Ranorex Spy で以下の RanoreXPath を入力し、Enter を押下します。

Demo Application の UI では、Button 1 が識別されます。