Mentor de Ferramentas: Revisando Requisitos Utilizando Rational RequisitePro
Esse mentor de ferramentas descreve como utilizar o Rational RequisitePro® para facilitar as revisões dos requisitos.
Ferramenta: Rational RequisitePro
Relacionamentos
Elementos Relacionados
Descrição Principal

Visão Geral

O RequisitePro facilita a revisão dos requisitos em um ambiente de equipe de projeto. Toda a documentação do projeto pode ser organizada e acessada de um único local. Os membros da equipe podem compartilhar comentários sobre os requisitos ou aspectos mais amplos do projeto por meio de discussões on-line. Todos os itens de discussão estão armazenados no banco de dados do projeto para revisão posterior. Para revisar a documentação de requisitos, um autor pode temporariamente proteger um documento durante a revisão. As revisões são depois mescladas no projeto e disponibilizadas a todos os membros da equipe.

Etapas de Ferramentas

Os seguintes requisitos revisam os conceitos e os procedimentos apresentados com mais detalhes.

  1. Acessar documentos de requisito em um único local
  2. Registrar alterações de requisitos nos documentos
  3. Desenvolver um diálogo na equipe de projetos
  4. Proteção de documentos de requisitos para revisão

1. Acessar documentos de requisitos

Como dos documentos de requisitos são criado ou importados no RequisitePro, eles são integrados ao projeto de gerenciamento de requisitos. Cada documento é associado ao banco de dados do projeto, que permite acesso rápido, centralizado por todos os usuários. Todos os documentos de requisitos no projeto podem ser abertos de uma única caixa de diálogo. Você também pode incluir documentos que não sejam de requisitos, como um glossário, no projeto RequisitePro para ser acesso de modo mais fácil pela equipe do projeto. Além disso, as informações de requisito estão disponíveis por meio de uma variedade de interfaces, incluindo Microsoft® Word, visualizações e RequisiteWeb.

Para criar um documento de requisito:

  1. No Explorer, selecione o pacote no qual deseja colocar o novo documento. Em seguida, clique em Arquivo > Novo > Documento. A caixa de diálogo Propriedades do Documento é exibida.
  2. Na guia Geral, digite o nome e a descrição do documento. Na lista Tipo de Documento, selecione um tipo de documento que será a base para o novo documento.
  3. Clique em OK.

Você pode abrir um ou mais documentos de requisito do Model Explorer, realizando uma das seguintes tarefas:

  • Dê um clique duplo no documento.
  • Clique com o botão direito do mouse no documento e selecione Abrir.

Para importar um documento do Word que contém texto de requisito:

  1. Clique em Arquivo > Importar. O Assistente de Importação é exibido.
  2. Selecione a opção Documento do Microsoft Word. Digite o caminho e o nome do documento do Word que deseja importar ou clique em Procurar e navegue até o documento desejado.
  3. Clique em Avançar para avançar no assistente. Quando você selecionar a opção Requisitos e documento, o RequisitePro analisará os requisitos automaticamente e os marcará no documento importado. Você pode analisar os requisitos por palavras-chave, delimitador de texto ou estilo de parágrafo do Word.
  4. A caixa de diálogo Propriedades do Documento é exibida. Digite o nome do documento e a descrição e selecione um tipo de documento na lista. Em seguida, clique em OK.

Para obter mais informações

ícone do manual da ajuda Consulte os seguintes tópicos na Ajuda on-line do RequisitePro:

  • Criando documentos de requisitos (Índice: documentos > criando)
  • Abrindo documentos (Índice: documentos > abrindo)
  • Importando requisitos de um documento do Word (Índice: importando > requisitos de um documento do Word)

2. Registrar alterações de requisitos nos documentos

Ao modificar um texto de requisito em um documento, você deve descrever a razão para a alteração. O RequisitePro registra e monitora as informações de revisão, fornecendo um registro do histórico de alterações de requisitos.

Para registrar uma alteração de requisito em um documento:

  1. Modificar o texto de requisito.
  2. Clique em qualquer lugar no texto de requisito e, em seguida, clique em RequisitePro > Requisito > Anotar Alteração. A caixa de diálogo Descrição da Alteração é exibida.
  3. Na caixa Descrição da Alteração, digite uma razão para a alteração.
  4. Clique em OK para fechar a caixa de diálogo.

As informações de alteração de requisitos estão disponíveis para os membros do projeto. Clique em RequisitePro > Propriedades do Requisito, e clique na guia Revisão. O RequisitePro gera um número de revisão para o requisito, indica a data e a hora nas quais a alteração foi feita, lista o autor da revisão e fornece uma descrição da alteração.

Para obter mais informações

ícone do manual da ajuda Consulte os tópicos a seguir na Ajuda on-line do RequisitePro:

  • Visão geral das Revisões (Índice: revisões > visão geral)
  • Criando e modificando as informações de revisão dos requisitos (Índice: revisões > requisitos)

3. Desenvolver um diálogo na equipe de projetos

O RequisitePro facilita a comunicação da equipe e a revisão com grupo de debate, tornando mais fácil para os usuários discutir seus requisitos. Com os grupos de discussão, os usuários podem criar e distribuir com rapidez os tópicos de discussão - comentários, problemas, questões ou até avisos de mudanças - relacionados a um requisito ou a qualquer aspecto do projeto. A distribuição pode ser para a equipe inteira ou limitada a um grupo específico de usuários. Se o e-mail estiver ativado para o projeto, as respostas podem dadas dentro do RequisitePro ou do RequisiteWeb ou com qualquer aplicativo de e-mail SMTP. O RequisitePro notifica os usuários sobre novas mensagens e armazena o encadeamento de discussão junto com os requisitos associados para serem consultados com facilidade por toda a equipe.

