comparar

Comparar duas áreas de trabalho/fluxos/linhas de base/capturas instantâneas, mostrando linhas de base e conjuntos de mudanças diferentes.

Finalidade

Examine um par de elementos de fluxo e mostre quais linhas de base e conjuntos de mudanças diferem entre os dois.

A exibição é apresentada como uma hierarquia de itens, por padrão:

Direção de fluxo (entrada/saída)
	Componente
		Linha de base
			Conjunto de mudanças
				Item de trabalho
				Entidades do sistema de arquivos

É possível aumentar ou diminuir a posição dos itens de trabalho na hierarquia com o comutador -w/--reroot.

As linhas de base e os conjuntos de mudanças possuem informações de autor e de tempo de entrega. O formato do campo de autor pode ser alterado com o comutador -C/--format-contributor, enquanto que o formato do tempo de entrega pode ser alterado com -D/--format-date.

Sinopse

O mesmo que em qualquer outro lugar. Pode ser executado no modo conectado, em uma área de trabalho carregada localmente ou em uma área de trabalho descarregada.

Opções e argumentos

-d  |  --dir ] workspace-path
O nome do caminho de uma área de trabalho local criada por scm load ou scm share. Este subcomando executa com o conjunto workspace-path como o diretório de trabalho atual. Você pode omitir esta opção se o diretório de trabalho atual é uma área de trabalho local.
-P  |  --password ] senha para o ID do usuário no repositório
A senha para o ID do usuário especificado no repositório nomeado. Se esta opção não estiver incluída na linha de comandos, será solicitada uma senha. Se você especificou uma URI de repositório ou apelido para o qual armazenou credenciais utilizando o comando scm login, esta opção é ignorada.
-r  |  --repository-uri ] URI do repositório
Especifica o repositório no qual executar esta ação. Se você armazenou credenciais do repositório utilizando o comando scm login, pode utilizar o apelido que forneceu para estas credenciais armazenadas
-u  |  --username ] ID do usuário no repositório
Especifica um ID do usuário que existe no repositório nomeado. Se você especificou uma URI de repositório ou apelido para o qual armazenou credenciais utilizando o comando scm login, esta opção é ignorada.
-c  |  --component ] arg ...
Usado apenas quando um argumento de linha de base é especificado pelo nome. Indica o componente no qual a linha de base pode ser localizada.
-C  |  --format-contributor ] arg
Especifica como os contribuidores devem ser listados. O argumento único é uma cadeia que tem os seguintes campos substituídos:
  • {userid} – Substituído pelo ID do usuário do repositório do usuário exclusivo.
  • {name} – Substituído pelo nome do usuário, conforme listado no repositório.
  • {email} – Substituído pelo endereço de e-mail do usuário, conforme listado no repositório.
  • {itemid} – Substituído pelo ID interno exclusivo do usuário no repositório. Este valor não é considerado significativo ou legível a humanos.
-D  |  --format-date ] arg
Especifica como as datas devem ser mostradas. O único argumento é uma cadeia que será passada através de SimpleDateFormatter http://java.sun.com/j2se/1.5.0/docs/api/java/text/SimpleDateFormat.html do Java.
-f  |  --flow-directions ] arg
Limita a exibição para incluir apenas alterações recebidas/enviadas. Deve ser um dos seguintes:
  • 'i' – Alterações recebidas
  • 'o' – Alterações enviadas
  • 'b' – Ambas as alterações, recebidas e enviadas
-I  |  --include-types ] arg
Inclui apenas itens dos tipos listados. O argumento é uma cadeia, que pode conter qualquer um dos seguintes caracteres:
  • 'd' – Direção de fluxo. O elemento mais importante.
  • 'c' – Componente.
  • 'b' – Linha de base.
  • 'w' – Item de trabalho.
  • 's' – Conjunto de mudanças.
  • 'f' – Alteração do sistema de arquivos.

Por padrão, todos os tipos, exceto as alterações do sistema de arquivos, são mostrados (ou seja, “dcbws”).

-p  |  --prune ] arg
Remove nós vazios da hierarquia. O valor pode consistir de uma cadeia contendo os caracteres:
  • 'd' – Indicando que as direções de fluxo vazio devem ser removidas.
  • 'c' – Indicando que os componentes inalterados devem ser removidos.

Por padrão, nada é removido.

-S  |  --Show ] arg
Controla quais campos/valores de opção são mostrados. O valor pode conter o seguinte:
  • 'c' – Indica que o contribuidor deve ser mostrado. Os contribuidores do autor serão mostrados nas linhas de base e nos conjuntos de mudanças.
  • 'd' – Indica que as datas devem ser mostradas. As datas são mostradas como horas de modificação nos conjuntos de mudanças e como horas de criação nas linhas de base.
  • 'i' – Indica que os itens de trabalho devem ser mostrados como filhos dos conjuntos de mudanças. Se não forem incluídos, os itens de trabalho serão mostrados apenas como parte da descrição do conjunto de mudanças.

Por padrão, todos os campos são mostrados.

-w  |  --reroot ] arg
Indica que os nós de item de trabalho devem ser movidos para cima na hierarquia exibida. O valor deve ser um de:
  • 'r' – Para raiz, indicando que todos os tipos de item devem ser mostrados em um item de trabalho.
  • 'd' – Indica que os itens de trabalho devem ser mostrados na direção do fluxo de trabalho, significando que todos os componentes serão mostrados nos itens de trabalho.
  • 'c' – Indica que os itens de trabalho devem ser mostrados nos componentes, significando que todos os conjuntos de mudanças e linhas de base serão mostrados nos componentes.
  • 'b' – Indica que os itens de trabalho devem ser mostrados nas linhas de base, significando que todos os conjuntos de mudanças serão mostrados nos itens de trabalho.

Por padrão, os itens de trabalho são mostrados nos conjuntos de mudanças.

Exemplos

Para gerar um log de mudança com um mínimo de informações secundárias, use:

$ scm compare -r blues ws eSCM-2.0 stream "Source Control 2.0" -I w -S "" -f i
Work Item 60074: Allow defining permissions for project and team areas in the Web UI
Work Item 62945: Set up some sort of Jazz Foundation build
Work Item 63040: TCT031b: Jazz Translations - more variables
Work Item 63053: Web UI template import doesn't allow change to workitem customization
Work Item 63091: Consider project area locale when creating change events and rendering feeds
Work Item 63266: CHKPII errors in COM.IBM.TEAM.PROCESS.DEFINITIONS.SERVER files
Work Item 63371: ProcessFeedRenderer.getProcessAreaChangeDetails should be re-written to accommodate translation

Usar “-I w” limita a exibição dos itens de trabalho, “-S ''” impede ruídos extras na linha de trabalho e “-f” i” garante que as alterações de saída não se entremisturem com as alterações de entrada.
Para gerar um log de mudanças que agrupa as alterações do sistema de arquivos no item de trabalho e no conjunto de mudanças e forneça um formato de data 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: CHKPII errors in COM.IBM.TEAM.PROCESS.DEFINITIONS.SERVER files
  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 should be re-written to accommodate translation
  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

Note o uso da opção -w para tornar os itens de trabalho o pai dos conjuntos de mudanças e o uso da opção -D para configurar o formato de data. Os aliases e os UUIDs são suprimidos com as opções iniciais “-u” e “-a”.