この変数は、環境変数の値を指定します。システム環境変数の値を出力するには、閉じ中括弧の前に、コロンそしてシステム環境変数名を記述します。

例:

session.id=${env_var:HOME}

テスト対象プロジェクトの名前を出力します。複数のプロジェクトが入力として渡される場合、テストされるプロジェクトの名前が出力され、その後に省略記号 (...) が続きます。

例:

build.id=${dtp_project}-${time}

結果がリンクされる一般的な DTP プロジェクトの名前を出力します。DTP に接続されている場合にのみ適用されます。 

例:

build.id=${general_project}

ワークスペース名または Visual Studio のソリューション名を出力します。

例:

report.mail.subject=Code Review Scanner Results for ${workspace_name}

実行されるテスト コンフィギュレーションの名前を出力します。レポートとメールの設定にのみ適用されます。

例:

report.mail.subject=Findings from running ${config_name} on the ${project_name}

有効な解析タイプのカンマ区切りリストを出力します (例: Static, Execution).レポートとメールの設定にのみ適用されます。

例:

report.mail.subject=${analysis_type} findings

ツール名を出力します。

例:

report.mail.subject=Tests executed by ${tool_name}

現在時刻を出力します。デフォルトは yyyy-MM-dd です。たとえば次のように書式をカスタマイズできます。

${time:yyyy-MM-dd-HH.mm}

結果をラベル付けするビルド識別子を指定します。ビルド識別子は、各ビルドに対して付ける場合もあれば、指定のビルドで実行された複数のテスト セッションに対して付ける場合もあります。ビルド識別子の最大長は 128 文字です。

デフォルト:  ${dtp_project}-${time:yyyy-MM-dd}

テストで有効に設定されているルールのリストをレポートに含めるかどうかを指定します。

デフォルト: false

指定の場所にアーカイブ ファイル (.zip) を生成します。このアーカイブ ファイルは、レポートを作成するために生成された全ファイルを含みます。 

どのレポート フォーマットでもアーカイブを作成できます (たとえば HTML、CSV、PDF など)。 

アーカイブを生成することで、レポートのカスタム変換も実施できます。なぜなら、すべての要素が指定のフォルダーに生成されるからです。

デフォルト: false

テストに関連付けられた要求、欠陥、タスク、および機能要求をレポートに含めるかどうかを指定します。

デフォルト: false

チーム メンバーごとに割り当てられたタスク タイプの数の概要をレポートに含めるかどうかを指定します。 

デフォルト: true

テスト中にチェックまたは実行されたファイルの概要をレポートに含めるかどうかを指定します。

デフォルト: false

XML カバレッジ レポートのバージョンを指定します。利用可能は値は次のとおりです。

1 - 基本的な (レガシーの) カバレッジ レポート。

2 - 最適化された XML レポート。 

デフォルトは 2 です。

report.custom.extension

report.custom.xsl.file

カスタム レポート形式のための XSL ファイルの場所と拡張子を指定します。report.format=custom と共に使用します。

詳細と例については 「レポート設定」を参照してください。

マネージャー レポートに開発者エラーについての詳細を含めるかどうかを指定します。

デフォルト: false

(管理者に対して HTML サマリー レポートを生成するのに加えて) チーム メンバー全員に対して詳細な HTML レポートを生成するかどうかを指定します。 

デフォルト: true

レポートの形式を指定します。使用可能な形式は、HTML、PDF、SATE、XUnit、およびカスタムです。1 回の実行で複数のレポートを異なる形式で生成するには、カンマ区切りのリストを入力します。Command Line ライセンス機能を有効にしている場合は、指定されたレポート形式に加えて、XML レポートが生成および保存されます。例：

report.format=html,pdf,xunit

デフォルト: html

レポートを添付ファイルとして送信するかどうかを指定します。すべてのコンポーネントが添付ファイルとして含まれます。画像のある HTML レポートを参照するには、すべての添付ファイルをディスクに保存する必要があります。

