レポートビューア を使用する

レポートビューアを使用すると、ブラウザを使用せずに、エラーデータを含むSQLiteデータベースをマシン上で直接開くことができます。また、重要なデータをすばやく見つけられる検索オプションやフィルターオプションもあります。

QAチームやビジネスチームの他のメンバーと連携する場合に、レポートを共有することができます。

レポートビューア を入手する

レポートビューアは Tricentis Toscaのインストールに含まれています。デフォルトインストール後、実行ファイル Tricentis.DataIntegrity.Report.Viewer.exe は %TRICENTIS_DI_HOME%\tools に保存されます。

レポートを開く

エラーレポートを作成したら、それをレポートビューアで開くことができます。これを行うには、以下の手順に従ってください。

  1. レポートビューアを開くには、 %TRICENTIS_DI_HOME%\tools に移動し、ファイル Tricentis.DataIntegrity.Report.Viewer.exe を実行します。

  2. これで、レポートビューアが開きます。特定のレポートを開くには、以下のオプションのいずれかを選択します。

    • SQLiteファイルレポートをドラッグ＆ドロップします。

    • 「 ブラウズ」をクリックして、マシン上のファイルをブラウズします。

これにより、レポートの「概要」ページが開きます。このページには比較結果、処理されたデータとエラーの概要、ソースとターゲットの説明が表示されます。

データ整合性レポートビューアには、成功した比較レポートが表示されます。

成功した比較のレポートが表示されるレポートビューア

レポートビューア を操作する

レポートビューアでは、さまざまな基準で比較結果を並べ替えることができます。どのタブが表示されるかは、比較結果とテストケースで指定した内容によって異なります。

特定の情報を表示するには、レポートビューアの上部にあるタブをクリックします。

  • 差異：ソースとターゲットの両方に存在する行の概要を表示します。

  • ソース内のみ：ソースのみに存在する行を表示します。

  • ターゲット内のみ：ターゲットのみに存在する行を表示します。

  • ソースで無効：処理できなかったソース行を表示します。

  • ターゲットで無効：処理できなかったターゲット行を表示します。

  • 一致：ソースとターゲットで一致するすべての行をチェックします。

レポートを変更する

結果を確認し、レポートをフィルタリングするには、レポートビューアの以下の機能を使用します。

  • 表示する列を選択するには、「列の可視性」をクリックします。

  • 「 差異のある列のみを表示」を選択すると、差異のある列のみが表示されます。

  • 「 コンテンツ検索」フィールドに検索クエリを入力すると、結果内のデータが強調表示されます。

  • 並べ替えやフィルタリングを行うには、各列の右上隅にある「 メニュー」アイコンをクリックします。複数の列のフィルターを組み合わせると、結果を絞り込むことができます。

  • 1ページに表示するレコード数を指定するには、データテーブルの下にある「レコードを表示」フィールドを使用します。

  • ページを移動するには、データテーブルの下にある「前へ」、いずれかの数字、または「次へ」をクリックします。

  • 「 終了」アイコンをクリックすると、スタートページに戻り、別のレポートを選択して表示することができます。

データ整合性レポートビューアでは、検索、並べ替え、フィルター、エクスポートのオプションを使用します。

レポートビューアの検索、並べ替え、フィルタリングのオプション

レポートを共有する

レポートビューアは、データの完全性に関する重要な洞察を提供します。QAチームやビジネスチームの他の人と調整したい場合は、この情報を共有することができます。

そのためには、以下のファイルをチームに転送してください。

または、HTMLレポートをエクスポートすることもできます。

レポートをエクスポートする

データベースや実行ファイルを転送することなく、他の人とデータを共有したい場合などにおいては、レポートをエクスポートすることができます。または、独自のレポートツールで結果を処理したい場合にレポートをエクスポートできます。

次のステップは、何をするかによって異なります。

