Migrazione del tema da una release precedente alla versione 7.5.1

Se si è utilizzato un tema personalizzato un una release precedente alla 7.5.1, il tema potrebbe non funzionare come previsto nella versione 7.5.1 o nelle successive. Se è stato effettuato l'aggiornamento alla versione 7.5.1 o a una versione successiva, per poter utilizzare il tema personalizzato, sarà necessario modificarlo e ripristinarlo.

Prima di iniziare

Per la release precedente di IBM® Rational Asset Manager, è necessario disporre di un tema personalizzato. È possibile creare un tema personalizzato seguendo i passi riportati in Modifica dell'aspetto del sito utilizzando i temi.
Salvare il tema personalizzato:
  1. Fare clic su Amministrazione > Strumenti.
  2. Nella sezione Gestione tema, fare clic su Scarica tema corrente. Verrà richiesto di aprire o salvare un file compresso.
  3. Salvare il file e ridenominarlo in modo da identificarlo come la versione personalizzata.

Informazioni su questa attività

In Rational Asset Manager versione 7.5.1, il file header.jspf viene aggiornato per visualizzare il nome dell'utente collegato, i link di accesso e di scollegamento, il menu Guida e le opzioni di menu. Se si carica un tema da una versione precedente, queste voci, oltre alle opzioni dei menu Contenuto della guida, Estensioni e Informazioni su Rational Asset Manager non saranno disponibili nel banner. Per visualizzare queste opzioni è necessario copiare un ulteriore codice HTML e JavaScript nel file header.jspf.

Procedura

  1. Aggiornare Rational Asset Manager. Viene applicato il tema predefinito della release.
  2. Opzionale: Scaricare il tema predefinito per la versione aggiornata di Rational Asset Manager in modo che sia possibile confrontare i temi:
    1. Fare clic su Amministrazione > Strumenti.
    2. Nella sezione Gestione tema, fare clic su Scarica tema corrente. Verrà richiesto di aprire o salvare un file compresso.
    3. Salvare il file e ridenominarlo in modo da identificarlo come la versione predefinita.
  3. Estrarre i file compressi.
  4. Nel file che contiene la versione personalizzata del tema, aprire il file header.jspf in un editor di testo.
  5. Copiare le seguenti righe di HTML e JavaScript ed incollarle nel file header.jspf in una ubicazione logica per il tema personalizzato. Se è stato scaricato il tema predefinito, è possibile confrontare le modifiche rispetto alla struttura contenuta nel file header.jspf predefinito.
    <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. Creare fogli di stile personalizzati per il tema che sovrascriveranno gli stili predefiniti.
    1. Creare uno o più file CSS e salvarli nella directory theme/custom/css.
    2. Rivedere i fogli di stile predefiniti installati con Rational Asset Manager. Per ogni stile che si desidera modificare, copiare le regole di stile nel file CSS e modificare gli stili. Le modifiche apportate nei nuovi file CSS sovrascriveranno le regole di stile nei fogli di stile predefiniti.
      Importante: Non modificare i fogli di stile predefiniti nel file di archivio dei temi. Questi fogli di stile cambiano da release a release e vengono sovrascritti durante l'aggiornamento di Rational Asset Manager.
    3. Copiare il file cssIncludes.jspf nella directory theme/custom dell'archivio temi. Questo file .jspf è necessario per utilizzare i fogli di stile personalizzati nella versione 7.5.1 sovrascrivendo i fogli di stile predefiniti.
    4. Aggiungere i fogli di stile predefiniti a theme/custom/cssIncludes.jspf come link. Esempio:

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

    5. Creare una cartella images nella directory personalizzata e salvare in questa cartella i file di immagine utilizzati nel tema personalizzato. Esempio: theme/custom/images-jke-enterprises
  7. Comprimere il tema in un file di archivio.
  8. Nella pagina Strumenti, nella sezione Gestione tema, fare clic su Sfoglia.
  9. Selezionare il file di archivio personalizzato.
  10. Fare clic su Carica.

Operazioni successive

Molti fogli di stile per il banner sono stati rimossi dall'archivio tema. È possibile visualizzare le regole di stile predefinite nel file PageTemplate.css e creare un proprio foglio di stile con cui sovrascrivere tali stili. L'ubicazione predefinita per il file PageTemplate.css è server/ram/javascript/dojo/jazz/ui/templates/PageTemplate.css.

Feedback