Avançar para a área de conteúdo

ir para o conteúdo principal

developerWorks Brasil  >  Rational  >

30 dicas de produtividade para os desenvolvedores do IBM Rational Requirements Composer: 30 dicas de produtividade para os desenvolvedores do IBM Rational Requirements Composer Parte 3. Modelos

As melhores práticas para criar e reusar modelos de artefatos

developerWorks
Opções de documento

Opções de documento que necessitam de JavaScript não são exibidas


Classificar esta página

Ajude-nos a melhorar este conteúdo


Nível: Introdutório

Nicolas R. Kruk, Software Engineer, IBM
Brendan Murray, Software Architect, IBM, Software Group

18/Jun/2009

Aprenda como usar o IBM Rational Requirements Composer para criar modelos através de artefatos e para reusar facilmente modelos existentes em outros projetos.

Modelos de artefatos são uma forma útil de reusar os artefatos que seu time definiu no IBM® Rational® Requirements Composer. Usar modelos para criar novos artefatos poupa tempo reduzindo a quantidade de trabalho redundante que é necessária na produção do mesmo conteúdo inicial em novos artefatos.

Dica 1:
Use modelos para iniciar novos artefatos com conteúdo que é comum entre eles, tais como cabeçalho da empresa para documentos de texto, uma marca d'água para esboços de interface de usuário, ou o esqueleto de seções necessárias para um requerimento. Seja criativo, pois é possível criar modelos de qualquer tipo de artefato para o qual há um editor no Rational Requirements Composer.

Os Modelos podem ser criados e modificados apenas por um usuário com direitos de administrador para um determinado projeto. Se você não tem esses direitos, mas é alguém que cria artefatos frequentemente, essa seção oferece informação que pode ajudá-lo a convencer seu administrador a adotar o uso de modelos.

Criando e usando modelos

A ação Criar Modelo de Artefato é uma opção do menu Arquivo quando um artefato está aberto em um editor (veja Figura 1).

Criar um modelo

É possível criar modelos de qualquer artefato que seja nativo ao Rational Requirements Composer (documentos de texto, esboços de interface de usuário, diagramas de casos de uso, etc.).

  1. Salve qualquer alteração ao editor.
  2. Selecione Criar Modelo de Artefato no menu. O conteúdo atual do editor será salvo para um modelo.

Figura 1. Criando um modelo de um artefato aberto em um editor
Expanded menu - Create Artifact Template selected

Dica 2:
Crie modelos a partir do menu Arquivo quando estiver trabalhando em um modelo e quiser salvar seu progresso, ou quando estiver atualizando um modelo existente.

Crie um modelo da home page de Um Projeto ou do Explorer do Projeto

Conforme a Figura 2, é possível criar modelos a partir da lista de artefatos na Home Page do Projeto ou do visualizador Explorer do Projeto. Clique com o botão direito em um artefato e selecione Criar Modelo de Artefato no menu.


Figura 2. Criando um modelo de um artefato na home page de um Projeto
Expanded menu - Create Artifact Template selected

Dica 3:
Crie modelos da home page de um Projeto ou do Explorer de um Projeto quando há um grupo de artefatos contemplados para serem usados para fazer modelos. É possível clicar facilmente em cada artefato na lista e marcá-los para usar seu conteúdo como modelo.

Crie um artefato com base num modelo

  1. Para criar um artefato com base em um modelo, selecione o modelo com o conteúdo que você quer usar na seção Modelos do Assistente novo.
  2. Após clicar em Finalizar, o novo artefato será iniciado com o conteúdo do modelo selecionado.

Figura 3. Inicie o conteúdo do novo artefato com um modelo
Initial Artifact Content field, Template section

Dica 4:
Quando você cria um artefato, clica no botão na seção modelo do assistente para ver se o administrador do seu projeto deixou qualquer modelo disponível para o tipo de artefato que você está criando. Em caso positivo, pode ficar óbvio através do nome do modelo que sua utilização dará ao seu artefato o conteúdo inicial que você teria que adicionar.



Voltar para parte superior


Gerenciando e atualizando modelos

Os modelos para um projeto são listados na aba de Administração na home page do Projeto, que está acessível apenas aos usuários que tem papel de administrador do projeto.


Figura 4. Gerenciando modelos na Aba do Administrador na home page de um Projeto
Administration tab view

Os modelos só estão disponíveis para os projetos nos quais foram criados. Na aba do Administrador você verá projetos para um projeto apenas.

A partir desta aba é possível renomear modelos e apagar os que não são mais necessários. Você pode ter notado que não há opção para modificar um modelo existente, mas, felizmente, há suporte para este cenário.

Como atualizar modelos existentes.

Para atualizar um modelo existente, crie um novo modelo de um artefato com o conteúdo do modelo atualizado e especifique o mesmo nome que o do modelo original.

Primeiro, será necessário ter um artefato com o conteúdo desejado para ser o novo modelo. Se não houver este artefato, o melhor método para obter um é criar um novo artefato com base no modelo que você quer atualizar.

Digamos que queira atualizar o modelo chamado "Documento_Template".

  1. Primeiro, crie uma instância deste modelo chamada "Updated Document_Template."

Figura 5. Crie um artefato de um modelo original
New Document window - Initial Artifact Content

  1. Agora que há um artefato com o qual trabalhar, mude seu conteúdo para conteúdo desejado para a nova versão do seu modelo.
  2. Quando terminar de fazer as alterações, selecione a ação Criar Modelo de Artefato e, quando o nome for solicitado, use o mesmo nome do modelo que gostaria de atualizar. Neste caso, entre Document_Template.

