サポートされているパラメータ

お 客様は、Tosca Cloudでテストを設定するために、2 種類のパラメータを使用できます。:

  • お客様が定義し、テストケース内の複数のテストステップで再利用できるカスタムパラメータです。カスタムパラメータでは、お客様が任意の名前と値を指定できます。

  • テスト環境に関連する処理など、バックグラウンドで動作する特別なタスクパラメータです。特別なタスクパラメータでは、特定の名前と値を入力する必要があります。

このトピックでは、Tosca Cloudにおけるすべての特別なタスクパラメータを一覧表示します。

パラメータ

テクノロジー

説明

AccessibilityFastMode

Web Automation

アクセシビリティテストのパフォーマンスを向上させます。

設定可能な値:

  • Ignore Passed Checks:「合格」チェックを除外します。その結果、アクセシビリティレポートには比較なしで違反のみが表示されます。これは、大規模なウェブページで特に有用です。

  • Disable Redundant Checks:変更されていない要素の重複分析を回避します。初期分析の後、Tosca Cloud は、分析間で変更された HTML 要素のみにフォーカスします。この機能は、以下の要素の変更を検出することに注意してください:サブツリー、子リスト、属性、文字データ。

  • Optimize AnalysisIgnore Passed ChecksDisable Redundant Checks の機能を使用します。これは、Tosca Cloud が、以前の分析の利点を組み合わせて適用し、新規または変更された HTML 要素のみを確認することで、重複したチェックや既に合格したチェックを回避することを意味します。

  • Off:パフォーマンス向上機能を無効にします。

AllowedAriaControls

Web Automation

テスト実行中にTosca Cloudが相互作用できる ARIA 要素を指定します。

値は、コロンまたはセミコロンで区切られたコントロールのリストです。例:combobox、link、listbox

AvoidExecutionRecorder

All

実行したテストケースの記録を無効にします。

Browser

Web Automation

このテストケースで使用するブラウザーです。デフォルト値はChromeです。

使用可能な値:InternetExplorerFirefoxChromeEdge

Browser<BrowserName>Path

Web automation

The absolute path to the executable file of the browser you want to use.You can use this parameter when you have multiple installations of the same browser on your machine and you want to specify which installation to run with your tests.

To use this parameter, replace <BrowserName> with the browser you use for your test case.You can choose from the following compatible browsers:

  • Chrome

  • Edge

  • Firefox

  • Island

For example: Add the parameter BrowserChromePath to your test case with the value C:\Program Files\TestBrowsers\Chrome\chrome.exe to specify that Chrome runs from that executable, instead of the default installation.

BrowserStack_<CapabilityName>

Web Automation

リモートテスト用の BrowserStack のケイパビリティを指定します。

名前の構文:

  • <CapabilityName> を BrowserStack のケイパビリティに置き換えます。

  • ケイパビリティ名に含まれるピリオドを、二つのアンダースコアに置き換えます。

  • ケイパビリティ名に含まれるコロンを、三つのアンダースコアに置き換えます。

例:Example.name:1 というケイパビリティの場合、BrowserStack_Example__name___1 となります。

BrowserStack のケイパビリティとその値については、BrowserStack のドキュメント(新しいタブで開きます)を参照してください。

BrowserVersion

Web Automation

ブラウザーのバージョンです。

BusyShapes(ビジー状態の形状表示)

All

ビジー状態のときにカーソルがどの形状になるかを定義します。

使用可能な値: AppStartingArrowCrossHandHelpIBeamIconNoSizeSizeAllSizeNESWSizeNSSizeNWSESizeWEUpArrowWait

ControlFramework

Web Automation

Web アプリケーションで使用されているコントロールフレームワークです。

CursorIdleDuration

All

カーソルが元の形状に戻った後に待機する時間(ミリ秒)です。デフォルト値は100です。

DokuSnapperAllPropertiesAvailable

All

テンプレート内でテストケースプロパティをプレースホルダーとして使用できるかどうかを指定します。標準のプレースホルダーよりも多くのカスタマイズ オプションを利用できます。

テンプレート内のプレースホルダーとしてテスト ケース プロパティを使用する場合は、TRUE を選択します。

DokuSnapperEnabled

All

DokuSnapperが有効かどうかを指定します。使用可能な値はTRUE False です。

DokuSnapperを有効にすると、Tosca Cloudが各実行時にすべてのテストケースのレポートを生成します。ドキュメント名は、テストケース名とタイムスタンプで構成されます。

DokuSnapperPath

All

生成されたレポートをTosca Cloud が保存するフォルダー パスです。

