このセクションでは、ローカル設定を指定する方法について説明します。ローカル設定は、レポート の生成、タスクの割り当て、ライセンスといったオプションをコントロールします。ローカル設定を使用すると、チーム全体で設定を共有するだけでなく、プロジェクトやテスト実行ごとに異なる設定を適用することができます。 

このセクションの内容

ローカル設定とは

ローカル設定は、レポート、Parasoft DTP、作成者といった設定を指定でき ます。ローカル設定を使用すると、以下の操作を行うことができます。

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

(info) オプションがローカル設定ファイルと GUI の両方で設定されている場合、ローカル設定ファイルの指定が GUI の設定を上書きします。

ローカル設定の指定と保存

ローカル設定は 2 種類の方法で定義できます。

  • 単純なテキストファイルに手動で設定を記述します。ファイルの名前や場所の要件あはりません。
  • Exporting GUI Preferences to a localsettings File」で説明しているように、 GUI 設定をエクスポートし、必要に応じて変更あるいは拡張します。

    GUI の設定をエクスポートしてローカル設定 (オプション) を作成する

    オプション ファイルを作成する最も簡単で速い方法は、GUI から設定をエクスポートすることです。

    1. [Parasoft] メニューの [設定] をクリックして
    2. 左側のリストから [Parasoft] を選択します。
    3. パネルの右側で [共有] リンクをクリックします。
    4. ダイアログが開いたら、ファイルにエクスポートする設定を指定します。
    5. [参照] ボタンをクリックし、設定を保存するファイルを指定します。
    6. [OK] をクリックします。
      • 既存のファイルを選択した場合、ファイルに設定が追加されます。その他の場合は新規ファイルが作成されます。
      • エクスポートされるパスワードは暗号化されます。

ローカル設定は、Parasoft DTP またはローカルファイルに格納できます。Parasoft DTP の場合、接続する Parasoft Test に設定が自動的に適用されます。ローカルファイルの場 合、設定をコマンドラインから指定することができます。  ローカル設定を保存して適用する方法については、「C++test 環境設定-概要」 を参照してください。 

その他の情報

  • 1 つの設定を 1 行で記述する必要があります。
  • 認証が確実に成功するよう、またセキュリティ レベルを向上させるため、暗号化されたパスワードを使用することを強く推奨します。「暗号化されたパスワードの作成」を参照してください。
  • DTP で指定されたローカル設定から設定をインポートしていて、その設定を GUI の設定で上書きしたい場合、適切なページで [DTP の設定を使用] チェックボックスをオフにし、手動で設定を行います。
  • テストの実行中にローカル設定の問題が検出された場合、その詳細がコマンドライン出力に レポートされます。
  • サーバーマシンからではなく、開発者/テスターのデスクトップからコマンドラインモードで実行している場合、tasks.clear=false オプションを使って、前回の結果が必ず保存さ れるようにしてください。

設定の一覧

レポート設定

設定説明
build.id=[id]

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

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

report.active_rules=true|false

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

デフォルト: false

report.archive=true|false

指定の場所に追加の圧縮アーカイブファイル (.zip) を生成します。ZIP にはレポートをビルドするために生成されたすべてのファイルが含まれます。 

このオプションは任意のレポート フォーマット (HTML、CSV、PDF など) に対してアーカイブを生成できます。 

アーカイブを生成する際、レポートのカスタム変換を行うこともできます。なぜなら、すべての要素はそれぞれ指定された出力先に出力されるからです。

デフォルト: false

report.associations=true|false

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

デフォルト: false

report.authors_details=true|false

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

デフォルト: true

report.contexts_details=true|false

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

デフォルト: false

report.custom.extension

report.custom.xsl.file

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

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

report.developer_errors=true|false

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

デフォルト: false

report.developer_reports=true|false

マネージャー向けの概要レポートに加えて、カスタマイズされた詳細なレポートを個々のチームメンバー向けに生成するかどうかを指定します。 

