UITestSD 外部オブジェクト

UITestSD 外部オブジェクトを使用すると、Panel オブジェクトなどのユーザーインターフェース (UI) の自動テストを開発できます。

この外部オブジェクトは、最初の UI Test オブジェクトを作成するときにナレッジベースにロードされます。

メソッド

ほとんどのメソッドが受け取るパラメーター

以下に示す (そして UI Test オブジェクトで使用される) メソッドのいくつかは、画面上のテキスト、コントロール名、その他の詳細を示すパラメーターを受け取ります。以下は、ほとんどのメソッドが受け取るパラメーターの一般的な側面です。

controlName

コントロールが定義されている GeneXus オブジェクトのコントロールの名前です ( [ Control Name ] プロパティに表示)。
例: 「&numeric」(変数)、「CustomerName」(項目属性)、「Save」(ボタン)。
注: GeneXus では大文字小文字は区別されないため、重要ではありません。

context

コントロールがあるコンテナを示します。
場合によっては、コントロールの名前のあいまいさをなくす必要があります。たとえば、画面上のコンポーネントの場合、同じ名前のコントロールが 2 つある場合があります。
たとえば、「Grid1」グリッドの 2 行目にある「Button1」というボタンをタップする場合は、次のように記述します:

&app.Tap("Button1", "Grid1.item(2)")   //&app は UITestSD 外部オブジェクトに基づく変数

注:
- context では、コントロールが見つかる場所のパスを定義していますが、パスが完全である必要はありません。たとえば、上の例では、「Button1」ボタンがある場所は「Grid1Table」テーブルの内部でもあるかもしれませんが、それを指定する必要はありません。
- コレクションを表すコントロールの場合 (グリッド、水平グリッド、タブなどのコントロール)、コレクション内のエレメントを「item」で指定できます。
- 事前定義のコンテキスト: 多くの場合、コンテキストは「Grid1」などコントロール名によって異なりますが、コンテキストを事前定義できる場合もあります。アプリケーションバー内のコントロールがその場合に該当します。このために、UITestingContext という名前の列挙型ドメインが定義されています。

UITestingContext 列挙型ドメインの機能

- このドメインは、メソッドのパラメーターの context と同じデータタイプ (VarChar(40)) に基づいています。
- 次の 1 つの値のみを持っています: ApplicationBar (値: "applicationbar")。これは、アプリケーションバーのコンテキストを表します。この context が指定された場合、そこで見つかるエレメントのみが検索されます。
- ApplicationBar のコンテキストが指定されている場合、表示されているエレメントの検索に加え、設計時にアプリケーションバーに配置されたエレメントも検索する必要があります。十分なスペースがないため、エレメントは柔軟なクライアントによってグループ化されていて、見つけるには追加のボタンを押す必要があります。

target

「ターゲット」または「アクションターゲット」とは、以下に対して行われる可能性のあるアクションを指します:

controlName または
画面に表示される任意のテキスト。

注:
- 画面上のエレメントを検索する場合、まず controlName で検索し、見つからなければテキストで検索します。
- 条件を満たすコントロールが複数ある場合は、最初に見つかったものを使用します (非決定性)。

expected

このブール値のパラメーターは、画面上にテキストを期待するかどうかを示します:

True を指定した場合、画面上にテキストを期待しています。テキストが画面上にない場合、テストは失敗します。
反対に、False を指定すると、テキストが画面上にある場合にテストが失敗します。

アクション用のメソッド

Back

Android の場合、デバイスの戻るボタンの操作をシミュレートします。iOS の場合は、戻るためのボタンのタップになります。

Back()

Tap

画面上の指定ポイント (<target>) をタップします。

Tap(<target>  [ , <context> ] )