Sincronizar recursos entre Rational Team Concert e Rational RequisitePro

Use o Jazz Connector para inicializar seu plano de projeto a partir de seus requisitos

Este artigo descreve um Jazz Connector que sincroniza requisitos em itens de trabalho no IBM® Rational Team Concert®, de modo que seja possível inicializar seu plano baseado em seus requisitos. Veremos como instalar o conector e deixá-lo pronto para rodar em seu ambiente.

O que o conector faz

Há três coisas que podem e devem ser feitas com requisitos: usá-los para conduzir design e desenvolvimento, para conduzir testes e para conduzir planejamento. O diagrama abaixo mostra como as funções de gerente de projeto, arquiteto e chefe de testes usam requisitos para acelerar suas tarefas.

Figura 1. Usos de requisitos
Reqs form basis for PMs, architects, test leads.

Este artigo descreve um conector IBM® Rational® Jazz™ que copia requisitos do IBM® Rational® RequisitePro® para itens de planejamento no IBM® Rational Team Concert®. Os requisitos podem, em seguida, ser designados a iterações e decompostos em tarefas para que a equipe de desenvolvimento implemente. Esta abordagem assegura que o planejamento seja gerenciado no nível dos requisitos e que o progresso da implementação destes (geralmente histórias ou cenários de caso) possa ser mensurado e gerenciado.

O código aqui utiliza a arquitetura do Jazz Connector, que proporciona vários benefícios. Primeiramente, ela oferece uma estrutura abrangente de mapeamento, de modo que campos no Rational RequisitePro podem ser mapeados facilmente para campos no Rational Team Concert. Além disso, a estrutura oferece fortes mecanismos de sincronização para assegurar que mudanças sejam transmitidas com sucesso entre os dois sistemas, e para resolução de eventuais conflitos.

O que há de novo na Versão 2

A principal mudança foi a reescrita do conector para que utilizasse as APIs REST do RequisitePro. Isso exige que o RequisiteWeb esteja instalado, mas oferece vários benefícios importantes. Permite que o conector seja implementado em servidores Jazz que não são Microsoft® Windows® e também simplifica enormemente o processo de instalação.

O conector também oferece dois mecanismos para selecionar quais requisitos devem ser sincronizados. É possível selecionar todos os requisitos de nível superior de um certo tipo para sincronização, ou escolher uma visualização. Também é possível estabelecer várias sincronizações, portanto, quando for necessário sincronizar vários tipos de requisitos, é preciso apenas configurar e executar várias sincronizações.


Remover versões anteriores

Recomenda-se desinstalar versões anteriores do conector. Siga estas etapas para desinstalar uma versão anterior do conector:

  1. No sistema de arquivos, remova a pasta do site de atualização do conector RequisitePro no diretório do servidor e remova-a, e remova o arquivo reqproconnector.ini de InstallDir/jazz/server/conf/Jazz/provision_profiles do servidor Jazz.
  2. Inicie o servidor RTC, navegue para https://localhost:9443/jazz/admin/cmd/requestReset e reinicie-o.-
  3. Pare o servidor, reinicie-o para atualizar os plug-ins e pare-o novamente para estar pronto para instalar o novo conector.

O conector anterior está desinstalado agora.


Instalar o servidor

A instalação do servidor é um processo simples. Ao descompactar o arquivo ReqProCon_server.zip incluído neste artigo (veja a seção Downloads), procure pela pasta chamada com.ibm.uk.reqproconnector.repositorymanager.updatesite e pelo arquivo chamado reqproconnector.ini. Siga estas etapas para instalar o lado do servidor do conector:

  1. Copie a pasta com.ibm.uk.reqproconnector.repositorymanager.updatesite para seu JazzInstallDir/Jazz/server.
  2. Copie o arquivo reqproconnector.ini para JazzInstallDir/server/conf/jazz/provision_profiles.

Seu sistema de arquivos deve estar como mostrado na Figura 2.

Figura 2. Sistema de arquivos do servidor
Jazz server file system showing installed plugin
  1. Agora reinicie o servidor Jazz para carregar as mudanças.

Configure o servidor e as regras de sincronização

Agora que os componentes do lado do servidor estão instalados, é necessário fazer duas coisas. Primeiramente, é preciso configurar os tipos de item de trabalho com os quais sincronizar. Em segundo lugar, é necessário configurar uma regra de sincronização.

Configure o tipo de item de trabalho para estar pronto para a sincronização