デフォルト: 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 マネージャーレポートのメール送信先を指定します。メールアドレスをセミコロン (;) で区切って指定する必要があります。 この設定は通常、マネージャーまたはアーキテク トにレポートを送信するのに使用します。また、 チームメンバーに自動的にレポートが送信されない場合 ( チームがサポート対象のソース管理システムを使っていない場合)、このオプションを使ってレポー トを送信できます。
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]開発者レポートを受け取るチームメンバーのアド レスを指定します。メールアドレスをセミコロン (;) で区切って指定する必要があります。 この設定は通常、開発者に自動的にレポートが送信されない場合に、開発者にレポートを送信するために使用します (たとえば、チームがサポート対象のソース管理システムを使用していない場合など)。 このオプションは、exclude オプションの指定を上書きします。  
report.mail.on.error.only=true|false

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

デフォルト: false

report.mail.server=[server]レポートの送信に使用されるメール サーバーを指定します。
report.mail.port=[port]

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

デフォルト: 25

report.mail.security=[SL| STARTTLS| NONE]使用するセキュリティを指定します。SSL、 STARTTLS、または NONE を指定できます。 SSL は Visual Studio では使用できません。
report.mail.subject=My New Subject

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

report.mail.subject=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

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

デフォルト: false

report.test_params=true|false

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

デフォルト: false

report.ue_coverage_details_htmls=[coverage_type]

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

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

LC - 行カバレッジ
SC -ステートメント カバレッジ
BCC - 基本ブロックカバレッジ
DC - f判断文 (Decision) カバレッジ
SCC - 単純条件カバレッジ
MCDC - MC/DC カバレッジ

session.tag=[name]

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

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

デフォルト: ${config_name}

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


Parasoft DTP 設定

設定説明
dtp.enabled=true|false

現行の C/C++test をDTP に接続するかどうかを指定します。

dtp.server=[server]DTP Server のホスト名を指定します。
dtp.port=[port]DTP サーバーのポート番号を指定します。
dtp.user=[username]DTP Server 認証のユーザー名を指定します。
dtp.password=[password]DTP Server 認証のパスワードを指定します。認証が確実に成功するよう、またセキュリティ レベルを向上させるため、暗号化されたパスワードを使用することを強く推奨します。「暗号化されたパスワードの作成」を参照してください。
report.dtp.publish=true|falseDTP サーバーへの結果のレポートを有効または無効にします。
dtp.project=[project_name]結果をリンクする DTP プロジェクトの名前を指定します。
dtp.additional.settings=[KEY1\=VALUE1\nKEY2\=VALUE2...]DTP に結果をレポートするための高度な設定を指定します。
dtp.autoconfig=true|falseDTP サーバーに格納された C/C++test 設定の自動設定を有効にします。

Team Server 設定

設定説明
tcm.server.enabled=true|false

C/C++test を Parasoft 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

ライセンス設定

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

設定説明
cpptest.license.use_network=true|false

ネットワーク ライセンスの取得を有効または無効にします。

例: cpptest.license.use_network=true

デフォルト: true

(info) デフォルトでは、C/C++test は主要な DTP サーバーとして設定された DTP の License Server からライセンスを取得しようとします。「Parasoft DTP の設定」を参照してください。他の License Server を指定するには、license.network.use.specified.server オプションを有効にします。

cpptest.license.local.password=[password]C/C++test が使用するローカル パスワードを指定します。 
cpptest.license.local.expiration=[expiration]

ローカルライセンスの有効期限を指定します。

デフォルト: 0

cpptest.license.network.edition=[edition_name]

C/C++test が License Server から取得するライセンスの種類を指定します。 

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

例:

cpptest.license.network.edition=desktop_edition

cpptest.license.network.edition=automation_edition

デフォルト: custom_edition

cpptest.license.custom_edition_features=[feature name]C/C++test のカスタム エディション ライセンスで有効にする機能を指定します。
cpptest.wait.for.tokens.time=[time in minutes]

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

