Миграция темы предыдущего выпуска до версии 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 архива темы. Этот файл .jspf требуется для использования пользовательских таблиц стилей в версии 7.5.1 для переопределения стандартных таблиц стилей.
    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 находится в сервер/ram/javascript/dojo/jazz/ui/templates/PageTemplate.css.

Отправить комментарий