comparar

Compare dos espacios de trabajo/secuencias/líneas base/instantáneas, mostrando las línea base y conjuntos de cambios diferentes.

Finalidad

Examinar un par de elementos de flujo y mostrar las líneas base y conjuntos de cambios de los dos.

La visualización se presenta como jerarquía de elementos de forma predeterminada:

Dirección de flujo (entrante/saliente)
	Componente
		Línea base
			Conjunto de cambios
				Elemento de trabajo
				Entidades de sistema de archivos

Es posible aumenta o disminuir la posición de los elementos de trabajo de la jerarquía con el conmutador -w/-rerrot.

Las líneas base y conjuntos de cambios presentan información de autor y hora de entrega. El formato d el campo Autor puede cambiarse con el conmutador -C/--format-contributor, mientras que el formato de la hora de entrega se puede modificar con -D/--format-date.

Sinopsis

Equivale a cualquier parte. Puede ejecutarse en modo inicio de sesión, en un espacio de trabajo cargado localmente o en un espacio de trabajo sin cargar.

Opciones y argumentos

-d  |  --dir ] vía de acceso de espacio de trabajo
El nombre de la vía de acceso de un espacio de trabajo local creado por scm load o scm share. Este submandato se ejecuta con vía de acceso de espacio de trabajo establecida como el directorio de trabajo actual. Puede omitir esta opción si el directorio de trabajo es un espacio de trabajo local.
-P  |  --password ] contraseña de ID de usuario de repositorio
La contraseña del ID de usuario especificado en el repositorio nombrado. Si esta opción no se incluye en la línea de mandatos, se le solicita una contraseña. Si ha especificado un URI de repositorio o apodo para el cual ha almacenado credenciales mediante el mandato scm login, se ignora esta opción.
-r  |  --repository-uri ] URI de repositorio
Especifica el repositorio en el que se debe llevar a cabo esta acción. Si ha almacenado credenciales de repositorio mediante el mandato scm login, puede utilizar el apodo que facilitó para estas credenciales almacenadas
-u  |  --username ] ID de usuario de repositorio
Especifica un ID de usuario que existe en el repositorio nombrado. Si ha especificado un URI de repositorio o apodo para el cual ha almacenado credenciales mediante el mandato scm login, se ignora esta opción.
-c  |  --component ] arg ...
Sólo se utiliza cuando se especifica un argumento de línea base por nombre. Indica al componente que se puede encontrar la línea base.
-C  |  --format-contributor ] arg
Especifica cómo deben mostrarse los colaboradores. El argumento único es una serie con los siguientes campos modificados:
  • {userid} – Sustituido por el identificador de usuario de repositorio del usuario único.
  • {name} – Sustituido por el nombre del usuario, tal y como se indica en el repositorio.
  • {email} – Sustituido por la dirección de correo del usuario, tal y como se indica en el repositorio.
  • {itemid} – Sustituido por elidentificador interno único del usuario en el repositorio.Este valor no se considera coherente o legible por el humano.
-D  |  --format-date ] arg
Especifica cómo debe mostrarse la fecha. El argumento individual es una serie que se enviará a través de Java's SimpleDateFormatter http://java.sun.com/j2se/1.5.0/docs/api/java/text/SimpleDateFormat.html.
-f  |  --flow-directions ] arg
Limita la visualización para incluir únicamente los cambios entrantes/salientes. Debe ser uno de los siguientes:
  • 'i' – Cambios entrantes
  • 'o' – Cambios salientes
  • 'b' – Cambios tanto entrantes como salientes
-I  |  --include-types ] arg
Sólo incluye elementos de los tipos indicados. El argumento es una serie que puede contener cualquiera de los siguientes caracteres:
  • 'd' – Dirección de flujo. El elemento superior.
  • 'c' – Componente.
  • 'b' – Línea base.
  • 'w' – Elemento de trabajo.
  • 's' – Conjunto de cambios.
  • 'f' – Cambio de sistema de archivos.

De forma predeterminada, se muestran todos los tipos excepto los cambios en el sistema de archivos (ie, “dcbws”).

-p  |  --prune ] arg
Elimina los nodos vacíos de la jerarquía. El valor puede consistir en una serie con los siguientes caracteres:
  • 'd' – Indica que deben eliminarse las direcciones de flujo vacías.
  • 'c' – Indica que deben eliminarse los componentes sin modificar.

Por defecto no se elimina nada.

