Mentor de Ferramentas:  Captura de um Vocabulário Comum Usando o Rational RequisitePro

Finalidade

A definição de um vocabulário comum tem por fim reduzir a ambigüidade entre os membros da equipe e estabelecer uma linguagem comum para examinar o sistema que está sendo criado. O uso de um vocabulário comum é útil para todas as descrições do sistema, incluindo as descrições de casos de uso e de outros documentos de requisitos.

Informações relacionadas no Rational Unified Process: 

• Atividade: Capturar um Vocabulário Comum 
• Atividade: Capturar um Vocabulário de Negócios Comum

Visão Geral

Um Glossário fornece uma definição para cada termo usado comumente na descrição do sistema que está sendo criado. Cada projeto deverá ter um documento de Glossário.

Passos na Ferramenta

Para documentar o Glossário do projeto usando o Rational RequisitePro, é necessário:

1. Adicionar o tipo de documento Glossary ao projeto (se necessário)
2. Criar um documento de Glossário
3. Criar requisitos no documento de Glossário

1.  Adicionar o tipo de documento Glossary ao projeto (se necessário) 

Você poderá usar o esquema de Glossário fornecido no RequisitePro se o tipo de documento Glossary estiver disponível no projeto. Se o projeto tiver sido criado usando-se qualquer um dos três templates contidos no RequisitePro, o tipo de documento Glossary já estará disponível; você poderá passar para o procedimento 2.

Para adicionar o tipo de documento Glossary a um projeto aberto no RequisitePro:

1. No Explorer, clique no projeto. Em seguida, clique em File > Properties. A caixa de diálogo Project Properties será exibida.
2. Clique na guia Document Types e clique em Add. A caixa de diálogo Document Type será exibida.
3. Digite um nome, uma descrição e uma extensão de arquivo para o tipo de documento que você deseja adicionar. A extensão de arquivo será aplicada a todos os documentos associados ao tipo de documento. GLS é uma extensão comumente usada para documentos de glossário.
4. Na caixa de listagem suspensa Default Requirement Type, selecione Glossary Requirement Type e vá para o Passo 5. Se essa opção não estiver incluída na caixa de listagem suspensa, clique em New. A caixa de diálogo Requirement Type será exibida.
   • Digite "Glossary Requirement type" no campo Name.
   • Digite "TERM" no campo Requirement Tag Prefix.
   • Digite ou altere as informações contidas nos outros campos (passo opcional).
   • Clique em OK para retornar à caixa de diálogo Document Type.
5. Na caixa de listagem suspensa Outline Name, selecione RUP Glossary (para o desenvolvimento de software) ou RUP Business Glossary (para a modelagem de negócios).
6. Clique em OK para fechar a caixa de diálogo Document Type.
7. Clique em OK para fechar a caixa de diálogo Project Properties.

Informações Adicionais

Consulte o tópico Creating and modifying document types (Índice: document types > creating) na Ajuda on-line do RequisitePro.

2. Criar um documento de Glossário

O documento de Glossário contém termos e definições identificados durante todas as atividades do projeto e especialmente quando você estiver identificando as necessidades dos envolvidos. (Consulte Atividade: Identificar Solicitações dos Principais Envolvidos.)

Para criar o documento de Glossário:

• Clique em File > New > Document. A caixa de diálogo Document Properties será exibida.
• No campo Name, digite "Glossary". (Esta será a maneira como você fará referência ao documento de Glossário no RequisitePro.)
• No campo Description, digite uma breve descrição.
• No campo Package, aceite a opção padrão ou clique no botão adjacente Browse para navegar até o pacote no qual você deseja inserir o documento de Glossário.
• No campo Filename, digite um nome de arquivo, que será usado pelo RequisitePro quando você salvar o documento de Glossário no disco.
• Na caixa de listagem suspensa Document Type, selecione Glossary Document Type (para o desenvolvimento de software) ou Business Glossary Document Type (para a modelagem de negócios).
• Clique em OK para fechar a caixa de diálogo Document Properties. O RequisitePro abrirá o documento de Glossário recém-criado no Microsoft® Word.
• No documento de Glossário, adicione termos e suas definições. É recomendável usar aliases para termos usados comumente que tenham a mesma definição (por exemplo, Operador - veja Maquinista).
• Clique em RequisitePro > Document > Save para salvar o documento de Glossário.

Informações Adicionais

Consulte o tópico Creating requirements documents (Índice: documents>creating) na Ajuda on-line do RequisitePro.

3. Criar requisitos no documento de Glossário

O Glossário não contém requisitos; no entanto, talvez você deseje marcar alguns termos do Glossário como requisitos, a fim de ter um controle deles quando forem redefinidos. Além disso, você poderá atualizar documentos quando necessário para que reflitam essas mudanças. Ao marcar esses termos como requisitos, você poderá definir vínculos de rastreabilidade entre termos do Glossário e características do produto ou requisitos do sistema que talvez você deseje redefinir depois que uma definição de um termo do Glossário tiver sido revisada.

Para criar requisitos no documento de Glossário:

1. Selecione (realce) o texto do termo do Glossário.
2. Siga um destes procedimentos:
   • Clique com o botão direito do mouse e selecione Create Requirement.
   • Clique em RequisitePro > Requirement > New.
     
   A caixa de diálogo Requirement Properties será exibida.
3. Aceite Glossary Requirement Type (TERM) como o tipo de requisito e clique em OK para fechar a caixa de diálogo Requirement Properties.
4. Clique em RequisitePro > Document > Save.

Informações Adicionais

Consulte o tópico Creating requirements in a document (Índice: requirements>creating) na Ajuda on-line do RequisitePro.

Copyright  (c) 1987 - 2001 Rational Software Corporation

Rational Unified Process