Report Viewer verwenden

Der Report Viewer ermöglicht es Ihnen, die SQLite-Datenbank, die Ihre Fehlerdaten enthält, direkt auf Ihrem Rechner und ohne Verwendung eines Browsers zu öffnen. Er bietet auch Such- und Filteroptionen, mit denen Sie wichtige Daten schneller finden können.

Wenn Sie sich mit anderen in Ihren QA- und Geschäftsteams abstimmen möchten, können Sie Ihre Reports teilen.

Report Viewer abrufen

Der Report Viewer ist Teil der Installation von Tricentis Tosca. Nach einer Standardinstallation finden Sie die ausführbare Datei Tricentis.DataIntegrity.Report.Viewer.exe unter %TRICENTIS_DI_HOME%\tools.

Report öffnen

Sobald Sie Ihren Fehlerreport erstellt haben, können Sie ihn im Report Viewer öffnen. Führen Sie hierzu diese Schritte aus:

Um den Report Viewer zu öffnen, gehen Sie zu %Tricentis_DI_HOME%\tools und führen Sie die Datei Tricentis.DataIntegrity.Report.Viewer.exe aus.
Dadurch öffnet sich der Report Viewer. Wählen Sie eine der folgenden Optionen, um einen bestimmten Report zu öffnen:
- Ziehen Sie die SQLite-Datei des Reports per Drag & Drop.
- Klicken Sie auf Browse, um auf Ihrem Rechner nach einer Datei zu suchen.

Dadurch öffnet sich die Seite Summary Ihres Reports. Sie zeigt die Vergleichsergebnisse, eine Übersicht über die verarbeiteten Daten und Fehler sowie eine Beschreibung von Quelle und Ziel.

Der Data Integrity Report Viewer zeigt einen Report über einen erfolgreichen Vergleich an.

Report Viewer zeigt einen Report über einen erfolgreichen Vergleich an

Im Report Viewer navigieren

Der Report Viewer sortiert die Ergebnisse Ihres Vergleichs nach verschiedenen Kriterien. Welche Reiter Sie sehen, hängt von den Vergleichsergebnissen und den Angaben in Ihrem Testfall ab.

Um bestimmte Informationen anzuzeigen, klicken Sie auf die Reiter oben im Report Viewer:

Differences: Erhalten Sie einen Überblick über Zeilen, die sich in Quelle und Ziel befinden.
In source only: Zeigen Sie Zeilen an, die sich nur in der Quelle befinden.
In target only: Zeigen Sie Zeilen an, die sich nur im Ziel befinden.
Invalid in source: Zeigen Sie Zeilen in der Quelle an, die nicht verarbeitet werden konnten.
Invalid in target: Zeigen Sie Zeilen im Ziel an, die nicht verarbeitet werden konnten.
Matched: Überprüfen Sie alle Zeilen, die in Quelle und Ziel identisch sind.

Ihren Report ändern

Um die Ergebnisse zu überprüfen und Ihren Report zu filtern, verwenden Sie die folgenden Features des Report Viewer:

Klicken Sie auf Columns visibility, um auszuwählen, welche Spalten angezeigt werden sollen.
Wählen Sie Shows columns with differences only, um nur Spalten mit Unterschieden anzuzeigen.
Geben Sie eine Suchanfrage in das Feld Content Search ein, um Daten in den Ergebnissen hervorzuheben.
Klicken Sie auf das Symbol Menu in der oberen rechten Ecke jeder Spalte, um zu sortieren und zu filtern. Sie können Filter in mehreren Spalten kombinieren, um Ihre Ergebnisse zu verfeinern.
Verwenden Sie das Feld Display records unterhalb der Datentabelle, um anzugeben, wie viele Datensätze pro Seite angezeigt werden sollen.
Klicken Sie auf Previous, eine der Zahlen oder Next unter der Datentabelle, um durch die Seiten zu navigieren.
Klicken Sie auf das Symbol Exit, um zur Startseite zurückzukehren, wo Sie einen anderen Report zur Ansicht auswählen können.

Verwenden Sie Such-, Sortier-, Filter- und Exportoptionen im Data Integrity Report Viewer.

Such-, Sortier- und Filteroptionen des Report Viewer

Reports teilen