デフォルト: false

完全なレポートではなく、コンパクト レポートまたはリンクをメールで送信することを指定します。 

trends を設定した場合、トレンド グラフ、概要の表、および他のコンパクト データが電子メールに含まれます。詳細データは含まれません。

links を設定した場合、レポートへのリンクだけが電子メールに含まれます (レポートは DTP 上にあります)。

開発者と cc で指定した送付先に、HTML レポートをメールするかどうかを指定します。 

注意: タスクが割り当てられている各チーム メンバーには、自身のタスクだけを含むレポートが自動送信されます。  

デフォルト: false

report.mail.cc プロパティで明示的に指定されていないチーム メンバーに、レポートを送信するかどうかを指定します。個々のチーム メンバーにレポートを送信するのを防止できます。

デフォルト: false

電子メールの形式を指定します。利用可能な形式は HTML と ASCII です。

デフォルト: html

送信メールの差出人を指定します。

デフォルト: <global_user_name>

タスクが生成された場合または致命的な例外が発生した場合にだけ管理者にレポートを送信するかどうかを指定します。この設定はチーム メンバーへの送信に影響しません。レポートされたタスクに責任があるチーム メンバーにだけメールが送信されます。

デフォルト: false

メール サーバーのポート番号を指定します。

デフォルト: 25

送信する電子メールの件名を指定します。デフォルトの件名は ${tool_name} Report - ${config_name} です。例えば件名を "SOAtest Report for Project A" に変更するには、次のように指定します。

report.mail.subject=SOAtest Report for Project A

デフォルト: ${tool_name} Report - ${config_name}

バルク メールの制限を避けるために、電子メールによるレポート送信間の時間の遅延を指定します。

デフォルト: 0

SMTP サーバー認証の設定を指定します。

realm の設定は、SASL レルムを使って認証するサーバーにだけ必要です。

メトリクスのサマリー レポートを生成するかどうかを指定します。この XML レポートには、メトリクスのサマリー情報だけでなく、可能な場合、個々のクラスおよびメソッドの詳細データも含まれます。メトリクス サマリー レポートが生成されるのは、メトリクスを有効にしたテスト コンフィギュレーションを実行した場合だけです。メトリクスの詳細は HTML および PDF レポートで表示されます。

デフォルト: true

API セキュリティ レポートを CWE または OWASP 2021 Top 10 のどちらでソートするかを指定します。

デフォルト: CWE

静的解析ルールの HTML ルール ファイルを置くディレクトリを指定します。そのパスに基づいて、ルール ドキュメントへのリンクが HTML レポートに追加されます。
ルールの HTML ファイルはツールによって提供されるか、テスト コンフィギュレーションの [静的] タブで [有効なルールの一覧] をクリックして生成できます。

GUI でこの設定を適用するには、.properties ファイルで設定を定義し、[レポートとパブリッシュ] ウィンドウの [オプション ファイル] フィールドにこのファイルへのパスを指定する必要があります。詳細については、「レポートの生成」を参照してください。

例：

report.rules=file:///C:/Temp/Burt/parasoft/xtest/gendoc/
report.rules=../gendoc/
report.rules=file:///<TOOL_INSTALL>/rules/docs/

デフォルト: none

セットアップの問題に関するセクションをレポートに含めるかどうかを指定します。 

top - レポートの先頭に「セットアップの問題」セクションを追加します。これがデフォルトの設定です。 

hidden - レポートに「セットアップの問題」セクションを追加しません。

bottom - レポートの末尾に「セットアップの問題」セクションを追加します。 

デフォルト: bottom

抑制されたメッセージをレポートに含めるかどうかを指定します。

デフォルト: false

レポートにパラメーターの詳細情報を含めるかどうかを指定します。

デフォルト: false

このオプションを有効にすると、テスト スイート サマリー レポート セクションに .tst ファイルだけが表示されます。無効にした場合、 各 .tst ファイル中の個々のテストがツリー形式に似た形式で表示されます。SOAtest のみ。

