Altova DiffDog Server 2025 

Al comparar archivos en modo texto (configurado con la opción CLI --mode=text), puede ver el informe de comparación en formato texto o en formato XML (lo cual se configura con--output-mode). Para entender cómo DiffDog Server informa de las diferencias entre archivos de texto, supongamos que los siguientes dos archivos de texto deben ser comparados en paralelo. (Tenga en cuenta que los archivos de texto incluyen, no solo los archivos .txt, sino también cualquier otro tipo de archivo no binario, como .html, .json, .js y .cs.)

Cuando los dos archivos se comparan en la interfaz gráfica de DiffDog (imagen siguiente), las diferencias entre los dos archivos se pueden ver claramente, como se muestra a continuación. En file2.txt, se ha añadido la línea 2, la línea 4 es diferente y falta la línea 6.

En DiffDog Server, puede ejecutar el siguiente comando para comparar estos dos archivos de texto y recibir un informe de comparación en formato texto.

diffdogcmdlclient diff file1.txt file2.txt --mode=text --output-mode=text --output-file=report.txt

•The --mode option treats the compared files as text (not as XML or binary).

•La opción --output-mode especifica el formato del informe de comparación (texto o XML).

•La opción --output-file especifica la ruta al archivo de informe generado.

•Dado que no existe la opción --quiet=true, el informe de comparación se generará tanto en la línea de comandos como en un archivo de salida. Consulte «Formatos de informe» en el tema Resultados de la comparación.

En las secciones siguientes describimos cómo se muestran los resultados de la comparación en los informes de texto y XML, respectivamente.

Informe en formato texto

En el informe en formato texto generado tras ejecutar la comparación, las diferencias se indican de la siguiente manera:

1a2

> nuts

3c4

< grape

---

> grapes

5d5

< strawberries

En el informe anterior, «a» en «1a2» indica un elemento añadido; «c» en «3c4» indica un cambio; y «d» en «5d5» indica un elemento eliminado. Los números a ambos lados de la letra son los números de línea del archivo izquierdo y derecho, respectivamente. Los caracteres «>» y «<» indican el archivo derecho e izquierdo, respectivamente, y las líneas en las que aparecen indican (i) qué se ha añadido y en qué sitio; (ii) qué es diferente y en qué sitio; y (iii) qué falta y en qué sitio (mostrando el texto del archivo donde está presente).

Los resultados deben entenderse como instrucciones a seguir para conseguir que ambos archivos sean iguales.

•1a2 significa «Después de la línea 1 del archivo izquierdo, añada el texto indicado para igualarlo con la línea 2 del archivo derecho». La línea siguiente muestra el texto que debe añadirse. En nuestro ejemplo, el texto «nuts» del archivo de la derecha debe añadirse al archivo de la izquierda.

•3c4 significa "Reemplace la línea 3 del archivo de la izquierda con la línea 4 del archivo de la derecha". Las siguientes líneas muestran el contenido relevante de ambos archivos, separados por "---".

•5d5 significa "Borre la línea 5 del archivo de la izquierda para que sea igual a la línea 5 del archivo de la derecha". La siguiente línea muestra el texto exacto que hay que borrar (en este caso «strawberries»).

Informe XML

También puede comparar los mismos dos archivos y obtener un informe en formato XML con este comando:

diffdogcmdlclient diff file1.txt file2.txt --mode=text --output-mode=xml --output-file=report.xml

El informe en formato texto mostrado anteriormente aparecería, en formato XML, como se muestra a continuación.

<?xml version="1.0" encoding="UTF-8"?>
<!-- Differencing export generated by Altova DiffDog Server -->
<diff_result>
  <diff_info comparison_mode="text">
     <source_left name="c:\file1.txt" uri="file:///c:/file1.txt"/>
     <source_right name="c:\file2.txt" uri="file:///c:/file2.txt"/>
  </diff_info>
  <text_diff left_location="1" right_location="2">
     <right_content>
        <line>nuts</line>
     </right_content>
  </text_diff>
  <text_diff left_location="3" right_location="4">
     <left_content>
        <line>grape</line>
     </left_content>
     <right_content>
        <line>grapes</line>
     </right_content>
  </text_diff>
  <text_diff left_location="5" right_location="5">
     <left_content>
        <line>strawberries</line>
     </left_content>
  </text_diff>
</diff_result>

Tenga en cuenta los siguientes puntos sobre el informe XML:

•El elemento diff_info de la parte superior proporciona información sobre los archivos comparados, incluyendo el modo de comparación utilizado y las rutas de los archivos comparados. Es un elemento que aparece solamente una vez. (El atributo comparison_mode indica el valor suministrado para la opción --mode en la línea de comandos, o el valor predeterminado de la opción si no se suministró ningún valor en la línea de comandos).

•Los elementos text_diff detallan las diferencias de texto encontradas. Sus atributos left_location y right_location indican las líneas de los archivos respectivos en las que se produce la diferencia.

•Los elementos left_content y right_content, respectivamente, contienen las líneas que son diferentes en cada text_diff. Si tanto left_content como right_content están presentes, se indica una diferencia textual dentro de una línea. Sin embargo, si solo está presente left_content o right_content, entonces lo que se indica es una línea adicional o una línea eliminada.

•El elemento line contiene el texto que es diferente. Si la diferencia abarca varias líneas, habrá varios elementos line consecutivos en el elemento text_diff.