You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

このセクションの内容:

概要

ローカル設定ファイルで設定を行うことで、他の Parasoft システムへの接続、エラー レポート、コード作成者の決定、およびその他の機能を実行する方法を指定できます。ローカル設定でパラメーターを定義していて、相当するパラメーターを GUI の [設定] ダイアログ (「チーム間での SOAtest の構成」を参照) でも指定している場合、ローカル設定のパラメーターが GUI のパラメーターを上書きします。ローカル設定によって以下の処理を行うことができます。

  • GUI または手動で指定した設定を DTP に入力し、チーム全体でレポートと環境設定を一元化する。
  • プロジェクトごとに異なる設定を使用する。
  • 必要に応じてチーム全体の設定を拡張したり上書きしたりする (たとえば、ローカル パスに関連する設定など)。
  • GUI を開かずに設定を変更する。
  • チーム全体で環境設定を共有し、プロジェクトとテスト実行ごとに異なる設定を適用する。 

ローカル設定の定義

ローカル設定は .properties 構成ファイルで定義されます。単純なテキスト ファイルに設定を記述する。各設定を 1 行で記述します。名前と場所の要件はありません。1 つの設定を 1 行で入力します。

また、「GUI からローカル設定ファイルへのエクスポート」で説明するように、GUI 設定をエクスポートしてローカル設定ファイルを作成し、必要に応じて変更したり拡張したりすることもできます。

設定での変数の使用

次の変数を設定に使用できます。セッション タグの値にコロン (:) を含めることはできません。

env_var

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

例:

session.id=${env_var:HOME}

project_name

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

例:

build.id=${project_name}

general_project

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

例:

build.id=${general_project}

workspace_name

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

例:

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

config_name

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

例:

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

analysis_type

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

例:

report.mail.subject=${analysis_type} findings

tool_name

ツール名を出力します。

例:

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


使用するローカル設定の指定

ローカル設定は DTP またはローカル ファイルに保存できます。DTP の場合、接続する Parasoft ツールに設定が自動適用されます。ローカル ファイルの場合、設定をコマンドラインで指定できます。 

1 回のテスト実行に対して多層のローカル設定をアクティブにできます。

ローカル設定を保存して適用する方法については、「チーム間での SOAtest の構成」を参照してください。 

注釈

  • 1 つの設定を 1 行で記述します。
  • ローカル設定で指定したパラメーターは、GUI で指定したパラメーターを上書きします。ローカル設定でパラメーターを指定していない場合、GUI のパラメーターが使用されます。
  • DTP で指定されたローカル設定から設定をインポートしていて、その設定を GUI の設定で上書きしたい場合、適切なページで [DTP の設定を使用] チェックボックスをオフにし、手動で設定を行います。
  • テストの実行中にローカル設定の問題が検出された場合、その詳細がコマンドライン出力にレポートされます。
  • サーバー マシンからではなく、開発者/テスターのデスクトップからコマンドライン モードで実行している場合、tasks.clear=false オプションを使って前回の結果を必ず保存するようにしてください。

レポート設定

設定目的
build.id

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

Default: build-yyyy-MM-dd HH:mm:ss

report.active_rules=true|false

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

デフォルト: false

report.archive=true|false

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

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

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

デフォルト: false

report.associations

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

デフォルト: false

report.authors_details

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

デフォルト: true

report.contexts_details

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

デフォルト: false

report.custom.extension

report.custom.xsl.file

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

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

report.developer_errors=true|false

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

デフォルト: false

report.developer_reports=true|false

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

デフォルト: true

report.format=html|pdf|sate|xunit|custom

レポートの形式を指定します。

デフォルト: html

report.generate_htmls=true|false

HTML レポートを生成してローカル ファイル システムに保存するかどうかを指定します。XML レポートは、この設定値に関係なく常に生成されて保存されます。

デフォルト: true

