XModulesのプロパティ

XModulesとXModuleAttributesは、デフォルトのプロパティによって定義されます。加えて、特定のパラメータの使用によっても定義されます。これらのパラメータは、システムと他のコントロールとのやり取りに影響を及ぼすため、関連性があります。パラメータは、 Properties ペインで作成されます。大文字と小文字が区別されることに注意してください。

Tricentis Toscaでは、 Configuration 、 Identification 、 Steering 、 Transition パラメータを区別します。

手作業でパラメータを作成する

新しいパラメータを作成するには、XModuleまたはXModuleAttributeを右クリックし、ミニツールバーから必要なオプションを選択します。

Example XModule のミニツールバーオプション

あるいは、XModuleまたはXModuleAttributeを左クリックし、動的メニューに表示される Modules - Create Object からパラメータを選択します。

構成パラメータ

このパラメータは、コントロールの制御に使用するコンポーネントを定義します。

パラメータ名

説明

有効な値または例

AvoidSnapper

これは、ModulesとModuleAttributesが Doku Snapper（chapter "テストの実行をキャプチャする"）によって記録されることから除外されるかどうかを指定します。

  • TRUE = 記録なし

  • False = 動画を記録する

AlgorithmicAssociation

選択したコンテキストの検索アルゴリズムに使用する特定のパラメータ。

アルゴリズム検索クエリのロジックに従って、コンテキストでターゲットオブジェクトを検索。

  • Items

  • Columns

  • Rows

  • Cells

  • エンジンに固有

BusinessAssociation

Tricentis Toscaの自動化レイヤーに必要な制御情報を含む。Tosca XScan でスキャンするとパラメータを自動的に作成します。

 

ConstraintIndex

実行中にコントロールを一意に識別するインデックス（see chapter "インデックスによってコントロールを識別する"）を指定します。

  • <integer>

CanExecuteInParallel

（Tricentis Data Integrity のみ）

TRUE に設定すると、モジュールをパラレルAgentで実行できます。

このパラメータは、 Tricentisデータ整合性（see chapter "データ整合性テストを並列して実行する"）のコンテキストでのみ DB Expert Module で使用できます。

  • True

  • False

Engine（必須）

エンジンのID

カスタマイズされた拡張機能はIDを割り当て可能。

アセンブリタグ EngineId に対応

  • Html

  • Xml

  • Framework

  • File

ExplicitName

初期設定ではXTestStepValueの名前を変更不可。このプロパティの値が true の場合、参照されるXTestStepValueの名前を変更可。True を使用する代わりに、セミコロンで区切って複数の値を指定することも可能。これらの値は、対応するXTestStepValueから選択可能。

  • true

  • false

  • <value range>

Extension

このパラメータの値として拡張IDを指定可能。各ライブラリの制御ルーチンが使用される。

（これは、アセンブリタグ ExtensionIdに対応）

カスタマイズされた値

ExternalEngine

このパラメータは、画像ベースのテスト自動化（see chapter "モバイルアプリケーション向けの画像ベースのテスト自動化"）で作成した Mobile Engine3.0Modulesに使用します。

ME3.0

IsTBoxModule

モジュールがTBoxモジュール (true) かクラシック (false) かを示す。

  • true

  • false

Parameter

制御レイヤーに使用されるパラメータ

  • true

  • false

SpecialExecutionTask

このパラメータを使用して、例えば xml ファイル（see chapter "埋め込み型SpecialExecutionTasks（XModule）"）を開くなどの特定のタスクを実行できます。

例：

  • ValidateXsd

  • SaveXmlFile

TechnicalAssociation

選択したコンテキストでの検索アルゴリズム用の特定のパラメータ。

オブジェクトの検索時に、テストオブジェクトのプロパティをコンテキストとして直接使用。

エンジンに固有

Transition

テクノロジーやコンテキスト間での移行により、同じTestStep内でさまざまなエンジンを使用可能にする。値は、制御につかう移行名。XPathToXmlElement の値を含む Transition 構成パラメータは、 XPath 移行パラメータを含む。

StringPropertyToXml

XPathToXmlElement

識別パラメータ

識別パラメータは、制御するコントロールの検索に使用するプロパティを決定します。AND-リンクを使用すると、任意の数のパラメータを組み合わせることができる。

パラメータ名

説明

有効な値または例

BusinessID Param

ビジネスIDは、特定のコントロールタイプとともに使用できるプロパティであり、制御対象となるすべてのテクノロジーに共通。

各ボタンにLabelプロパティがあり、各TextBoxに Text プロパティがある。

ReflectedID Param

Toscaの既定値コントロールユニットに含まれていないテストオブジェクトのプロパティを、 Reflection を使用してターゲットテクノロジーから取得可能。前提条件として、各テクノロジーは、反映されたオブジェクトアクセスを適切にサポートする必要がある。