Der Report Viewer vermittelt Ihnen wichtige Einblicke in die Integrität Ihrer Daten. Wenn Sie sich mit anderen in Ihren QA- und Geschäftsteams abstimmen möchten, können Sie diese Informationen teilen.

Leiten Sie dazu die folgenden Dateien an Ihre Teams weiter:

Die Datenbankdatei, die den von Ihnen erstellten Vergleichsreport enthält.
Die ausführbare Datei.

Alternativ können Sie einen HTML-Report exportieren.

Reports exportieren

Sie können Reports exportieren, z. B. wenn Sie Daten mit anderen teilen möchten, ohne Datenbank- und ausführbare Dateien weiterleiten zu müssen. Oder wenn Sie Ergebnisse in Ihren eigenen Reporting-Tools verarbeiten möchten.

Ihre nächsten Schritte hängen davon ab, was Sie tun möchten:

Ich möchte einen HTML-Export auslösen, den ich mit anderen teilen kann.

Sie können den HTML-Export auf eine der folgenden Arten auslösen:

Über die Befehlszeile, als Teil eines Skripts.
Über einen Tosca-Testfall, wenn Sie das Auslösen von Reportexporten automatisieren möchten. In diesem Fall exportiert Tricentis Tosca automatisch einen Report, wenn Sie Ihren Testfall ausführen.

Wenn Ihr Fehlerreport groß ist, sollten Sie ihn auf mehrere Dateien aufteilen. Browser können keine HTML-Dateien anzeigen, die größer als 50 MB sind.

HTML-Report über die Befehlszeile auslösen

Gehen Sie zu dem Verzeichnis, das das Befehlszeilentool Tricentis.DataIntegrity.Report.Exporter.exe enthält:
- Unter Windows ist dies %TRICENTIS_DI_HOME%/tools/windows.
- Unter Linux ist dies %Tricentis_DI_HOME%/tools/tools/linux.
Geben Sie die Befehlszeile Tricentis.DataIntegrity.Report.Viewer.exe export <Argumente> ein und ersetzen Sie <Argumente> durch die Argumente, die Sie verwenden möchten.

In diesem Beispiel ruft der Report Viewer die Informationen aus der Reportdatei example_report.db ab, die sich unter C:/ExampleFolder befindet. Er erstellt separate Dateien für die Reiter Summary und Differences und speichert sie unter C:\ExampleFolder.

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

In diesem Beispiel ruft der Report Viewer die Informationen aus der Reportdatei report.db ab, die sich im gleichen Verzeichnis wie die Datei Tricentis.DataIntegrity.Report.Exporter.exe befindet. Er erstellt eine HTML-Ausgabe mit dem Namen my_report.html unter C:\ExampleFolder.

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

In diesem Beispiel ruft der Report Viewer die Informationen aus der Reportdatei myreport.db ab, die sich im gleichen Ordner wie die Datei Tricentis.DataIntegrity.Report.Exporter.exe befindet. Er exportiert einen Report zum Reiter Summary und speichert ihn unter C:\ExampleFolder\summary_report.json.

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

HTML-Report über einen Testfall auslösen

Um den Export einer HTML-Datei über einen Testfall auszulösen, führen Sie diese Schritte aus:

Greifen Sie im Tosca Commander auf Ihre DI-Untermenge zu und gehen Sie zu Data Integrity Testing->_DI Sample Tests and Execution Lists->TestCases->Reconciliation->Miscellaneous->Export differences to db and generate shareable HTML report.
Kopieren Sie das Beispiel Generate html report und fügen Sie es in Ihren Complete Row by Row Comparison-Testfall ein.
Füllen Sie die Testschrittwerte aus:

Testschrittwert	Beschreibung
Path	Geben Sie den vollständigen Pfad zum Report Exporter ein: Unter Windows ist dies %TRICENTIS_DI_HOME%/tools/windows/Tricentis.DataIntegrity.Report.Exporter.exe. Unter Linux ist dies %TRICENTIS_DI_HOME%/tools/tools/linux/Tricentis.DataIntegrity.Report.Exporter.exe.
Arguments	Geben Sie die Argumente ein, die Sie verwenden möchten.
WaitForExit	Geben Sie True ein. Dies ist von entscheidender Bedeutung. Wenn Sie True nicht eingeben, löst der Testfall die Befehlszeile aus, schließt sie aber sofort wieder.
ExitCode	Geben Sie einen Befehlszeilen-ExitCode ein. Wir empfehlen Ihnen, 0 einzugeben und die Aktion Verify auszuwählen. In diesem Fall erhalten Sie in Ihrem Testfall eine Warnung, wenn der Befehl fehlschlägt.