DokuSnapperReportFormat

All

DokuSnapper に生成させるレポートのファイル形式を指定します。次の値のいずれかを選択します。

  • PDFドキュメント (.pdf)

  • Wordドキュメント(.docx)

  • Excelドキュメント(.xlsx)Note that Excel reports don't support templates, which means you can't customize .xlsx reports.

DokuSnapperShowBuffersInTables

All

バッファのテストステップを表に表示するかどうかを指定します。

バッファ操作をレポート内のテーブルとして表示するには、TRUEを選択します。

DokuSnapperStorageLocationType

All

レポートの Attachments タブを見つけられるように、Tosca を選択します。

マシン上でテストを実行するために、テストを実行するマシン上で、DokuSnapperPath で指定したフォルダーにドキュメントを保存できるように、Local を選択します。Tosca Cloudがその保存を行います。For that reason, you can't retrieve local reports from a クラウド agent.

DokuSnapperTemplate

All

生成されたドキュメントが基づくテンプレートファイルの絶対パスを指定します。

テンプレートをカスタマイズすることができます。詳細については、Work with templates を参照してください。

以下の前提条件に注意してください。

  • テンプレートには、2行の列を持つテーブルを1つだけ含める必要があります。

  • このドキュメントの右側の列には、さまざまなプレースホルダーを挿入できます。

EnableSlotContentHandling

Web Automation

コントロールを割り当てられたスロット要素の子として表示するかどうかを指定します。

ExampleDirectoryJSON

JSON

テスト実行中に JSON ファイルを保存するために使用されるディレクトリです。

ExampleDirectoryXML

XML

テスト実行中にXMLファイルを保存するために使用されるディレクトリです。

ExcelLanguage

All

計算に使用する言語を、ワークステーションのローカル言語に変更します。

AppiumServer

Mobile

Appiumサーバのアドレスです。

TMAServer

Mobile

Tricentis Mobile Agent のサーバーアドレスを指定します。

ExecuteInParallel

Mobile

CALC を使用した計算に用いる言語です。英語またはローカル言語を選択できます。

ExperitestAccessKey

Mobile

Experitestのアクセスキーです。

ExperitestAppiumVersion

Mobile

ExperitestのAppiumバージョンです。

LiveView

Mobile

スキャンまたはテスト実行中にデバイスの画面を確認する必要がある場合は、Live View 機能を使用します。Live View は、デバイス上で何が起きているかをプレビューできるよう、動的に生成されたスクリーンショットをポップアップウィンドウに表示します。また、スキャン中にデバイスを操作することもできます。

OSVersion

Mobile

次の状況でこのパラメータを追加します。

  • ローカルまたはリモートの iOS シミュレーターを自動化する場合。

  • Androidデバイスの正確な ID を提供したくないが、特定のバージョンの Androidについてテスト自動化をトリガーしたい場合。この場合は、使用している Android オペレーティングシステムのバージョンを入力します。Tosca Cloud は、このパラメータに一致するデバイス上でテストを自動的に実行します。

TapByCoordinates

Mobile

{CLICK} アクションを指定したコントロールでタップをシミュレートしたい場合に、このパラメータを追加します。

{CLICK} アクションに関連するステアリングの問題が発生した場合のフォールバック手段として、このパラメータを使用します。

ScrollToVisible

Mobile

表示されていない要素を TricentisTosca Cloudに自動的にスクロールおよびステアリングさせたい場合は、このパラメータを追加し、値を TRUE に設定します。

UseXBrowserForMobile

Mobile

Mobile の代わりに Web Automation 技術を使用したい場合に、このパラメータを追加します。

Fibermode

Web Automation

テストランの時間を改善します。

FocusOnActivate

Web Automation

ユーザーシミュレートされたキーボードが失敗しないようにします。

HostEnableHeadlessExecution

HOST

ヘッドレスでテストを実行できるようにします。

HostName

HOST

ホストのIPアドレス。

HostPort

HOST

HOSTのポート。デフォルト値は23です。

HostTimeout

HOST

TricentisTosca Cloud と HOST サーバー間の通信に許可される最大時間を設定します。デフォルト値は40000ミリ秒です。

HubAddress

Web Automation

テストケースを実行したいグリッドハブの IP アドレス。

IgnoreAriaControls

Web Automation

テスト実行中にARIA要素を無視します。有効にするには、値を TRUE に設定します。

IgnoreInvisibleTableContent

All

テスト実行中に不可視のテーブル内容を無視するかどうかを指定します。有効にするには、値を TRUE に設定します。

IgnoreWhitespace

All