Reflected IDを使用した検索または識別は、ターゲットの膨大な情報を処理する必要があるため、一般的に遅くなりがちです。

XBrowser Engineに関しては、さまざまなブラウザーベンダーのオブジェクトモデルが異なる方法で実装されているため、Reflected IDを使用することでXBrowserの機能を削減できます。

Internet Explorer 9（サポート対象外） のlang 属性

TechnicalIDパラメータ

Technical IDは、Toscaがテクノロジー固有のコントロール用に提供するプロパティ。

HTML入力要素の値、すべてのHTML要素の InnerText 、XML宣言の Encoding など

制御パラメータ

制御パラメータを使用すると、コントロールが制御されている時の動作を指定できます。

パラメータ名

説明

有効な値または例

BringToFront

このパラメータはモジュールレベルでの定義が可能。False に設定すると、テストの実行中にウィンドウが自動的に最前面に表示される設定が無効になる。

デフォルト値 = TRUE

確認アイテムキー

このパラメータは、Vision AI Modules にのみ適用されます。

項目を確認してドロップダウンを閉じるために、Vision AIが入力するキーシーケンスを指定。

詳細情報については see chapter " タイピングのための追加パラメータ"

既定値 = "{Tab}"

DeleteTextKeys

このパラメータは、Vision AI Modules にのみ適用されます。

テストステップの値が空の場合に、Vision AIが入力すべきキーシーケンスを指定します。

詳細情報についてはこちらを参照してください。see chapter " タイピングのための追加パラメータ"

既定値 = "{Delete}"

FocusOnActivate

(XBrowser Engine 3.0 のみ)

このパラメータは、XBrowser Engine 3.0 を使用してMicrosoft Edgeを制御するために、モジュールレベルでの定義が可能。

このパラメータは、ブラウザーのツールバーのコントロールの1つにフォーカスがある時などに、ブラウザーウィンドウをアクティブにした後で現在読み込まれているページにフォーカスを移す必要がある場合に使用可能。

true

false（既定値）

HeaderColumn

システムが行名（see "ヘッダーの定義"）を検索する列を定義します。

既定値 = 1

既定値 = 1

HoldDelay

このパラメータは、Vision AI Modules にのみ適用されます。

Vision AIが入力およびキーの押下を続ける長さの値を、ミリ秒単位で入力。

詳細情報についてはこちらを参照してください。see chapter " タイピングのための追加パラメータ"

既定値 = 0

IgnoreAriaControls

Toscaが実行中にすべての ARIA要素を無視するか、または特定のARIA要素を無視するかを指定します。

互換性およびXBrowserのカスタマイゼーションに問題がある時は、 True 設定を推奨。

Tricentis Tosca 16.0より前に作成されたすべてのモジュールは、制御パラメータが True に設定されており、更新直後の互換性の問題を防止できます。

True

False

コントロールのリストで、コロンまたはセミコロンで区切られています。例えば、コンボ ボックス、リンク、リストボックスなどです。

IgnoreInvisibleHtmlElements

実行中に、非表示のHTML要素をToscaに無視させる場合に指定。

  • 非表示のHTML要素を複数含むページでのパフォーマンスに問題がある時は、 True 設定を推奨。

  • True

  • False

IgnoreInvisibleTableContent

初期設定で、スキャンやテーブル制御を実行すると、非表示のテーブルコンテンツが含まれる。ただし、このパラメータの値が True 設定の場合は無視される。

true

  • false（既定値）

  • KeyDelay

このパラメータは、Vision AI Modules にのみ適用されます。

Vision AIがキーアップまたはキーダウンの各アクション後に待機する長さを、ミリ秒単位で入力。

LoadStrategy

このパラメータは、TableのModuleAttribute レベルで定義が可能。IgnoreSpans に設定すると、エンジンのテーブル読み込みパフォーマンスが向上。

既定値 = IgnoreSpans for:

Database Engine 3.0

SAP Engine 3.0

既定値 = Default（他のすべてのエンジンに共通）

ScanControlNetwork

 

このパラメータは、Vision AI Modules にのみ適用されます。

  • Toscaがコントロールの検出に使用する、サーバー上のニューラルネットワークを定義。

  • 既定値:

v5 ：改善されたネットワーク

他の値:

v4 ：標準ネットワーク（下位互換性用）

ScanOcrNetwork

このパラメータは、Vision AI Modules にのみ適用されます。

  • ToscaがOCRの実行に使用する、サーバー上のニューラルネットワークを定義。

既定値:

  • v3 ：Azure OCR Read v3.2（中速、良好な精度）

他の値:

v4 ：Azure Form Recogniser v3.1（低速、高精度）

v2 ：Azure OCR Read v3.0（下位互換性用）

ScrollingBehavior

  • コントロールを制御するために、画面上のどの位置にコントロールを配置するかを定義。