report.graph.cs_start_date=[MM/dd/yy]ある期間にわたって静的解析タスクを記録するトレンド グラフの開始日を指定します。 
report.graph.ue_coverage_start_date=[MM/dd/yy]ある期間にわたってカバレッジを記録するトレンド グラフの開始日を指定します。 
report.graph.ue_start_date=[MM/dd/yy]ある期間にわたってテスト実行の結果を記録するトレンド グラフの開始日を指定します。 
report.location_details=true|false

XML データにファイルの絶対パスを追加するかどうかを指定します。インポート時にデスクトップ インストールにタスクを再配置するには、サーバー インストールでこのオプションをオンにする必要があります。 

デフォルト: false

report.mail.attachments=true|false

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

デフォルト: false

report.mail.cc=[email_addresses]包括的な HTML マネージャー レポートのメール送信先を指定します。[email_addresses] には、メール アドレスをセミコロン (;) で区切って指定する必要があります。この設定は通常、マネージャーまたはアーキテクトにレポートを送信するために使用します。また、チーム メンバーに自動的にレポートが送信されない場合、このオプションを使ってレポートを送信できます。
report.mail.compact=trends|links

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

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

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

report.mail.domain=[domain]レポートの送信に使用するメール ドメインを指定します。
report.mail.enabled=true|false

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

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

デフォルト: false

report.mail.exclude=[email_addresses]レポートを送信しない電子メール アドレスを指定します。コードに対して作業しているがレポートを受信させたくないメンバーがいる場合、そのメンバーにレポートを自動送信するのを防止できます。
report.mail.exclude.developers=true|false

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

デフォルト: false

report.mail.format=html|ascii

電子メールの形式を指定します。

デフォルト: html

report.mail.from=[email_address OR user_name_of_the_same_domain]

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

デフォルト: <global_user_name>

report.mail.include=[email_addresses]開発者レポートを受け取るチーム メンバーのアドレスを指定します。[email_addresses] には、メール アドレスをセミコロン (;) で区切って指定します。この設定は通常、開発者に自動的にレポートが送信されない場合に、開発者にレポートを送信するために使用します (例えば、チームがソース管理システムを使用していない場合などです)。このオプションは、exclude オプションの指定を上書きします。 
report.mail.on.error.only=true|false

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

デフォルト: false

report.mail.port=[port]

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

デフォルト: 25

report.mail.security=[SL| STARTTLS| NONE]使用するセキュリティを指定します。使用するセキュリティを指定します。SSL、STARTTLS、または NONE を指定できます。SSL は Visual Studio では使用できません。
report.mail.server=[server]レポートの送信に使用するメール サーバーを指定します。
report.mail.subject=My New Subject

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

report.mail.subject=SOAtest Report for Project A

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

report.mail.time_delay=[server]

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

デフォルト: 0

report.mail.unknown=[email_address OR user_name_of_the_same_domain]"unknown" に割り当てられたエラー レポートの送信先を指定します。
report.mail.username=[username] report.mail.password=[password] report.mail.realm=[realm]

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

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

report.metrics_details=true|false

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

デフォルト: true

report.setup.problems=top|bottom|hidden

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

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

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

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

デフォルト: bottom

report.suppressed_msgs=true|false

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

デフォルト: false

report.test_params=true|false

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

デフォルト: false

report.test_suites_only=true|false

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

デフォルト: true

report.ue_coverage_details_htmls=[coverage_type]

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

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

LC - 行カバレッジ

session.tag=[name]

結果をラベル付けするために使用するセッション タグを指定します。この値は、Team Server にサマリー結果をアップロードするときに使用されます。 

タグは、解析プロセスの実行中にチェックされるモジュールの識別子です。 異なるモジュールのレポートには、異なるタグを付けるべきです。

デフォルト: ${config_name}

tasks.source.control.details=true|false
ソース管理システムからの情報 (リビジョンやコメント) をレポートに含めるかどうかを指定します。

DTP の設定

設定目的
dtp.autoconfig=true|false

DTP に格納された設定を使って自動設定を有効化します。

デフォルト: false

dtp.enabled=true|false

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