文字列内の空白を無視するかどうかを指定します。

指定可能な値:NoneLeading onlyTrailing onlyLeading and trailing

MouseDelay

All

HTML アプリケーションでのマウス操作におけるカーソル速度。指定可能な値は 0 から 100 の範囲です。

MouseoverOffsetXAxis

All

カーソルとウィンドウの左側の距離のパーセント。デフォルトでは、カーソルはウィンドウの中央に配置されます。

MouseoverOffsetYAxis

All

ウィンドウ上端からカーソルまでの距離。デフォルトでは、カーソルはウィンドウの中央に配置されます。

MoveMouseOverApplication

All

カーソルの状態を確認する前に、マウスポインターをアプリケーションウィンドウ上にホバーさせるかどうかを指定します。有効にするには、値を TRUE に設定します。

OnDialogFailure

All

Tricentis Tosca Cloud とテスト中のシステムとの相互作用が失敗した場合に、Tricentis Tosca Cloud が実行すべき動作を指定します。

OnExceptionFailure

All

例外が発生した場合に、Tricentis Tosca Cloud が実行すべき動作を指定します

Onlydefaultcomponents

All

実行時には、Tricentis Tosca Cloud のデフォルトコンポーネントのみが使用されます。個別のカスタマイズは考慮されません。

OnVerificationFailure

All

テスト中のシステムが提供した値が指定したテスト値と一致しない場合に、Tricentis Tosca Cloud が実行すべき動作を指定します。

オペレーティングシステム

Web Automation

テストケースを実行したいオペレーティングシステム。

PageSync

All

ブラウザのすべてのAJAXリクエストが処理されるまで、テストランを中止します。有効にするには、値を TRUE に設定します。

PreventUIAChildrenRecursion

UIA

UI 要素の階層構造をナビゲートする際に、無限ループをチェックするかどうかを指定します。

  • TRUE に設定すると、TricentisTosca Cloudが再帰を防ぐための追加チェックを実行します。無限再帰の問題が発生した場合は、この値を使用することを推奨します。

  • Falseに設定されている場合、Tricentis Tosca Cloudはこのチェックを実行しないため、テスト実行が高速化されます。これはデフォルト値です。

ReportSuccessfulExecutionOf

All

TricentisTosca Cloud がテスト結果をログに記録するレベルを定義します。

  • TestSteps:テストステップが成功、失敗、または一時停止した場合に、テストステップレベルで詳細をログに記録します。

  • TestStepValues - All:テストステップが成功、失敗、または一時停止した場合に、テストステップ値レベルで詳細をログに記録します。

  • TestStepValues - Verify onlyアクションモード Verify のテストステップ値に対してのみ動作します。 テストステップが成功、失敗、または一時停止した場合に、Tricentis Tosca Cloudはテストステップ値レベルで詳細をログに記録します。テストステップが失敗した場合、アクションモードが Verify でなくても、Tricentis Tosca Cloudは結果をログに記録します。

  • TestCases:テストケースが成功した場合に、テストケースレベルまで詳細をログに記録します。テストケースが失敗または一時停止した場合、Tricentis Tosca Cloud は、失敗または一時停止したテストステップのテストステップ値レベルの詳細に加えて、その前に成功したすべてのテストステップのテストステップ値レベルの詳細もログに記録します。

RunAccessibilityAnalysis

Web Automation

回帰テストに追加したいアクセシビリティテストの種類を定義します。

設定可能な値:

  • After InputsアクションモードInput の各テストステップの後に、既存の回帰テストと併行してアクセシビリティ分析を実行します。たとえば、入力後の新しい UI 状態を分析するために使用します。

  • Before InputsアクションモードInput の各テストステップの前に、既存の回帰テストと併行してアクセシビリティ分析を実行します。

注意:大規模なテストセットに分析を追加すると、テスト実行時間が長くなる可能性があります。

ScreenFlow(スクリーンフロー)

Web automation、 Mobile

アクションモードが Input のすべてのテストステップ値のスクリーンショットを生成します。

ScreenFlowPath

Web automation、 Mobile

Tricentis Tosca Cloud がスクリーンショットを保存するディレクトリを指定します。

ScrollingBehavior

All

コントロールを操作できるようにするため、画面上のどこに配置するかを定義します:TopBottomCenter(標準)None

Selfhealing

All

テストケースのセルフヒーリング を有効にします。

設定可能な値:WeightedCombination

SelfHealingWeightThreshold

All

適切なコントロールを見つけるためのアルゴリズム組み合わせ数を制限します。デフォルト値は0.75です。

SendKeysDelay

