Remote Service でテスト実行のために Tosca CI Client を設定します。

このトピックは、Tricentisが近い将来に廃止する予定の従来の機能について説明します。廃止計画およびタイムラインに関する詳細情報については、この Tricentisナレッジベースの記事をご覧ください。

代替案については、トピックをチェックしてください。

この章では、Windowsオペレーティングシステムからテスト実行を起動する場合に、 Tosca Continuous Integration ClientTosca CI Client)の動作を設定する方法を説明します。

Windows 以外のオペレーティング システムからの起動の動作を構成する方法については、 see chapter "Windows以外のオペレーティングシステム向けにリモートテスト実行用の Tosca CI Client を設定する" を参照してください。

Tosca CI Client の設定

Tosca CI Client を設定するには、 ファイルを変更する必要があります。このファイルは %COMMANDER_HOME%\ToscaCI\Client にあります。

ToscaCIClient.dll.config ファイルは、 ToscaCIClient.exe ファイルと同じディレクトリに配置する必要があります。

以下の設定を変更します。

設定名

説明

オプション

CI RemoteExecutionRestEndpoint

リモート実行サービスのエンドポイントを定義します。

appsettings.json ファイルで指定した同じエンドポイントアドレスを入力します。

ホスト名を Remote Execution Service をホストするマシンのIPアドレスに置き換えます。

 

WebserviceAuthenticationUsername

テストの実行を Tosca CI Client に許可します。クライアント認証用に Remote Execution Service を設定している場合、この設定は必須です。

appsettings.json ファイルで指定した同じ値を入力してください。

 

WebserviceAuthenticationPassword

AuthenticationUsername のパスワード。クライアント認証用に Remote Execution Service を設定している場合、この設定は必須です。

appsettings.json ファイルで指定した同じ値を入力してください。

 

TimestampFormat

実行結果のタイムスタンプのフォーマットを定義します。デフォルト値は yyMMdd HHmm です。

この設定はカスタム文字列で変更できます。可能な構文については、Microsoftのドキュメント(新しいタブで開く)を参照してください。

X

ReportIntermediateResults

テストランの最後に要約結果に加えて、各ExecutionEntryの実行後に結果を受け取りたいことを指定いたします。

デフォルトでは、この設定はオフになっております。つまり、False に設定します。

X

PollingInterval

この設定は、 ReportIntermediateResultsTRUE に設定されている場合にのみ適用されます。

Tosca CI ClientTosca Distribution Server からの結果を要求する間隔(ミリ秒)。

X

CiClientTimeout

この設定は、 ReportIntermediateResultsTRUE に設定されている場合にのみ適用されます。

Tosca CI ClientTosca Distribution Server からの応答を待機する時間をミリ秒単位で指定します。

Tosca CI Client がこの時間内に Tosca Distribution Server から応答を受け取らなかった場合、実行を中断し、キューからリクエストを削除します。

CiClientTimeout で定義された時間間隔は、 PollingInterval て定義された時間間隔以上の長さである必要があります。短い場合は、自動的に PollingInterval で定義された時間間隔が使用されます。

デフォルト値は 36000000 です。

X

ResultType

テスト結果の構造を定義します。

ReportIntermediateResultsTRU の場合、結果タイプ Junit のみが可能です。

X

PathToResultFile

ToscaCI Clientresult.xml ファイルへのパスを定義します。ビルドサーバはこのファイルをインポートしてテスト結果を表示します。

特定のテストの実行に指定されたパスを使用したくない場合は、呼び出しパラメータを使用してこの設定を上書きできます。

X

実行結果の検討

ビルドサーバで、テストが成功したかどうかを示す終了コードが必要な場合は、この設定のTRUE に設定します。終了コードは、テストが成功したか失敗したか、あるいは1つ以上のExecutionEntriesに対して結果がなかったかをビルドサーバーに通知します。

  • 合格:終了コード 0

  • 失敗:終了コード -1

  • ExecutionEntriesに表示する結果はありません:終了コード -2このコードは、 ReportIntermediateResultsTrue に設定されている場合に適用されます。

X

例: Tosca CI Client の動作定義

以下の例では、 Tosca CI Client の動作を以下のように定義しています。

  • Tosca CI Client は結果ファイルを C:\Sample_Directory\Result.xml のパスに保存します。

  • ビルドサーバは Tosca CI Client からの終了コードを待ちます。

<userSettings>
    [...]
    <TOSCAContinuousIntegration.TOSCACIClient.Properties.Settings>
        [...]
        <setting name="PathToResultFile" serializeAs="String">
            <value>"C:\Sample_Directory\Result.xml"</value>
        </setting>
        <setting name="ConsiderExecutionResult" serializeAs="String">
            <value>True</value>
        </setting>
        [...]
    </TOSCAContinuousIntegration.TOSCACIClient.Properties.Settings>
</userSettings>