以下のいずれかの方法で、HTMLのエクスポートをトリガーできます。

  • コマンドラインを使用して、スクリプトの一部として。

  • レポートエクスポートのトリガーを自動化したい場合は、Toscaテストケースを使用して。この場合、テストケースを実行するたびに、Tricentis Toscaが自動的にレポートをエクスポートします。

エラーレポートのサイズが大きい場合は、複数のファイルに分割することを検討してください。ブラウザは50MBを超えるサイズのHTMLファイルを表示できません。

コマンドライン経由でHTMLレポートをトリガーする

  1. 以下のコマンドラインツールが含まれているディレクトリに移動してください。Tricentis.DataIntegrity.Report.Exporter.exe

    • Windowsでは %TRICENTIS_DI_HOME%/tools/windows です。

    • Linuxでは %TRICENTIS_DI_HOME%/tools/tools/linux です。

  2. 次のコマンドラインを入力してください。Tricentis.DataIntegrity.Report.Viewer.exe <arguments> をエクスポートし、 5"="" ctype="link" equiv-text='lt;a href="../../../../data_integrity/di_report_viewer.htm#arguments_csv"gt;lt;MadCap:conditionalText MadCap:conditions="data_integrity.CSV" xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd"gt;' id="7">uments"/ を 使用したい引数と置き換えます。

この例ではレポートビューワーが C:/ExampleFolder にあるレポートファイル example_report.db から情報を取得します。Summary タブと Differences タブ用にそれぞれのファイルを作成し、両方のファイルを C:∕ExampleFolder に保存します。

Tricentis.DataIntegrity.Report.Exporter.exe --input C:\ExampleFolder\example_report.db --output C:\ExampleFolder --t Summary --t Differences --format html

この例ではレポートビューアーは、ファイル Tricentisと同じディレクトリにあるレポートファイル report.db から情報を取得します。DataIntegrity.Report.Exporter.exe.my_report.html というします。テーブルパラメータを使用しないため、レポートビューワーはすべてのテーブルのレポートをエクスポートし、 C:\ExampleFolder に保存します。

Tricentis.DataIntegrity.Report.Exporter.exe --input report.db -output C:\ExampleFolder\my_report.html -f html

この例ではレポートビューワーがファイル Tricentisと同じフォルダーにあるレポートファイル myreport.db から情報を取得します。DataIntegrity.Report.Exporter.exe.レポートを Summary タブにエクスポートし、 C:\ExampleFolder\summary_report.json に保存します。

TricentisDataIntegrity.Report.Exporter.exe --myreport.db -output C:\ExampleFolder\summary_report.json --table Summary

テストケース経由でHTMLレポートをトリガーする

テストケースを介してHTML の ファイルのエクスポートをトリガーするためには、以下の手順に従ってください。

  1. Tosca Commander において、 DIサブセットにアクセスし、 Data整合性テスト->;_DIサンプルテストと実行リスト->テストケース->;照合 ->その他 -& gt;差異をdbにエクスポートして共有可能なHTMLレポートを生成します。

  2. サンプルのhtmlレポートの生成をコピーして、完全な行ごとの比較テストケースに貼り付けます。

  3. 以下の通り、TestStepValuesを入力します。

TestStepValues

説明

Path

Report Exporter へのフルパスを入力します。

  • Windowsの場合： %TRICENTIS_DI_HOME%/tools/windows/Tricentis.DataIntegrity.Report.Exporter.exe.

  • Linuxの場合： %TRICENTIS_DI_HOME%/tools/tools/linux/Tricentis.DataIntegrity.Report.Exporter.exe.

Arguments

したい引数。

WaitForExit

True と入力します。これは非常に重要です。True と入力しないと、テストケースはコマンドラインを一旦トリガーしますが、すぐにまた閉じます。

終了コード

コマンドラインの終了コードを入力してください。0 を入力し、 ActionMode 確認するを選択するよう推奨します。この場合、コマンドが失敗するとテストケースに警告が表示されます。

この例ではテストケースで直接、エクスポートを自動的にトリガーします。

レポートビューアーは、 C:/Temp にあるレポートファイル「 report.db 」から情報を取得します。すべて に保存いたします。