デフォルト: false

dtp.user=[username]DTP ユーザー認証のユーザー名を指定します。
dtp.password=[password]

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

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

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

dtp.context.path=[path] DTP へのパスを指定します。コンテキストパスは、 dtp.server 設定で指定されたホスト名からの相対パスです。この設定は、DTP がホスト サーバーのルート以外の場所にデプロイされている場合にのみ構成する必要があります。これは、組織でリバース プロキシを使用している場合に当てはまります。
report.dtp.publish=trueテスト結果のデータを DTP にパブリッシュするかどうかを指定します。
dtp.server=[host]DTP サーバーのホスト名を指定します。 
dtp.project=[project_name]

結果をリンクする DTP プロジェクト名を指定します。 

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

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

Team Server 設定

設定目的
tcm.server.enabled=true|false

Team Server への接続を有効化/無効化します。 

デフォルト: false

tcm.server.name=[name]Team Server を実行するマシンの名前または IP アドレスを指定します。 
tcm.server.port=[port]

Team Server のポート番号を指定します。

デフォルト: 18888

tcm.server.accountLogin=true|false
tcm.server.username=[username]
tcm.server.password=[password]

Team Server に接続するためにユーザー名とパスワードをサブミットするかどうかを指定します。ユーザー名とパスワードは常に必要なわけではありません。必要かどうかはチームのセットアップによって決まります。 

accountLogin が true の場合、username と password でユーザー名とパスワードをそれぞれ指定します。

なお、これらのプロパティ設定を使用するには、Team Server 側でユーザー名とパスワードの設定を有効にする必要があります。

tcm.server.accountLogin のデフォルト: false

ライセンス設定

さらに詳しい情報と例については、「ローカル設定によるライセンスの追加」を参照してください。

設定目的
soatest.license.use_network=true|false

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

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

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

例: soatest.license.use_network=true

デフォルト: true

license.network.host=[host]

License Server を実行するマシンの名前または IP アドレスを指定します。 

例: soatest.license.network.host=10.9.1.63

license.network.port=[port]

License Server のポート番号を指定します。 

例: soatest.license.network.port=8080

一般的なポート番号は、HTTP/Sの場合は 8443 または 8080、TCP の場合は 2002(デフォルト)です。

license.network.context.path=[path] 

DTP License Server へのパスを指定します。コンテキスト パスは、license.network.host で指定されたホスト名からの相対パスです。 この設定は、DTP がホスト サーバーのルート以外の場所にデプロイされている場合にのみ構成する必要があります。これは、組織でリバース プロキシを使用している場合に当てはまります。

コンテキスト パスの設定は、スタンドアロンの License Server ではサポートされていません。

リバース プロキシ サーバーの構成とコンテキスト パスの構成の詳細については、DTP のドキュメントを参照してください。 

license.network.user=[username] 

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

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

例: license.network.user=JohnDoe

license.network.password=[password] 

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

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

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

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

license.network.use.specified.server=[true|false]

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

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

true に設定し、license.network.connection.type 設定でライセンス ネットワーク接続タイプを指定します。SOAtestは、license.network.host および license.network.port 設定で指定されたサーバーからライセンスを取得します。 

license.network.connection.type=[http|tcp]

このオプションは、DTP/License Server に HTTP 経由で接続するか TCP 経由で接続するかを指定します。 セキュア ポート (SSL) を介した HTTP を推奨します。  

デフォルトは http です。

license.network.auth.enabled=[true|false] 

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

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

soatest.license.network.edition=[edition_name]

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

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

例:

soatest.license.network.edition=desktop_edition

soatest.license.network.edition=server_edition

デフォルト: custom_edition

soatest.license.autoconf.timeout=[seconds]

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

デフォルト: 20

soatest.license.local.password=[password]

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

soatest.license.wait.for.tokens.time=[time in minutes]

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

例:

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

デフォルト: 0

テクニカル サポートの設定

設定目的
techsupport.auto_creation=true|false

