Comparar duas áreas de trabalho/fluxos/linhas de base/capturas instantâneas, mostrando linhas de base e conjuntos de alterações diferentes.
Propósito
Examinar um par de elementos do fluxo e mostrar quais linhas de base e conjuntos de alterações diferem entre as dois.
A exibição é apresentada como um hierarquia de itens, por padrão:
Direção do fluxo (entrada/saída)
Componente
Linha de base
Conjunto de alterações
Item de trabalho
Entidades de Sistemas de Arquivos
É possível aumentar ou diminuir a posição de itens de trabalho na hierarquia com o comutador -w/--reroot.
Linhas de base e conjuntos de alterações têm informações de autor e tempo de entrega. O formato do campo do autor pode ser alterado com o comutador -C/--format-contributor, enquanto o formato do tempo de entrega pode ser alterado com o -D/--format-date.
Sinopse
Igual a qualquer outro local. Pode executar em modo de login, em uma área de trabalho localmente carregada 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 é um espaço 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 somente itens dos tipos listados. O argumento é uma cadeia, que pode conter qualquer um dos seguintes caracteres:
- 'd' – Direção do fluxo. O elemento no topo.
- 'c' – Componente.
- 'b' – Linha de Base.
- 'w' – Item de trabalho.
- 's' – Conjunto de alterações.
- 'f' – Alteração do sistema de arquivos.
Por padrão, todos os tipos, exceto alterações do sistema de arquivos são mostrados (isto é, “dcbws”).
- [ -p | --prune ] arg
- Remover nós vazios da hierarquia. O valor pode consistir em cadeia que contém os caracteres:
- 'd' – Indicando que direções de fluxo vazias devem ser removidas.
- 'c' – Indicando que componentes inalterados devem ser removidos.
Por padrão, nada é removido.
- [ -S | --Show ] arg
- Controla quais valores/campos de opção são mostrados. O valor pode conter o seguinte:
- 'c' – Indica que o contribuidor deve ser mostrado. Contribuidores de autor serão mostrados em linhas de base e conjuntos de alterações.
- 'd' – Indica que datas devem ser mostradas. Datas são mostradas como horários de modificação em conjuntos de alterações e horários de criação em linhas de base.
- 'i' – Indica que itens de trabalho devem ser mostrados como filhos de conjuntos de alterações. Se não incluídos, os itens de trabalho somente serão mostrados como parte da descrição do conjunto de alterações.
Por padrão, todos os campos são mostrados.
- [ -w | --reroot ] arg
- Indica que os nós do item de trabalho devem ser movidos para cima na hierarquia exibida. O valor devem ser um dos seguintes:
- 'r' – Para raiz, indicando que todos os tipos de item devem ser mostrados sob um item de trabalho.
- 'd' – Indica que itens de trabalho devem ser mostrados sob a direção do fluxo, significando que todos os componentes serão mostrados sob itens de trabalho.
- 'c' – Indica que itens de trabalho devem ser mostrados sob componentes, significando que todos os conjuntos de alterações e linhas de base serão mostrados sob componentes.
- 'b' – Indica que itens de trabalho devem ser mostrados sob linhas de base, significando que todos os conjuntos de alterações serão mostrados sob itens de trabalho.
Por padrão, os itens de trabalho são mostrados sob conjuntos de alterações.
Exemplos
Para gerar um log de alterações com o mínimo de informações irrelevantes, use:
$ scm compare -r blues ws eSCM-2.0 stream "Source Control 2.0" -I w -S "" -f i
Item de Trabalho 60074: Permite definir permissões para áreas do projeto e da equipe na UI da Web
Item de Trabalho 62945: Configura algum tipo de construção do Jazz Foundation
Item de Trabalho 63040: TCT031b: Conversões Jazz - mais variáveis
Item de Trabalho 63053: Importação de modelo UI da Web não permite alteração para customização de item de trabalho
Item de Trabalho 63091: Considera o código do idioma da área do projeto ao criar eventos de alterações e alimentações de renderização
Item de Trabalho 63266: Erros de CHKPII em arquivos COM.IBM.TEAM.PROCESS.DEFINITIONS.SERVER
Item de Trabalho 63371: ProcessFeedRenderer.getProcessAreaChangeDetails deve ser reescrito para acomodar conversão
Usar “-I w” limita a exibição a itens de trabalho, “-S ''” evita ruído extra na linha do item de trabalho e “-f” i” garante que alterações de saída não se misturam com alterações de entrada.
Para gerar um log de alterações que agrupa alterações de sistema de arquivos sob o item de trabalho e conjunto de alterações e fornece 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
Item de Trabalho 63266: Erros de CHKPII em arquivos COM.IBM.TEAM.PROCESS.DEFINITIONS.SERVER
Sem comentário sex, 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
Item de Trabalho 63371: ProcessFeedRenderer.getProcessAreaChangeDetails deve ser reescrito para acomodar conversão
caso de identificador em que a categoria é conhecida, mas não tem uma mensagem distinta Ter, 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
Mescla Ter, 6 Nov 2008 19:50:52 -0500
/com.ibm.team.process.service/src/com/ibm/team/process/internal/service/messages.properties
Item de Trabalho 63416: Cadeia não exteriorizada para atributo de conversão para adaptador de domínio declarado
Sem comentário sex, 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 do -w para tornar itens de trabalho um pai de conjuntos de alterações, e -D para definir o formato de data. Aliases e UUIDs são suprimidos com as opções iniciais “-u” e “-a”.