...
ローカル設定ファイルで設定を行うことで、他の Parasoft システムへの接続、エラー レポート、コード作成者の決定、およびその他の機能を実行する方法を指定できます。ローカル設定でパラメーターを定義していて、相当するパラメーターを GUI の [設定] ダイアログ (「チーム間での SOAtest の構成Configuring Preferences Overview」を参照) でも指定している場合、ローカル設定のパラメーターが GUI のパラメーターを上書きします。ローカル設定によって以下の処理を行うことができます。
...
ローカル設定は .properties 構成ファイルで定義されます。単純なテキスト ファイルに設定を記述する。各設定を 1 行で記述します。名前と場所の要件はありません。1 つの設定を 1 行で入力します。
また、「GUI からローカル設定ファイルへのエクスポート」で説明するように、GUI 設定をエクスポートしてローカル設定ファイルを作成し、必要に応じて変更したり拡張したりすることもできます。
...
1 回のテスト実行に対して多層のローカル設定をアクティブにできます。
ローカル設定を保存して適用する方法については、「チーム間での SOAtest の構成Configuring Preferences Overview」を参照してください。
注釈
- 1 つの設定を 1 行で記述します。
- ローカル設定で指定したパラメーターは、GUI で指定したパラメーターを上書きします。ローカル設定でパラメーターを指定していない場合、GUI のパラメーターが使用されます。
- DTP で指定されたローカル設定から設定をインポートしていて、その設定を GUI の設定で上書きしたい場合、適切なページで [DTP の設定を使用] チェックボックスをオフにし、手動で設定を行います。
- テストの実行中にローカル設定の問題が検出された場合、その詳細がコマンドライン出力にレポートされます。
- サーバー マシンからではなく、開発者/テスターのデスクトップからコマンドライン モードで実行している場合、tasks.clear=false オプションを使って前回の結果を必ず保存するようにしてください。
...
| 設定 | 目的 |
|---|---|
build.id | 結果をラベル付けするビルド識別子を指定します。ビルド識別子は、各ビルドに対して付ける場合もあれば、指定のビルドで実行された複数のテスト セッションに対して付ける場合もあります。 セッションに対して付ける場合もあります。ビルド識別子の最大長は 128 文字です。 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 |
| カスタム レポート形式のための XSL ファイルの場所と拡張子を指定します。 report.format=custom と共に使用します。 詳細と例については 「レポート設定Configuring Reporting Settings」を参照してください。 |
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] | 送信メールの差出人を指定します。 デフォルト: |
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.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 | セットアップの問題に関するセクションをレポートに含めるかどうかを指定します。
デフォルト: 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 にサマリー結果をアップロードするときに使用されます。 タグは、解析プロセスの実行中にチェックされるモジュールの識別子です。 異なるモジュールのレポートには、異なるタグを付けるべきです。 デフォルト: |
tasks.source.control.details=true|false | ソース管理システムからの情報 (リビジョンやコメント) をレポートに含めるかどうかを指定します。 |
...
| 設定 | 目的 |
|---|---|
dtp.autoconfig=true|false | DTP に格納された設定を使って自動設定を有効化します。 デフォルト: false |
dtp.enabled=true|false | SOAtest/Virtualize を DTP に接続するかどうかを指定します。 デフォルト: false |
dtp.user=[username] | DTP ユーザー認証のユーザー名を指定します。 |
dtp.password=[password] | DTP ユーザー認証のパスワードを指定します。 認証と安全な接続を確実に行うために、パスワードをエンコードすることを強く推奨します。 |
dtp.context.path=[path] | DTP へのパスを指定します。コンテキストパスは、 dtp.server 設定で指定されたホスト名からの相対パスです。この設定は、DTP がホスト サーバーのルート以外の場所にデプロイされている場合にのみ構成する必要があります。これは、組織でリバース プロキシを使用している場合に当てはまります。 |
report.dtp.publish=true | テスト結果のデータを DTP にパブリッシュするかどうかを指定します。 |
dtp.server=[host] | DTP サーバーのホスト名を指定します。 |
dtp.project=[project_name] | 結果をリンクする DTP プロジェクト名を指定します。 全般的なプロジェクトの詳細については「Connecting to DTP への接続」を参照してください。 デフォルト: デフォルト プロジェクト |
...
| 設定 | 目的 |
|---|---|
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 | ネットワーク ベースのライセンスを有効/無効にします。
例: デフォルト: |
license.network.host=[host] | License Server を実行するマシンの名前または IP アドレスを指定します。 例: |
license.network.port=[port] | License Server のポート番号を指定します。 例: 一般的なポート番号は、HTTP/Sの場合は 8443 または 8080、TCP の場合は 2002（デフォルト）です。 |
license.network.context.path=[path] | DTP License Server へのパスを指定します。コンテキスト パスは、 コンテキスト パスの設定は、スタンドアロンの License Server ではサポートされていません。 リバース プロキシ サーバーの構成とコンテキスト パスの構成の詳細については、DTP のドキュメントを参照してください。 |
license.network.user=[username] |
このオプションでは、 例: |
license.network.password=[password] |
このオプションでは、 認証と安全な接続を確実に行うために、パスワードをエンコードすることを強く推奨します。 |
license.network.use.specified.server=[true|false] | このオプションにより、SOAtest は「DTP と License Server」または「DTP の 2 つのインスタンス」のいずれかに同時に接続できます。 ローカル設定の指定 で指定された DTP サーバーからライセンスを取得する場合は、
|
license.network.connection.type=[http|tcp] | このオプションは、DTP/License Server に HTTP 経由で接続するか TCP 経由で接続するかを指定します。 セキュア ポート (SSL) を介した HTTP を推奨します。 デフォルトは |
license.network.auth.enabled=[true|false] |
このオプションでは、 |
| LicenseServer から取得するライセンスの種類を指定します。
例:
デフォルト: 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] | 現在ライセンスを使用できない場合に、ライセンスを待機する時間を指定します。 例:
デフォルト: 0 |
...
| 設定 | 目的 |
|---|---|
report.rules=[url_path_to_rules_directory] | 静的解析ルールの HTML ルール ファイルを置くディレクトリを指定します (ルールの html ファイルは、テスト コンフィギュレーションの [静的] タブで [有効なルールの一覧] ボタンをクリックすると、生成されます)。 デフォルト: none |
tasks.clear=true|false | コマンドライン モードでの起動時に、既存のタスクを消去します。既存の結果のロードのために時間がかかるのを防ぎます。 デフォルト: true |
console.verbosity.level=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] | カスタムの課題トラッキング タグを指定します。カンマで区切って複数のタグを指定できます。例:
詳細については「コードとテストの関連付けの特定Indicating Code and Test Correlations」を参照してください。 |
parallel.mode=Manual|Auto|Disabled | どのモードをアクティブにするかを決定します。
並行処理の設定の詳細については 「並行処理の設定Configuring Parallel Processing」を参照してください。 デフォルト: Auto |
parallel.max_threads=<number> | 同時に実行できる並行スレッドの最大数を指定します。実際の並行スレッドの数は、CPU の数、利用できるメモリ、およびライセンス設定に基づいて決定されます。 デフォルト: [available_processors] |
parallel.free_memory_limit=<percentage> | 「アプリケーションで利用できるメモリ全体」に占める「低メモリ状況でキープしておく空きメモリの大きさ」の割合をパーセント値で指定します。このオプションは、他のプロセスが空きメモリを必ず使用できるようにするために使用します。 デフォルト: 25 |
parallel.no_memory_limit=true|false | 利用できるメモリに対して (既存のシステム制限を超える) 制限をかけないことを指定します。 デフォルト: false |
...
| 設定 | 目的 |
|---|---|
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 認証と安全な接続を確実に行うために、パスワードをエンコードすることを強く推奨します。 |
ローカル設定の例
例 1
| Code Block |
|---|
例 2
| Code Block |
|---|
# Team Server settings: (these may be redundant with settings already specified in Team Preferences of the installed version, so may not be needed).
tcm.server.enabled=true
tcm.server.name=<team_server.company.com>
# Report settings
report.developer_errors=true
report.developer_reports=true
report.format=html
session.tag=<project name>
# Mail settings:
report.mail.enabled=true
report.mail.cc=<[email protected];[email protected]>
report.mail.server=mail.company.com
report.mail.domain=company.com
report.mail.subject=<Static Analysis results on Project X>
report.mail.attachments=true |
例 2
| Code Block |
|---|
# Team Server settings tcm.server.enabled=true tcm.server. 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
| Code Block |
|---|
# 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 |