デフォルト: true

行ごとのカバレッジ詳細情報が付加されたソース コードのレポートに、テストの HTML レポートからリンクするかどうかを指定します。 

[coverage_type] には以下の値を使用できます。

LC - 行カバレッジ

結果をラベル付けするために使用するセッション タグを指定します。セッション タグは、解析プロセス中にチェックされたモジュールの識別子です。異なるモジュールのレポートは、異なるタグでマークするべきです。

デフォルト: ${config_name}

tasks.source.control.details=true|false

DTP に格納された設定を使って自動設定を有効化します。この設定は GUI には適用されず、インポート時には無視されます (その処理については「CLI オプション」ページの -settings または -property を参照してください)。

デフォルト: false

SOAtest/Virtualize を DTP に接続するかどうかを指定します。 

デフォルト: false

DTP ユーザー認証のパスワードを指定します。

認証と安全な接続を確実に行うために、パスワードをエンコードすることを強く推奨します。-encodepass フラグを指定して SOAtest のコマンドライン インスタンスを実行することで、パスワードをエンコードできます。コマンドラインツールは、構成ファイルで使用できるエンコードされた文字列を生成します。 

詳細については「CLI オプション」を参照してください。

結果をリンクする DTP プロジェクト名を指定します。プロジェクトが DTP に存在せず、dtp.user で指定されたユーザーがプロジェクトを作成するための十分な権限を持っている場合、プロジェクトは自動的に作成されます。

全般的なプロジェクトの詳細については「DTP への接続」を参照してください。

デフォルト: デフォルト プロジェクト

アプリケーション カバレッジを有効にするかどうかを指定します。

デフォルト: false

テスト対象のアプリケーションとカバレッジ エージェントがホストされる URL を指定します。プロトコル (HTTP/HTTPS) とポートを含めます。複数のエントリはセミコロン ( ; ) で区切ります。

例: http\://<AGENT_HOST>\:8050;http\://<AGENT_HOST>\:9050

ユーザー ID を指定すると、カバレッジ結果を特定のユーザーに関連付けることができます。ユーザー ID は、カバレッジ エージェントがマルチ ユーザー モードで実行するように設定されている場合にだけ指定するべきです。

詳細については DTP Engine のドキュメントを参照してください。

カバレッジ レポートを DTP にアップロードするかどうかを指定します。複数のカバレッジ エージェントを設定している場合、それらのカバレッジ レポートは DTP 用の 1 つのカバレッジ レポートにマージされます。

デフォルトは、report.dtp.publish の値、または -publish が soatestcli に渡される場合は true です。

テスト対象アプリケーションのスキャン中に除外するバイナリのカンマ区切りパターンを指定します。任意。バイナリの分析には時間がかかり、このオプションを使用しないと、必要以上に多くのバイナリが分析されます。application.coverage.static.file が指定されている場合は使用しないでください。デフォルトでは、すべてのバイナリが受け入れられます。以下のワイルド カードをサポートします。

* は 0 個以上の文字に一致します。

例: *HelpPage*

テスト対象アプリケーションのスキャン中に含めるバイナリのカンマ区切りパターンを指定します。任意。バイナリの分析には時間がかかり、このオプションを使用しないと、必要以上に多くのバイナリが分析されます。application.coverage.static.file が指定されている場合は使用しないでください。デフォルトでは、すべてのバイナリが受け入れられます。以下のワイルド カードをサポートします。

* は 0 個以上の文字に一致します。

例: *qademo_webapp*

dotTEST または Jtest で生成された静的カバレッジ ファイルの URL またはローカル ファイルを .xml または .data 形式で指定します。任意。静的カバレッジ ファイルが個別に DTP にアップロードされる場合は必要ありません。Application.coverage.binaries が指定されている場合は使用しないでください。