テストケースにおいて、エクスポートを自動的にトリガーする

使用可能な引数のリスト

以下の引数を使用してHTMLレポートのエクスポートをトリガーすることができます。

引数名

値

--i, --input

作成した比較レポートを含むデータベースファイルへのパス

--o, --output

出力を保存する場所へのパス:

  • 一つのテーブルまたはすべてのテーブルをエクスポートする場合、ディレクトリまたはファイルへのパスを入力することができます。

  • 複数の特定のテーブルをエクスポートする場合は、ディレクトリへのパスを入力します。レポート・ビューワーは、レポートファイルを以下の形式 <name of the report file>_<table>

注: 概要タブのエクスポートファイルは常にJSONファイルとなります。 概要タブをエクスポートし、ファイルへのパスを指定する場合、ファイル名の拡張子は .json でなければなりません。

--f, --format

出力フォーマット。HTML を入力してください。

-t、-table

レポートをエクスポートするテーブルの名前以下のいずれかの値を入力してください：差異、不一致、無効、不一致なソース、不一致なターゲット、無効なソース、無効なターゲット、または概要。

HTML において、一致した行のエクスポートはサポートされておりません。

以下のいずれかの方法で、複数のテーブルのレポートをエクスポートできます：

  • 表ごとに1つの引数を複数回使用します。

  • その引数は一切使わないでください。この場合、レポート・ビューワーはすべてのテーブルのレポートをエクスポートします。

--progress

エクスポートの進行状況を表示します。

--h, --help

ヘルプを表示します。

--V, --version

バージョン情報を表示します。

以下のいずれかの方法で抽出をトリガーできます。

  • コマンドラインを使用して、スクリプトの一部として。

  • このプロセスを自動化したい場合Toscaテストケースを使用して。この場合、テストケースを実行するたびに、Tricentis Toscaが自動的にレポートをエクスポートします。

コマンドライン経由で抽出をトリガーする

  1. 以下のコマンドラインツールが含まれているディレクトリに移動してください。Tricentis.DataIntegrity.Report.Exporter.exe

    • Windowsでは %TRICENTIS_DI_HOME%/tools/windows です。

    • Linuxでは %TRICENTIS_DI_HOME%/tools/tools/linux です。

  2. 次のコマンドラインを入力してください。Tricentis.DataIntegrity.Report.Viewer.exe <arguments> をエクスポートし、 5"="" ctype="link" equiv-text='lt;a href="../../../../data_integrity/di_report_viewer.htm#arguments_csv"gt;lt;MadCap:conditionalText MadCap:conditions="data_integrity.CSV" xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd"gt;' id="7">uments"/ を 使用したい引数と置き換えます。

この例ではレポートビューワーが C:/ExampleFolder にあるレポートファイル example_report.db から情報を取得します。Summary タブと Differences タブ用にそれぞれのファイルを作成し、両方のファイルを C:∕ExampleFolder に保存します。

Tricentis.DataIntegrity.Report.Exporter.exe --input C:\ExampleFolder\example_report.db --output C:\ExampleFolder --t Summary --t Differences

この例ではレポートビューアーは、ファイル Tricentisと同じディレクトリにあるレポートファイル report.db から情報を取得します。DataIntegrity.Report.Exporter.exe.します。

Tricentis.DataIntegrity.Report.Exporter.exe --input report.db -output C:\ExampleFolder

この例ではレポートビューワーがファイル Tricentisと同じフォルダーにあるレポートファイル myreport.db から情報を取得します。DataIntegrity.Report.Exporter.exe.レポートを Summary タブにエクスポートし、 C:\ExampleFolder\summary_report.json に保存します。

TricentisDataIntegrity.Report.Exporter.exe --myreport.db -output C:\ExampleFolder\summary_report.json --table Summary

テストケース経由で抽出をトリガーする