All

ミリ秒単位の遅延を指定します。

IgnoreInvisibleHtmlElements

Salesforce(セールスフォース)

テスト実行中に HTML 要素を無視するかどうかを指定します。有効にするには、値を TRUE に設定します。

Salesforce アプリケーションで可視コントロールのみを操作したい場合、このパラメータを Salesforce のテストケースまたはプレイリストに追加します。

OptimizeForSalesforce

Salesforce(セールスフォース)

テスト実行時間を短縮します。デフォルト値はTRUEです。

SFDC_CPQ

Salesforce(セールスフォース)

CPQ Automationの CPQ オブジェクトを一意に識別するアダプタを有効または無効にします。次のいずれかの値を選択します。

  • True: enable loading of CPQ .dll.

  • False: disable loading of CPQ .dll.

  • Auto(デフォルト):Tricentis Tosca Cloud がオブジェクトを CPQ として識別するかどうかを自動的に判定します。

SFDCConsumerKey

Salesforce(セールスフォース)

Salesforce API に接続しようとしているアプリケーションのClient ID。

SFDCConsumerSecret

Salesforce(セールスフォース)

認証のためのクライアントシークレットです。

SFDCCustomDomain

Salesforce(セールスフォース)

アプリケーションのカスタムドメインです

SFDCPassword

Salesforce(セールスフォース)

Salesforce にサインインするためのパスワードです。

SFDCQuickSearch

Salesforce(セールスフォース)

コントロール識別の速度を向上させ、テスト実行全体のパフォーマンスを改善します。デフォルト値はTRUEです。

SFDCユーザー名

Salesforce(セールスフォース)

Salesforce にサインインするためのユーザー名です。

SfTimeoutForElementLoading

Salesforce(セールスフォース)

Salesforce 要素が読み込まれるまで、Tricentis Tosca Cloudがアクションを実行する前に待機する最大時間を指定します。

SAPTimeout

SAP

SAPが応答するまでの待機時間(秒単位)。

SynchronizationTimeout

All

任意のコントロールを待機する際に、TricentisTosca Cloud が待つ時間(ミリ秒)を指定します。デフォルト値は10000です。

SynchronizationTimeoutDuringWaitOn

All

WaitOn を使用した検証を待機する際に、TricentisTosca Cloudが待つ時間(ミリ秒)を指定します。デフォルト値は20000です。

SyncStateInteractive

All

読み込みステータスが interactive の Web アプリケーションでテストを実行します。有効にするには、値を TRUE に設定します。

TargetDateFormat

All

アプリケーションが受け入れて使用する日付形式です。日付と時刻の値を作成する際に、これを定義する必要がある場合があります。

デフォルト値はddです。MM.yyyy(月.年 形式)

また、入力することも可能です。.NET の日付書式文字列です。…に関する情報については.NET の書式については、Microsoft のドキュメントを参照してください。標準書式(新しいタブで開く)とカスタム書式(新しいタブで開く)が確認できます

TargetDateTimeFormat

All

アプリケーションが受け入れて使用する日付/時刻の形式です。日付と時刻の値を作成する際に、これを定義する必要がある場合があります。

デフォルト値はyyyyMMddHHmmssです。

また、入力することも可能です。NETの日付・時刻形式文字列です。…に関する情報については.NET の書式については、Microsoft のドキュメントを参照してください。標準書式(新しいタブで開く)とカスタム書式(新しいタブで開く)が確認できます

TargetDecimalCharacter

All

アプリケーションの小数点記号。

TargetGroupingCharacter

All

アプリケーションの区切り文字です。

TargetTimeFormat

All

アプリケーションが受け入れ、使用する時間フォーマットです。日付と時刻の値を作成する際に、これを定義する必要があるかもしれません。

デフォルト値は HH:mm です。

また、入力することも可能です。.NET の時間形式文字列です。…に関する情報については.NET の書式については、Microsoft のドキュメントを参照してください。標準書式(新しいタブで開く)とカスタム書式(新しいタブで開く)が確認できます

TBox_Logging_ReportSuccessfulExecutionof

All

テストランログ結果の詳細レベルです。デフォルト値はTestStepValuesAllです。

可能な値: TestCasesTestStepsTestStepValuesVerificationTestStepValuesA

TestCaseRetries

All

テストケースの最大リカバリー試行回数です。

ToscaDateFormat

All

日付や時刻の式で必要になる場合がある、Tricentis Tosca Cloudにおける日付値の形式です。

ToscaDateTimeFormat

All

TricentisTosca Cloudにおける結合された日時値の形式です。

