Finalidade

Este mentor de ferramentas descreve como usar o Rational RequisitePro® para facilitar as revisões de requisitos.

Informações relacionadas no Rational Unified Process: Atividade: Revisar Requisitos.

Visão Geral

O RequisitePro facilita a revisão de requisitos no ambiente de uma equipe de projeto. Toda a documentação do projeto poderá ser organizada e acessada a partir de um único local. Os membros da equipe poderão então compartilhar comentários sobre requisitos específicos ou aspectos mais amplos do projeto através de discussões on-line. Todos os itens de discussão, que poderão ser compartilhados por e-mail ou diretamente no RequisitePro, serão armazenados no banco de dados do projeto para fins de revisão posterior. Para revisar documentos de requisitos, um autor poderá reter temporariamente um documento durante a revisão. As revisões serão posteriormente incorporadas ao projeto e disponibilizadas para todos os membros da equipe.

Passos na Ferramenta

Os seguintes conceitos e procedimentos de revisão de requisitos são apresentados mais detalhadamente.

  1. Acessar documentos de requisitos em um único local
  2. Registrar as mudanças nos requisitos em documentos
  3. Desenvolver um diálogo com a equipe do projeto
  4. Reter documentos de requisitos para fins de revisão

1. Acessar documentos de requisitos em um único local Início da página

À medida que os documentos de requisitos são criados ou importados para o RequisitePro, eles são integrados ao projeto de gerenciamento de requisitos. Cada documento será associado ao banco de dados do projeto, o que permite um acesso rápido e centralizado por parte de todos os usuários. É possível abrir todos os documentos de requisitos do projeto a partir de uma única caixa de diálogo. Também é possível adicionar documentos que não contêm requisitos, como um glossário, ao projeto do RequisitePro para que sejam acessados facilmente pela equipe do projeto. Além disso, as informações sobre requisitos estão disponíveis em diversas interfaces, incluindo o Microsoft® Word, diferentes visões e o RequisiteWeb.

Para criar um documento de requisitos:

  1. No Explorer, selecione o pacote em que você deseja que o novo documento fique localizado. Em seguida, clique em File > New > Document. A caixa de diálogo Document Properties será exibida.
  2. Na guia General, digite um nome e uma descrição para o documento. Na caixa de listagem suspensa Document Type, selecione um tipo do documento no qual você deseja que o novo documento se baseie.
  3. Clique em OK.

Para abrir um ou mais documentos de requisitos enquanto um projeto do RequisitePro estiver aberto:

  • No Explorer, clique duas vezes no documento que você deseja abrir.
  • No Explorer, selecione o documento que você deseja abrir, clique com o botão direito do mouse e, em seguida, selecione Open.

Para importar um documento do Word que contenha textos de requisitos:

  1. Clique em File > Import. O Import Wizard será exibido.
  2. Selecione a opção Microsoft Word Document. Digite o caminho e o nome do documento do Word que você deseja importar ou clique em Browse e navegue até o documento desejado.
  3. Clique em Next para avançar no assistente. Quando você seleciona a opção Requirements and document, o RequisitePro analisa automaticamente os requisitos e os marca no documento importado. É possível analisar os requisitos com base em palavras-chave, delimitadores de texto ou estilos de parágrafo do Word.
  4. Clique em Help em qualquer tela para acessar instruções adicionais.

Informações Adicionais

Consulte os seguintes tópicos na Ajuda on-line do RequisitePro:

  • Creating requirements documents (Índice: documents > creating)
  • Opening documents (Índice: documents > opening)
  • Importing requirements from a Word document (Índice: importing > requirements from a Word document)

2. Registrar as mudanças nos requisitos em documentos Início da página

Ao modificar o texto de um requisito em um documento, você deverá descrever a razão da mudança. O RequisitePro registra e monitora as informações de revisão, fornecendo, portanto, um registro do histórico das mudanças nos requisitos.

Para registrar em um documento uma mudança feita em um requisito:

  1. Modifique o texto do requisito.
  2. Clique em qualquer lugar do texto do requisito e, em seguida, clique em RequisitePro > Requirement > Annotate Change. A caixa de diálogo Change Description será exibida.
  3. Na caixa de texto Change Description, digite uma razão para a mudança.
  4. Clique em OK para fechar a caixa de diálogo.

A informação referente à mudança no requisito estará disponível para os membros do projeto. Clique em Requirement > Properties e, em seguida, clique na guia Revision. O RequisitePro gerará um número de revisão para o requisito, indicará a data e a hora em que a mudança foi feita, listará o autor da revisão e fornecerá uma descrição da mudança.

Informações Adicionais

Consulte os seguintes tópicos na Ajuda on-line do RequisitePro:

  • Revisions overview (Índice: revisions > overview)
  • Creating and modifying requirement revision information (Índice: revisions > requirements)

3. Desenvolver um diálogo com a equipe do projeto Início da página

O RequisitePro facilita a revisão e a comunicação da equipe com grupos de discussão, possibilitando que os usuários discutam seus requisitos sem dificuldades. Com os grupos de discussão, os usuários poderão criar e distribuir rapidamente tópicos de discussão - comentários, questões, problemas ou até notificações de mudanças - referentes a um requisito ou a qualquer aspecto do projeto. A distribuição pode se estender a toda a equipe ou se limitar a um grupo específico de usuários. Se o e-mail for ativado para o projeto, as respostas poderão ser elaboradas no RequisitePro ou no RequisiteWeb ou através de qualquer aplicativo de e-mail SMTP. O RequisitePro notificará os usuários das novas mensagens e armazenará os threads de discussão juntamente com os requisitos associados para facilitar a consulta por parte de todo o time.