詳細については「ユーザー定義テスト コンフィギュレーションを作成する」を参照してください。

例: static_coverage.xml

DTP でカバレッジ イメージを作成するために使用されるタグのセットを指定します。カバレッジ イメージは、同じビルド ID の実行からのカバレッジ データを集約するための一意の識別子です。複数のエントリはセミコロン ( ; ) で区切ります。

詳細については、Parasoft DTP ユーザー ガイドを参照してください。

例: ${dtp_project};${dtp_project}_Functional Test

ランタイム カバレッジ データとテストの関連付けの保存を有効にします。false に設定すると、ランタイム カバレッジ データはどの行がカバーされているかだけを記録し、どのテストケースがどの行をカバーしているかは記録しません。

デフォルト: true

ネットワーク ライセンスを有効/無効にします。

true に設定し、ネットワーク ライセンスを使用するように License Server 設定 (license.network.url) または Parasoft DTP Settings のいずれかを構成します。  

false に設定し、ローカル ライセンスを使用するように soatest.license.local.password 設定を構成します。

例: soatest.license.use_network=true

デフォルト: true

License Server の URL を指定します。プロトコルとホスト名または IP アドレス、および必要に応じてポート番号とコンテキスト パスを含めます。

例: https://10.9.1.63:8443

license.network.url オプションで指定されたセカンダリ DTP サーバーでの認証用のユーザー名を指定します。

このオプションでは、license.network.use.specified.server オプションと license.network.auth.enabled オプションを true に設定する必要があります。

例: license.network.user=JohnDoe

license.network.url オプションで指定されたセカンダリ DTP サーバーでの認証用のユーザー パスワードを指定します。

このオプションでは、license.network.use.specified.server オプションと license.network.auth.enabled オプションを true に設定し、license.network.user を構成する必要があります。

認証と安全な接続を確実に行うために、パスワードをエンコードすることを強く推奨します。-encodepass フラグを指定して SOAtest のコマンドライン インスタンスを実行することで、パスワードをエンコードできます。コマンドラインツールは、構成ファイルで使用できるエンコードされた文字列を生成します。 

詳細については「CLI オプション」を参照してください。

このオプションにより、SOAtest は DTP と License Server のいずれか、または DTP の 2 つのインスタンスに同時に接続できます。

Parasoft DTP Settings で指定された DTP サーバーからライセンスを取得する場合は、false に設定します。 

true に設定すると、SOAtest は license.network.url オプションで指定されたサーバーからライセンスを取得します。 

license.network.url オプションで指定されたセカンダリ DTP サーバーでの認証を有効化/無効化します。

このオプションでは、license.network.use.specified.server オプションを true に設定する必要があります。

soatest.license.network.edition=[edition_name]

LicenseServer から取得するライセンスの種類を指定します。 

[edition_name] は server_edition にできます。カスタム エディションを使用するには、"=" の後に何も指定しないでください (値を空にしてください)。

例:

soatest.license.network.edition=desktop_edition

soatest.license.network.edition=server_edition

デフォルト: custom_edition

License Server からライセンスを自動設定するときのタイムアウト時間を指定します。

デフォルト: 20

Parasoft から提供されたローカル パスワードを指定します。 

現在ライセンスを使用できない場合に、ライセンスを待機する時間を指定します。 

例:

soatest.license.wait.for.tokens.time=3.

デフォルト: 0

OpenID Connect によるユーザー認証を有効または無効にします。

デフォルト: false

OpenID Connect サーバーの URI を指定します。

例: oidc.issuer.uri=http://server.com/

OpenID Connect サーバーによって提供される ID を指定します。

OpenID Connect サーバーに対するアプリケーションのパスワード。

ユーザーの詳細へのアクセスを承認するために認証中に使用されるスコープのスペース区切りのリストを定義します。

デフォルト: openid profile offline_access

OpenID Connect サーバーでのユーザー認証に使用するメソッドを指定します。

デフォルト: devicecode

