Webアプリケーションコントロール
コントロールは、アプリケーション内のテスト対象の画面要素です。例：テキストボックスやテーブル。このトピックは、Tosca Cloudがサポートするすべての
Webアプリケーションコントロールには、テストで使用できるプロパティもあることに注意してください。詳細なリストについては、Webアプリケーションコントロールのプロパティをご覧ください。
標準コントロール
Tosca Cloudは、
-
汎用GUI（汎用アプリケーション要素）
Web固有のコントロール
このトピックに記載されている標準コントロールのほかに、Tosca Cloud は、以下のコントロールもサポートしています。
コンテナ
コンテナは、コントロールを含むHTMLファイル内の不可視領域です。主に、一連の異なるコントロールを1つとして操作したり、スタイルを設定したりするために使用されます。
Tosca Cloudは、HTMLコード内にDIV、SPAN、あるいはFIELDSETタグが存在する場合、コントロールをコンテナとして識別します。
エディットボックス
エディットボックスは、英数字や記号を入力できる空のフィールド、または事前に入力済みのフィールドです。
Tosca Cloudは、HTMLコード内にINPUTタグが存在する場合、コントロールをエディットボックスとして識別します。
HTMLドキュメント
HTMLドキュメントは、外部のHTMLファイルやスニペットが既存のHTMLフレーム内に埋め込まれたものです。これは主に、メディア、ウィジェット、あるいはWebページ全体などのサードパーティの要素を独自のHTMLアプリケーションに統合あるいは埋め込むために使用されます。
Tosca Cloudは、HTMLフレームコントロールの各エントリをHTMLドキュメントとして識別します。
HTMLフレーム
このタイプのコントロールは、子要素としてHTMLドキュメントコントロールを含みます。
Tosca Cloudは、HTMLコード内にFRAMEまたはIFRAMEタグが存在する場合、コントロールをHTMLフレームとして識別します。
Chromeを使用しており、ローカルWebサイトのCookieを保存したい場合は、--enable-file-cookiesパラメータを使用してください。
数値
Tosca Cloudは、HTMLコード内にINPUTタグが存在し、属性Typeの値がnumberである場合、コントロールを数値として識別します。
プッシュボタン
プッシュボタンは、HTMLファイル内のクリック可能なボタンです。通常は、アクションをトリガーします。
Tosca Cloudは、次のいずれかに該当する場合、コントロールをプッシュボタンとして識別します。
-
HTMLコード内にBUTTONタグが存在する。
-
HTMLコード内にINPUTタグが存在し、属性TYPEの値がSUBMIT、RESET、BUTTON、またはIMAGEである。
テクニカルアクションモードPushは、DOMクリックを実行した後、指定されたFireEventsを実行することに注意してください。
ShadowDOM
Tosca Cloudは、Google Chrome、Microsoft Edge Chromium、およびMozilla FirefoxにおけるオープンモードおよびクローズドモードのShadowDOMをサポートしています。これらは、HTMLフレームと同様に操作します。
ウィンドウ
ウィンドウはブラウザで開いているウィンドウを表示します。
Tosca Cloudは、HTMLコード内にWINDOWタグが存在する場合、コントロールをウィンドウとして識別します。
その他の操作オプション
このセクションでは、Webアプリケーションコントロールを自動化するための追加オプションについて説明します。
設定パラメータ DisableGetElementById
このパラメータは、同じIDを持つ複数のコントロールが確実に検出されるようにするのに役立ちます。2つ以上のコントロールが同じIDを共有している場合、Tosca Cloud はスキャン中にこのパラメータを自動的に生成します。Tosca Cloud は、最初のモジュール属性を除くすべてのモジュール属性にこのパラメータを追加します。デフォルト値はTrueです。
ステアリングパラメータ FireEvent
このトピックに記載されているすべてのコントロールタイプにステアリングパラメータFireEventを追加できます。これを行うには、Valueフィールドに接頭辞onを付けずにイベントハンドラを指定します。例えば、onclickの代わりにclickという値を指定します。大文字と小文字が区別されることに注意してください。
アクションモードInputは、常にビジネスベースのコントロールのデフォルト操作を使用してイベントをトリガーします。
複数のイベントを追加するには、セミコロンで区切ります。例えば、change;blurなどです。
イベントの可用性は、実装されたコントロールによって異なります。HTMLイベントに関する詳細情報は、こちらのW3Schoolsのページをご覧ください（新しいタブで開きます）。
ステアリングパラメータ FireEventMethodIE
Internet Explorerで開き、Microsoft固有のメソッドAttachEventを使用するアプリケーションの場合、パラメーターFireEventに加えて、ステアリングパラメータFireEventMethodIEを追加する必要があります。
パラメータFireEventMethodIEには、以下の値を指定できます。
|
値 |
説明 |
|---|---|
|
なし |
値を指定しない場合、DispatchEventがトリガーされます。DispatchEventが利用できない場合は、FireEventがトリガーされます。 |
|
FireEvent |
FireEventsをトリガーします。 |
|
DispatchEvent |
DispatchEventをトリガーします。 |
|
FireEvent + DispatchEvent |
FireEventをトリガーし、続けてDispatchEventをトリガーします。 |
|
DispatchEvent + FireEvent |
DispatchEventをトリガーし、続けてFireEventをトリガーします。 |
ステアリングパラメータ SyncStateInteractive
デフォルトでは、Tosca Cloudは読み込みステータスdocument.readyStateがcompleteであるWebサイトのみを操作します。読み込みステータスがinteractiveであるWebサイトも操作するようTosca Cloudに指定できます。これを行うには、ステアリングパラメータSyncStateInteractiveを追加し、その値をfalseに設定します。
あるいは、SyncStateInteractiveをテストケースパラメータとして定義することも可能です。
パラメータSyncStateInteractiveは、Internet Explorerで実行するテストでのみ機能します。
ステアリングパラメータ AllowedAriaControls
テスト実行中にTosca Cloudが対話するARIA要素を指定します。
Tosca Cloudは、IgnoreAriaControls設定の構成に基づいて、新しいモジュールにステアリングパラメータAllowedAriaControlsを自動的に追加し、その値を設定します。
AllowedAriaControlsは、ステアリングパラメータまたはテストケースパラメータとして定義できます。
ステアリングパラメータ IgnoreAriaControls
テスト実行中にTosca Cloud がすべてのARIA要素または特定のARIA要素を無視するかどうかを指定します。
ARIAサポートの拡張に伴い、モジュールの機能を確保するためにAllowedAriaControlsパラメータを使用してTosca Cloudが無視するARIA要素を指定することをお勧めします。
IgnoreAriaControlsパラメータは、AllowedAriaControlsパラメータで指定されたコントロールを上書きします。
IgnoreAriaControlsは、ステアリングパラメータまたはテストケースパラメータとして定義できます。
ステアリングパラメータ EnableSlotContentHandling
ステアリングパラメータEnableSlotContentHandlingを追加して、コントロールを割り当てられたスロット要素の子として表示するかどうかを指定します。
Tosca on-prem2023.2以前からアップロードしたモジュールではこのステアリングパラメータは表示されず、Trueに設定されていることに注意してください。DOM構造の通りにコントロールを表示したい場合は、手動でステアリングパラメータEnableSlotContentHandlingを追加し、Falseに設定してください。
プロパティ IsSteerable
テクニカルプロパティIsSteerableは、それぞれのコントロールで別途指定されていない限り、そのコントロールがTosca Cloudで操作可能かどうかを定義します。
技術的な観点からは、Tosca CloudはプロパティCurrentStyle.DIsplayがnone以外を持っているか、およびプロパティCurrentStyle.Visibilityがhidden以外の値を持っているかを検証します。
CSSスタイルプロパティ
CSSスタイルプロパティ（style_で始まるプロパティ）を使用してHTML要素を識別できます。
コントロールのスタイルプロパティを読み込むには、スキャン中にコントロールを選択します。Moreボタンを選択し、次にLoad allを選択します。
また、アクションモードVerify、WaitOn、およびBufferを使用してCSSスタイルプロパティを操作することもできます。
入力コントロールの特別なフォーマット
一部の入力要素には特別にフォーマットされたデータが必要です。
|
type属性の値 |
データ型 |
期待されるフォーマット |
例 |
|---|---|---|---|
|
日付 |
文字列 |
yyyy-MM-dd |
2012-03-20 |
|
時刻 |
文字列 |
HH:mmまたはHH:mm:ssまたはHH:mm:ssSSS |
20:15または20:15:03 |
|
日時-現地 |
文字列 |
yyyy-MM-ddTHH:mm |
2012-03-20T20:15 |
|
月 |
文字列 |
yyy-mm |
2012-03 |
|
週 |
文字列 |
yyyy-Www |
2013-W04 |
|
カラー |
文字列 |
#<hexadecimal color code> |
#45AE3B |
|
range |
文字列 |
任意の数 マシンのローカライゼーションに準拠した小数点セパレータを使用してください。 |
3または3.14または31.4E-1 |
時間に関連するコントロール（date、time、datetime-local、またはweek）を空の値で操作する場合、Tosca Cloud はHTML要素の値をクリアします。
隠し入力フィールド
隠し入力要素の内容は変更できません。隠し入力要素とは、属性typeがhiddenである入力要素のことです。
マウスなしでの左クリック
{CLICK}を使用して、すべてのHTMLコントロールに対して左クリックを行うことができます。この場合、Tosca Cloud はマウスを使用して左クリックを実行します。
あるいは、マウスなしで左クリックを実行することもできます。マウスなしの場合、通常、より安定しており、テストのパフォーマンスを向上させ、マシンがロックされていてもTosca Cloudがクリックを実行できるようにします。
以下のオプションのいずれかを選択してください。
-
ボタン、ラジオボタン、およびコンテナに対してxを使用して左クリック操作を実行する。これにより、コントロールがアクティブかどうかを検証してから、マウスなしで左クリックを実行するようTosca Cloudに指示します。
-
すべてのHTMLコントロールに対して、{Invoke[Click]}で左クリック操作を実行する。これにより、マウスなしでに直ちに左クリックを実行するようTosca Cloud に指示します。
他のテーブルからのテーブルヘッダー
デフォルトでは、テーブルにはステアリングパラメータHeaderRowおよびHeaderColumnがあります。しかし、これらのステアリングパラメータをオーバーライドして、他のテーブルのヘッダー行や列を使用してテーブルをカスタマイズすることができます。別のテーブル（ヘッダーテーブルと呼びます）に属するヘッダーを指定するには、次の手順に従います。
-
ヘッダーテーブルと、ヘッダーを追加するテーブル（ターゲットテーブルと呼びます）をスキャンします。
-
ターゲットテーブルに移動し、HeaderTableという名前のステアリングパラメータを追加します。パラメータの値として、ヘッダーテーブルのUniqueIdを入力します。
-
ターゲットテーブルからステアリングパラメータHeaderRow、HeaderColumn、RowCount、ColumnCount、ColumnNumber、RowNumber、RawColumnNumber、およびRawRowNumberを削除します。
また、以下の点に注意してください。
-
ヘッダーテーブルには、アクションモードSelectを使用してください。
-
位置決め。ヘッダー行または列は、ヘッダーテーブルで割り当てられているインデックスに入ります。例えば、ヘッダーテーブルのHeaderRowが2の場合、ヘッダーはターゲットテーブルの2行目として表示されます。インデックスがターゲットテーブルの行数または列数を超える場合、ヘッダーは最後の行または最後の列として表示されることに注意してください。
-
UniqueIdの変更の可能性。Tosca on-premからアップロードすると、テストアーティファクトのUniqueIdが変更されます。Tosca on-premからアップロードするたびに、ステアリングパラメータHeaderTableを適合させる必要があります。