In diesem Beispiel lösen Sie den Export automatisch direkt in Ihrem Testfall aus.

Der Report Viewer ruft die Informationen aus der Reportdatei report.db ab, die sich unter C:/Temp befindet. Er exportiert alle Informationen im HTML-Format und speichert eine Datei namens summary_report.html unter C:\ExampleFolder.

Automatisch den Export in Ihrem Testfall auslösen

Liste der verfügbaren Argumente

Sie können die folgenden Argumente verwenden, um den Export eines HTML-Reports auszulösen:

Argumentname	Wert
--i, --input	Pfad zur Datenbankdatei, die den von Ihnen erstellten Vergleichsreport enthält.
--o, --output	Pfad, in dem Sie die Ausgabe speichern möchten: Wenn Sie eine Tabelle oder alle Tabellen exportieren, können Sie den Pfad zu einem Verzeichnis oder einer Datei eingeben. Wenn Sie mehrere spezifische Tabellen exportieren, geben Sie den Pfad zu einem Verzeichnis ein. Der Report Viewer speichert die Reportdateien im Format <Name der Reportdatei>_<Tabelle>. Hinweis: Die Exportdatei des Reiters Summary ist immer eine JSON-Datei. Wenn Sie den Reiter Summary exportieren möchten und den Pfad zur Datei angeben, muss der Dateiname die Erweiterung .json haben.
--f, --format	Ausgabeformat. Geben Sie HTML ein.
--t, --table	Name der Tabelle, für die Sie einen Report exportieren möchten. Geben Sie einen der folgenden Werte ein: Differences, Matched, Unmatched, Invalid, UnmatchedSource, UnmatchedTarget, InvalidSource, InvalidTarget oder Summary. Sie können Reports für mehrere Tabellen auf eine der folgenden Arten exportieren: Verwenden Sie das Argument mehrmals, ein Argument pro Tabelle. Verwenden Sie das Argument überhaupt nicht. In diesem Fall exportiert der Report Viewer Reports für alle Tabellen.
--progress	Zeigen Sie den Exportfortschritt an.
--h, --help	Zeigen Sie die Hilfe an.
--V, --version	Zeigen Sie die Versionsinformationen an.

Ich möchte Reportdaten im CSV-Format extrahieren und in meinem eigenen Reporting-System verarbeiten.

Sie können die Extraktion auf eine der folgenden Arten auslösen:

Über die Befehlszeile, als Teil eines Skripts.
Über einen Tosca-Testfall, wenn Sie diesen Prozess automatisieren möchten. In diesem Fall exportiert Tricentis Tosca automatisch einen Report, wenn Sie Ihren Testfall ausführen.

Extraktion über die Befehlszeile auslösen

Gehen Sie zu dem Verzeichnis, das das Befehlszeilentool Tricentis.DataIntegrity.Report.Exporter.exe enthält:
- Unter Windows ist dies %TRICENTIS_DI_HOME%/tools/windows.
- Unter Linux ist dies %Tricentis_DI_HOME%/tools/tools/linux.
Geben Sie die Befehlszeile Tricentis.DataIntegrity.Report.Viewer.exe export <Argumente> ein und ersetzen Sie <Argumente> durch die Argumente, die Sie verwenden möchten.

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

In diesem Beispiel ruft der Report Viewer die Informationen aus der Reportdatei report.db ab, die sich im gleichen Verzeichnis wie die Datei Tricentis.DataIntegrity.Report.Exporter.exe befindet. Sie verwenden den Parameter table nicht, daher exportiert der Report Viewer Reports für alle Tabellen und speichert sie unter C:\ExampleFolder.

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

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

Extraktion über einen Testfall auslösen

Um den Export einer CSV-Datei über einen Testfall auszulösen, führen Sie diese Schritte aus:

