PDF、Word、Excelでカスタムレポートを作成する

Tosca Cloud は、ダッシュボードやレポートページなど、さまざまなレポートソリューションを提供します。このトピックでは、もう一つの選択肢である：テストケースレベルでのカスタムレポートについて説明します。いわゆる「DokuSnapper」には、いくつかの重要な利点があります：

• すべてのテストステップに関する詳細なデータ。

• テスト対象アプリケーションにグラフィカルユーザーインターフェース（GUI）がある場合のスクリーンショット。

• Microsoft Word、Microsoft Excel、またはPDF形式です。

• PDFおよびMicrosoft Wordのレポート用のカスタマイズ可能なテンプレートです。

• テストランの添付ファイルタブにあるレポートや、ローカルマシン上のオフラインのレポート

テストケースのためにDokuSnapperを有効にしてください。

DokuSnapperはテストケースレベルでレポートを作成します。有効にするためには、レポートを希望する各テストケースに以下のテストケースパラメータを追加してください：

• DokuSnapperEnabled

• DokuSnapperStorageLocationType

• DokuSnapperReportFormat

• DokuSnapperPath

• DokuSnapperTemplate

テンプレートでの作業

DokuSnapper はPDF またはMicrosoftWordレポートを作成するときに、レポート内のどこにどの情報が表示されるかを定義するテンプレートを使用します。テンプレートは、ニーズに合わせてカスタマイズすることができます。

Microsoft Excelレポートはカスタマイズできないことにご注意ください。

テンプレートを見つける

After a default installation of ランチャー, you can find the templates at %localappdata%\TRICENTIS\Launcher\TBox\<version>\Resources.

プレースホルダーでカスタマイズする

テンプレートはプレースホルダーを使用して、Tosca Cloudにどの情報をレポートのどこに配置するかを指示します。開始する際に役立つテンプレートがいくつか用意されています。すでにいくつかのプレースホルダーがありますが、必要に応じて追加、削除、置き換えができます。

各テンプレートの最初のページには、表紙と概要があり、以下のプレースホルダーを使用できます：

プレースホルダー	同等の情報
<Duration>	テストケースの実行時間。
<ErrorTestSteps>	エラーが発生したテストステップの数。
<FailedTestSteps>	失敗したテストステップの数。
<NoResultsTestSteps>	結果のないテストステップの数。
<PassedTestSteps>	成功したテストステップの数。
<TestCaseName>	テストケースの名前。
<TestCaseResult>	テスト ケースの結果:例、成功または失敗。
<TestCaseStartTime>	テストケースが開始した時間。特別なタスクパラメータである「ToscaDateFormat」および「ToscaTimeFormat」に従って日付時刻を表示します。
<TestCaseEndTime>	テストケースが終了した時間。特別なタスクパラメータである「ToscaDateFormat」および「ToscaTimeFormat」に従って日付時刻を表示します。
<[ToscaObjectProperty]>	テストケース内の任意のプロパティの値。[ToscaObjectProperty]をレポートするプロパティに置き換えます。 このプレースホルダーを使用するには、値が TRUE のパラメータ DokuSnapperAllPropertiesAvailable を追加する必要があることに注意してください。

表紙と概要ページの後に、右上隅にプレースホルダーが表示されたページが表示されます。これは2列のテーブルですが、境界線とグリッド線は表示されていません。

テーブルの左側は、Tosca Cloud がGUIを持つアプリケーションのテスト実行中にキャプチャしたスクリーンショット専用です。この列にはプレースホルダーを追加することはできません。

ただし、テーブルの右側には以下のプレースホルダーを使用することができます：

プレースホルダー	同等の情報
<Log>	あらかじめ定義された基本的なテスト情報と使用値。レポートに含める詳細情報を指定しない場合は、このオプションを試してみてください。
<TestStepName>	実行されたテストステップの名前。
<TestStepResult>	実行されたテストステップの結果。
<TestStepStartTime>	テストステップが開始された正確な時間。
<TestStepEndTime>	テストステップが終了した正確な時間。
<UsedValue>	テストステップの実行中に使用した実際の値。

テーブルに列を追加したり、テンプレートにテーブルを追加したりすることはできませんのでご注意ください。

レポートにアクセス

テストを実行した後、DokuSnapperPathパラメータで指定した場所にレポートが保存されます。