-S  |  --Show ] arg
Controla qué valores/campos de opciones se muestran. El valor puede contener lo siguiente:
  • 'c' – Indica que debe mostrarse el colaborador. Los colaboradores del autor se mostrarán en las líneas base y los conjuntos de cambios.
  • 'd' – Indica que deben mostrarse las fechas. Las fechas se muestran como horas de modificación en los conjuntos de cambios y horas de creación en las líneas base.
  • 'i' – Indica que los elementos de trabajo deben mostrarse como elementos secundarios de los conjuntos de cambios. Si no se incluye, los elementos de trabajo sólo se mostrarán como parte de la descripción de los conjuntos de cambios.

Por defecto se muestran todos los campos.

-w  |  --reroot ] arg
Indica que los nodos de los elementos de trabajo deben moverse hacia arriba en la jerarquía mostrada. El valor debe ser uno de los siguientes:
  • 'r' – Para raíz, indica que todos los tipos de elemento deben mostrarse bajo el elemento de trabajo.
  • 'd' – Indica que los elementos de trabajo deben mostrarse bajo la dirección de flujo, es decir que todos los componentes se mostrarán bajo los elementos de trabajo.
  • 'c' – Indica que los elementos de trabajo deben mostrarse bajo los componentes, es decir que todos los conjuntos de cambios se mostrarán bajo los componentes.
  • 'b' – Indica que los elementos de trabajo deben mostrarse bajo las líneas base, es decir que todos los conjuntos de cambios se mostrarán bajo los elementos de trabajo.

De manera predeterminada, los elementos de trabajo se muestran bajo los conjuntos de cambios.

Ejemplos

Para generar un registro de cambios con el mínimo de información superflua, utilice los siguiente:

$ scm compare -r blues ws eSCM-2.0 stream "Source Control 2.0" -I w -S "" -f i
Work Item 60074: Permite la definición de permisos para las áreas de proyecto y equipo en la UI web
Work Item 62945: Configura un orden de construcción Jazz Foundation
Work Item 63040: TCT031b: Jazz Translations - más variables
Work Item 63053: La importación de la plantilla de UI web no permite la personalización de elementos de trabajo
Work Item 63091: Considera el entorno local del área de proyecto al crear eventos de cambio y representar canales de información
Work Item 63266: Errores CHKPII en los archivos COM.IBM.TEAM.PROCESS.DEFINITIONS.SERVER
Work Item 63371: ProcessFeedRenderer.getProcessAreaChangeDetails debe rescribirse para ubicar traducción

El uso de “-I w” limita la visualización de elementos de trabajo, “-S ''” evita ruidos adicionales en la línea del elemento de trabajo y “-f” i” garantiza que los cambios salientes no se mezclan con los cambios entrantes.
Para generar un registro de cambios que agrupe los cambios del sistema de archivos bajo el elemento de trabajo y el conjunto de cambios, a la vez que facilita un formato de fecha específico:

$ scm -u n -a n compare -r blues ws eSCM-2.0 stream "Source Control 2.0" -I wfs -w d -S d -D "EEE, d MMM yyyy HH:mm:ss Z" -f i
Work Item 63266: Errores CHKPII en los archivos COM.IBM.TEAM.PROCESS.DEFINITIONS.SERVER
  No comment Fri, 7 Nov 2008 16:52:24 -0500
    /com.ibm.team.process.definitions.server/data/agile/attachments/template.properties
    /com.ibm.team.process.definitions.server/data/eclipseway/attachments/template.properties
    /com.ibm.team.process.definitions.server/data/openup/attachments/template.properties
    /com.ibm.team.process.definitions.server/data/scrum/attachments/template.properties
    /com.ibm.team.process.definitions.server/data/simple/attachments/template.properties
Work Item 63371: ProcessFeedRenderer.getProcessAreaChangeDetails debe rescribirse para ubicar traducción  handle case where category is known but doesn't have a distinct message Thu, 6 Nov 2008 16:49:09 -0500
    /com.ibm.team.process.service/src/com/ibm/team/process/internal/service/messages.properties
    /com.ibm.team.process.service/src/com/ibm/team/process/internal/service/ProcessFeedRenderer.java
  Merges Thu, 6 Nov 2008 19:50:52 -0500
    /com.ibm.team.process.service/src/com/ibm/team/process/internal/service/messages.properties
Work Item 63416: Not externalized string for translatable attribute for declared domain adapter
  No comment Fri, 7 Nov 2008 16:46:56 -0500
    /com.ibm.team.process.ide.ui/plugin.properties
    /com.ibm.team.process.ide.ui/plugin.xml

Tenga en cuenta el uso de -w para que los elementos de trabajo sean padre de los conjuntos de cambios y de -D para definir el formato de fecha. Los alias y UUID se suprimen con las opciones iniciales “-u” y “-a”.

Comentarios

¿Le ha servido de ayuda? Puede incluir sus comentarios en Jazz.net (registro obligatorio): Comentarios en el foro o envíe un error