テストケースを介して の CSV ファイルのエクスポートをトリガーするためには、以下の手順に従ってください。

  1. Tosca Commander において、 DIサブセットにアクセスし、 Data整合性テスト->;_DIサンプルテストと実行リスト->テストケース->;照合 ->その他 -& gt;差異をdbにエクスポートして共有可能なHTMLレポートを生成します。

  2. サンプルのhtmlレポートの生成をコピーして、完全な行ごとの比較テストケースに貼り付けます。

  3. 形式を変更すると、テストケースがCSV形式でのエクスポートをトリガーします。そのためには、以下のオプションのいずれかを選択します。

    • Delete the Argument with the value --format の値を持つ引数と HTML の値を持つ引数を削除します。--format パラメータを使用しない場合、テストケースはCSV形式で自動的にエクスポートします。

    • 値を HTML から CSV に変更します。

  4. 以下の通り、TestStepValuesを入力します。

TestStepValues

説明

Path

Report Exporter へのフルパスを入力します。

  • Windowsの場合： %TRICENTIS_DI_HOME%/tools/windows/Tricentis.DataIntegrity.Report.Exporter.exe.

  • Linuxの場合： %TRICENTIS_DI_HOME%/tools/tools/linux/Tricentis.DataIntegrity.Report.Exporter.exe.

Arguments

。

WaitForExit

True と入力します。これは非常に重要です。True と入力しないと、テストケースはコマンドラインを一旦トリガーしますが、すぐにまた閉じます。

終了コード

コマンドラインの終了コードを入力してください。0 を入力し、 ActionMode 確認するを選択するよう推奨します。この場合、コマンドが失敗するとテストケースに警告が表示されます。

この例ではテストケースで直接、エクスポートを自動的にトリガーします。

レポートビューアーは、 C:/Temp にあるレポートファイル「 report.db 」から情報を取得します。いたします。

テストケースにおいて、エクスポートを自動的にトリガーする

使用可能な引数のリスト

以下の引数を使用してCSVレポートのエクスポートをトリガーすることができます。

引数名

値

--i, --input

作成した比較レポートを含むデータベースファイルへのパス

--o, --output

出力を保存する場所へのパス:

  • 一つをエクスポートする場合、ディレクトリまたはファイルへのパスを入力することができます。

  • 複数の特定のテーブルをエクスポートする場合は、ディレクトリへのパスを入力します。レポート・ビューワーは、レポートファイルを以下の形式 <name of the report file>_<table>

  • すべてのテーブルをエクスポートするためテーブルの引数を使用しない場合は、ディレクトリへのパスを入力してください。

注: 概要タブのエクスポートファイルは常にJSONファイルとなります。 概要タブをエクスポートし、ファイルへのパスを指定する場合、ファイル名の拡張子は .json でなければなりません。

-t、-table

レポートをエクスポートするテーブルの名前以下のいずれかの値を入力してください：差異、不一致、無効、不一致なソース、不一致なターゲット、無効なソース、無効なターゲット、または概要。

HTML において、一致した行のエクスポートはサポートされておりません。

以下のいずれかの方法で、複数のテーブルのレポートをエクスポートできます：

  • 表ごとに1つの引数を複数回使用します。

  • その引数は一切使わないでください。この場合、レポート・ビューワーはすべてのテーブルのレポートをエクスポートします。

--d, --delimiter

値を区切るデリミタです。

デフォルトの区切り文字はコンマです。別の方法で値を区切りたい場合は、必要な区切り文字を入力してください。

--progress

エクスポートの進行状況を表示します。

--h, --help

ヘルプを表示します。

--V, --version

バージョン情報を表示します。

すでにレポートビューアが開いている場合は、一回限りのエクスポートを簡単にトリガーできます。レポートビューアは、情報をCSV形式でエクスポートします。「 概要」タブを除くすべてのタブをエクスポートできます。

次のステップは以下のとおりです。

  1. レポートビューアで、エクスポートする情報のタブをクリックします。

  2. 「 CSVにエクスポート」をクリックします。

  3. 後続のダイアログで、エクスポートファイルの保存先と名前を選択します。

  4. 「 保存」をクリックします。