ToscaDecimalCharacter

All

Tosca Cloudにおける小数点記号です。

ToscaGroupingCharacter

All

TricentisTosca Cloudにおける桁区切り記号です。

ToscaTimeFormat

All

Tricentis Tosca Cloudにおける時刻値の形式です。

UIAFasterLists

UIA

テスト実行中に、大きなリストボックスコンボボックスの操作をより高速にします。有効にするには、値を TRUE に設定します。

UseKeyboardLayout

All

仮想マシンや Citrix システムでキーボードコマンドを使用したい場合に重要なパラメータですが、SendKeys や Textinput コマンドが動作しない環境で役立ちます。有効にするには、値を TRUE に設定します。

UserSimulation

All

Input アクションでクリックイベントやキーボードコマンドをトリガーできるようにします。有効にするには、値を TRUE に設定します。

可能なイベント:

  • チェックボックスやラジオボタンの選択/選択解除

  • プッシュボタンを押すこと

  • リンクの選択

  • テキストボックスへの文字入力

WaitingForCursor

All

テストステップを実行する前にTricentisTosca Cloudがカーソルの状態を確認するかどうかを指定します。有効にするには、値を TRUE に設定します。

WebDriver_<CapabilityName>

Web Automation

リモートテスト用の WebDriver の capabilities を指定します。

名前の構文:

  • <CapabilityName> を WebDriver の capability に置き換えます。

  • ケイパビリティ名に含まれるピリオドを、二つのアンダースコアに置き換えます。

  • ケイパビリティ名に含まれるコロンを、三つのアンダースコアに置き換えます。

例:Example.name:1 の capability には、WebDriver_Example__name___1 を使用します。

WebDriver や BrowserStack の capabilities とその値については、WebDriver のドキュメント(新しいタブで開く)または BrowserStack のドキュメント(新しいタブで開く)を参照してください。

WebDriverJson_<ProviderOptionsTag>

Web Automation

リモートテスト用のクラウドプロバイダー固有の capabilities を指定します。

名前の構文:

  • <ProviderOptionsTag> を、お使いのクラウドプロバイダーの options タグに置き換えます。

  • ケイパビリティ名に含まれるピリオドを、二つのアンダースコアに置き換えます。

  • ケイパビリティ名に含まれるコロンを、三つのアンダースコアに置き換えます。

例:BrowserStack の bstack:options タグには、WebDriverJson_bstack___options を使用します。

このパラメータの値は、複数の capabilities を含めることができ、次の構文を使用する JSON 文字列である必要があります

  • 文字列を開始および終了するための中括弧。

  • capability の特定の値を定義するためのセミコロン。

  • capabilities を区切るためのカンマ。

  • 特殊文字をエスケープするための二重引用符。

  • その他の仕様に対する当社の値式(value expressions)

例: "{""userName"": ""<UserName>"", ""accessKey"": ""<accessKey>"", ""browserVersion"": ""136"", ""os"": ""OS X"", ""osVersion"": ""Monterey"", ""acceptInsecureCerts"": true, ""timeouts"": {""implicit"": 10000, ""pageLoad"": 30000}}"」

options タグ、capability 名、そして capabilities の特定の値については、お使いのクラウドプロバイダーのドキュメントを参照してください。

WebDriverProxyAddress

Web Automation

テストケースを実行したいプロキシサーバの IP アドレス。

WebDriverProxyPassword

Web Automation

プロキシサーバーで認証するためのパスワード。

WebDriverProxyUsername

Web Automation

プロキシサーバで認証するためのユーザー名。

WebDriverUserProfilePreference_<PreferenceName>

Web Automation

Chrome、Edge、または Firefox の WebDriver リモートテストに、ブラウザー固有のユーザープロファイル設定を適用します。

名前の構文:

  • <PreferenceName> をブラウザーの preference に置き換えます。

  • ケイパビリティ名に含まれるピリオドを、二つのアンダースコアに置き換えます。

  • ケイパビリティ名に含まれるコロンを、三つのアンダースコアに置き換えます。

例: preference Preference.name:1 に対しては、WebDriverUserProfilePreference_Preference__name___1 を使用します。

preferences とその値の詳細については、使用している Web ブラウザーのドキュメントを参照してください。

WebServiceEngineLogRequestResponse

API

リクエストとレスポンスは、エラーの検索(ログ記録)のために、HTTP メッセージとしてテキストファイルに保存できます。これには、パラメータ WebserviceEngineLogRequestResponse を定義しておく必要があります。

WebServiceEngineResponseTimeout

API

応答のタイムアウトをローカルに設定します。