Motiv von einem früheren Release auf Version 7.5.1 migrieren

Wenn Sie in einem früheren Release als Version 7.5.1 ein angepasstes Motiv verwendet haben, kann es sein, dass dieses Motiv in Version 7.5.1 oder höher nicht wie erwartet funktioniert. Wenn Sie ein Upgrade auf Version 7.5.1 oder höher durchführen, müssen Sie das angepasste Motiv bearbeiten und wiederherstellen, um es verwenden zu können.

Vorbereitende Schritte

Für das frühere Release von IBM® Rational Asset Manager benötigen Sie ein angepasstes Motiv. Angepasste Motive können durch Ausführen der Schritte im Abschnitt Aussehen der Site durch Verwendung von Motiven ändern erstellt werden.
Speichern Sie das angepasste Motiv:
  1. Klicken Sie auf Administration > Tools.
  2. Klicken Sie im Abschnitt "Motiv verwalten" auf Aktuelles Motiv herunterladen. Daraufhin werden Sie zum Öffnen oder Speichern einer komprimierten Datei aufgefordert.
  3. Speichern Sie die Datei und benennen Sie sie um, damit die Datei als angepasste Version kenntlich ist.

Informationen zu diesem Vorgang

In Rational Asset Manager Version 7.5.1 wird die Datei header.jspf so aktualisiert, dass der Name des angemeldeten Benutzers, die Links 'Anmelden' und 'Abmelden', das Menü Hilfe und die zugehörigen Menüoptionen angezeigt werden. Wenn Sie ein Motiv aus einer früheren Version hochladen, sind diese Elemente zusätzlich zu den Menüoptionen Hilfeverzeichnis, Erweiterungen und Informationen zu Rational Asset Manager nicht im Banner sichtbar. Damit diese Optionen angezeigt werden, müssen Sie zusätzlichen HTML- und JavaScript-Code in die Datei header.jspf kopieren.

Vorgehensweise

  1. Führen Sie für Rational Asset Manager ein Upgrade durch. Das Standardmotiv für das Release wird angewendet.
  2. Optional: Laden Sie das Standardmotiv für die Version von Rational Asset Manager herunter, für die das Upgrade durchgeführt wurde, damit Sie die Motive vergleichen können:
    1. Klicken Sie auf Administration > Tools.
    2. Klicken Sie im Abschnitt "Motiv verwalten" auf Aktuelles Motiv herunterladen. Daraufhin werden Sie zum Öffnen oder Speichern einer komprimierten Datei aufgefordert.
    3. Speichern Sie die Datei und benennen Sie sie um, damit die Datei als Standardversion kenntlich ist.
  3. Extrahieren Sie die komprimierten Dateien.
  4. Öffnen Sie in der Datei, die die angepasste Version des Motivs enthält, die Datei header.jspf in einem Texteditor.
  5. Kopieren Sie die folgenden HTML- und JavaScript-Zeilen und fügen Sie in die Datei header.jspf ein, und zwar an einer Position, die für Ihr angepasstes Motiv logisch ist. Wenn Sie das Standardmotiv heruntergeladen haben, können Sie die Änderungen mit der Struktur in der Standardversion der Datei header.jspf vergleichen.
    <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. Erstellen Sie angepasste Style-Sheets für Ihr Motiv, um die Standard-Styles zu überschreiben.
    1. Erstellen Sie eine oder mehrere CSS-Dateien, und speichern Sie sie im Verzeichnis theme/custom/css.
    2. Schauen Sie sich die Standard-Style-Sheets an, die mit Rational Asset Manager installiert wurden. Kopieren Sie bei allen Styles, die Sie ändern wollen, die Styleregeln in Ihre CSS-Datei und bearbeiten Sie die Styles. Die Änderungen, die Sie in Ihren neuen CSS-Dateien vornehmen, setzen Sie Styleregeln in den Standard-Style-Sheets außer Kraft.
      Wichtig: Ändern Sie nicht die Standard-Style-Sheets in der Motivarchivdatei. Diese Style-Sheets ändern sich von Release zu Release und werden überschrieben, wenn ein Upgrade für Rational Asset Manager durchgeführt wird.
    3. Kopieren Sie die Datei cssIncludes.jspf in das Verzeichnis theme/custom Ihres Motivarchivs. Diese .jspf-Datei ist für die Verwendung von angepassten Style-Sheets in Version 7.5.1 erforderlich, um so die Standard-Style-Sheets zu überschreiben.
    4. Fügen Sie Ihre angepassten Style-Sheets der Datei theme/custom/cssIncludes.jspf als Links hinzu. Beispiel:

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

    5. Erstellen Sie den Ordner images im Verzeichnis "custom", und speichern Sie darin die Imagedateien, die in Ihrem Motiv verwendet werden. Beispiel: theme/custom/images-jke-enterprises
  7. Komprimieren Sie das Motiv in eine Archivdatei.
  8. Klicken Sie auf der Seite "Tools" im Abschnitt "Motiv verwalten" auf Durchsuchen.
  9. Wählen Sie die angepasste Motivdatei aus.
  10. Klicken Sie auf Hochladen.

Nächste Schritte

Viele der Style-Sheets für das Banner wurden aus dem Motivarchiv entfernt. Sie können die Standardstyleregeln in der Datei PageTemplate.css anzeigen und ein eigenes Style-Sheet erstellen, um diese Styles zu überschreiben. Die Standardposition der Datei PageTemplate.css ist das Verzeichnis server/ram/javascript/dojo/jazz/ui/templates/PageTemplate.css.

Feedback