テストの問題が発生したときに、テクニカル サポート アーカイブを自動的に作成するかどうかを指定します。

デフォルト: false

techsupport.send_email=true|false

テクニカル サポート アーカイブを Parasoft サポートに送信するかどうかを指定します。true を指定する場合、GUI または レポート設定 で必ず電子メールの設定を行ってください。

デフォルト: false  

techsupport.archive_location=[directory]テクニカル サポート アーカイブを保存する場所を指定します。
techsupport.verbose=true|false

テクニカル サポート アーカイブに詳細ログを含めるかどうかを指定します。なお、ロギング システムにカスタム コンフィギュレーションがある場合、このオプションを true にすることはできません。詳細ログは、一時フォルダーの xtest.log ファイルに保存されます。

  • Windows:
    • <USER>\AppData\Local\Temp\parasoft\techsupport
  • macOS では、ランダム パスが生成されます。
    • var/folders/<PATH>/<USER>/parasoft/techsupport
  • Linux:
    • /tmp/<USER>/parasoft/techsupport

詳細ログの状態は、セッションを越えて保持され、アプリケーションの起動時に復元されます。

ログ ファイルは、一定のサイズ以上に大きくなることはありません。最大サイズに達するたびに、バックアップが作成されます。

デフォルト: false

techsupport.verbose.scontrol=true|false

ソース管理コマンドからの出力を詳細ログに含めるかどうかを指定します。出力にソース コードの一部が含まれることがあります。  

デフォルト: false

techsupport.item.general=true|false

一般的なアプリケーション ログを含めるかどうかを指定します。

デフォルト: false

techsupport.item.environment=true|false

環境変数、JVM システム プロパティ、プラットフォームの詳細、その他のプロパティ (メモリなど) をテクニカル サポート アーカイブに含めるかどうかを指定します。

デフォルト: false

techsupport.advanced=true|false

拡張オプションを有効にするかどうかを指定します。

デフォルト: false

techsupport.advanced.options=[option]テクニカル サポートから入力を求められた拡張オプションを指定します。

作成者とスコープの設定

設定目的
authors.mappings.location=team|local|shared

作成者マッピング ファイルを保存する場所を指定します。local または shared を指定しない限り、この設定のデフォルトは team です。

local (推奨) を指定した場合、作成者マッピングは直接ローカル設定で設定されます。詳細については authors.mapping および authors.user{n} を参照してください。詳細については authors.mapping および authors.user{n} を参照してください。

shared を指定した場合、authors.mappings.file オプションを使ってローカル ファイルにマッピングを格納できます。 

team および shared オプションは推奨しません。これらのオプションを使って指定したファイルは、以前に使用した書式であるべきです。

#author to author
user1=user3
user2=user3
#author to email
[email protected]

 デフォルト: team

authors.mapping{n}=[from_user, to_user]

上記で説明したように、 authors.mappings.location=local のための作成者マッピングを指定します。

例:

authors.mappings.location=local
authors.mapping1=baduser,gooduser
authors.mapping2=brokenuser,fixeduser 
authors.mapping3=olduser,newuser 

authors.user{n}=[username, email, full_name]

authors.mappings.location=local のための特定の作成者名と電子メール アドレスを指定します。

例:

authors.user1=dan,[email protected],Dan Stowe
authors.user2=jim,[email protected],Jim White 

authors.mappings.file=[path]

上記の authors.mappings.location=shared の場合に、共有されるファイルを指定します。

例:

authors.mappings.file=/home/user/dev/temp/author_mapping1.txt

authors.ignore.case=true|false

作成者で大文字を小文字を区別するかどうかを指定します。true の場合、David と david は同じユーザーと見なされます。false の場合、 David と david は別のユーザーと見なされます。

デフォルト: false

scope.sourcecontrol=true|false

サポートされるソース管理システムからのデータに基づいてコード作成者を算定するかどうかを指定します。 

デフォルト: false

scope.local=true|false

ローカル ユーザーに基づいてコード作成者を算定するかどうかを指定します。

デフォルト: true

scope.recommended.computation=first|random

「推奨されるタスク」を開発者ごとにどのように選択するかを指定します。以下のモードを設定できます:

random: (デフォルト) ランダムに n 個のタスクが選択されます。

first: 各チーム メンバーに、1 日あたりの最初のタスクが表示されます。

scope.xmlmap=true|false

タスクの割り当てを計算するために、特定のファイルまたはファイル セットに割り当てるタスクを定義した XML ファイルを使用するかどうかを指定します (このマッピングは、GUI で指定した後に XML ファイルに保存できます)。

デフォルト: true

scope.xmlmap.file=[file]特定のファイルまたはファイル セットに割り当てるタスクを定義した XML ファイルの名前を指定します。

ソース管理システムの設定

同じ種類の複数のリポジトリを定義するには

同じ種類のリポジトリを複数定義するには、インデックス ( 1 ~ n) を追加する必要があります。例: 

scontrol.rep1.type=ccase
scontrol.rep1.ccase.vob=/vobs/myvob1

scontrol.rep2.type=ccase
scontrol.rep2.ccase.vob=/vobs/myvob2

1 つのリポジトリだけを定義する場合、インデックスは必要ありません。例:

scontrol.rep.type=ccase
scontrol.rep.ccase.vob=/vobs/myvob1

Git リポジトリ定義プロパティ