この機能は、ページのヘッダが制御対象のコントロールと重なってしまう時などに使用。

  • Top

  • Bottom

Center (標準)

なし

SelectTextKeys

  • このパラメータは、Vision AI Modules にのみ適用されます。

  • テストステップの値で指定した値を入力する前にVision AIが入力するキー シーケンスを指定します。

  • 詳細情報についてはこちらを参照してください。see chapter " タイピングのための追加パラメータ"

  • 既定値 = "{Home-Ctrl-Home-Shift-End}"

SendKeysDelay

キーボードコマンドの個々の文字が送信される時間差を指定可能。値はミリ秒単位で指定。

例: 100

SiebelBusyCheck

Siebelページがビジー状態か否か、システムによる確認の無効化が可能。確認を無効にするには、値を False に設定。

true

false

SynchronizationTimeout

Tricentis Toscaがテストオブジェクトが期待される状態に達するまでの待機時間（ミリ秒単位）を指定します。

詳細情報についてはこちらをご確認ください。see chapter "設定 - 同期"

  • <time in ms>

  • 1000

SynchronizationTimeoutDuringWaitOn

Tricentis Toscaがテストオブジェクトが期待される状態に達するまでの待機時間（ミリ秒単位）を指定します。

この設定は、 ActionMode WaitOn のテストステップ専用です。

1000

TreatAs

このパラメータはVision AIモジュールにのみ適用。

Vision AIで制御するを操縦する方法を指定します。

ボタン、セル、チェックボックス、カラム、ドロップダウン、アイコン、入力、リスト、メニュー、パネル、ラジオボタン、行、 スクロールバー、タブバー、テーブル、テキスト、タイトルバー、ツールバー、ツリー、ウィンドウ

UIAFasterLists

（UIA Engine 3,0 のみ）

UIA Engine 3.0 の大規模な ListBoxと ComboBox に関して、実行中の制御を高速化する。

True

False（既定値）

UseDivCenterScrolling

コントロールを自動的に選択する前に、ビューポートの中央にスクロールするかどうかを指定します。

これは、ドキュメントではないスクロール可能な要素に役立ちます。

  • True

  • False (既定値)

ワイルドカードの使用

TBox Delete Bufferモジュールを使用してバッファを削除するためにワイルドカード文字 * を使用するかどうかを指定します。

使用しない場合は False に設定すると、Tricentis Toscaが * をワイルドカードではなく通常の文字として認識します。

  • True

  • False

UserSimulation

ActionModeの Input を使用して、イベントやキーボードのクリックをトリガーできる。

可能なイベント:

  • CheckBoxeやRadioButtonの選択/選択解除

  • PushButtonの押下

リンクの選択

テキストボックスへのテキスト入力

true

  • false（既定値）

  • 値が True に設定されていると、例えばPushButtonをクリックすることで入力を可能にできます

  • WaitAfter

  • このパラメータはModuleAttributeレベルで作成され、コントロールが制御された後の待機時間を指定。

既定値 = 0

WaitBefore

このパラメータはModuleAttributeレベルで作成され、コントロールが制御されるまで（制御前）の待機時間を指定。

時間はミリ秒単位で指定。

テストに待機時間を追加する方法の詳細については、 "ベストプラクティス｜テストケース｜待ち時間" を参照してください。

既定値 = 0

WaitIntermediate
（JavaFXエンジンのみ）

JavaFX Engine 3,0に対する定義が可能。このパラメータはModuleAttributeレベルで作成され、テーブル内のスクロールの待機時間を定義。

待ち時間はミリ秒単位で指定。

既定値 = 130

移行パラメータ

移行パラメータは、テクノロジー間および/またはコンテキスト間の移行を作成します。

パラメータ名

説明

有効な値または例

XPath

XML エンジン3.0 の場合、パラメーター XPath には、ノードの検索に使用される XPath 式が含まれます。パラメーター XPath は、構成パラメーター Transition および値 XPathToXmlElement（see chapter "XPath式によるXML要素の選択"）とともに使用する必要があります。

XBrowser エンジン3.0 およびモバイルエンジン3.0 の場合、パラメータ XPath を使用して、XPath式（see chapter "XPathによるHTML要素の特定"）によって HTML 要素を識別できます。

XPath式

有効な値または例

XPath

XML エンジン3.0 の場合、パラメーター XPath には、ノードの検索に使用される XPath 式が含まれます。パラメーター XPath は、構成パラメーター Transition および値 XPathToXmlElement（see chapter "XPath式によるXML要素の選択"）とともに使用する必要があります。

XBrowser エンジン3.0 およびモバイルエンジン3.0 の場合、パラメータ XPath を使用して、XPath式（see chapter "XPathによるHTML要素の特定"）によって HTML 要素を識別できます。

XPath式