例えば C/C++test に 3 分間ライセンス トークンを待機させるには、cpptest.wait.for.tokens.time=3. と指定します。

デフォルト: 0

cpptest.license.autoconf.timeout=[seconds]

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

デフォルト: 20

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

license.network.host および license.network.port オプションで指定したカスタム License Server からのライセンス取得を有効または無効にします。

例: license.network.use.specified.server=true

デフォルト: false

license.network.host=[host]

ライセンスを取得するスタンドアロンの License Server、別の DTP サーバー、またはレガシー License Server のホスト名を指定します。license.network.use.specified.server オプションに true を設定する必要があります。

例: license.network.host=jade.mycompany.com

(info) サーバーが HTTPS プロトコルを使用している場合、ホスト名の先頭に https:// を追加します。

license.network.port=[port]

license.network.host オプションで指定された License Server に割り当てられたポート番号を指定します。

  • スタンドアロンの License Server の場合:  Tomcat の設定に依存します (通常、8080 などの HTTP ポートです)
  • 別の DTP の License Server の場合: 通常、443 または 8443 などの HTTPS ポートです。
  • レガシー License Server の場合: 通常、2002 です。

例: license.network.port=2222

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

カスタム License Server からライセンスを取得する場合に接続の種類を指定します。

http: スタンドアロンの License Server または別の DTP の License Server からライセンスを取得できます。

tcp: レガシー License Server からライセンスを取得できます。

license.network.use.specified.serverlicense.network.host、および license.network.port を有効にする必要があります。

例: license.network.connection.type=http

license.network.auth.enabled=true|false

license.network.host および license.network.port で指定された別の DTP の認証を有効または無効にします。

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

license.network.user=[username]

license.network.host および license.network.port オプションで指定された別の DTP サーバーの認証用ユーザー名を指定します。license.network.use.specified.server および license.network.auth.enabled オプションに true を設定する必要があります。

例: license.network.user=JohnSnow

license.network.password=[password]

license.network.host および license.network.port オプションで指定された別の DTP サーバーの認証用パスワードを指定します。license.network.use.specified.server および license.network.auth.enabled オプションに true を設定し、license.network.user に値を指定する必要があります。認証が確実に成功するよう、またセキュリティ レベルを向上させるため、暗号化されたパスワードを使用することを強く推奨します。「暗号化されたパスワードの作成」を参照してください。

例: license.network.password=Wic2019!

OpenID Connect 設定

設定目的
oidc.enabled=true|false

OpenID Connect を介したユーザー認証を有効化します。

デフォルト値は false です。


oidc.issuer.uri=[uri]DTP が登録されている OpenID Connect サーバーの URL を指定します。
oidc.client.id=[id]OpenID Connect サーバーによって提供される ID を指定します。
oidc.client.secret=[password]OpenID Connect サーバーによって提供されるパスワードを指定します。
oidc.keystore=[path]

OpenID Connect サーバーでユーザーを認証するための証明書を保存するキーストア ファイルへのパスを指定します。

キーストア ファイルは 1 つの証明書だけを保存できます。Parasoft テスト ツールは、複数のユーザーの証明書を含むキーストアをサポートしていません。

oidc.keystore.password=[password]自己署名クライアント証明書を保存するキーストア ファイルのパスワードを指定します。認証の成功とセキュリティ レベルの向上を確保するために、暗号化されたパスワードを使用することを強く推奨します。暗号化されたパスワードの作成」を参照してください。
oidc.callback.host=localhost | 127.0.0.1

この設定は、OpenID Connect サーバーと通信するために IDE で設定されたローカル コールバック ホストを指定します。

(info) これは IDE 関連の設定であり、コマンドラインでの使用を意図したものではありません。

デフォルト値は localhost です。

oidc.callback.port=0 | [port number]

OpenID Connect サーバーと通信するために IDE で設定されたコールバック ポート番号を指定します。

