Finalidade

Esta página de Kit de Ferramentas descreve como modificar a Árvore de Navegação.  Ela aplica-se ao Rational Unified Process (RUP) e também ao seu site de projeto na Web, caso ele use o applet Treebrowser. A organização da Árvore de Navegação no RUP é definida em cinco arquivos de menu: o arquivo principal "tree.dat" e quatro arquivos de submenu.

Observe que o Template de Site de Projeto na Web e os sites da Web de exemplo de organização, incluídos no RUP, usam apenas um arquivo de menu, o "tree.dat". Esse arquivo contém todas as informações relacionadas à organização da Árvore de Navegação.

Visão Geral

Para modificar a Árvore de Navegação:

  1. Noções básicas sobre a Árvore de Navegação e os arquivos de menu correspondentes (*.dat)
  2. Adição da Árvore de Navegação
  3. Adição de links a páginas externas
  4. Impacto da modificação da Árvore de Navegação
  5. Verificação de suas modificações

1. Noções básicas sobre a Árvore de Navegação e os arquivos de menu correspondentes (*.dat) Início da página

O frame da esquerda contém uma Árvore de Navegação com links para todas as páginas no site da Web, conforme mostrado aqui.

Vários arquivos controlam o comportamento da Árvore de Navegação:

Arquivos Comentários
applet/orytree.htm É neste local que o applet Treebrowser é "declarado". Se você desejar alterar o layout do applet, faça isso neste arquivo.
applet/tree.dat Este arquivo define a estrutura da Árvore de Navegação que corresponde à parte estática do processo. Ele também contém referências aos arquivos de menu de subárvore (listados abaixo) da Árvore de Navegação, que correspondem à parte dinâmica do processo.
applet/rpw_discipline_subtree.dat Esta subárvore define a estrutura das disciplinas na Árvore de Navegação.
applet/rpw_artifact_subtree.dat Esta subárvore define a estrutura dos conjuntos de artefatos na Árvore de Navegação.
applet/rpw_role_subtree.dat Esta subárvore define a estrutura dos papéis na Árvore de Navegação.
applet/rpw_tool_subtree.dat Esta subárvore define a estrutura dos mentores de ferramentas na Árvore de Navegação.

 

Cada linha do arquivo tree.dat consiste em sete campos, separados por um "*". Consulte Kit de Ferramentas: O applet Treebrowser para obter uma especificação mais detalhada desse formato. Os exemplos a seguir mostram diferentes padrões de uso para a definição de itens de menu na Árvore de Navegação. Veja primeiro uma rápida descrição de cada um dos sete campos:

  1. Define o nível na árvore
  2. Título do item de menu
  3. Caminho para um local de arquivo relativo ao local do tree.dat
  4. Define o frame de destino em que a página (em 3) deve ser exibida
  5. Ícone a ser usado quando o item de menu for recolhido
  6. Ícone a ser usado quando o item de menu for expandido
  7. Indica se o item deve ser expandido ('t') ou não ('f') quando a Árvore de Navegação for exibida inicialmente.

Exemplo 1:
Link para uma página dentro da estrutura de pastas do RUP:

0*Glossary*../process/glossary.htm* *bookc.gif*booko.gif*f*

O frame de destino nesse exemplo é definido como um caractere de espaço em branco para indicar que a página será aberta no frame principal da mesma sessão do navegador.

Exemplo 2:
Link para uma página fora da estrutura de pastas do RUP:

0*Rational*http://www.rational.com*_blank*bookc.gif*booko.gif*f*

O arquivo a ser aberto nesse exemplo é o URL de um site da Web externo. O campo target-frame é definido como "_blank" para que seja aberta uma nova janela de navegador da Web.

Exemplo 3:
Referência à subárvore de papéis do arquivo principal tree.dat:

0*Role Sets*../process/workers/ovu_works.htm* *workers.gif*workers.gif*f*
1*Papéis*rpw_role_subtree.dat* *workers.gif*workers.gif*f*

O exemplo acima mostra o formato de uma referência a uma subárvore. A primeira linha descreve o título da entrada na Árvore de Navegação e uma referência à página a ser aberta, se for selecionada. A segunda linha indica que a estrutura dessa subárvore é definida em um arquivo de menu separado.

Exemplo 4:
Formato das entradas de menu em um arquivo de menu de subárvore (por exemplo, rpw_role_subtree.dat):

0*Additional Role Set*../process/workers/wks_others.htm* *workers.gif*workers.gif*f*
1*Any Role*../process/workers/wk_any.htm* *workers.gif*workers.gif*f*

Um arquivo de menu de subárvore segue exatamente o mesmo formato do arquivo de menu principal, exceto pelo fato de os níveis na árvore serem locais nessa subárvore. Como a subárvore de papéis foi incluída (consulte o exemplo 3) no nível superior da hierarquia da Árvore de Navegação, as entradas definidas como nível zero nessa subárvore (por exemplo, 'Additional Role Set') serão exibidas no nível um da Árvore de Navegação. Posteriormente, a entrada 'Any Role' do exemplo acima será exibida no nível dois da Árvore de Navegação.

Consulte a documentação da Árvore de Navegação para obter mais detalhes.

Para obter uma explicação detalhada do tree.dat e dos arquivos de subárvore, consulte "Os arquivos de dados" na documentação da Árvore de Navegação.

2. Adição da Árvore de Navegação Início da página

