Migrar el tema desde un release anterior a la versión 7.5.1

Si ha utilizado un tema personalizado en un release anterior al 7.5.1, es posible que dicho tema no funcione según lo esperado en la versión 7.5.1 o posterior. Si actualiza a la versión 7.5.1 o posterior, debe editar y restaurar el tema personalizado para poder utilizarlo.

Antes de empezar

Debe tener un tema personalizado para el release anterior de IBM® Rational Asset Manager. Puede crear un tema personalizado siguiendo los pasos de la sección Cambiar la apariencia del sitio utilizando temas.
Guarde el tema personalizado:
  1. Pulse Administración > Herramientas.
  2. En la sección Gestionar tema, pulse Descargar tema actual. Se le solicitará que abra o guarde un archivo comprimido.
  3. Guarde el archivo y renómbrelo para identificar el archivo como la versión personalizada.

Acerca de esta tarea

En Rational Asset Manager versión 7.5.1, el archivo header.jspf se actualiza para visualizar el nombre del usuario que ha iniciado la sesión, los enlaces Iniciar sesión y Finalizar sesión, el menú Ayuda y las opciones de menú. Si sube un tema de una versión anterior, estos elementos además de las opciones de menú Contenido de la ayuda, Ampliaciones, y Acerca de Rational Asset Manager no son visibles en el banner. Para visualizar dichas opciones, debe copiar HTML y JavaScript adicionales en el archivo header.jspf.

Procedimiento

  1. Actualice Rational Asset Manager. Se aplicará el tema predeterminado para el release.
  2. Opcional: Descargue el tema predeterminado para la versión actualizada de Rational Asset Manager a fin de comparar los temas:
    1. Pulse Administración > Herramientas.
    2. En la sección Gestionar tema, pulse Descargar tema actual. Se le solicitará que abra o guarde un archivo comprimido.
    3. Guarde el archivo y renómbrelo para identificar el archivo como la versión predeterminada.
  3. Extraiga los archivos comprimidos.
  4. En el archivo que contiene la versión personalizada del tema, abra el archivo header.jspf en un editor de texto.
  5. Copie las líneas siguientes de HTML y JavaScript y péguelas en el archivo header.jspf, en una ubicación lógica para el tema personalizado. Si ha descargado el tema predeterminado, puede comparar los cambios con la estructura que se encuentra en el archivo header.jspf predeterminado.
    <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. Crear hojas de estilo personalizadas para que su tema sobrescriba los estilos predeterminados.
    1. Cree uno o varios archivos CSS y guárdelos en el directorio theme/custom/css.
    2. Revise las hojas de estilo predeterminadas instaladas con Rational Asset Manager. Para los estilos que desee cambiar, copie las reglas de estilo en el archivo CSS y edite los estilos. Los cambios que hace en sus archivos CSS alteran temporalmente las reglas de estilo en las hojas de estilo predeterminadas.
      Importante: No modifique las hojas de estilo predeterminadas en el archivo de archivado de temas. Estas hojas de estilo cambian de release a release y se sobrescriben cuando se actualiza Rational Asset Manager.
    3. Copie el archivo cssIncludes.jspf en el directorio theme/custom de su archivador de tema. Este archivo .jspf es necesario para utilizar hojas de estilo personalizadas en la versión 7.5.1 para alterar temporalmente las hojas de estilo predeterminadas.
    4. Añada las hojas de estilo personalizadas a theme/custom/cssIncludes.jspf como enlaces. Ejemplo:

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

    5. Cree una carpeta images en el directorio personalizado y guarde en ella los archivos de imagen utilizados en el tema. Ejemplo: theme/custom/images-jke-enterprises
  7. Comprima el tema en un archivo de archivado.
  8. En la sección Gestionar tema de la página Herramientas, pulse Examinar.
  9. Seleccione el archivo de archivado personalizado.
  10. Pulse Cargar.

Qué hacer a continuación

Muchas de las hojas de estilo del banner se han eliminado del archivos de tema. Puede visualizar las reglas de estilo predeterminadas en el archivo PageTemplate.css y crear su propia hoja de estilo para alterar temporalmente estos estilos. La ubicación predeterminada del archivo PageTemplate.css es servidor/ram/javascript/dojo/jazz/ui/templates/PageTemplate.css.

Comentarios