Greifen Sie im Tosca Commander auf Ihre DI-Untermenge zu und gehen Sie zu Data Integrity Testing->_DI Sample Tests and Execution Lists->TestCases->Reconciliation->Miscellaneous->Export differences to db and generate shareable HTML report.
Kopieren Sie das Beispiel Generate html report und fügen Sie es in Ihren Complete Row by Row Comparison-Testfall ein.
Ändern Sie das Format, damit Ihr Testfall den Export im CSV-Format auslöst. Wählen Sie dazu eine der folgenden Optionen:
- Löschen Sie das Argument mit dem Wert --format und das Argument mit dem Wert HTML. Wenn Sie den Parameter --format nicht verwenden, führt der Testfall den Export automatisch im CSV-Format aus.
- Ändern Sie den Wert von HTML zu CSV.
Füllen Sie die Testschrittwerte aus:

Testschrittwert	Beschreibung
Path	Geben Sie den vollständigen Pfad zum Report Exporter ein: Unter Windows ist dies %TRICENTIS_DI_HOME%/tools/windows/Tricentis.DataIntegrity.Report.Exporter.exe. Unter Linux ist dies %TRICENTIS_DI_HOME%/tools/tools/linux/Tricentis.DataIntegrity.Report.Exporter.exe.
Arguments	Geben Sie die Argumente ein, die Sie verwenden möchten.
WaitForExit	Geben Sie True ein. Dies ist von entscheidender Bedeutung. Wenn Sie True nicht eingeben, löst der Testfall die Befehlszeile aus, schließt sie aber sofort wieder.
ExitCode	Geben Sie einen Befehlszeilen-ExitCode ein. Wir empfehlen Ihnen, 0 einzugeben und die Aktion Verify auszuwählen. In diesem Fall erhalten Sie in Ihrem Testfall eine Warnung, wenn der Befehl fehlschlägt.

In diesem Beispiel lösen Sie den Export automatisch direkt in Ihrem Testfall aus.

Der Report Viewer ruft die Informationen aus der Reportdatei report.db ab, die sich unter C:/Temp befindet. Er exportiert Reports für die Tabellen Differences und Matched und speichert sie unter C:\ExampleFolder.

Automatisch den Export in Ihrem Testfall auslösen

Liste der verfügbaren Argumente

Sie können die folgenden Argumente verwenden, um den Export eines CSV-Reports auszulösen:

Argumentname	Wert
--i, --input	Pfad zur Datenbankdatei, die den von Ihnen erstellten Vergleichsreport enthält.
--o, --output	Pfad, in dem Sie die Ausgabe speichern möchten: Wenn Sie eine Tabelle exportieren, können Sie den Pfad zu einem Verzeichnis oder einer Datei eingeben. Wenn Sie mehrere spezifische Tabellen exportieren, geben Sie den Pfad zu einem Verzeichnis ein. Der Report Viewer speichert die Reportdateien im Format <Name der Reportdatei>_<Tabelle>. Wenn Sie das Argument table nicht verwenden, weil Sie alle Tabellen exportieren möchten, geben Sie den Pfad zu einem Verzeichnis ein. Hinweis: Die Exportdatei des Reiters Summary ist immer eine JSON-Datei. Wenn Sie den Reiter Summary exportieren möchten und den Pfad zur Datei angeben, muss der Dateiname die Erweiterung .json haben.
--t, --table	Name der Tabelle, für die Sie einen Report exportieren möchten. Geben Sie einen der folgenden Werte ein: Differences, Matched, Unmatched, Invalid, UnmatchedSource, UnmatchedTarget, InvalidSource, InvalidTarget oder Summary. Sie können Reports für mehrere Tabellen auf eine der folgenden Arten exportieren: Verwenden Sie das Argument mehrmals, ein Argument pro Tabelle. Verwenden Sie das Argument überhaupt nicht. In diesem Fall exportiert der Report Viewer Reports für alle Tabellen.
--d, --delimiter	Trennzeichen zum Trennen der Werte. Das Standardtrennzeichen ist ein Komma. Wenn Sie Werte auf eine andere Weise trennen möchten, geben Sie das gewünschte Trennzeichen ein.
--progress	Zeigen Sie den Exportfortschritt an.
--h, --help	Zeigen Sie die Hilfe an.
--V, --version	Zeigen Sie die Versionsinformationen an.