Altova DiffDog Server 2024 

El comando diff afecta tanto al archivo ejecutable de DiffDog Server como a la línea de comandos del cliente de DiffDog. El comando diff efectúa una comparación en paralelo de dos archivos, directorios o URLs. Las entidades que se comparan pueden ser de distinto tipo (por ejemplo, puede comparar una URL, como http://server/file.txt, con una ruta de acceso a un archivo, como C:\file.txt). Tenga en cuenta que se pueden comparar archivos con URLs, por ejemplo, pero no archivos y directorios (ni URLs y directorios).
 

También se pueden comparar archivos de Microsoft Word 2003 o superior (.docx, .dotx), véase Comparar documentos de Word.

Una comparación a menudo implica un "lado derecho" y un "lado izquierdo". Sin embargo, también es posible realizar comparaciones a tres bandas en el caso de archivos y URLs (pero no con directorios). Los archivos o directorios de la comparación pueden estar en el equipo en el que se ejecuta DiffDog Client o en el equipo remoto en el que se ejecuta DiffDog Server. También se puede usar un método combinado (comparar archivos o directorios locales con otros remotos).

Sintaxis

También se puede llamar a este comando usando el alias compare. Puede usar compare y diff indistintamente.

Argumentos

path

El argumento path puede ser la ruta a un archivo o directorio o una ruta URL con el formato http://server/segment.

Usar rutas como argumentos es solo una de las dos posibles maneras de dar rutas de entrada al comando diff. La segunda manera es establecer las opciones -client-left, --client-right o --server-left, --server-right. Use el segundo método si DiffDog Client no se ejecuta en el mismo equipo que DiffDog Server.
 
En otras palabras, si usa las opciones -client-left, --client-right o --server-left, --server-right, entonces no necesita especificar ninguna ruta como argumentos. Si no usa estas opciones deberá dar exactamente dos rutas como argumentos. (Para hacer una comparación a tres bandas deberá dar tres rutas como argumentos.)

Opciones

A continuación enumeramos las opciones que se pueden aplicar al comando diff.

--alias, --a

Si el administrador de servidor ha restringido el acceso a las rutas del servidor por razones de seguridad ya no podrá hacer comparaciones que hagan referencia directa a rutas de servidor (véase Restringir el acceso a las rutas de servidor). En su lugar deberá indicar el nombre de un alias con la opción --alias.

Esta opción es importante si la comparación incluye una ruta de servidor (es decir, si se usan las opciones --server-left o --server-right). Los valores válidos para esta opción son los alias definidos en el Archivo de configuración del servidor. Para obtener la lista de alias disponibles, ejecute el comando aliases. Para más información consulte Restringir el acceso a las rutas de servidor.

--config, --c

Esta opción indica la ruta a un archivo de configuración del cliente. Para más información, consulte el apartado Archivo de configuración del cliente.

Si no establece la opción --c, el ejecutable de DiffDog Client intentará leer el archivo de configuración del cliente desde el mismo directorio. Si no existe un archivo de configuración en el mismo directorio que el ejecutable se usarán los valores descritos en la ayuda de la línea de comandos y en esta documentación.

--client-left, --cl

Esta opción indica el lado izquierdo de la comparación (debe ser una ruta a un archivo o directorio local).

--client-middle, --cm

Esta opción se puede aplicar la comparación a tres bandas. Indica la ruta local al archivo del "medio" (también conocido como "ancestro común").

--client-right, --cr

Esta opción especifica el lado derecho de la comparación (debe ser una ruta a un archivo o directorio local).

--dir-compare-contents, --dc

Esta opción indica si en una comparación de directorios se debe comparar el contenido de los archivos además de cualquier otra opción que se haya definido por separado (como tamaño o fecha de modificación de los archivos). Para ignorar el contenido de los archivos en una comparación, establezca este valor en false (esto llevará a una comparación más rápida aunque menos exacta). El valor predeterminado de esta opción es true.

--directory-filter, --df

Esta opción se puede aplicar a comparaciones de directorios. Los filtros de directorios permiten definir criterios para que se incluyan o excluyan de la comparación ciertos archivos o subdirectorios. Son valores válidos para esta opción filtros de directorios definidos en el archivo de configuración del cliente, en el grupo [dir.filter]. Por ejemplo, si el archivo de configuración define un filtro [dir.filter:svn], use la siguiente sintaxis para establecer este filtro en la línea de comandos:

--directory-filter=svn

En Windows, si se instala DiffDog en el mismo equipo que DiffDog Server puede indicar como valor de opción cualquier filtro de directorio que ya exista en DiffDog (sea predeterminado o personalizado). Por ejemplo, para establecer el filtro predeterminado "ningún directorio SVN" en la línea de comandos, use esta sintaxis:
 

--directory-filter="No SVN directories"

Para ver o crear un filtro de directorios en DiffDog:

1.En el menú Herramientas, haga clic en Opciones de DiffDog.

2.Haga clic en la pestaña Comparación de directorios.

Para más información sobre cómo crear filtros de directorios con DiffDog, consulte la documentación de DiffDog (https://www.altova.com/es/documentation).

--dir-compare-mod-times-ignore-seconds, --di

Esta opción se puede aplicar a la comparación de directorios. Indica que en la comparación de directorios se debe ignorar un número dado de segundos (+/-) al comparar horas de modificación. El valor predeterminado de esta opción es 0, que significa que la comparación no ignorará ninguna diferencia temporal.

--dir, --dir-ignore-case, --dic

Esta opción se puede aplicar a la comparación de directorios. El valor predeterminado de esta opción es false, que significa que la comparación no distingue entre minúsculas y mayúsculas. Por ejemplo, los directorios siguientes se tratarían como directorios distintos (porque el nombre del archivo del directorio derecho es distinto).

Para ignorar las minúsculas y mayúsculas en la comparación, establezca esta opción en true. En este caso, un directorio llamado "UnDirectorio" se consideraría igual que "undirectorio", o un archivo "archivo.TXT" sería igual que "archivo.txt".
 

--dir-compare-sizes, --ds

Esta opción se puede aplicar a la comparación de directorios. Si su valor es true, indica que se debe comparar el tamaño de los directorios. De lo contrario se ignora este criterio de comparación. El valor predeterminado de esta opción es false.

--dir-compare-mod-times, --dt

Esta opción se puede aplicar a la comparación de directorios. Si su valor es true indica que al comparar directorios se deben comparar los archivos que estos contengan según la hora de modificación. De lo contrario se ignora este criterio de comparación. El valor predeterminado de esta opción es false.

--doc-format-bold, --dfb

Esta opción se puede aplicar a la comparación de documentos de Word. Son valores válidos:

--doc-format-font-color, --dfc

Esta opción se puede aplicar a la comparación de documentos de Word. Son valores válidos:

--doc-format-font-name, --dff

Esta opción se puede aplicar a la comparación de documentos de Word. Son valores válidos:

--doc-format-font-size, --dfs

Esta opción se puede aplicar a la comparación de documentos de Word. Son valores válidos:

--doc-format-italic, --dfi

Esta opción se puede aplicar a la comparación de documentos de Word. Son valores válidos:

--doc-format-underline, --dfu

Esta opción se puede aplicar a la comparación de documentos de Word. Son valores válidos:

--doc-ignore-blank-lines, --dib

Esta opción se puede aplicar al comparar documentos de Word o directorios que contienen documentos de Word. En el caso de las comparaciones de directorios, la opción se aplica solamente a los documentos de Word de ese directorio. Valores válidos:

--doc-ignore-case, --doc

Esta opción se aplica a las comparaciones de documentos de Word o directorios que contengan documentos de Word. En el caso de las comparaciones de directorios, la opción se aplica solamente a los documentos de Word de ese directorio. Son valores válidos:

--doc-whitespace-mode, --dws

Esta opción se puede aplicar a la comparación de documentos de Word o a la de directorios que contengan documentos de Word. En el caso de la comparación de directorios, la opción se aplica solo a los documentos de Word que haya en ellos.

Define cómo deben tratarse en la comparación los espacios en blanco. Estos caracteres pueden ser los siguientes: espacios, tabulaciones, retornos de carro y avances de línea

--ignore-blank-lines

Esta opción indica si las líneas en blanco se deben ignorar en la comparación. Son valores válidos true y false. El valor predeterminado es false.

La opción se aplica en función de la opción --mode que esté activa. Si --mode=text, entonces se aplica a archivos de texto y equivale a la opción --text-ignore-blank-lines. Si --mode=xml, entonces no afecta a la comparación. Si --mode=doc, entonces se aplica a los documentos de Word y equivale a la opción --doc-ignore-blank-lines. Si compara directorios, se aplica a cada todos los tipos de comparaciones que se encuentren en ese directorio.

--ignore-case

Esta opción se puede aplicar tanto a las comparaciones de archivos como a las de directorios. La opción se aplica en función de la opción --mode que esté activa. Si --mode=text, entonces se aplica a archivos de texto y equivale a la opción --text-ignore-case. Si --mode=xml, entonces se aplica a archivos XML y equivale a las opciones --xml-ignore-case-in-names y --xml-ingore-case-in-text. Si --mode=doc, entonces se aplica a documentos de Word y equivale a la opción --doc-ignore-case. Si compara directorios, se aplica a cada todos los tipos de comparaciones que se encuentren en ese directorio. Son valores válidos:

--loglevel, --L

Establece el nivel de información que se proporciona sobre mensajes de información, advertencia y error. Son valores válidos:

--mode, --m

Esta opción indica el tipo de comparación que se debe realizar. Son valores válidos:

--output-file, --o

Esta opción permite escribir el resultado del comando en un archivo de texto en el equipo cliente. El valor debe especificar una ruta de archivo válida en el equipo cliente. Use la opción --om para indicar el formato del archivo de salida.

--output-mode, --om

Esta opción permite indicar el formato en que se debe crear el resultado de la comparación (texto o XML). Son valores válidos: auto (opción predeterminada), text, xml, html.

--port

Esta opción indica el puesto en el que DiffDog Server atiende las respuestas. Activar esta opción es útil si DiffDog Server se ejecuta en un puerto que no sea el predeterminado, 29800. Puede definir esta opción en la línea de comandos o en el archivo de configuración del cliente. Tenga en cuenta que si la define desde la línea de comandos esta opción tiene prioridad frente a la que se haya definido en el archivo de configuración.

--quiet, --q

Evita que la salida estándar se muestre en la línea de comandos. Son valores válidos:

--server-output-file, --s

Esta opción permite escribir la salida del comando en un archivo de texto en el equipo servidor. El valor debe indicar una ruta de archivo válida en el equipo servidor. Use la opción --om para establecer el formato del archivo de salida.

--server

Esta opción indica el puesto en el que DiffDog Server atiende las respuestas. Activar esta opción es útil si DiffDog Server se ejecuta en un servidor que no sea el predeterminado, localhost. Puede definir esta opción en la línea de comandos o en el archivo de configuración del cliente. Tenga en cuenta que si la define desde la línea de comandos esta opción tiene prioridad frente a la que se haya definido en el archivo de configuración.

--server-left, --sl

Esta opción permite añadir una ruta remota a la comparación. Indica el lado izquierdo de la comparación (una ruta a un archivo o directorio al que el servidor pueda acceder).

--server-middle, --sm

Esta opción permite añadir una ruta remota a la comparación. Indica el elemento del medio de la comparación (en comparaciones a tres bandas). El valor debe ser una ruta a un archivo o directorio al que el servidor pueda acceder.

--server-right, --sr

Esta opción permite añadir una ruta remota a la comparación. Indica el lado derecho de la comparación (una ruta a un archivo o directorio al que el servidor pueda acceder).

--text-ignore-case, --ic

Esta opción se puede aplicar al comparar archivos de texto o directorios que contengan documentos de texto. En las comparaciones de directorios la opción se aplica solo a los archivos de texto que contenga ese directorio.

Son valores válidos:

--text-ignore-blank-lines, --ib

Esta opción se puede aplicar al comparar documentos de texto o directorios que contengan documentos de texto. En las comparaciones de directorios la opción se aplica solo a los archivos de texto que contenga ese directorio. La opción indica si se deben ignorar las líneas en blanco en la comparación de archivos de texto. Son valores válidos true y false. El valor predeterminado es false.

--text-whitespace-mode, --tws

Esta opción se puede aplicar al comparar documentos de texto o directorios que contengan documentos de texto. En las comparaciones de directorios se aplica solo a los archivos de texto que contenga ese directorio.

Define cómo deben tratarse en la comparación los espacios en blanco. Estos caracteres pueden ser los siguientes: espacios, tabulaciones, retornos de carro y avances de línea

--whitespace-mode, --ws

Esta opción se aplica a comparaciones de archivos y directorios. Puede indicar el tipo de archivo con la opción --mode. Si indica --mode=text, entonces la opción afecta a archivos de texto y equivale a la opción --text-whitespace-mode. Si indica --mode=xml, entonces la opción afecta a documentos Word y equivale a la opción --doc-whitespace-mode. Si quiere comparar directorios, esta opción afecta a todos los tipos de comparaciones que se puedan hacer con los archivos que contienen esos directorios, en función de la extensión de los archivos.

Define cómo deben tratarse en la comparación los espacios en blanco. Estos caracteres pueden ser los siguientes: espacios, tabulaciones, retornos de carro y avances de línea

Si se están comparando archivos XML se eliminan o normalizan los espacios en blanco de los valores de atributo. El resto de espacios en blanco se ignoran.

--xml-filter, --xf

Esta opción se aplica a comparaciones XML. Un filtro XML contiene reglas que indican que se deben ignorar ciertos atributos o elementos XML en la comparación. Son valores válidos para esta opción los filtros XML definidos en el archivo de configuración del cliente, en el grupo [xml.filter]. Por ejemplo, si el archivo de configuración define un filtro [xml.filter:ignore-abc-elems], use la siguiente sintaxis para establecer el filtro en la línea de comandos:

--xml-filter=ignore-abc-elems

En Windows, si DiffDog está instalado en el mismo equipo que DiffDog Server puede indicar como valor de opción cualquier filtro XML creado con DiffDog. Para ver o definir un filtro XML en DiffDog, siga estos pasos:

1.En el menú Herramientas, haga clic en Opciones de comparación.

2.Haga clic en la pestaña XML.

3.En la opción Filtrar elementos o atributos concretos, en la parte inferior derecha, haga clic en el botón con puntos suspensivos .

Para más información sobre cómo crear filtros XML con DiffDog, consulte la documentación de DiffDog (https://www.altova.com/es/documentation).

--xml-ignore-case-in-names, --xicin

Esta opción se puede aplicar al comparar archivos XML. Al establecerla en true se efectuará una comparación de denominaciones de identificadores sin tener en cuenta las mayúsculas. Por ejemplo, imaginemos que quiere comparar los siguientes dos archivos XML:

En este listado el atributo ID está en mayúsculas en el archivo del lado izquierdo pero no en el del derecho. Si --xml-ignore-case-in-names=true, entonces se ignoran las mayúsculas, por lo que esos dos archivos se tratarán como iguales. Por defecto, esta opción está establecida en false, lo que significa que esos dos archivos no se son iguales.

--xml-ignore-case-in-text, --xicit

Esta opción se puede aplicar al comparar archivos XML. Si se establece en true se realizará una comparación de texto sin lenguaje de marcado en la que no se tendrán en cuenta las mayúsculas. Por ejemplo, imaginemos que quiere comparar los siguientes dos archivos XML:

En este listado el valor del atributo hardcover está en minúsculas en el archivo del lado izquierdo pero en el del derecho está en mayúsculas. Pasa lo mismo con el valor del elemento genre. Para poder tratar estos dos archivos como iguales, establezca --xml-ignore-case-in-text=true. Por defecto, esta opción tiene como valor false, lo que significa que archivos como los anteriores no son iguales.

--xml-ignore-markup-attributes, --xima

Esta opción se puede aplicar al comparar archivos XML. Son valores válidos:

--xml-ignore-markup-comments, --ximc

This option is applicable when comparing XML files. Valid values:

--xml-ignore-markup-cdata, --ximcd

Esta opción se puede aplicar al comparar archivos XML. Son valores válidos:

--xml-ignore-markup-doctype, --ximd

Esta opción se puede aplicar al comparar archivos XML. Son valores válidos:

--xml-ignore-markup-processing-instructions, --ximpi

Esta opción se puede aplicar al comparar archivos XML. Son valores válidos:

--xml-ignore-markup-xml, --ximx

Esta opción se puede aplicar al comparar archivos XML. Son valores válidos:

--xml-ignore-namespace, --xins

Esta opción se puede aplicar al comparar archivos XML. Si se establece en true, se ignorarán los espacios de nombres XML en la comparación. Por defecto, el valor de esta opción es false.

--xml-ignore-prefixes, --xip

Esta opción se puede aplicar al comparar archivos XML. Si se establece en true, se ignorarán los prefijos XML en la comparación. Por ejemplo, imagine que quiere comparar los archivos XML que ve a continuación. Ambos contienen elementos idénticos pero los prefijos son distintos.

Por defecto, el valor de esta opción es false, lo que significa que los archivos no se consideran iguales. Sin embargo, si la opción --xml-ignore-prefixes se establece en true, entonces los prefijos se ignoran y los archivos se consideran iguales.

--xml-ignore-text, --xit

Esta opción se puede aplicar al comparar archivos XML. Si se establece en true, en la comparación se ignorará el contenido de texto de los nodos XML. Esto es útil si quiere comparar únicamente la estructura de dos archivos XML e ignorar el contenido de los nodos. Por defecto, el valor de esta opción es false.

--xml-order-by-attributes, --xoba

Esta opción se puede aplicar al comparar archivos XML. Establezca esta opción en true si quiere ordenar todos los atributos XML antes de la comparación. Por ejemplo, imaginemos que quiere comparar los siguientes dos archivos XML:

En este listado el orden de los atributos es distinto en cada uno de los archivos, aunque los atributos son los mismos. Si establece la opción --xml-order-by-attributes en true, la aplicación ordenará los atributos antes de compararlos y, por tanto, considerará los archivos como iguales. El valor por defecto es false, lo que significa que los archivos no son iguales si el orden de los atributos no es el mismo.

--xml-order-by-elements, --xobe

Esta opción se puede aplicar al comparar archivos XML. Establezca esta opción en true si quiere todos los elementos XML antes de la comparación. Por ejemplo, imaginemos que quiere comparar los siguientes dos archivos XML:

En este listado los archivos del lado derecho y del izquierdo contienen exactamente los mismos elementos, solo que en un orden distinto. Si establece la opción --xml-order-by-elements en true, la aplicación ordenará los elementos antes de compararlos y, por tanto, considerará los archivos como iguales. El valor por defecto es false, lo que significa que los archivos no son iguales si el orden de los elementos no es el mismo.
 

--xml-order-by-attribute-list, --xobl

Esta opción se puede aplicar al comparar archivos XML. Hay instancias en las que varios elementos tienen exactamente el mismo nombre y los mismos atributos, pero los valores de los atributos son diferentes. Para filtrar por atributos concretos antes de la comparación, establezca esta opción en una lista de atributos creados en el archivo de configuración del cliente, en el grupo [xml.orderby:<name_of_your_list>].

Por ejemplo, imaginemos que quiere comparar los siguientes dos archivos XML:

En este listado los archivos de los lados izquierdo y derecho no son iguales. Sin embargo, si ordenara todos los elementos phone por su atributo ext, entonces sí serían iguales. Para hacer posibles estas comparaciones, primero debe modificar el archivo de configuración del cliente como sigue:

Ahora puede ejecutar el comando diff con la opción --xml-order-by-attribute-list=mylist. Al hacerlo la aplicación ordena los elementos por su atributo ext y como resultado los archivos se consideran iguales. Si la opción --xml-order-by-attribute-list no está establecida, archivos como los dos anteriores NO se considerarían iguales.

Otra opción, para ordenar por todos los atributos, establezca la opción --xml-order-by-attributes=true.

En Windows, si DiffDog está instalado en el mismo equipo que DiffDog Server, puede establecer esta opción en una lista de atributos personalizada creada en DiffDog. Para ver o crear una lista de atributos personalizada en DiffDog:

1.En el menú Herramientas, haga clic en Opciones de comparación.

2.Haga clic en la pestaña XML.

3.Marque la casilla Omitir orden de nodos secundarios.

4.Haga clic en Atributos concretos y luego en el botón con puntos suspensivos .

Para más información sobre cómo crear listas de atributos personalizadas con DiffDog, consulte la documentación de DiffDog (https://www.altova.com/es/documentation).

--xml-order-by-text, --xobt

Esta opción se puede aplicar al comparar archivos XML. Hay instancias en las que varios elementos tienen exactamente el mismo nombre y los mismos atributos, pero el texto de los elementos difiere. Establezca esta opción en true si quiere ordenar estos elementos por su texto antes de la comparación. Por ejemplo, imaginemos que quiere comparar los siguientes archivos:

En este listado, los archivos del lado izquierdo y del derecho no son iguales. Sin embargo, si establece la opción --xml-order-by-text en true, la aplicación ordenará los elementos por su texto y, como resultado, los archivos serán tratados como iguales. El valor predeterminado es false, lo que significa que los elementos no están ordenados por su texto, por lo que estos archivos no se tratarán como iguales.

--xml-resolve-entities, --xre

Esta opción se puede aplicar al comparar archivos XML. Si se establece en true, entonces se resuelven todas las entidades en el documento. De lo contrario, los archivos se comparan con las entidades como están. Esta opción tiene el valor predeterminado false.

--xml-whitespace-mode, --xws

This option is applicable when comparing XML documents or directories containing XML documents. In case of directory comparisons, the option will apply only to XML files in that directory.

Define cómo deben tratarse en la comparación los espacios en blanco. Estos caracteres pueden ser los siguientes: espacios, tabulaciones, retornos de carro y avances de línea This option specifically affects whitespace characters that are inside element and attribute values. Whitespace characters that are outside attribute or element values are disregarded for comparison.

--zip-as-dir, --zd

Esta opción se puede aplicar al comparar archivos ZIP. Si se establece en true, los archivos ZIP se tratarán como directorios en vez de como archivos binarios. El valor predeterminado de esta opción es false.