Aliases são nomes abreviados que identificam exclusivamente itens no controle de origem. Aliases números números com quatro dígitos (entre parênteses) que são exibidos à esquerda do item aos quais eles se referem. Por exemplo:
$ scm status
Área de Trabalho: (6377) "My Workspace" <-> (7487) "Stream"
Componente: (6429) "Flux Capacitor"
Linha de Base: (8471) 6815 "v20091102"
Saída:
Alterar conjuntos:
(8459) --@ 98314 "Degauss Flux Capacitor" - <No comment>
No exemplo acima, cada número entre parênteses (6377, 7487, 6429, 8471, 8459) é um alias.
Cada subcomando possui um conjunto de códigos de retorno. 0 é retornado se o subcomando for bem-sucedido. Um valor diferente de zero é retornado quando há um erro ou problema, como um conflito, ou quando o sandbox local não está sincronisado com a área de trabalho remota.
Os exemplos a seguir assumem que você efetuou login em um repositório com lscm login. Assim, é necessário fornecer somente -r repositoryNickName com cada subcomando. Por exemplo:
$ lscm login -r https://your.repository.com:9443/jazz -n nickname -u echughes -c Password (echughes @ https://your.repository.com:9443/jazz): Logged in to https://your.repository.com:9443/jazz
Também é possível consultar o repositório https://your.repository.com:9443/jazz com um apelido. Por exemplo, transmita -r nickname ao subcomando em vez da URL, nome de usuário e senha.
Antes de iniciar um projeto, é necessário ter um nome de usuário, senha e a URL de seu repositório. Você também deve ser um membro de uma área da equipe.
Se você não souber o nome do fluxo com o qual você está colaborando, poderá usar lscm list streams -r nickname para listar os fluxos aos quais você possui acesso. Por exemplo:
$ lscm -a y list streams -r l DeLorian Upgrades Home Energy Converter Doc Brown's playpen
Depois de ter localizado o fluxo no qual deseja trabalhar, você pode criar uma área de trabalho remota para conter suas alterações. Por exemplo:
$ lscm create workspace -r l myNewWorkspace -s "DeLorian Upgrades" Workspace (8551) "myNewWorkspace" successfully created
A inclusão do parâmetro -s especifica com qual fluxo a área de trabalho deve colaborar. A nova área de trabalho tem esse fluxo como o destino de fluxo padrão e tem o estado do fluxo como seu estado inicial.
Para carregar a área de trabalho remota:
$ lscm load myNewWorkspace -r l Downloading /flux.capacitor/requirements.txt (0 B) Downloading /flux.capacitor/diagrams/design.cad (0 B)
Na CLI de controle de origem, você pode seguir um fluxo de trabalho típico, como modificar arquivos, registrar entrada de arquivos, aceitar novas alterações e entregas alterações.
As ações de registrar entrada e entregar CLI são as mesmas que no cliente Eclipse. O registro de entrada envia alterações de seu disco local para uma área de trabalho remota; a entrega envia alterações de uma área de trabalho remota para o fluxo.
No exemplo de CLI a seguir, você modifica vários arquivos e determina o que foi modificado executando status:
$ lscm status
Área de Trabalho: (8551) "myNewWorkspace" <-> (8552) "DeLorian Upgrades"
Componente: (8553) "Flux Capacitor"
Linha de Base: (8554) 1 "Initial Baseline"
Não resolvidas:
-c /flux.capacitor/requirements.txt
Saída:
Alterar conjuntos:
(8555) --$ "Initial CAD"
O comando status varre todos os diretórios compartilhados para localizar alterações, o que pode demorar muito tempo. Se você desejar apenas visualizar como sua área de trabalho remota é comparada ao fluxo, é possível executar lscm status –n, que ignora a varredura do disco local.
Para confirmar as alterações, use lscm checkin:
$ lscm checkin flux.capacitor/
Confirmando...
Área de Trabalho: (8551) "myNewWorkspace" <-> (8552) "DeLorian Upgrades"
Componente: (8553) "Flux Capacitor"
Saída:
Alterar conjuntos:
(8556) --@ <No comment>
Este exemplo cria implicitamente um novo conjunto de alterações. Os conjuntos de alterações que receberam arquivos e pastas durante a confirmação são listados na saída.
Depois de o conjunto de alterações ser criado, é possível associá-lo a um item de trabalho e incluir um comentário. Para designar um item de trabalho, use lscm changeset associate. Para configurar o comentário, use lscm changeset comment.
É possível visualizar periodicamente o status em um fluxo executando lscm status:
$ lscm status -C
Workspace: (8551) "myNewWorkspace" <-> (8552) "stream19_test_max_results_1256765247692134"
Componente: (8553) "Flux Capacitor"
Linha de Base: (8554) 1 "Initial Baseline"
Saída:
Alterar conjuntos:
(8556) --@
Alterações:
---c /flux.capacitor/requirements.txt
Entrada:
Alterar conjuntos:
(8615) --$ "Initial layout"
Alterações:
---c /flux.capacitor/diagrams/design.cad
O sinalizador -C mostra o conteúdo dos conjuntos de alterações.
No exemplo acima, há uma única alteração recebida para design.cad. Você pode aceitar esta alteração porque ela não modifica nenhum dos arquivos nos conjuntos de alterações.
Execute lscm accept:
$ lscm accept -v
Repositório: https://localhost:9443/jazz/
Área de Trabalho: (8551) "myNewWorkspace"
Componente: (8553) "Flux Capacitor"
Alterar conjuntos:
(8615) ADMIN --$ "Initial layout"
Alterações:
--c /flux.capacitor/diagrams/design.cad
Ocasionalmente, alterações recebidas modificam arquivos que você já modificou.
No exemplo abaixo, você modifica flux.capacitor/requirements.txt para incluir uma nota de uma reunião de planejamento, registra a entrada do arquivo e executa status:
$ lscm status -C
Workspace: (8551) "myNewWorkspace" <-> (8552) "stream19_test_max_results_1256765247692134"
Componente: (8553) "Flux Capacitor"
Linha de Base: (8554) 1 "Initial Baseline"
Saída:
Alterar conjuntos:
(8617) -#@ "Update from November planning meeting"
Alterações:
-#-c /flux.capacitor/requirements.txt
Entrada:
Alterar conjuntos:
(8616) -#$ "Results of initial trials"
Alterações:
-#-c /flux.capacitor/requirements.txt
Ocorreu uma colisão. Os arquivos que você modificou também foram modificados por outro usuário que entregou alterações ao fluxo. A colisão é observada pelo # na frente dos arquivos participantes e dos conjuntos de alterações participantes. Quando o conjunto de alterações com o alias 8616 é aceito, você tem um conflito.
$ lscm accept 8616 -v -i
Repositório: https://localhost:9443/jazz/
Área de Trabalho: (8551) "myNewWorkspace"
Componente: (8553) "Flux Capacitor"
Alterar conjuntos:
(8616) ADMIN -#$ "Results of initial trials"
Alterações:
!-c /flux.capacitor/requirements.txt
As áreas de trabalho a seguir ainda possuem conflitos após a aceitação:
myNewWorkspace
Execute 'scm resolve' ou 'scm conflicts' ou 'scm status' para obter ajuda na resolução dos conflitos.
O -i insere marcadores de conflito nos arquivos. Os marcadores são similares aos marcadores utilizados por outros sistemas de controle de origem.
O ! na lista de alterações indica que o arquivo possui um conflito.
É possível obter uma lista de conflitos nos componentes carregados atualmente executando scm conflicts.
O arquivo contém marcadores de conflito no local, indicando o problema:
- Must not need any more than 1.5 gigawatts of power - Determine minimum necessary speed <<<<<<< mine - Twin Pines parking lot? ======= - Initial trials suggest 60kmh >>>>>>> proposed
A linha entre <<<<<<< mine e o sinal de igual é do conjunto de alterações em sua área de trabalho. A linha entre os sinais de igual e >>>>>>> proposed é do conjunto de alterações recebido. É possível obter o arquivo original executando lscm conflicts -m flux.capacitor/requirements.txt. Se você deseja obter a versão recebida, é possível executar lscm conflicts -p flux.capacitor/requirements.txt. O -m é uma forma abreviada para mine e o -p é uma forma abreviada para proposed.
Resolva a alteração com a proposta. Limpe os marcadores de conflito do arquivo:
- Must not need any more than 1.5 gigawatts of power - Determine minimum necessary speed Initial trials suggest 60kmh
Confirme a alteração e se comunique com o repositório em que o conflito foi resolvido com a versão que foi registrada executando lscm resolve:
lscm resolve -c flux.capacitor/requirements.txt
Nenhuma saída indica que o conflito foi resolvido.
O -c indica que o conflito deve ser resolvido com a versão que está registrada. Também é possível usar -p para resolver com a versão proposta.
Agora você pode fazer mais alterações ou entregar o conjunto de alterações com lscm deliver:
$ lscm deliver Delivering changes from "myNewWorkspace" into "DeLorian Updates" Sem linhas de base para colocar no fluxo.
Para determinar quem modificou determinadas linhas de um arquivo, execute lscm annotate:
$ lscm annotate flux.capacitor/requirements.txt 1 Marty (8556) 2009-11-04 - Must not need any more than 1.5 gigawatts of power 2 Marty (8556) 2009-11-04 - Determine minimum necessary speed 3 Doc (8616) 2009-11-04 Results of initial t - Initial trials suggest 60kmh
A saída de annotate possui seis colunas:
Para comparar diferentes versões de um arquivo, use scm diff, que gera uma correção padrão.
Para excluir alterações não confirmadas, use scm undo.
Esta seção descreve comandos avançados que são principalmente utilizados pelos administradores que configuram o Controle de origem do Rational Team Concert para outros usuários. A maioria dos usuários cria e carrega apenas áreas de trabalho fora dos fluxos existentes.
Um componente é um agrupamento de árvores de origem que mantém os agrupamentos lógicos de códigos de origem juntos.
Conforme um projeto cresce, você ocasionalmente precisa incluir novas árvores de origem. Se não fizer sentido para um componente existente manter as alterações, então você precisa incluir um novo componente:
$ lscm create component "Flux Capacitor" "DeLorian Upgrades" -r l Component (8553) "Flux Capacitor" successfully created.
No exemplo acima, você criou um novo componente no fluxo DeLorian Upgrades. Os usuários que possuem áreas de trabalho colaborando com esse fluxo veem a adição do componente como uma alteração recebida. Quando eles aceitam as alterações recebidas, os usuários recebem o conteúdo no componente.
Se um usuário quiser incluir novos arquivos no componente criado para este propósito, ele pode executar esta tarefa com o subcomando share. O Controle de origem do Rational Team Concert somente permite que os diretórios e as pastas sejam compartilhados em uma área de trabalho. O usuário deve incluir o novo componente em uma área de trabalho remota:
$ lscm workspace add-component -r l myNewWorkspace 8553 Component (8553) "Flux Capacitor" successfully added.
No exemplo acima, o alias 8553 se refere ao componente recém-criado no exemplo anterior.
O novo componente agora está na área de trabalho, portanto, o usuário deve compartilhar a árvore de origem na área de trabalho:
$ lscm share -r l myNewWorkspace 8553 flux.capacitor Uploading files... Shared successfully
No exemplo a seguir, a ação carrega o conteúdo do diretório flux.capacitor na área de trabalho remota chamada myNewWorkspace e o inclui no componente especificado por 8553, que é o Flux Capacitor da etapa anterior.
Isso ajudou? É possível fornecer feedback em Jazz.net (é necessário registrar-se): Comentar nos fóruns ou submeter um erro