As reuniões das equipes durante um projeto possibilitam abordar os fundamentos para a tomada de decisões, que não são abordados com freqüência, assim como propostas de mudanças. Os grupos de discussão ajudam as equipes a resolverem esses problemas permitindo que os usuários façam o seguinte:

  • Criem discussões e associem-nas a um único requisito, a um conjunto de requisitos ou a todo o projeto
  • Distribuam automaticamente mensagens de e-mail (se estiver ativado) para o grupo de discussão selecionado
  • Vejam uma representação gráfica dos threads de discussão em um formato hierárquico de árvore mostrando os comentários e as respostas
  • Executem consultas sobre as discussões
  • Modifiquem os atributos das discussões (prioridade, status)
  • Imprimam discussões

Para criar uma discussão:

  1. Siga um destes procedimentos:
    • No Explorer, selecione um requisito e clique em Requirement > Discussions.
    • Em uma visão, selecione um ou mais requisitos e clique em Requirement > Discussions.
    • Em um documento do Word, clique em qualquer lugar de um requisito e, em seguida, clique em RequisitePro > Requirement > Discussions. A caixa de diálogo Discussions será exibida.
  2. Clique em Create.
  3. Na caixa de diálogo Discussion Properties, clique nas guias General, Attributes, Participants e Requirements para definir a discussão e adicionar participantes. Você poderá optar por associar a discussão a requisitos.
  4. Clique em OK.

Para ver e responder a uma discussão:

  1. Clique em Project > View Discussions ou clique no ícone de discussão realçado na barra de ferramentas (indicando que uma nova mensagem da discussão foi criada).
  2. Na lista de discussões, clique em uma discussão. Um indicador de expansão/recolhimento é exibido à esquerda das discussões com respostas.
  3. Clique em um item para lê-lo.
  4. Para responder ao item de discussão selecionado, clique em Reply.
  5. Na caixa de diálogo Discussion Response, digite sua resposta.
  6. Clique em OK.

Informações Adicionais

Consulte os seguintes tópicos na Ajuda on-line do RequisitePro:

  • Creating discussions (Índice: discussions > creating)
  • Reading discussions (Índice: discussions > viewing)
  • Responding to discussions (Índice: discussions > responding to)
  • Configuring e-mail for discussions (Índice: e-mail > discussions, setting projects up for)

4. Reter documentos de requisitos para fins de revisão Início da página

O recurso "offline authoring" do RequisitePro aprimora o processo de revisão permitindo que os autores façam o "check-out" de um documento do projeto e revisem-no no Word. Uma cópia somente leitura do documento permanecerá no RequisitePro; ela estará protegida contra modificações de outros membros da equipe até que a revisão esteja concluída. O documento off-line, que é simplesmente um documento do Word, poderá ser distribuído para co-autores para fins de revisão. O documento resultante poderá ser disponibilizado novamente on-line e o ciclo de revisão poderá ser concluído.

Enquanto o documento estiver off-line, o usuário que tiver feito seu check-out poderá marcar (criar), desmarcar e excluir requisitos nele usando o Microsoft Word. O usuário poderá encaminhar o documento a outros membros da equipe para fins de revisões semelhantes. (É recomendável manter apenas uma cópia do documento off-line e passá-la para cada membro da equipe em seqüência.) O outros usuários poderão ver o documento no RequisitePro, mas não poderão editá-lo.

Quando o documento for disponibilizado novamente, o RequisitePro fará o seguinte:

  • Criará requisitos a partir do texto marcado.
  • Atualizará o banco de dados com as mudanças feitas nos requisitos existentes. Entre elas poderão estar incluídas exclusões, modificações e adições. Se os requisitos tiverem sido excluídos, o proprietário da sessão off-line será avisado antes de as exclusões serem registradas.
  • Rejeitará todas as mudanças nos requisitos feitas pelos usuários que não tenham permissão para editar o documento. Nesse caso, todo o documento retornará ao seu estado original on-line.

Para fazer o check-out de um documento de requisitos tornando-o off-line:

  1. Clique em Tools > Offline Documents.
  2. Clique no documento que você deseja acessar off-line. (Use uma ação de seleção múltipla para selecionar vários documentos.)
  3. Clique em Take Offline. A caixa de diálogo Take Offline Information será exibida.
  4. Digite uma razão para acessar o documento off-line e o caminho do diretório em que você deseja armazenar o documento (ou clique em Browse para localizar o diretório).
  5. Se pretender acessar vários documentos off-line, marque a caixa de seleção Apply to All para aplicar as entradas Reason e Location a todos os documentos. Desmarque essa caixa de seleção para referir-se a cada documento individualmente.
  6. Clique em OK.

Para disponibilizar os documentos novamente on-line:

  1. Clique em Tools > Offline Documents.
  2. Na lista Offline Documents, selecione o documento a ser novamente disponibilizado on-line.
  3. Clique em Bring Online.
  4. Na caixa de texto Description of Changes, digite uma descrição das mudanças feitas no documento selecionado no momento enquanto ele estava off-line. Se você estiver disponibilizando novamente vários documentos on-line e as mudanças se aplicarem a todos os documentos subseqüentes, marque a caixa de seleção Apply to All.
  5. Clique em OK. Clique em Yes para aceitar o documento atualizado.

Informações Adicionais

Consulte os seguintes tópicos na Ajuda on-line do RequisitePro:

  • Taking documents offline (Índice: offline authoring > taking documents offline)
  • Bringing offline documents back online (Índice: offline authoring > bringing documents back online)

Copyright  (c) 1987 - 2001 Rational Software Corporation


Exibir o Rational Unified Process usando quadros

Rational Unified Process