(info) これは IDE 関連の設定であり、コマンドラインでの使用を意図したものではありません。

0: ポートは自動的に設定されます。

デフォルト値は 0 です。

oidc.callback.timeout=[seconds]

C/C++test を使用するときに OpenID Connect を介して DTP で認証するために、認証ページでユーザー資格情報を提供するために許可される最大時間を指定します

(info) これは IDE 関連の設定であり、コマンドラインでの使用を意図したものではありません。

デフォルト値は 60 です。

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

設定説明
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 の場合、ユーザーホームは <drive>:\Documents and Settings\<user>\Local Settings\Temp\parasoft\xtest です。

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

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

デフォルト: 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]

テクニカルサポートから入力を求められた拡張オプションを指定します。

デフォルト: false

techsupport.dtp.engine=true|false

解析中に生成された追加データを送信するかどうかを指定します。

デフォルト: false

作成者とスコープの設定

設定説明
authors.mappings.location=team|local|shared

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

local (推奨) を指定した場合、作成者マッピングは直接ローカル設定で設定されます。詳細については 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

サポートされるソース管理システムからのデータに基づいてコード作成者を算定するかどうかを指定します。GUI で指定された値を使用する場合、これを設定する必要はありません。

デフォルト: false

scope.local=true|false

ローカルユーザーに基づいてコード作成者を算定するかどうかを指定します。GUI で指定された値を使用する場合、これを設定する必要はありません。

デフォルト: true