Para que a sincronização funcione, é necessário armazenar a chave de requisito no item de trabalho. Portanto, é preciso criar um novo campo no item de trabalho para armazenar o valor.

  1. Clique com o botão direito na área do projeto e escolha Open.
  2. Clique na guia Process Configuration e navegue para Project Configuration > ConfigurationData > Work Items > Types and Attributes.
  3. No menu suspenso, escolha o tipo para o qual deseja sincronizar requisitos, e em seguida inclua um atributo customizado de nome key, ID keye tipo Small String.
  4. Salve as alterações.
Figura 3. Exemplo de uma História customizada, incluindo o campo-chave
Story work item customized with a key field

Configurar uma regra de sincronização

Agora é preciso configurar uma regra de sincronização, que é um mapeamento dos campos do RequisitePro para os campos do item de trabalho.

  1. Primeiro, selecione a conexão na visualização Team Artifacts. Clique com o botão direito e selecione Administer > Synchronization Rules.
Figura 4. Opção de menu para administrar regras de sincronização
Two drop-down menus with selections highlighted

Agora crie uma nova conexão externa para representar o projeto RequisitePro:

  1. Na visualização Synchronization Rules, clique com o botão direito em External Repository ConnectionsSynchronization e escolha New > External Repository Connection.
  2. Especifique o nome da conexão, a conexão REST RequisitePro (por exemplo: http://reqwebhostname/ReqWeb/Servlet/project/projectname), as credenciais de login e a área do projeto de destino.

    Nota: devido a uma limitação, o nome do projeto no catálogo RequisiteWeb não pode conter espaços.

A tela deve estar semelhante à da Figura 5.

Figura 5. Janela External Repository Connection
Properties dialog box

Agora é necessário configurar o mapeamento entre o RequisitePro e o Rational Team Concert.

  1. Na visualização Synchronization Rule, clique com o botão direito na área do projeto e escolha New > Synchronization Rule. Siga estas etapas para configurar a regra:
  2. Especifique um nome para a regra.
  3. No canto superior esquerdo da tela, especifique o tipo de item de trabalho, o repositório externo criado anteriormente, o gerenciador externo (RequisiteWeb 7.1) e o tipo de requisito para o qual deseja sincronizar.
  4. Em seguida, especifique o mapeamento. No mínimo, devem ser especificados:
    • FiledAgainst: Equipe
    • Key: chave (não se esqueça de marcar a chave como o identificador externo)
    • Type: RtcType
    • Summary: Nome
  5. Observe que a propriedade FiledAgainst precisa usar CategoryTransformer, portanto desmarque No Transformation (Just Copy) e escolha o CategoryTransformer no menu suspenso.
  6. Se você tiver campos enumerados, mapeie os dois campos, desmarque a caixa de opção No Transformation (Just Copy) e inclua o mapeamento de enumeração na caixa Value Mapping.

Ao concluir, a regra de sincronização deve estar semelhante à Figura 6.

Figura 6. Uma regra de sincronização simples
Shows Type, Property, and Value mapping selections

Agora é necessário configurar as permissões para o cliente de sincronização (veja também a Figura 7). O cliente exige a permissão Synchronize with external objects. É possível incluir o usuário que irá executar a sincronização no projeto, ou modificar as configurações do projeto para que todos os usuários tenham essa permissão.

  1. Para fazer isso, abra a área do projeto, clique na guia Process Configuration e navegue para Team Configuration > Permissions.
  2. Em seguida, no painel principal, selecione Item Connector > Synchronize with external objects e garanta que o usuário selecionado ou todos têm permissão para isso.
Figura 7. Permissões no projeto para sincronizar com objetos externos
Selection circled under Item Connections

Instalar o cliente

  1. Para instalar o cliente, faça download e descompacte o arquivo ReqProCon_client.zip da seção Downloads deste artigo.
  2. Edite o arquivo start_reqpro_connector.bat e atualize a variável de ambiente para os diretórios jre bin e ext do cliente Jazz.

    Nota:
    Esse deve ser o JRE (Java™ Runtime Environment) fornecido com o cliente Jazz.

  3. Em seguida, é necessário fazer download dos arquivos do cliente Java Archive (JAR) em Jazz.net e salvá-los na pasta chamada jpjc no mesmo diretório que o cliente.
  4. Agora atualize o arquivo em lote novamente, e configure a variável JAVA_CLIENT_JARS para apontar para o diretório em que estão todos os arquivos Java™ Archive (JAR).

Executar a sincronização

Para executar a sincronização, é necessário primeiro modificar o arquivo reqproconnector.properties com suas configurações. É possível configurar a maneira como os requisitos são selecionados, por tipo de requisito ou por visualização. No arquivo fornecido, a configuração é para selecionar visualizações, e as opções para selecionar por tipo estão comentadas.

  1. É útil criar um usuário separado para usar o conector. O usuário deve ter privilégios de administrador Jazz e uma licença de desenvolvedor, construção, e do cliente do conector IBM® Rational® ClearCase® ou IBM® Rational® ClearQuest®.
  2. Em seguida, em uma linha de comando, execute o arquivo start_reqpro_conector.bat. Isso irá conectar ao RequisitePro e sincronizar os requisitos com o Servidor Jazz Team.
  3. Após verificar que o conector funciona e copia os requisitos para o Servidor Jazz Team Server, configure esse arquivo para ser executado a intervalos regulares selecionando Control Panel > Scheduled Tasks > Add Scheduled Task, programando o arquivo para ser executado a cada 15 minutos.
  4. O Servidor Jazz Team cuida automaticamente da sincronização reversa. Entretanto, para forçar a sincronização, selecione a regra na visualização Synchronization Rule, clique com o botão direito e escolha Synchronize Out.

Dica:
Se as mudanças de requisitos não fluírem adequadamente entre os dois sistemas, deve ser, provavelmente, porque o requisito foi alterado em ambos no mesmo período de sincronização. Nesse caso, os requisitos com falhas irão aparecer como fora de sincronia, e pode-se então decidir qual mudança aceitar. Para ver os requisitos fora de sincronia, clique na regra na VisualizaçãoSynchronization e escolha Show Unsynchronized.

Figura 8. A opção de menu Show Unsynchronized
Option selected on drop-down menu

Agora você deve ter uma sincronização bidirecional funcional entre requisitos do Rational RequisitePro e itens de trabalho do Rational Team Concert.


Limitações

O conector tem as seguintes limitações:

  • Campos de enumeração de multisseleção do Rational RequisitePro não são suportados no mapeamento.
  • O nome do projeto registrado no RequisiteWeb não deve conter espaços. Uma solução alternativa é incluir uma segunda entrada ao catálogo do RequisiteWeb para ser usada pelo conector

Resumo

É possível usar o Conector Rational RequisitePro a Rational Team Concert para sincronizar requisitos com itens de plano de alto nível. Isso significa que os planos do projeto têm forte rastreabilidade para os requisitos acordados, o que deve levar a entrega melhorada do projeto e maior satisfação do cliente ao assegurar que os requisitos declarados sejam planejados, avaliados e entregues. Esta versão do conector foi reprojetada para usar as APIs REST do RequisitePro, o que significa que podem ser usadas em outros servidores com outros sistemas operacionais além de Microsoft Windows.


Downloads

DescriçãoNomeTamanho
Client filesReqProCon_client.zip228KB
Server filesReqProCon_server.zip68KB
Connector filesreqproconnector_v2_16Jun_src.zip722KB

Recursos

Aprender

Obter produtos e tecnologias

Discutir

Comentários

developerWorks: Conecte-se

Los campos obligatorios están marcados con un asterisco (*).


Precisa de um ID IBM?
Esqueceu seu ID IBM?


Esqueceu sua senha?
Alterar sua senha

Ao clicar em Enviar, você concorda com os termos e condições do developerWorks.

 


A primeira vez que você entrar no developerWorks, um perfil é criado para você. Informações no seu perfil (seu nome, país / região, e nome da empresa) é apresentado ao público e vai acompanhar qualquer conteúdo que você postar, a menos que você opte por esconder o nome da empresa. Você pode atualizar sua conta IBM a qualquer momento.

Todas as informações enviadas são seguras.

Elija su nombre para mostrar



Ao se conectar ao developerWorks pela primeira vez, é criado um perfil para você e é necessário selecionar um nome de exibição. O nome de exibição acompanhará o conteúdo que você postar no developerWorks.

Escolha um nome de exibição de 3 - 31 caracteres. Seu nome de exibição deve ser exclusivo na comunidade do developerWorks e não deve ser o seu endereço de email por motivo de privacidade.

Los campos obligatorios están marcados con un asterisco (*).

(Escolha um nome de exibição de 3 - 31 caracteres.)

Ao clicar em Enviar, você concorda com os termos e condições do developerWorks.

 


Todas as informações enviadas são seguras.


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=80
Zone=Rational
ArticleID=513804
ArticleTitle=Sincronizar recursos entre Rational Team Concert e Rational RequisitePro
publish-date=08272010