Altova DiffDog Server 2023 

El comando run ejecuta una comparación, siempre que se dé como argumento uno de estos tipos de archivo:
 

*.dirdif (comparación de directorios)

*.filedif (comparación de archivos)

*.dbdif (comparación de bases de datos)

 

Puede crear archivos .filedif y .dirdif con la aplicación de escritorio Altova DiffDog (https://www.altova.com/es/diffdog); para ello guarde cualquier comparación de archivos o directorios en un archivo. Las comparaciones de datos de BD (.dbdif) solo se pueden crear con DiffDog Enterprise Edition.

 

Los archivos *.filedif y *.dirdif solo se pueden ejecutar en Windows. Para que la comparación se realice correctamente es necesario que todas las rutas de acceso a archivos y directorios que eran válidas en el equipo de escritorio lo sean también en el equipo servidor. Si configura los trabajos de comparación directamente en DiffDog Server (en vez de con archivos *.filedif y *.dirdif) puede ejecutarlos independientemente de la plataforma.

 

Para ejecutar archivos *.dbdif con DiffDog Server recomendamos ejecutar DiffDog Server en el mismo equipo que la aplicación de escritorio DiffDog o bien en un equipo Windows. Si DiffDog Server se ejecuta en un equipo o en un sistema operativo distinto, debe tener en cuenta estas limitaciones:

 

si la comparación incluye archivos CSV, solo puede ejecutar archivos *.dbdif en servidores Windows. Para que la comparación se realice con éxito todas las rutas de acceso a los archivos CSV que eran válidas en el equipo de escritorio deben serlo también en el equipo servidor.

si la comparación incluye bases de datos, el equipo servidor debe estar configurado y ser capaz de establecer y mantener la conexión de BD. Es decir, debe tener instalados los controladores de la BD y cumplir con cualquier otro requisito necesario para la conexión también en el equipo de destino. Por ejemplo, si el archivo *.dbdif incluye una conexión que necesita un controlador ODBC del proveedor de BD, debe tener ese controlador instalado también en el equipo servidor. Tenga en cuenta que algunos métodos de conexión a bases de datos admitidos en Windows no son compatibles con Linux y macOS. Para más información consulte Bases de datos compatibles.

 

Si configura los trabajos de comparación directamente en DiffDog Server (en vez de con archivos *.dirdif) puede ejecutarlos independientemente de la plataforma.

 

Al ejecutar el comando run, DiffDog Server informa del resultado de la comparación con un código de estado (0 = no hay diferencias, 1 = diferencias, 2 = error), de forma parecida a como funciona el comando diff. El resultado se muestra directamente en la línea de comandos, a no ser que se impida con la opción --quiet.

 

En el caso de las comparaciones .filedif or .dirdif también puede redirigir el resultado de la comparación a un archivo de informe en formato XML o texto. La ruta del archivo de informe se define en la interfaz gráfica de usuario de la aplicación de escritorio DiffDog, donde puede definir la ruta de salida de una comparación .filedif o .dirdif como sigue:
 

1.Abra un archivo .dirdif o .filedif ya existente (o cree una nueva comparación) en DiffDog.

2.En el menú Herramientas, haga clic en Opciones de comparación del documento.

3.Elija una opción:

a.Para no exportar a un archivo, elija No permitir exportaciones (es la opción predeterminada).

b.Para exportar el informe a un archivo XML, seleccione Exportar a un archivo XML e introduzca la ruta en el campo de búsqueda.

c.Para exportar a un archivo de texto, seleccione Exportar a un archivo de texto e introduzca la ruta en el campo de búsqueda.

4.En el menú Archivo, haga clic en Guardar como y guarde la comparación como .filedif (o .dirdif, si corresponde).

 

Para comparaciones .dbdif el resultado de la comparación solo está disponible en formato XML. Use el comando de redirección de la línea de comandos para redirigir el resultado a un archivo, por ejemplo:

 

<executable> run comparison.dbdif >"C:\esult.xml"

 

Nota:las opciones --server y --port no están disponibles si este comando se ejecuta para el ejecutable de DiffDog Server (no el cliente).

 

Sintaxis

<executable> run [opciones] {FILES}

 

También puede llamar al comando run usando los alias import o load. Puede usar run, import o load indistintamente.

 

Argumentos

comparison-file

Indica la ruta a un archivo de comparación en formato .dirdif, .filedif o .dbdif. La ruta del archivo de comparación puede ser absoluta o relativa al directorio de trabajo activo en ese momento. Puede dar como argumentos tantos archivos de comparación como necesite. El único límite es el número de caracteres de entrada que admita la shell de comandos.

 

Opciones

--config, --c

Esta opción indica la ruta de acceso a un archivo de configuración del cliente en el que están definidos los detalles de DiffDog Server.

 

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.

 

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

 

true

No muestra la salida estándar en la ventana terminal.

false

(Predeterminado) Muestra la salida estándar en la ventana terminal.

 

--loglevel, --L

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

 

none

No informa de nada.

info

Informa acerca de mensajes de información, advertencia y error.

warning

Informa acerca de mensajes de advertencia y error.

error

(valor predeterminado) Solo informa acerca de mensajes de error.

 

--output-mode, --om

Esta opción indica el formato del informe de la comparación. Son valores válidos: auto (predeterminado), text, sql, xml, html.

 

Nota importante sobre el valor sql:

 

Genera el informe en formato SQL. Este valor es importante si el lado derecho de la comparación de datos es una BD. Este valor contiene instrucciones SQL que combinan datos de la comparación de izquierda a derecha. Por ejemplo, si falta alguna fila en el lado derecho se generan instrucciones INSERT. Si en el lado derecho sobran filas, entonces se generan instrucciones DELETE. Para valores que hayan cambiado se generan instrucciones UPDATE.

 

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

 

--alias

Indica qué alias se usa cuando el servidor se ejecuta en modo restringido.

 

Ejemplos

Para ejecutar el archivo de comparación C:\DiffDog\Comparison1.filedif, use el siguiente comando:

 

DiffDogCmdlClient run C:\DiffDog\Comparison1.filedif

 

Para ejecutar el archivo de comparación Comparison1.filedif y Comparison2.dirdif (se encuentran ambos en el directorio C:\DiffDog), use el siguiente comando:

 

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

 

© 2017-2023 Altova GmbH