Uma maneira fácil de modificar o RUP e/ou seu site de projeto na Web é adicionando links a seu próprio material na Árvore de Navegação.

Por exemplo, o início do arquivo tree.dat no RUP é semelhante a este:

img.zip*

0*Overview*../process/ovu_proc.htm* *humpchart.gif*humpchart.gif*f*
1*Site Map*../sitemap/sitemap.htm* *ovutable.gif*ovutable.gif*f*

...
...

Para adicionar entradas na Árvore de Navegação, insira novas linhas ao arquivo tree.dat. Por exemplo, se você desejar adicionar uma nova entrada no nível superior para "Our Own Process" e um link, um nível abaixo, para a página "Our Design Guidelines", o arquivo tree.dat seria semelhante a este:

img.zip*

0*Our Own Process*../our_process/index.htm* *folderc.gif*foldero.gif*f*
1*Our Design Guidelines*../our_process/desguide.htm* *fbookc.gif*booko.gif*f*
0*Overview*../process/ovu_proc.htm* *humpchart.gif*humpchart.gif*f*
1*Site Map*../sitemap/sitemap.htm* *ovutable.gif*ovutable.gif*f*
...
...

A Árvore de Navegação do RUP modificada teria então esta aparência:

3. Adição de Links a Páginas Externas Início da página

Quando você adicionar links a páginas que estão fora da estrutura de site da Web, é recomendável que essas páginas sejam abertas em uma nova janela do navegador da Web. Isso é muito importante para links adicionados ao RUP — se você não exibir a página em uma nova janela do navegador da Web, ela será exibida no frame principal, podendo fazer com que os botões de navegação criem erros de JavaScript. Isso pode ocorrer porque os botões de navegação precisam ter acesso de leitura à página.

  • Na Árvore de Navegação, defina o campo target-frame como "_blank".
  • Nas páginas da Web, se houver hyperlinks para páginas externas nas páginas comuns da Web, verifique se o frame de destino para o hyperlink é uma nova janela. O código HTML para esse hyperlink seria:

<a href="another page" target="_blank">another pages<a>

4. Impacto da modificação da Árvore de Navegação Início da página

Desde o release do RUP lançado na primavera de 2001 (versão 2001.04.00), o site da Web que você está vendo passou a ser gerado automaticamente a partir de um modelo de processo básico do RUP, expresso através da Linguagem Unificada de Modelagem. A modelagem e a publicação de sites da Web são feitas na ferramenta Rational Process Workbench™ (RPW). Consulte a seção de mentores de ferramentas do RPW para obter mais detalhes. Discutiremos aqui o impacto da modificação da árvore de navegação no processo de republicação e nas futuras atualizações do site do RUP na Web.

Se você não usar a RPW para configurar o RUP, consulte a página Modificação Básica do Rational Unified Process para obter detalhes.

Entretanto, se você usá-la para a configuração do processo, esteja ciente que:

  • Quando a RPW publicar uma nova versão do site do RUP na Web, ela preservará as mudanças efetuadas pelo usuário na Árvore de Navegação. Porém, todos os arquivos existentes no diretório de saída selecionado serão excluídos (após a confirmação do usuário). Portanto, se você adicionar seus próprios arquivos e vinculá-los manualmente através da Árvore de Navegação, certifique-se de que eles estejam localizados fora da estrutura de diretórios do RUP publicada. Observe que a melhor maneira de efetuar modificações com a RPW instalada é fazê-las no modelo de processo básico. Consulte a documentação da RPW para obter mais detalhes.
  • Para alterar a ordem de qualquer uma das subárvores que aparecem na Árvore de Navegação, altere-a manualmente nos arquivos de menu (consulte acima), movendo as linhas para cima ou para baixo. Verifique se moveu toda a linha e certifique-se de que tenha movido as linhas dentro da subárvore. Esses tipos de mudanças serão mesclados com os novos arquivos da Árvore de Navegação resultantes da próxima sessão de publicação do site na Web.

5. Verificação de suas modificações Início da página

Depois de efetuar mudanças na Árvore de Navegação (no tree.dat ou em qualquer um dos respectivos arquivos de subárvore), você poderá exibir o resultado na próxima vez em que carregar o site do RUP na Web. Se não quiser encerrar a sessão de seu Navegador, você poderá ver o resultado selecionando <Refresh> no navegador. Observe que alguns Navegadores exigem que as teclas <Shift> + <Refresh> sejam pressionadas para serem carregados corretamente.

Se a Árvore de Navegação não carregar após uma mudança manual, é provável que haja erro em uma ou mais linhas alteradas. Inspecione os arquivos e verifique cuidadosamente se o formato especificado em Applet Treebrowser, seção Arquivos de Dados foi seguido. Veja a seguir uma lista de erros típicos:

  1. Não há sete campos em uma linha (conte o número de '*').
  2. Está faltando o caractere de espaço em branco para o frame de destino.
  3. Um ou mais itens de menu não possuem item pai; por exemplo, não há qualquer item no nível 1 que corresponda a um item no nível 2.
  4. Erro de grafia no caminho do arquivo, cujo resultado é a mensagem de erro "Esta página não pode ser exibida"
  5. Nome incorreto de um arquivo de ícone, cujo resultado é um item de menu sem ícone associado.

Copyright  (c) 1987 - 2001 Rational Software Corporation


Exibir o Rational Unified Process usando quadros

Rational Unified Process