將佈景主題從舊版移轉至 7.5.1 版

如果您是在 7.5.1 版以前的舊版中使用自訂佈景主題,該佈景主題在 7.5.1 版或更新的版本中並不能如預期般運作。如果您要升級至 7.5.1 版或更新的版本,您必須編輯並還原自訂佈景主題,才能使用它。

開始之前

對於舊版 IBM® Rational® Asset Manager,您必須要有一個自訂佈景主題。您可以完成利用佈景主題來變更網站的外觀中的步驟,來建立自訂佈景主題。
儲存自訂佈景主題:
  1. 按一下管理 > 工具
  2. 在「管理佈景主題」區段中,按一下下載現行的佈景主題。這會提示您開啟或儲存壓縮檔。
  3. 儲存檔案並重新命名,以便將該檔案識別為自訂版本。

關於這項作業

Rational Asset Manager 7.5.1 版中,header.jspf 檔已經更新,會顯示登入使用者的名稱、「登入」和「登出」鏈結、「說明」功能表以及功能表選項。如果您從舊版上傳佈景主題,橫幅上除了「說明內容」、「延伸」和「關於 Rational Asset Manager」功能表選項以外,將看不見這些項目。如果要看見那些選項,您必須另外將其他的 HTML 與 JavaScript 複製到 header.jspf 檔中。

程序

  1. 升級 Rational Asset Manager 這會套用版本的預設佈景主題。
  2. 選擇性的: 下載升級版 Rational Asset Manager 的預設佈景主題,以便比較佈景主題:
    1. 按一下管理 > 工具
    2. 在「管理佈景主題」區段中,按一下下載現行的佈景主題。這會提示您開啟或儲存壓縮檔。
    3. 儲存檔案並重新命名,以便將該檔案識別為預設版本。
  3. 解壓縮壓縮檔。
  4. 在包含自訂版佈景主題的檔案中,用文字編輯器開啟 header.jspf 檔。
  5. 複製下列 HTML 和 JavaScript 字行,依照您自訂佈景主題的邏輯,貼到 header.jspf 檔案裡。 如果您已下載預設佈景主題,可以將您的所做的變更與預設 header.jspf 檔中的結構相比較。
    <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. 幫您的佈景主題建立自訂樣式表來置換預設樣式。
    1. 建立一或多個 CSS 檔,儲存在 theme/custom/css 目錄中。
    2. 檢閱跟 Rational Asset Manager 一起安裝的預設樣式表。 如果要變更任何樣式,請將該樣式規則複製到您的 CSS 檔,然後編輯樣式。您在新的 CSS 檔裡所作的變更會置換預設樣式表裡的樣式規則。
      重要: 請勿修改佈景主題保存檔裡的預設樣式表。這些樣式表會隨版本改變而改變,會在 Rational Asset Manager 更新時被改寫。
    3. cssIncludes.jspf 檔複製到您佈景主題保存裡的 theme/custom 目錄。利用 7.5.1 版裡的自訂樣式表置換預設樣式表時,一定要有這個 .jspf 檔。
    4. 將您自訂的樣式表新增到 theme/custom/cssIncludes.jspf,作成鏈結。 範例:

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

    5. 在自訂目錄裡建立一個 images 資料夾,來儲存您的佈景主題所用的映像檔。 範例:theme/custom/images-jke-enterprises
  7. 將佈景主題壓縮成一個保存檔。
  8. 在「工具」頁面的「管理佈景主題」區段中,按一下瀏覽
  9. 選取自訂的保存檔。
  10. 按一下上傳

下一步

橫幅的一些樣式表已從佈景主題保存檔移除。您可以在 PageTemplate.css 檔中檢視預設樣式規則,並且建立自己的樣式表來置換這些樣式。PageTemplate.css 檔的預設位置是 server/ram/javascript/dojo/jazz/ui/templates/PageTemplate.css

意見回饋