Aktivieren Sie bitte JavaScript, um diese Seite anzeigen zu können.

Altova DiffDog Server 2020 

Mit dem Befehl run wird ein Vergleich ausgeführt, wenn eine der folgenden Dateiarten als Argument angegeben wird:

 

*.dirdif- (Verzeichnisvergleich)

*.filedif (Dateivergleich)

*.dbdif (Datenbankdatenvergleich)

 

Sie können  .filedif- und .dirdif-Dateien mit der Altova DiffDog Desktop-Applikation (https://www.altova.com/de/diffdog) erstellen, indem Sie einen Datei- oder Verzeichnisvergleich als Datei speichern. Datenbankdatenvergleiche (.dbdif) können nur in der DiffDog Enterprise Edition erstellt werden.

 

Die Ausführung von *.filedif und *.dirdif-Dateien mit DiffDog Server wird nur unter Windows unterstützt. Damit der Vergleich funktioniert, müssen alle Datei- oder Verzeichnispfade, die auf dem Desktop-Rechner gültig waren, auch auf dem Server-Rechner gültig sein. Wenn Sie die Vergleichsaufträge direkt in DiffDog Server einrichten (anstatt *.dbdif- oder *.dirdif-Dateien zu verwenden), können Sie diese plattformunabhängig ausführen.

 

Am einfachsten lassen sich *.dbdif-Dateien mit DiffDog Server ausführen, wenn DiffDog Server entweder auf demselben Rechner wie DiffDog Desktop oder auf einem Windows-Rechner installiert ist. Wenn DiffDog Server auf einem anderen Rechner oder Betriebssystem ausgeführt wird, gelten die folgenden Einschränkungen:

 

Wenn CSV-Dateien am Vergleich beteiligt sind, wird die Ausführung von .dbdif-Dateien nur auf Windows Servern unterstützt. Damit der Vergleich funktioniert, müssen alle CSV-Dateipfade, die auf dem Desktop-Rechner gültig waren, auch auf dem Server-Rechner gültig sein.

Wenn Datenbankverbindungen am Vergleich beteiligt sind, muss der Server-Rechner für die Verarbeitung der Datenbankverbindung konfiguriert sein und dazu in der Lage sein, d.h. auf dem Zielbetriebssystem müssen alle Datenbanktreiber vorhanden sein und andere für die Verbindung erforderlichen Voraussetzungen erfüllt werden. Wenn die .dbdif-Datei etwa eine Verbindung enthält, für die ein ODBC-Treiber des Datenbankanbieters benötigt wird, so muss der Treiber auch auf dem Server-Rechner installiert sein. Beachten Sie, dass einige unter Windows unterstützte Datenbankverbindungsmethoden auf Linux und macOS nicht unterstützt werden. Informationen dazu finden Sie unter Unterstützte Datenbanken.

 

Wenn Sie die Vergleichsaufträge direkt in DiffDog Server einrichten (anstatt *.dbdif-Dateien zu verwenden), können Sie diese plattformunabhängig ausführen.

 

Wenn Sie den run Befehl starten, gibt DiffDog Server das Ergebnis des Vergleichs, ähnlich wie beim Befehl diff, durch den Rückgabestatuscode aus (0 = keine Unterschiede, 1 = Unterschiede, 2 = Fehler). Die Ausgabe wird direkt in der Befehlszeile angezeigt, außer Sie unterdrücken dies mit der Option --quiet.

 

Sie können die Ausgabe bei .filedif- oder .dirdif-Vergleichen optional in einer Berichtsdatei im XML- oder Textformat ausgeben. Der Pfad zur Berichtsdatei wird über die grafische Benutzeroberfläche der DiffDog Desktop-Applikation definiert. Sie können den Ausgabepfad eines .filedif- oder .dirdif-Vergleichs in DiffDog folgendermaßen definieren:

 

1.Öffnen Sie eine vorhandene .dirdif- oder .filedif Datei (oder erstellen Sie einen neuen Vergleich) in DiffDog.

2.Klicken Sie im Menü Extras auf Vergleichsdokumentoptionen.

3.Wählen Sie eine der folgendem Methoden:

a.Um das Ergebnis nicht in einer Datei zu speichern, klicken Sie auf Kein Export (Dies ist die Standardoption).

b.Um den Vergleichsbericht in einer Textdatei zu speichern, klicken Sie auf Textdatei und geben Sie anschließend den Pfad in das benachbarte Textfeld ein.

c.Um den Bericht in einer XML-Datei zu speichern, klicken Sie auf XML-Datei und geben Sie anschließend den Pfad in das benachbarte Textfeld ein.

4.Klicken Sie im Menü Datei auf Speichern unter und speichern Sie den Vergleich als .filedif (oder gegebenenfalls als .dirdif).

 

Bei .dbdif-Vergleichen steht das Vergleichsergebnis nur im XML-Format zur Verfügung. Mit Hilfe der Command Shell-Umleitung können Sie die Ausgabe in eine Datei umleiten, z.B:

 

DiffDogCmdlClient run comparison.dbdif >"C:\result.xml"

 

Syntax

DiffDogCmdlClient run comparison-file1 [comparison-file2 [comparison-fileN]]

 

Der Befehl run kann auch mit dem Alias import oder load aufgerufen werden. Sie können run, import oder load daher austauschbar verwenden.

 

Verwenden Sie auf Linux-Systemen zum Aufrufen der ausführbaren Datei nur Kleinbuchstaben. Außerdem müssen Sie auf Linux- und macOS-Systemen dem Namen der ausführbaren Datei eventuell das Präfix "./" voranstellen, wenn Sie diese vom aktuellen Verzeichnis der Command Shell aus aufrufen.

 

Argumente

comparison-file

Definiert den Pfad zu einer Vergleichsdatei im .dirdif- oder .filedif-Format. Der Pfad zur Vergleichsdatei kann ein absoluter Pfad oder ein relativer Pfad zum Arbeitsverzeichnis sein. Sie können als Argumente so viele Vergleichsdateien wie notwendig angeben. Dies ist nur durch die Anzahl der von Ihrer Befehlszeilen-Shell unterstützten Eingabezeichen eingeschränkt.

 

Optionen

--config, --c

Mit dieser Option wird der Pfad zu einer Client-Konfigurationsdatei, in der die Informationen für die Verbindung mit DiffDog Server definiert sind, angegeben.

 

Wenn Sie die Option --c nicht definieren, versucht die ausführbare DiffDog-Befehlszeilen-Client-Datei, die Client-Konfigurationsdatei aus demselben Verzeichnis zu lesen. Wenn sich keine Konfigurationsdatei im selben Verzeichnis wie die ausführbare Datei befindet, werden die in der Befehlszeilenhilfe und dieser Dokumentation beschriebenen Standardwerte verwendet.

 

--port

Mit dieser Option wird der Port definiert, unter dem DiffDog Server für Requests empfangsbereit ist. Eine Definition dieser Option ist dann sinnvoll, wenn DiffDog Server an einem anderen als dem Standard-Port 29800 ausgeführt wird. Anstatt diese Option in der Befehlszeile zu definieren, können Sie sie auch in der Client-Konfigurationsdatei definieren. Wenn Sie diesen Wert in der Befehlszeile setzen, beachten Sie, dass er Vorrang vor einem in der Konfigurationsdatei definierten Wert hat.

 

--quiet, --q

Verhindert, dass die Standardausgabe in der Befehlszeile angezeigt wird. Gültige Werte:

 

true

Standardausgabe nicht im Terminal-Fenster anzeigen.

false

(Standardwert) Standardausgabe im Terminal-Fenster anzeigen.

 

--loglevel, --L

Definiert die Ausgabeebene für Informationen, Warnungen und Fehlermeldungen. Gültige Werte:

 

none

Unterdrückt die Protokollierung.

info

Informationen, Warnungen und Fehlermeldungen ausgeben.

warning

Fehler und Warnmeldungen ausgeben.

error

(Standardeinstellung) Nur Fehlermeldungen ausgeben.

 

--output-mode, --om

Diese Option definiert des Format des Vergleichsberichts. Gültige Werte:

 

auto

(Standardwert) Lass die Applikation entscheiden.

text

Bericht im Textformat ausgeben.

sql

Bericht im SQL-Format ausgeben. Dieser Wert ist sinnvoll, wenn es sich bei der rechten Seite des Datenvergleichs um eine Datenbank handelt. Der Bericht enthält SQL-Anweisungen, die Daten von der linken auf der rechten Seite des Vergleichs zusammenführen. Wenn z.B. auf der rechten Seite Zeilen fehlen, werden INSERT-Anweisungen generiert. Umgekehrt, wenn auf der rechten Seite zusätzliche Zeile vorhanden sind, werden DELETE-Anweisungen generiert. Für geänderte Werte werden UPDATE-Anweisungen generiert.

xml

Bericht im XML-Format ausgeben.

 

--server

Mit dieser Option wird die Server-Adresse definiert, unter der DiffDog Server für Requests empfangsbereit ist. Eine Definition dieser Option ist dann sinnvoll, wenn DiffDog Server auf einem anderen als dem lokalen Standardserver localhost ausgeführt wird. Anstatt diese Option in der Befehlszeile zu definieren, können Sie sie auch in der Client-Konfigurationsdatei definieren. Wenn Sie diesen Wert in der Befehlszeile setzen, beachten Sie, dass er Vorrang vor einem in der Konfigurationsdatei definierten Wert hat.

 

Beispiel

Um die Vergleichsdatei C:\DiffDog\Comparison1.filedif auszuführen, dann verwenden Sie den folgenden Befehl:

 

DiffDogCmdlClient run C:\DiffDog\Comparison1.filedif

 

Um die Vergleichsdateien Comparison1.filedif und Comparison2.dirdif auszuführen (beide im Verzeichnis C:\DiffDog), dann verwenden Sie den folgenden Befehl:

 

DiffDogCmdlClient run C:\DiffDog\Comparison1.filedif C:\DiffDog\Comparison2.dirdif

© 2020 Altova GmbH