ユーザー認証情報を含むカスタム トークン ファイルへのパスを指定します。

例: oidc.devicecode.token.file=C:\\parasoft\\token

OpenID Connect サーバーでユーザーを認証するための証明書を格納するキーストアファイルへのパスを指定します。FIPS 承認アルゴリズムのみが許可される場合、キーストアファイルは BCFKS (Bouncy Castle FIPS Keystore) 形式である必要があります。

例: oidc.keystore=C:\\parasoft\\certificates\\client_keystore.jks

OpenID Connect サーバーでの認証に使用するエイリアスを指定します。キーストアファイルに複数のエントリが含まれている場合は、この設定を構成する必要があります。

例: oidc.keystore.alias=myalias

自己署名クライアント証明書を格納するキーストアファイルのパスワードを指定します。認証を確実に成功させ、セキュリティレベルを高めるために、エンコードされたパスワードを使用することを強く推奨します。-encodepass フラグを指定して SOAtest のコマンドライン インスタンスを実行することで、パスワードをエンコードできます。コマンドラインツールは、構成ファイルで使用できるエンコードされた文字列を生成します。 

例: oidc.keystore.password=myPassword0987

datasources.jdbc.classpath=[path1];[path2];[path3] ...

JDBC ドライバーの jar ファイルおよび class フォルダーの場所を指定します。

特殊文字 (空白、スラッシュ、コロンなど) はエスケープする必要があります。たとえば: 

%20 = 空白
%3A = :
%5C = \
%7B = {
%7D = }
%24 = $

複数の jar を指定する場合、\n で区切ります。

たとえば: C:\temp\withspace\${example}\jar.jar

上記のパスは、次のように指定します。

C%3A%5Ctemp%5Cwith%20space%5C$2 4%7Bexample%7D%5Cjar.jar\n 

system.properties.classpath=[path1];[path2];[path3] ...

classpath に含める jar ファイルを指定します。例:

system.properties.classpath=C\:\\myjars\\myLib1.jar;C\:\\myjars\\myLib2.jar

browsertest-
ing.asynchronous_request_timeout=[seconds]

SOAtest がトラフィックの完了を待機するのを中止して「タイムアウト」と見なすまでの遅延時間 (秒) を指定します。

browsertest-
ing.allowable_binary_extensions=[extensions]

browsertest-
ing.allowable_binary_mimetypes=[mime_types]

以下の書式で除外する値を指定します。 

traffic.wizard.xpath.ignores=[element name 1]:[value pattern 1];[element name 2]:[value pattern 2];[element name 3]:[value pattern 3]

たとえば、

traffic.wizard.xpath.ignores=*:[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0- 9]{2}:[0-9]{2}([.][0-9]{1,3})?(([+-][0-9]{2}:[0- 9]{2})|Z)?;uuid:[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}

バックスラッシュ文字 (\) を正規表現で使用するには、エスケープする必要があります。例えば、1 桁を表す正規表現 [\d] であれば、[\\d] と入力します。

CTP サーバーの場所を指定します。必須

例: env.manager.server=http://em_hostname:8080/

CTP でこのサーバーを表示する際の名前を指定します。このサーバーを識別するのに役立つ任意の値を指定できます。任意

例: env.manager.server.name=MyVirtServerLabel

仮想アセットがデプロイされたときに、Virtualize サーバーが CTP に通知するかどうかを指定します。任意

例: env.manager.notify=true

CTP にログインするためのユーザー名を指定します。任意

例: env.manager.username=me

CTP にログインするためのパスワードを指定します。任意

例: env.manager.password=12345

認証と安全な接続を確実に行うために、パスワードをエンコードすることを強く推奨します。-encodepass フラグを指定して Virtualize のコマンドライン インスタンスを実行することで、パスワードをエンコードできます。コマンドラインツールは、構成ファイルで使用できるエンコードされた文字列を生成します。

詳細については「CLI オプション」を参照してください。