プロパティ説明
scontrol.rep.type=gitGit リポジトリ タイプの識別子。
scontrol.git.exec=Git の実行モジュールへのパス。設定しない場合、コマンドはパス上にあると見なされます。
scontrol.rep.git.branch=ソース管理モジュールが使用するブランチの名前。このプロパティを指定しない場合、現在チェックアウトされているブランチが使用されます。
scontrol.rep.git.url=リモート リポジトリ (例 git://hostname/repo.git)
scontrol.rep.git.workspace= ローカルの git リポジトリがあるディレクトリ。

Perforce リポジトリ定義プロパティ

プロパティ説明
scontrol.perforce.exec=外部クライアント実行モジュール (p4) へのパス。
scontrol.rep.type=perforcePerforce リポジトリ タイプの識別子。 
scontrol.rep.perforce.host=Perforce サーバー ホスト。 
scontrol.rep.perforce.port=Perforce サーバー ポート。デフォルト ポートは 1666。
scontrol.rep.perforce.login=Perforce のユーザー名。 
scontrol.rep.perforce.password=パスワード。 
scontrol.rep.perforce.client=P4CLIENT 環境変数またはそれに相当するもので指定されているクライアント ワークスペース名。ファイルがダウンロードできるように、ワークスペースのルート ディレクトリはローカル パスのために構成する必要があります。 

Subversion リポジトリ定義プロパティ

プロパティ説明
scontrol.rep.type=svnSubversion リポジトリ タイプの識別子。 
scontrol.rep.svn.url=Subversion URL はプロトコル、サーバー名、ポートおよび開始リポジトリ パスを指定します (たとえば svn://buildmachine.foobar.com/home/svn)。 
scontrol.rep.svn.login=ログイン名。 
scontrol.rep.svn.password =暗号化していないパスワード。 
scontrol.svn.exec=外部クライアント実行モジュール (svn) へのパス。

Microsoft Team Foundation Server リポジトリ定義プロパティ  

プロパティ説明
scontrol.rep.type=tfsTFS リポジトリ タイプの識別子。 
scontrol.rep.tfs.url=TFS リポジトリの URL (例: http://localhost:8080/tfs)
scontrol.rep.tfs.login =TFS ユーザー名。
scontrol.rep.tfs.password=TFS パスワード。

ファイル エンコーディングの設定

設定目的
fileencoding.mode=default|user|auto

ファイル エンコーディングの指定方法を定義します。 

default: システム プロパティを使用します。

user: 下記の fileencoding.user-encoding を使って、明示的にエンコーディング名を指定します。

auto: fileencoding.auto-language で指定された極東言語のエンコーディングの自動検出を有効にします。

デフォルト: default

fileencoding.user-encoding=<name_of_encoding>

fileencoding.mode=user の場合、エンコーディング名を指定します。 

有効なエンコーディング名は、ASCII-US、 UTF-8、UTF-16、UTF-16LE、UTF-16BE、 または java.nio の canonicalName (正準名) です。 

次の書式で指定します: parasoft-dotNET-[codepagenumber]

fileencoding.auto-language=<language’s numeric_code>

fileencoding.mode=auto の場合、言語の数字コードを指定します。有効なコードは次のとおりです。

  • JAPANESE = 1
  • CHINESE = 2
  • SIMPLIFIED CHINESE = 3
  • TRADITIONAL CHINESE = 4
  • KOREAN = 5

その他の設定

設定目的
report.rules=[url_path_to_rules_directory]

静的解析ルールの HTML ルール ファイルを置くディレクトリを指定します (ルールの html ファイルは、テスト コンフィギュレーションの [静的] タブで [有効なルールの一覧] ボタンをクリックすると、生成されます)。 

デフォルト: none

tasks.clear=true|false

コマンドライン モードでの起動時に、既存のタスクを消去します。既存の結果のロードのために時間がかかるのを防ぎます。 

デフォルト: true

console.verbosity.level=low|normal|high

[コンソール] ビューの冗長レベルを指定します。設定できるオプションは次のとおりです。

low: 現在のステップの名前とステータス (完了、失敗、最新) についての基本情報とエラーを表示します。

normal: テストと解析の最中にレポートされた問題とコマンド行も表示します。

high: 警告も表示します。

デフォルト: low

soatest.custom.rules.dir=[directory]

ユーザー定義ルールを保存する場所を指定します。

soatest.custom.configs.dir=[directory]

ユーザー定義テスト コンフィギュレーションを保存する場所を指定します。

exec.env=[env1; env2; ...]テスト セッションが実行された環境を説明するタグのリストを指定します。タグを使って、OS (例えば Windows、Linux)、アーキテクチャ (例えば x86、x86_64)、コンパイラ、ブラウザーなどを説明できます。これらのタグは完全なテスト セッションを説明します。環境についての説明をさらに追加したい場合は、サービス API によってテスト スイート、テスト、またはテスト ケースのレベルで説明を追加できます。
issue.tracking.tags=[value]

カスタムの課題トラッキング タグを指定します。カンマで区切って複数のタグを指定できます。例:

issue.tracking.tags=@custom,@pr ,@fr

詳細については「コードとテストの関連付けの特定」を参照してください。

parallel.mode=Manual|Auto|Disabled

どのモードをアクティブにするかを決定します。 

  • Auto: SOAtest が並行処理の設定をコントロールします。
  • Manual: ニーズに合わせて並行処理の設定をユーザーが手動で行うことができます。
  • Disabled: 利用できる CPU の中から 1 個だけを使用します。

並行処理の設定の詳細については 「並行処理の設定」を参照してください。

デフォルト: Auto

parallel.max_threads=<number>

同時に実行できる並行スレッドの最大数を指定します。実際の並行スレッドの数は、CPU の数、利用できるメモリ、およびライセンス設定に基づいて決定されます。

デフォルト: [available_processors]

parallel.free_memory_limit=<percentage>

「アプリケーションで利用できるメモリ全体」に占める「低メモリ状況でキープしておく空きメモリの大きさ」の割合をパーセント値で指定します。このオプションは、他のプロセスが空きメモリを必ず使用できるようにするために使用します。

デフォルト: 25

parallel.no_memory_limit=true|false

利用できるメモリに対して (既存のシステム制限を超える) 制限をかけないことを指定します。 

デフォルト: false

SOAtest および Virtualize 固有のオプション

設定目的

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 

scripting.jython.homeJython インストール ディレクトリを指定します。単一のディレクトリでなければなりません。特殊文字をエスケープするには、フォワード スラッシュ (/) またはバックスラッシュ (\) を使用します。
scripting.jython.pathjython.home/Lib ディレクトリ以外の場所にあるモジュールをパスに追加するために使用します。複数のパスを指定できます。特殊文字をエスケープするには、フォワード スラッシュ (/) またはバックスラッシュ (\) を使用します。
scripting.timeout.minutes応答しないスクリプトを停止してエラー メッセージをログに記録するまでのタイムアウト時間を分で指定します。

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

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

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

xml.conversion.data.model.directoriesXML との間で固定長データをどのように変換するかを指定するデータ モデルを登録します。適切なデータ モデルを含むディレクトリ リストをセミコロンで区切って入力します。
browsertesting.chrome_executable_pathChrome の実行可能ファイルへのパスを指定します。 
browsertesting.firefox_executable_path=[path]Firefox の実行可能ファイルへのパスを指定します。
browsertesting.proxy_port=[port]プロキシのポートを指定します。詳細およびヒントについては『SOAtest ユーザーズ ガイド』の「プロキシ設定の詳細」を参照してください。
browsertesting.browser_communication_port=[port]ブラウザー通信ポートを指定します。
browsertesting.startup_timeout=[seconds]SOAtest がブラウザーの起動を待機するのを中止して「タイムアウト」と見なすまでの遅延時間 (秒) を指定します。
browsertesting.user_action_timeout=[seconds]SOAtest がユーザー アクションの待機を中止して「タイムアウト」と見なすまでの遅延時間 (秒) を指定します。
browsertesting.page_load_timeout=[seconds]SOAtest がページのロードを待機するのを中止して「タイムアウト」と見なすまでの遅延時間 (秒) を指定します。

browsertest-
ing.asynchronous_request_timeout=[seconds]

SOAtest が非同期リクエストの待機を中止して「タイムアウト」と見なすまでの遅延時間 (秒) を指定します。
browsertesting.element_timeout=[seconds]SOAtest が要素の待機を中止して「タイムアウト」と見なすまでの遅延時間 (秒) を指定します。
browsertesting.dialog_timeout=[seconds]SOAtest がダイアログのオープンを待機するのを中止して「タイムアウト」と見なすまでの遅延時間 (秒) を指定します。
browsertesting.http_traffic_timeout=[seconds]

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

browsertesting.print_debug_info=true|falseブラウザー機能テスト シナリオの記録中に、実行されたアクションを SOAtest が記録しない場合があります。このオプションを有効にすると、記録中にコンソールにメッセージが出力され、SOAtest が処理したイベントの情報、生成された可能性があるロケーターが表示されます。記録中に例外が発生した場合はその例外も表示されます。

browsertest-
ing.allowable_binary_extensions=[extensions]

指定の拡張子のバイナリ ファイルを Traffic Viewer および出力で使用できます。デフォルトでは、テキスト ファイルだけが使用できます。拡張子のリストをカンマで区切って指定します。

browsertest-
ing.allowable_binary_mimetypes=[mime_types]

指定の MIME タイプのバイナリ ファイルを Traffic Viewer および出力で使用できます。デフォルトでは、テキスト ファイルだけが使用できます。MIME タイプのリストをカンマで区切って指定します。
browsertesting.content_fetch_mode=all.con-tent|non.hidden.iframesアクション前およびアクション後の HTML ビューアーに、非表示フレームのコンテンツを表示するかどうかを指定します。  このオプションの詳細については『SOAtest ユーザーズ ガイド』を参照してください。
security.trust.all.certificates任意の証明書を受け入れることを指定します。証明書が「信頼されていない」ページをロードする場合、このオプションが役立ちます。
security.use.default.java.cacertsJava の信頼された証明書ベンダーの標準リストからの証明書だけを受け入れることを指定します。

Virtualize 固有のオプション

SOAtest および Virtualize 固有のオプション で説明されているオプションも Virtualize に適用されることに注意してください。

設定目的
server.startupVirtualize 起動時にサーバーを自動的に起動するかどうかを指定します。
server.port.httpVirtualize サーバーが HTTP の通信に使用するポートを指定します。
server.port.httpsVirtualize サーバーが HTTPS の通信に使用するポートを指定します。
server.port.monitoringVirtualize サーバーがモニタリングに使用するポートを指定します。
traffic.wizard.xpath.ignores

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

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] と入力します。

Continuous Testing Platform (CTP) 固有の設定

設定目的
env.manager.server

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

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

env.manager.server.name

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

例: env.manager.server.name=MyVirtServerLabel

env.manager.notify

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

例: env.manager.notify=true

env.manager.username

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

例: env.manager.username=me

env.manager.password

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

例: env.manager.password=12345

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

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

ローカル設定の例

例 1


例 2

# Team Server settings
tcm.server.enabled=true
tcm.server.name=teamserver.mycompany.com
tcm.server.port=18888
tcm.server.accountLogin=true
tcm.server.username=tcm_user
tcm.server.password=tcm_pass
 
 
# Mail settings
report.mail.enabled=true
report.mail.server=mail.mycompany.com   
report.mail.domain=mycompany.com   
report.mail.cc=project_manager   
report.mail.subject=Coding Standards 

例 3

# REPORTS
 
#Determines whether reports are emailed to developers and to the additional recipients specified with the cc setting.
#Remember that if the team is using CVS for source control and each developer's email address matches his or her CVS username + the mail domain, each developer that worked on project code will automatically be sent a report that contains only the errors/results related to his or her work.

report.mail.enabled=true
 
#Exclude developers emails (true/false) 
report.mail.exclude.developers=false
 
# Append developers errors to manager emails (true/false) 
report.developer_errors=true
 
# Send reports to developers (true|false) 
report.developer_reports=true
 
# Append suppressed messages (true|false) 
report.suppressed_msgs=false
 
#Determines where to mail complete test reports.
#This setting is typically used to send reports to managers or architects.
#It can also be used to send reports to developers if developer reports
#are not sent automatically (for example, because the team is not using CVS). 
[email protected]; ${env_var:USERNAME} @domain.com
 
# mail target for unknown developer errors 
[email protected]
 
#Specifies the mail server used to send reports. 
report.mail.server=mail_server.domain.com
 
#Specifies the mail domain used to send reports. 
report.mail.domain=domain.com
 
#Specify mali from 
report.mail.from=nightly
 
#Specifies any email addresses you do not want to receive reports.
#This setting is used to prevent from automatically sending reports to someone that worked on the code, but should not be receiving reports. This setting is only applicable if the team is using CVS for source control and developer reports are being sent automatically.
report.mail.exclude=developer1;developer2
 
# Specifies the subject line of the emails sent.
report.mail.subject= ${tool_name} Report - ${config_name}
 
# Report test params include (true|false) 
report.test_params=true
 
# Team Server
 
#Determines whether the current installation is connected to the Team Server. 
tcm.server.enabled=true
 
#Specifies the machine name or IP address of the machine running Team Server. 
tcm.server.name=team_server.domain.com
 
#Specifies the Team Server port number. 
tcm.server.port=18888
 
tcm.server.accountLogin=true 
tcm.server.username=user 
tcm.server.password=password 
session.tag= ${config_name}
 
# SCOPE
 
#code authorship based on CVS 
scope.sourcecontrol=true
 
#code authorship based on author tag 
scope.author=false
 
#code authorship based on local user 
scope.local=false
 
# LICENSE
 
#override license settings
#soatest.license.autoconf.timeout=40
soatest.license.use_network=true
soatest.license.network.host=license_server.domain.com 
soatest.license.network.port=2222
soatest.license.network.edition=server_edition
 
# SOURCE CONTROL
 
scontrol.rep1.type=cvs
scontrol.rep1.cvs.root=:pserver:developer@cvs_server.domain.com:/home/cvs/scontrol.rep1.cvs.pass=mypassword  
  • No labels