Anzeige von Vergleichsergebnissen
Bei Ausführung eines Vergleichs wird das Vergleichsergebnis durch den Exit-Status (Rückgabecode) des Befehls, mit dem die ausführbare DiffDog Server- (oder DiffDogCmdlClient)-Datei aufgerufen wurde, angegeben. So wird etwa mit dem folgenden Windows Batch-Skript ein Vergleich zwischen zwei Dateien ausgeführt. Der Exitcode wird über die Umgebungsvariable %ERRORLEVEL% abgerufen:
SET DIFFDOGSERVER="C:\Program Files\Altova\DiffDogServer2024\bin\DiffDogServer.exe" |
Windows Batch-Skript
Auf einem Linux-Rechner würde das entsprechende Skript folgendermaßen aussehen:
#!/bin/bash DIFFDOGSERVER=/opt/Altova/DiffDogServer2024/bin/diffdogserver ${DIFFDOGSERVER} diff book1.xml book2.xml --mode=xml echo $? |
Linux Shell-Skript
Der Exitcode kann einen der folgenden Werte haben:
Exitcode | Bedeutung |
0 | Es gibt keine Unterschiede. |
1 | Es gibt Unterschiede. |
2 | Es ist ein Fehler aufgetreten. |
Wenn Unterschiede vorhanden sind (Exitcode = 1), können Sie außerdem einen detaillierten Vergleichsbericht direkt in der Befehlszeile anzeigen lassen oder diesen im XML- oder Textformat ausgeben. Um das Ausgabeformat als Text oder XML zu definieren, definieren Sie die Option --output-mode. So werden etwa mit dem folgenden Befehl zwei Textdateien im Textvergleichsmodus (d.h. --mode=text) verglichen und das Ergebnis wird in der Befehlszeile als Text angezeigt:
<executable> diff a.txt b.txt --mode=text --output-mode=text |
Um die Ausgabe in eine Datei umzuleiten, definieren Sie die Option --output-file. So werden etwa mit dem folgenden Befehl zwei Textdateien im Textvergleichsmodus (d.h. --mode=text) verglichen. Der Ergebnisbericht ist im XML-Format und wird in die Datei out.xml umgeleitet:
<executable> diff a.txt b.txt --mode=text --output-mode=xml --output-file=out.xml |
| Anmerkung: | Die Option --output-mode=text wird beim Vergleich von XML- oder Word-Dateien nicht unterstützt. |
Standardmäßig wird der Bericht mit den Vergleichsergebnissen in der Befehlszeile angezeigt. Um die Ausgabe zu unterdrücken, definieren Sie die Option --quiet=true, z.B.:
<executable> diff a.txt b.txt --mode=text --output-mode=text --quiet=true |
In der folgenden Tabelle finden Sie eine Liste der für die verschiedenen Vergleichsarten unterstützten Berichtsformate
Vergleichstyp | XML-Bericht | Textbericht | Anmerkungen |
|---|---|---|---|
Textdateien (nicht Binärdatei) | Ja | Ja | |
XML-Dateien | Ja | Nein | |
Word-Dokumente | Ja | Nein | |
Binärdateien | Nein | Nein | Um das Vergleichsergebnis für Binärdateien anzuzeigen, überprüfen Sie nach Ausführung des Vergleichs den Exitcode, wie unter Binärdateien beschrieben. |
Verzeichnisse | Ja | Ja |
In den folgenden Abschnitten wird die Struktur der für die einzelnen oben angeführten Szenarien erzeugten Vergleichsberichtsdateien beschrieben, um Ihnen einen Überblick über die gemeldeten Unterschiede zu geben bzw. damit Sie den Bericht auch auf automatisierte Weise verarbeiten können.