Figura 6. Crie um modelo e use o nome do modelo original
New Artifact Template window


Figura 7. Sobrescrevendo um modelo para atualizar seu conteúdo.
Confirm Replace view with OK selected

  1. Você receberá um aviso de que já existe um modelo com o nome. Após clicar em OK, o modelo original será sobrescrito com o novo conteúdo.

Dica 5:
Para atualizar um modelo existente, crie um novo artefato usando aquele modelo, faça as alterações aquele artefato e cria um modelo usando o mesmo nome do modelo original.

OBS:
Todos os nomes dos modelos devem ser únicos Dois modelos não podem ter o mesmo nome mesmo que tenham conteúdos diferentes. Portanto, quando sobrescrever um modelo existente com um novo nome, assegure-se de que está sobrescrevendo o modelo correto, ou poderá, acidentalmente, sobrescrever um modelo com um conteúdo de tipo diferente.



Voltar para parte superior


Compartilhando modelos entre projetos.

Como observamos, os modelos criados em um projeto podem ser usados apenas quando são criados artefatos no mesmo projeto. Se é preciso usar um modelo de um projeto para outro projeto, é possível aproveitar-se do fato de que os modelos são incluídos quando se faz o download do projeto do servidor do Rational Requirements Composer.

Um truque útil é fazer o download do projeto com o mesmo modelo que você precisa e então carregar aquele projeto novamente no seu novo projeto.

  1. Abra a home page do Projeto para o projeto do qual quer fazer download e selecione Arquivo> Download.
  2. Selecione um diretório na sua unidade de disco rígido e clique OK.
  3. Selecione Arquivo > Carregar.
  4. Selecione Carregar um Arquivo do Recentements Composer e então clique em Próximo.
  5. Para Localização, especifique o diretório selecionado no assistente de Download.
  6. Para Carregar para o Projeto, selecione o projeto para o qual quer copiar o modelo.
  7. Clique Concluir.

Todos os modelos do projeto original serão copiados para o segundo projeto. Essa técnica também pode ser usada para copiar definições de grupos de atributos de um projeto para outro.

Se você tiver vários projetos e souber que vai usar os mesmos modelos em todos, o melhor jeito é manter esses modelos separados em um projeto comum. É possível apagar todos os artefatos daquele projeto (por exemplo, os usados para gerar os modelos) para que apenas modelos seja adicionados ao segundo projeto no passo de carregamento.

Dica 6:
Mantenha modelos e grupos de atributos a serem usados em vários projetos em um projeto comum que não contem nenhum artefato. Será possível fazer o download e o carregamento desse projeto para outros projetos para copiar os modelos e grupos de atributos.

Conforme a nova versão do Rational Requirements Composer vai sendo desenvolvida, a facilidade de uso das operações e minimização do tempo que gasta com elas está a frente dos nossos esforços. Se acredita que o uso de nossa ferramentas está debilitado por algo que acredita possa ser melhorado, ou que parece estar com defeitos, os desenvolvedores agradecem suas sugestões. Visite Rational Requirements Composer na jazz.net para ver planos de interação para o novo release e ver ou submeter solicitações de recursos e relatar falhas. Fique a vontade para enviar um email aos autores destas séries com suas perguntas ou sugestões.



Voltar para parte superior


Resumo das Dicas

Dica 1: Use modelos para iniciar novos artefatos com conteúdo que é comum entre eles, tais como cabeçalho da empresa para documentos de texto, uma marca d'água para esboços de interface de usuário, ou o esqueleto de seções necessárias para um requerimento. Seja criativo, pois é possível criar modelos de qualquer tipo de artefato para o qual há um editor no Rational Requirements Composer.

Dica 2:Crie modelos a partir do menu Arquivo quando estiver trabalhando em um modelo e quiser salvar seu progresso, ou quando estiver atualizando um modelo existente.

Dica 3:Crie modelos da home page de um Projeto ou do Explorer de um Projeto quando há um grupo de artefatos contemplados para serem usados para fazer modelos. É possível clicar facilmente em cada artefato na lista e marcá-los para usar seu conteúdo como modelo.

Dica 4: Quando criar um artefato, clique no botão na seção modelo do assistente para ver se o administrador do seu projeto deixou qualquer modelo disponível para o tipo de artefato que você está criando. Em caso positivo, pode ficar óbvio através do nome do modelo que sua utilização dará ao seu artefato o conteúdo inicial que você teria que adicionar.

Dica 5: Para atualizar um modelo existente, crie um novo artefato usando aquele modelo, faça as alterações aquele artefato e cria um modelo usando o mesmo nome do modelo original.

Dica 6: Mantenha modelos e grupos de atributos a serem usados em vários projetos em um projeto comum que não contem nenhum artefato. Será possível fazer o download e o carregamento desse projeto para outros projetos para copiar os modelos e grupos de atributos.



Recursos

Aprender

Obter produtos e tecnologias

Discutir


Sobre os autores

Nicolas Kruk

Nicolas Kruk is a member of the Common User Interface team for Rational Requirements Composer. He was the developer primarily responsible for Artifact Templates support in Version 1.0. Previously, he was a member of the team that delivered the Rational Deployment Architecture Platform for IBM Rational Software Architect Version 7.5. Nicolas graduated from the Rochester Institute of Technology in 2008 with a bachelor’s degree in computer science.


Brendan Murray is a Software Architect with IBM Ireland. He has extensive experience with development processes, Web application development, internationalization, and localization.




Avalie esta página


Reserve um instante para completar este formulário para nos ajudar a servi-lo melhor.



 


 


Não
são úteis
Extremamente
úteis