Migrando o tema a partir de uma liberação anterior à versão 7.5.1

Se tiver usado um tema customizado em uma liberação anterior à 7.5.1, esse tema pode não funcionar como esperado na versão 7.5.1 ou posterior. Se atualizar para a versão 7.5.1 ou posterior, você deve editar e restaurar o tema customizado para usá-lo.

Antes de Iniciar

Para a liberação anterior do IBM® Rational Asset Manager, você deve ter um tema customizado. É possível criar um tema customizado concluindo as etapas em Alterando a Aparência do Site com Temas.
Salve o tema customizado:
  1. Clique em Administração > Ferramentas.
  2. Na seção Gerenciar Tema, clique em Fazer o Download do Tema Atual. Você é solicitado para abrir ou salvar um arquivo compactado.
  3. Salve o arquivo e renomeie-o para identificar o arquivo como a versão customizada.

Sobre Esta Tarefa

No Rational Asset Manager versão 7.5.1, o arquivo header.jspf é atualizado para exibir o nome do usuário conectado, os links de Login e Logout, o menu Ajuda e as opções de menu. Se fizer upload de um tema a partir de uma versão anterior, esses itens, além das opções de menu Conteúdo de Ajuda, Extensões e Sobre o Rational Asset Manager, não estarão visíveis no banner. Para ver essas opções, você deve copiar HTML e JavaScript adicionais no arquivo header.jspf.

Procedimento

  1. Atualizar o Rational Asset Manager. O tema padrão para a liberação é aplicado.
  2. Opcional: Faça o download do tema padrão para a versão atualizada do Rational Asset Manager para que seja possível comparar os temas:
    1. Clique em Administração > Ferramentas.
    2. Na seção Gerenciar Tema, clique em Fazer o Download do Tema Atual. Você é solicitado para abrir ou salvar um arquivo compactado.
    3. Salve o arquivo e renomeie-o para identificar o arquivo como a versão padrão.
  3. Extraia os arquivos compactados.
  4. No arquivo que contém a versão customizada do tema, abra o arquivo header.jspf em um editor de texto.
  5. Copie as seguintes linhas do HTML e JavaScript e cole-as no arquivo header.jspf em um local que seja lógico para seu tema customizado. Se tiver transferido por download o tema padrão, será possível comparar as mudanças com relação à estrutura que está no arquivo header.jspf padrão.
    <h:panelGroup id="signin" rendered="#{!loginUser.user.registered}">
    	<h:outputLink id="loginURL" value="#{loginUser.loginAction}">
    		<h:outputText id="loginUid" value="#{loginUser.loginMsg}" /> 
    	</h:outputLink>
    </h:panelGroup>
    <h:panelGroup id="signout" rendered="#{loginUser.user.registered}">
    	<h:outputText id="welcomeUser" value="#{loginUser.welcomeMsg}" escape="false"/>
    	<h:outputText id="welcomeSeparator" value="|" />
    	<h:outputLink id="logoutLnk" value="javascript:logout();">
    		<h:outputText id="uidnotWAS" styleClass="signInOutText" value="#{loginUser.loginMsg}" />
    	</h:outputLink>
    </h:panelGroup>
    
    <a href="#" title="${bundle.navigation_help}"
    id="help_menu" class="jazz-ui-MenuPopup">
    	<span class="sprite-image help-menu"></span>
    	<img class="caret" src="${pageContext.request.contextPath}/javascript/dojo/jazz/ui/graphics/Toolbar/white-caret.gif" />
    </a>
    <script type="text/javascript">
    dojo.addOnLoad(function() {
    	var helpMenu = new jazz.ui.MenuPopup({align: "right", cacheMenu:
    true},'help_menu'); //options,elementID
    	helpMenu.menuProvider = function() {
    		var menu = new jazz.app._ComponentMenu();
    		menu.addItemByArgs({label: "${bundle.navigation_help_content}", icon:
    dojo.moduleUrl("jazz.ui","graphics/PageTemplate/icons/systemhelp.gif"), onClick: function()
    {window.open("${applicationScope.docPath}/index.jsp")} });
    	menu.addItemByArgs({label: "${bundle.navigation_extensions}",
    icon:
    dojo.moduleUrl("ram","graphics/content/icons/extensions_obj.gif"),
    href: "${pageContext.request.contextPath}/extensions.jsp"});
    		menu.addItemByArgs({label: "${bundle.navigation_about}", icon: dojo.moduleUrl("ram","graphics/content/icons/ram_obj.gif"),
    onClick: showAboutDialog });
    		return menu;
    	};
    );
    </script>
  6. Crie folhas de estilo customizadas para seu tema para substituir os estilos padrão.
    1. Crie um ou mais arquivos CSS e salve-os no diretório theme/custom/css.
    2. Revise as folhas de estilo padrão que foram instaladas com o Rational Asset Manager. Para quaisquer estilos que deseja alterar, copie as regras de estilo no seu arquivo CSS e edite os estilos. As mudanças feitas nos arquivos CSS novos substituem as regras de estilo nas folhas de estilo padrão.
      Importante: Não modifique as folhas de estilo padrão no archive de tema. Essas folhas de estilo são alteradas de liberação para liberação e são sobrescritas quando é feito upgrade do Rational Asset Manager.
    3. Copie o arquivo cssIncludes.jspf para o diretório theme/custom do seu archive de tema. Esse arquivo .jspf é necessário para usar as folhas de estilo customizadas na versão 7.5.1 para substituir as folhas de estilo padrão.
    4. Inclua suas folhas de estilo customizadas para theme/custom/cssIncludes.jspf como links. Exemplo:

      <link rel="stylesheet" type="text/css" href="${pageContext.request.contextPath}/${applicationScope.themePath}/custom/css/jkeEnterprises.css" />

    5. Crie uma pasta images no diretório customizado e salve os arquivos de imagens usados no seu tema dentro dele. Exemplo: theme/custom/images-jke-enterprises
  7. Compacte o tema em um archive.
  8. Na página Ferramentas, na seção Gerenciar Tema, clique em Navegar.
  9. Selecione o archive customizado.
  10. Clique em Upload.

O que Fazer Depois

Várias das folhas de estilo para o banner foram removidas do archive do tema. É possível visualizar as regras de estilos padrão no arquivo PageTemplate.css e criar sua própria folha de estilo para substituir esses estilos. O local padrão para o arquivo PageTemplate.css é server/ram/javascript/dojo/jazz/ui/templates/PageTemplate.css.

Feedback