Os grupos de discussão ajudam as equipes a capturar a razão para tomar decisões e propor mudanças. Os grupos de debate permitem que os usuários:

  • Criem discussões e as associe a um único requisito, um conjunto de requisitos ou o projeto inteiro.
  • Distribuam automaticamente mensagens de e-mail (se ativado) para todos os participantes selecionados da discussão.
  • Visualizem uma representação gráfica dos encadeamentos de discussão em um formato de árvore hierárquica, mostrando comentários e respostas.
  • Executem consultas sobre as discussões.
  • Modifiquem os atributos de uma discussão (prioridade, status).
  • Imprimam discussões.

Para criar uma discussão:

  1. Abra a caixa de diálogo Discussão executando uma das seguintes opções:
    • No Explorer, selecione um requisito e clique em Requisito > Discussões.
    • Em uma visualização, selecione um ou mais requisitos e clique em Requisito > Discussões.
    • Em um documento do Word, clique em qualquer lugar de um requisito e clique em RequisitePro > Requisito > Discussões.
  2. Clique em Criar.
  3. Na caixa de diálogo Propriedades de Discussão, clique nas guias Geral, Atributos, Participantes e Requisitos para definir a discussão e incluir participantes. Você tem a opção de associar a discussão aos requisitos.
  4. Clique em OK e em Fechar.

Para visualizar e responder a uma discussão:

  1. Clique em Projeto > Visualizar Discussões ou clique no ícone de discussão em destaque ícone de discussão na barra de ferramentas (indicando que uma nova mensagem de discussão será criada).
  2. Na lista de discussões, clique em uma discussão. Um indicador de expansão/redução é exibido à esquerda das discussões com as respostas.
  3. Clique em um item para lê-lo.
  4. Para responder ao item de discussão selecionado, clique em Responder.
  5. Na caixa de diálogo Resposta da Discussão, digite sua resposta.
  6. Clique em OK.

Para obter mais informações

ícone do manual da ajuda Consulte os seguintes tópicos na Ajuda on-line do RequisitePro:

  • Criando discussões (Índice: discussões > criando)
  • Lendo discussões (Índice: discussões > visualizando)
  • Respondendo a discussões (Índice: discussões > respondendo a)
  • Configurando e-mail para discussões (Índice: e-mail > discussões, configurando projetos para)

4. Proteger documentos de requisitos para revisão

O recurso "autoria off-line" no RequisitePro aprimora o processo de revisão permitindo aos autores "efetuar registro de saída" de um documento do projeto e revisá-lo no Microsoft Word. Uma cópia de leitura do documento permanece no RequisitePro; ela está protegida contra modificação feita por outros membros da equipe até que a revisão seja concluída. O documento off-line, que é simplesmente um documento do Word, pode ser distribuído para os coautores para revisão. O documento resultante pode ser colocado novamente on-line, e o ciclo de revisão pode ser concluído.

Enquanto o documento está off-line, o usuário que colocou o documento off-line pode utilizar o Word para marcar (criar), desmarcar e excluir requisitos no documento. O usuário pode rotear o documento para outros membros da equipe para revisões semelhantes. (É recomendado manter apenas uma cópia do documento off-line e passar essa cópia a cada membro da equipe um por vez.) Outros usuários podem visualizar o documento no RequisitePro, mas não podem editá-lo.

Quando o documento é devolvido, o RequisitePro faz o seguinte:

  • Cria requisitos de um texto marcado.
  • Atualiza o banco de dados com as alterações feitas nos requisitos existentes. Isso pode incluir exclusões, modificações e adições. Se os requisitos forem excluídos, o proprietário da sessão off-line será avisado antes de a exclusão ser registrada.
  • Rejeita quaisquer alterações nos requisitos em que o usuário não tem permissão de edição. Nesse caso, o documento inteiro volta para seu estado on-line original.

Para colocar um documento de requisitos off-line:

  1. Clique em Ferramentas > Documentos Off-line.
  2. Clique no documento que deseja colocar off-line. (Utilize uma ação de multisseleção para selecionar vários documentos.)
  3. Clique em Colocar Off-line. A caixa de diálogo Colocar Informações Off-line é exibida.
  4. Digite a razão para colocar o documento off-line e o caminho do diretório em que deseja armazenar o documento (ou clique em Procurar para localizar o diretório).
  5. Se você estiver colocando vários documentos off-line, selecione a caixa de opções Aplicar a Todos para aplicar as entradas Razão e Local a todos os documentos. Desmarque essa caixa de opções para lidar com cada documento individualmente.
  6. Clique em OK.

Para colocar os documentos on-line novamente:

  1. Clique em Ferramentas > Documentos Off-line.
  2. Na lista Documentos Off-line, selecione o documento que deseja colocar novamente on-line.
  3. Clique em Colocar On-line.
  4. Na caixa Descrição das Alterações, digite uma descrição das alterações feitas no documento selecionado atualmente enquanto ele estava off-line. Se você estiver colocando vários documentos on-line novamente e as alterações se aplicarem a todos os documentos, selecione a caixa de opções Aplicar a Todos.
  5. Clique em OK. Clique em Sim para aceitar o documento atualizado.

Para obter mais informações

ícone do manual da ajuda Consulte os seguintes tópicos na Ajuda on-line do RequisitePro:

  • Colocando documentos off-line (Índice: autoria off-line > colocando documentos off-line)
  • Colocando documentos off-line novamente on-line (Índice: autoria off-line > colocando documentos novamente on-line)