Consulter des résultats de comparaison
Lorsque vous exécutez une comparaison, le résultat de cette comparaison est rapporté par le statut de sortie (code de retour) de la commande qui a appelé le programme d'exécution du DiffDog Server (ou DiffDogCmdlClient). Par exemple, le script batch Windows suivant exécute une comparaison entre deux fichiers et obtient le code de sortie depuis la variable d'environnement %ERRORLEVEL% :
SET DIFFDOGSERVER="C:\Program Files\Altova\DiffDogServer2024\bin\DiffDogServer.exe" |
Script batch Windows
Sur un appareil Linux, le script équivalent ressemblerait à ceci :
#!/bin/bash DIFFDOGSERVER=/opt/Altova/DiffDogServer2024/bin/diffdogserver ${DIFFDOGSERVER} diff book1.xml book2.xml --mode=xml echo $? |
Script shell Linux
Le code de sortie peut présenter une des valeurs suivantes :
Niveau d'erreur | Signification |
0 | Aucune différence n'existe |
1 | Des différences existent |
2 | Une erreur s'est produite |
Lorsque des différences existent (code de sortie = 1), vous pouvez aussi consulter un rapport de comparaison détaillé dans la ligne de commande ou les faire sortir dans un rapport en format XML ou texte. Afin de spécifier le format de sortie en tant que texte ou xml, définir l'option --output-mode. Par exemple, la commande suivante compare deux fichiers de texte en utilisant un mode de comparaison de texte (c'est à dire, --mode=text) et affiche la sortie en tant que texte dans la ligne de commande :
<executable> diff a.txt b.txt --mode=text --output-mode=text |
Afin de rediriger la sortie vers un fichier, définir l'option --output-file. Par exemple, la commande suivante compare deux fichiers de texte en utilisant le mode de comparaison de texte (c'est à dire, --mode=text). Le rapport de sortie sera en format XML et sera redirigé vers le fichier out.xml :
<executable> diff a.txt b.txt --mode=text --output-mode=xml --output-file=out.xml |
| Note : | L'option --output-mode=text n'est pas prise en charge lors de la comparaison des fichiers XML ou de documents Word. |
Par défaut, le rapport contenant des résultats de comparaison sera affiché dans la ligne de commande. Pour supprimer la sortie, définir l'option --quiet=true, par exemple :
<executable> diff a.txt b.txt --mode=text --output-mode=text --quiet=true |
La table suivante recense les formats de rapport pris en charge pour les différents types de comparaison .
Type de comparaison | Rapport XML | Rapport Texte | Notes |
|---|---|---|---|
Fichiers de texte (non-binaires) | Oui | Oui | |
Fichiers XML | Oui | Non | |
Documents Word | Oui | Non | |
Fichiers binaires | Non | Non | Pour consulter le résultat de comparaison pour les fichiers binaires, vérifier le code de sortie après avoir exécuté une comparaison, comme décrit dans Fichiers binaires. |
Répertoires | Oui | Oui |
Les sections suivantes décrivent la structure des fichiers de comparaison produits pour chacun des scénarios ci-dessus. Cette information a pour but de vous aider à comprendre les différences rapportées et peut aussi être utile si vous souhaitez traiter le rapport de manière automatisée.