scope.recommended.computation=first|random開発者ごとの「推奨されるタスク」をどのように選択するかを指定します。デフォルトの random の場合、ランダムに n 個のタスクが選択されます。 first の場合は、レポートされた最初の n 個のタスクが選択されます (n は、開発者ごとにレポートされる 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


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

プロパティ説明
scontrol.rep.type=accurevAccuRev リポジトリ タイプの識別子。 
scontrol.rep.accurev.host=AccuRev サーバー ホスト。 
scontrol.rep.accurev.port=AccuRev サーバー ポート。デフォルト ポートは 1666。
scontrol.rep.accurev.login=AccuRev のユーザー名。 
scontrol.rep.accurev.password=AccuRev のパスワード。 

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

プロパティ説明
scontrol.ccase.exec=外部クライアント実行モジュール (cleartool) へのパス。
scontrol.rep.type=ccaseClearCase リポジトリタイプの識別子。  
scontrol.rep.ccase.vob= VOB 中のパス。ccase.vob 値 + File.separator は ClearCase 制御ディレクトリへの有効なパスでなければなりません。 

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

プロパティ説明
scontrol.rep.type=cvsCSV リポジトリ タイプの識別子。 
scontrol.rep.cvs.root=完全な CVSROOT の値。 
scontrol.rep.cvs.pass=

プレーン テキスト パスワードまたは暗号化されたパスワード。暗号化されたパスワードは、.cvspass ファイル中のパスワードと同じでなければなりません。

CVS の場合、ユーザーのホームディレクトリの .cvspass の値を使用します。

CVSNT の場合、レジストリの HKEY_CURRENT_USER\Software\Cvsnt\cvspass の値を使用します。

"cvs login" を使ってコマンド ラインから初めて CVS リポジトリにログインした場合、パスワードはレジストリに保存されます。このパスワードを取得するには、egedit を使ってレジストリを参照し、HKEY_CURRENT_USER->CVSNT> cvspass キーの下の値を探します。この値には完全なログイン名 (:pserver:exampleA@exampleB:/exampleC) と暗号化されたパスワード値が表示されます。

scontrol.rep.cvs.useCustomSSHCreden-tials=EXT/SSH 接続のために CVS のログイン名とパスワードを使用するかどうかを指定します。true または false を指定できます。デフォルトは false です。
scontrol.rep.cvs.ext.server

EXT モードで CVS サーバーに接続している場合、このオプションは、サーバーサイドでどの CVS アプリケーションを起動するかを指定します。

CVS_SERVER 変数と同じ意味を持ちます。cvs がデフォルトです。

scontrol.rep.cvs.ssh.loginname=外部プログラムを使ってログインを提供できる場合に、SSH 接続のためのログイン名を指定します。
scontrol.rep.cvs.ssh.password=SSH 接続のためのパスワードを指定します。
scontrol.rep.cvs.ssh.keyfile=キー認証を使って SSH 接続を確立するための秘密鍵ファイルを指定します。
scontrol.rep.cvs.ssh.passphrase=キー認証メカニズムを使った SSH 接続のためのパスフレーズを指定します。
scontrol.rep.cvs.useShell=CVS リポジトリへの接続を確立するために、外部プログラム (CVS_RSH) を有効にします。true または false を指定できます。デフォルトは false です。
scontrol.rep.cvs.ext.shell=CVS_RSH プログラムとして使用される実行ファイルへのパスを指定します。コマンドラインパラメーターは cvs.ext.params プロパティで指定するべきです。
scontrol.rep.cvs.ext.params=

外部プログラムに渡すパラメーターを指定します。次のマクロを使って、値をコマンドラインパラメーターに展開できます。これらのマクロは大文字と小文字を区別します。

  • {host} リポジトリ ホスト
  • {port} ポート:
  • {user} cvs ユーザー
  • {password} cvs パスワード
  • {extuser} パラメーター cvs.ssh.loginname
  • {extpassword} パラメーター cvs.ssh.password
  • {keyfile} パラメーター cvs.ssh.keyfile
  • {passphrase} パラメーター cvs.ssh.passphrase

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 環境変数またはそれに相当するもので指定されているクライアント ワークスペース名。ファイルがダウンロードできるように、ワークスペースのルートディレクトリはローカルパスのために構成する必要があります。 

Serena Dimensions リポジトリ定義プロパティ

プロパティ説明
scontrol.rep.type=serenaSerena Dimensions リポジトリのタイプ識別子。 
scontrol.serena.dmroot=Serena Dimensions の実行モジュールへのパス。 (例: scontrol.serena.dmroot=C\:\\Program Files (x86)\\Serena\\Dimensions 2009 R2\\CM\\)
scontrol.rep.serena.login=ログイン名。
scontrol.rep.serena.password=パスワード。
scontrol.rep.serena.host=Serena Dimensions のサーバーホスト名。
scontrol.rep.serena.dbname=プロジェクトで使用するデータベースの名前。
scontrol.rep.serena.dbconn=データベースへの接続文字列。
scontrol.rep.serena.locale=使用する言語。 (例: scontrol.rep.serena.locale=en_US)
scontrol.rep.serena.mapping=

デフォルトの作業エリア以外の場所にプロジェクトをダウンロードまたは移動した場合、このオプションを使って、Serena リポジトリのプロジェクト (またはストリーム) とローカル プロジェクトとのマッピングを指定します。

デフォルト作業エリアで作業している場合、マッピングを定義する必要はありません。

Star Team リポジトリ定義プロパティ

プロパティ説明
scontrol.rep.type=starteamStar Team リポジトリ タイプの識別子。 
scontrol.rep.starteam.host=Star Team サーバー ホスト。 
sscontrol.rep.starteam.port=Star Team サーバー ポート。デフォルト ポートは 49201。 
scontrol.rep.starteam.login=ログイン名。 
scontrol.rep.starteam.password=暗号化していないパスワード。
scontrol.rep.starteam.path=

大規模なマルチ プロジェクト リポジトリで作業している場合、作業対象のプロジェクト、ビュー、またはフォルダーを指定してパフォーマンスを向上させることができます。 

次のものを指定できます。 単純なプロジェクト名 (リポジトリパスを検索するときにすべてのビューがスキャンされます)。 プロジェクト/ ビュー (指定のビューだけがスキャンされます)。 プロジェクト/ ビュー/ フォルダー (指定のStarTeam フォルダーがスキャンされます)。

例:

scontrol.rep.starteam.path=proj1
scontrol.rep.starteam.path=proj1/view1
scontrol.rep.starteam.path=proj1/view1/folderA
scontrol.rep.starteam.path=proj1/view1/folderA/folderB 

scontrol.rep.starteam.workdir=

scontrol.rep.starteam.path の設定で StarTeam のビューまたはフォルダーを指定する場合、このプロパティを使って、次のものを指定できます。 選択されたビューのルート フォルダーに対する新しい作業ディレクトリ (パスがビューを表す場合) 選択されたフォルダーに対する新しい作業ディレクトリ (パスがフォルダーを表す場合)

例:

scontrol.rep.starteam.workdir=c:\\storage\\dv
scontrol.rep.starteam.workdir=/home/storage/dv 

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

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

CM Synergy リポジトリ定義プロパティ

プロパティ説明
scontrol.rep.type=synergySynergy/CM リポジトリ タイプの識別子。 
scontrol.rep.synergy.host=synergy/cm エンジンが稼動するコンピュー タ。このプロパティを指定しない場合、ロー カル ホストが使用されます。Web モードの 場合、ホストはプロトコルとポートを含む有効な Synergy Web URL でなければなりません (例: http://synergy.server:8400)
scontrol.rep.synergy.dbpath=

synergy データベースの絶対パス。 例: \\host\db\name (UNC/Windows パス中のバックスラッシュ '\' は '\\' にする必要があります)

scontrol.rep.synergy.projspec= プロジェクト名とバージョンを格納した Synergy プロジェクト仕様。例: name-version 
scontrol.rep.synergy.login=Synergy のユーザー名。 
scontrol.rep.synergy.password=Synergy の暗号化していないパスワード。 
scontrol.rep.synergy.port=Synergy のポート。
scontrol.rep.synergy.remote_client=(UNIX のみ) ccm をリモート クライアントとして開始するかどうかを指定します。デフォルトは false です。任意。このプロパティは Web モードでは使用されません。
scontrol.rep.synergy.local_dbpath=リモート クライアント セッションを実行するときにデータベース情報をコピーするコピー先のパスを指定します。このプロパティが null の場合、デフォルトの場所が使用されます。このプロパティは Web モードでは使用されません。
scontrol.synergy.exec=外部クライアント実行モジュール (ccm) へのパス。 

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

プロパティ説明
scontrol.rep.type=tfsTFS リポジトリ タイプの識別子。 
scontrol.rep.tfs.host=TFS を実行しているマシンの名前。
scontrol.rep.tfs.port=TFS サーバーのポート番号 (任意。指定されていない場合、8080 が使用されます)。
scontrol.rep.tfs.protocol=TFS サーバーへの接続に使用されるプロトコル。指定できる値は HTTP および HTTPS です。
scontrol.rep.tfs.url=TFS リポジトリの URL (例: http://localhost:8080/tfs)
scontrol.rep.tfs.login =TFS のユーザー名。
scontrol.rep.tfs.password=TFS のパスワード

Microsoft Visual Source Safe リポジトリ定義プロパティ

プロパティ説明
scontrol.rep.type=vssVisual SourceSafe リポジトリのタイプ識別子。
scontrol.rep.vss.ssdir=リポジトリ データベースのパス。(UNC/Windows パス中のバックスラッシュ '\' は '\\' にする必要があります)  
scontrol.rep.vss.projpath=VSS プロジェクトのパス。 
scontrol.rep.vss.login=VSS のログイン。 
scontrol.rep.vss.password=VSS のパスワード。 
scontrol.vss.exec= 外部クライアント実行モジュール (ss) へのパス。
scontrol.vss.lookup=フル VSS データベース検索を行って、ローカル パスとリポジトリ パスの関連付けを発見するかどうかを指定します。true または false で指定します。 

重要な注意事項

  • リポジトリ データベースがローカルにある場合でも、repository(n).vss.ssdir プロパティは UNC 値を保持するべきです。
  • VSS の名前付け規則、規約、および制限事項に注意してください。名前とラベルに次の文字は使用できません。
    • ドル記号 ($)
    • アットマーク記号 (@)
    • 括弧記号 < >、[ ]、{ }、( )
    • コロン (:) およびセミコロン (;)
    • 等号 (=)
    • キャレット (^)
    • 感嘆符 (!)
    • パーセント記号 (%)
    • 疑問符 (?)
    • カンマ (,)
    • 一重引用符 (') と二重引用符 (")
  • プロジェクト名がドット記号 (.) で開始している場合、 Visual Studio 6 の VSS 6.0 (ビルド 8163) はプロジェクトを適切に処理できません。そのようなプロジェクト名を使用している場合、サブプロジェクトを追加できません。
  • サブプロジェクトにカスタム作業ディレクトリを使用してはいけません。例えばプロジェクト $/SomeProject の作業ディレクトリは C:\TEMP\VSS\SomeProject であり、そのサブプロジェクト $/SomeProject/SomeSubProject の作業ディレクトリは D:\SomeSubProject です。

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

設定説明
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 ファイルは、テスト コンフィギュレーションの [静的] タブで[ 有効なルールの一覧] ボタンをクリックすると、生成されます)。 

例:

report.rules=file:///C:/Temp/Burt/parasoft/xtest/gendoc/report.rules=../gendoc/ 

デフォルト: none

tasks.clear=true|false

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

デフォルト: true

console.verbosity.level=low|normal|high

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

low: エラーおよび現在のステップの名前とステータス (done、failed、up-to-date) についての基本情報を表示します。

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

high: 警告も表示します。

デフォルト: low

cpptest.custom.rules.dir=[directory]

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

cpptest.custom.configs.dir=[directory]

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

custom.compilers.dir=[directory]カスタム コンパイラのディレクトリ設定 ([Parasoft] > [設定] > [コンフィギュレーション] の [カスタムコンパイラ]) を上書きして、このオプションで指定されたディレクトリでカスタム コンパイラを検索します。
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: C/C++test が並行処理の設定をコントロールします。
  • Manual: ニーズに合わせて並行処理の設定をユーザーが手動で行うことができます。
  • Disabled: 利用できる CPU の中から 1 個だけを使用します。

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

デフォルト: Auto

parallel.max_threads=<number>

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

デフォルト: [available_processors]

parallel.free_memory_limit=<percentage>

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

デフォルト: 25

parallel.no_memory_limit=true|false

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

デフォルト: false

ローカル設定での変数の使用

レポート、E-mail、Parasoft DTP、Team Server、およびライセンスの設定では以下の変数を使 用することができます。

(warning) なお、セッション タグの値にコロン (:) を使用することはできません。

env_var

例: ${env_var:HOME}

コロンの後に指定された環境変数の値を出力します。

project_name

例: ${project_name}

テスト対象プロジェクトの名前を出力します。複数のプロジェクトを入力として渡した場合、この変数は「テスト対象プロジェクト名...」と出力します。

workspace_name

例: ${workspace_name}


ソリューション名を出力します。

config_name

例: ${config_name}

実行されたテストコンフィギュレーションの名前を出力します。レポート設定と E-mail 設定にだけ適用されます。

analysis_type

例: ${analysis_type}

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

tool_name

例: ${tool_name}

ツール名を出力します (例: C++test).

例 1

# 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

# Parasoft DTP settings
dtp.enabled==true
dtp.server=server1.mycompany.com
dtp.port=32323
dtp.user=smith
dtp.password=?1q2W3e4R5t6Y7u8I9o!

# 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

#network license retrieved from DTP
dtp.enabled=true
dtp.server=onya.mycompany.com
dtp.port=443
dtp.user=user1
dtp.password=mypassword
cpptest.license.use_network=true
 
# 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