Altova DiffDog Server 2025 

Der Befehl run kann sowohl auf die ausführbare DiffDog Server-Datei als auch auf den DiffDog-Befehlszeilenclient angewendet werden. Mit dem Befehl run wird ein Vergleich ausgeführt. Der Befehl kann mit den folgenden Argumenten ausgeführt werden:

•*.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.

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:

Syntax

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

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 Verbindungsinformationen zu 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:

--loglevel, --L

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

--output-mode, --om

Diese Option definiert des Ausgabeformat des generierten Berichts. Die folgenden Werte werden unterstützt: auto (Standardwert), text, sql, xml, html.

Beachten Sie die folgenden Punkte zum Wert 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.

--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.

--alias

Definiert, welcher Alias verwendet werden soll, wenn der Server im eingeschränkten Modus ausgeführt wird.

Beispiele

Mit dem unten stehenden Befehl wird die ausführbare DiffDog Client-Datei aufgerufen, um die Vergleichsdatei C:\DiffDog\Comparison1.filedif auszuführen:

Mit dem unten stehenden Befehl wird die ausführbare DiffDog Client-Datei aufgerufen, um die Vergleichsdateien Comparison1.filedif und Comparison2.dirdif auszuführen: