Инструменты портала и портлета, Информация о выпуске

© Copyright International Business Machines Corporation 2006. Все права защищены. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM® Corp.

Информация о выпуске

1.0 Ограничения
   1.1 На панели Неполадки показываются предупреждающие сообщения о неработающих ссылках
   1.2 Поддержка текста на языке описания в Проектировщике портала
   1.3 Неправильно используется цветовая палитра по умолчанию
2.0 Известные неполадки и обходные пути
   2.1 Требуется ручная синхронизация Целевой среды выполнения и версии сервера портала мастера Создать проект портала
   2.2 Правка файлов JSP типа содержимого CSS в окне диалога Стили
   2.3 Созданный код клиента служб для JSF не работает в портлетах JSR 168 Faces
   2.4 Сообщение 'Несовместимые файлы' при импорте проекта портала
   2.5 Невозможно запустить портлет JSR 168, для которого не указан ИД приложения с портлетами, или невозможно запустить проект портала, содержащий такой портлет.
   2.6 Для сервера WebSphere Portal 6.0 регистрируется состояние Остановлен, хотя он работает
   2.7 После запуска или развертывания проекта My Portal в Portal 6.0 на страницах не отображаюся портлеты
   2.8 При создании сообщений бизнес-процесса с форматом doc/lit WSDL имена сообщений не отображаются в мастере.
   2.9 Параметр действия по умолчанию в мастере взаимодействующих портлетов может содержать неверное значение, если проект портлета JSR 168 содержит портлеты разных типов.
   2.10 Не работает контейнер страницы задач, если изменено значение по умолчанию для уникального имени
   2.11 Во время развертывания некоторых проектов портала, перенесенных из Rational Developer 6.x, может возникать NoModuleFileException
   2.12 Установка режима PARENT_LAST для загрузчика классов для портлетов Faces
   2.13 Опция "Выполнить в среде тестирования WebSphere Portal v5.1" может не работать с проектами портала, созданными с помощью Rational Developer 6.x
   2.14 Примеры портала и портлетов в Галерее примеров и мастере импорта портала фильтруются по ролям

1.0 Ограничения

1.1 На панели Неполадки показываются предупреждающие сообщения о неработающих ссылках

При импорте примера проекта портала из Галереи примеров или при создании проекта портала с помощью мастера "Создать проект портала" в панели Неполадки появляется предупреждающее сообщение о неработающей ссылке.

1.2 Поддержка текста на языке описания в Проектировщике портала

В этой версии Rational® Developer, Проектировщик портала поддерживает только отображение в форматах HTML, cHTML и WML.  Если в импортированном проекте указаны  другие поддерживаемые языки описания для страницы или метки, они они будут поддерживаются в Rational Developer, но их нельзя будет изменить. Эти языки описания не будут показаны в панели Свойства. 

1.3 Неправильно используется цветовая палитра по умолчанию

Если странице не присвоена цветовая палитра, используется цветовая палитра по умолчанию, применяемая в WebSphere® Portal 6. Однако, в Проектировщике порта в этом случае вместо палитры по умолчанию используется цветовая палитра родительской страницы.

2.0 Известные неполадки и обходные пути

2.1 Требуется ручная синхронизация Целевой среды выполнения и версии сервера портала мастера Создать проект портала

При выборе версии сервера портала в мастере Создать сервер портала не происходит автоматического обновления целевой среды выполнения.  Необходимо вручную задать целевую среду выполнения, соответствующую версии сервера портала.   Например, для версии 6.0.0.x сервера портала следует выбрать среду выполнения WebSphere Portal v6.0 , для версии 5.1.0.x  - среду выполнения WebSphere Portal v5.1 . Если версия целевой среды выполнения не соответствует версии портала, то при развертывании проекта портала сервер может быть поврежден или станет непригодным для использования.

2.2 Правка файлов JSP типа содержимого CSS в окне диалога Стили

В WebSphere Portal v6.0 при редактировании с помощью окна диалога Стили файлов JSP типа содержимого CSS, таких как styles.jsp или styles_theme.jspf,  выражения JSP могут быть показаны в окне диалога.  Эти выражения JSP не могут быть  изменены в окне диалога, их необходимо изменить исходной панели Проектировщика CSS.

2.3 Созданный код клиента служб для JSF не работает в портлетах JSR 168 Faces

Если клиент службы в Faces JSP для портлета JSR168 Faces генерируется с помощью следующих инструментов, то созданный код страницы не будет работать ни в WebSphere Portal 6.0, ни в WebSphere Portal 5.1. К этим инструментам относятся:

Эта неполадка связана с новой реализацией программы выполнения портлета JSR168 Faces, содержащейся в jsf-portletbridge.jar, которая отличается от используемой ранее.

В новой реализации объекты EJB pagecode для JSP Faces, объявленные как объекты MBean с областью действия запроса, не сохраняются при переходе от этапа Действие портлета к этапу Вывод. В генерированном коде клиента Web-служб объект EJB pagecode используется для кэширования результата Web-службы на этапе Действие. Однако, поскольку он не в области действия запроса, на этапе Вывод создается новый экземпляр. Следовательно, кэшированный результат теряется.

Существует два возможных решения:

  1. Поместите объект EJB в область действия сеанса (в файле faces-config.xml). Просто измените одну строку в файле конфигурации.
  2. Не такой простой, как первый, но предпочитаемый способ реализации клиента служб в портлетах JSR168. Он больше всего соответствует стилю программирования портлетов JSR168 и обеспечивает лучшую поддержку кнопки Назад и установки закладок.
PortletResponse response = (PortletResponse)getFacesContext().getExternalContext().getResponse();
((ActionResponse)response).setRenderParameter("resultValue", resultValue);
PortletRequest request = (PortletRequest)getFacesContext().getExternalContext().getRequest();
request.getPortletSession().put("resultValue", resultValue);
PortletResponse response = (PortletResponse)getFacesContext().getExternalContext().getResponse();
((ActionResponse)response).setRenderParameter("inputValue", inputValue);
PortletRequest request = (PortletRequest)getFacesContext().getExternalContext().getRequest();
String inputValue = request.getParameter("inputValue");

2.4 Сообщение 'Несовместимые файлы' при импорте проекта портала

При импорте проекта портала может появиться сообщение-вопрос: "Следующие файлы рабочей области несовместимы с редактором. Обновить редактор с учетом содержимого рабочей области?". Нажмите Да. 

2.5 Невозможно запустить портлет JSR 168, для которого не указан ИД приложения с портлетами, или невозможно запустить проект портала, содержащий такой портлет.

В соответствии со спецификацией JSR 168, идентификатор приложения с портлетами не обязателен, однако Rational® Developer публикует портлеты без этого идентификатора неправильно. Rational Developer не генерирует портлеты без этих идентификаторов. Возможно, портлет был создан с помощью импорта из другого источника. Для обхода этой неполадки откройте файл описания портлета для проекта на вкладке Исходный текст и добавьте ИД приложения с портлетами. Например:
<portlet-app xmlns=... version=... xmlns:xsi=... xsi:schemaLocation=... id="ВВЕДИТЕ_ИД_ЗДЕСЬ">
...
</portlet-app>

2.6 Для сервера WebSphere Portal 6.0 регистрируется состояние Остановлен, хотя он работает

Если для сервера регистрируется состояние Остановлен, в то время как он работает, прежде всего убедитесь, что в редакторе сервера правильно указаны порты коннектора SOAP/RMI и разрешения WebSphere. Если эти параметры неверны, то для сервера никогда не будет зарегистрировано состояние Запущен. Если параметры правильные, но для сервера по-прежнему показано состояние Остановлен, то, возможно, неполадка связана с сосуществованием WebSphere Application Server v6.1 и WebSphere Portal v6.0.

Наиболее вероятная причина этой неполадки заключается в том, что сервер WebSphere Application Server 6.1 установлен в локальной системе, и вы запускаете [сервер портала] с новой рабочей областью. В этой новой рабочей области автоматически создается и инициализируется экземпляр сервера WebSphere Application Server 6.1, что препятствует правильной работе функции определения состояния Portal 6.0. Эта неполадка может также возникать в том случае, когда сервер Portal 6.0 создается сразу после создания сервера WebSphere Application Server v6.1.

Для обхода этой неполадки перезапустите продукт Rational с той же самой рабочей областью. После этого экземпляр сервера Portal 6.0 должен работать правильно, поскольку сервер WebSphere Application Server 6.1 не будет инициализирован, то есть его состояние будет не Остановлен или Запущен, а останется пустым.

2.7 После запуска или развертывания проекта My Portal в Portal 6.0 на страницах не отображаюся портлеты

После запуска или развертывания проекта My Portal в Portal 6.0 на страницах не отображаюся портлеты. Для того чтобы свести к минимуму последствия этой неполадки, во всех случаях, когда не требуется полное развертывание, выполняйте развертывание только конфигурации.

При возникновении этой неполадки попытайтесь развернуть только конфигурацию проекта портала, без развертывания портлетов. Обычно это позволяет порталу правильно выводить портлеты.

2.8 При создании сообщений бизнес-процесса с форматом doc/lit WSDL имена сообщений не отображаются в мастере.

Если создается новое сообщение бизнес-процесса, а файл WSDL - в формате doc/lit, то на второй странице мастера могут быть не показаны имена входящего и исходящего сообщений. Тем не менее, их можно по-прежнему выбрать и просмотреть сведения о сообщении в правой панели мастера. Несмотря на то, что имена сообщений не показаны в мастере, будет генерироваться правильный код.  

2.9 Параметр действия по умолчанию в мастере взаимодействующих портлетов может содержать неверное значение, если проект портлета JSR 168 содержит портлеты разных типов.

Если для создания исходных или целевых портлетов применяется мастер взаимодействующих портлетов, а ваш проект портлета JSR 168 содержит портлеты нескольких типов, например, один базовый портлет и один портлет struts, то параметр действия по умолчанию в мастере может быть неправильным.

В базовых портлетах и портлетах Faces значение параметра действия по умолчанию должно быть равно ACTION_NAME_PARAM, но пользователь может выбрать другое значение.
В портлетах struts значение параметра действия должно быть равно spf_strutsAction.

2.10 Не работает контейнер страницы задач, если изменено значение по умолчанию для уникального имени

Для уникального имени в контейнерах страниц задач существуют значения по умолчанию: 
 WebSphere Portal v6.0:   ibm.portal.MyTasks
 WebSphere Portal v5.1:   wps.MyTasks

Если в Проектировщике портала используется другая страница с уникальным именем, отличным от перечисленных выше,  то после развертывания в WebSphere Portal эта страница не распознается как страница контейнера страниц задач. 

Способ обхода неполадки:  После развертывания  измените значение параметра TaskPageContainerUniqueName в портлете Список задач, выполнив следующие действия:
 1.  Выберите Администрирование > Управление портлетами > Портлеты
 2.  Нажмите кнопку Настроить для  портлета Список задач
 3.  Для параметра TaskPageContainerUniqueName нажмите кнопку Изменить.
 4.  Измените значение параметра, указав в качестве нового уникального имени в Проектировщике портала одно из следующий значений:

  WebSphere Portal v6.0:   ibm.portal.MyTasks
  WebSphere Portal v5.1:   wps.MyTasks
 5.  Нажмите кнопку OK. 

2.11 Во время развертывания некоторых проектов портала, перенесенных из Rational Developer 6.x, может возникать NoModuleFileException

Если проект портала был перенесен из Rational Developer 6.x  в рабочую область Rational Developer 7.0, то при его развертывании может произойти сбой и возникнуть исключительная ситуация NoModuleFileException.   В этом случае для устранения неполадки выполните описанные ниже действия.

      <module id="WebModule_1163447032109">
          <web>
              <web-uri>wps.war</web-uri>
              <context-root>wps</context-root>
          </web>
      </module>
      <module id="WebModule_WSRP">
         <web>
            <web-uri>wps_facade.war</web-uri>
            <context-root>/wsrp</context-root>
         </web>
      </module>
      <module id="EjbModule_1">
          <ejb>wp.scheduler.ejb.jar</ejb>
      </module>
      <security-role id="SecurityRole_1">
         <description>Everyone in the enterprise.</description>
         <role-name>Everyone Role</role-name>
      </security-role>
      <security-role id="SecurityRole_2">
         <description>All Authenticated users in the enterprise.</description>
         <role-name>All Role</role-name>
      </security-role>
      <security-role id="SecurityRole_3">
         <description>No users in the enterprise.</description>
         <role-name>No Role</role-name>
      </security-role>

2.12 Установка режима PARENT_LAST для загрузчика классов для портлетов Faces

Вследствие того, что в WebSphere Portal 6.0 поставлялась устаревшая версия jsf-ibm.jar, некоторые компоненты JSF выводятся в портлетах неправильно, если для загрузчика классов Web-модуля портлета установлен режим PARENT_FIRST.  Дело в том, что когда для загрузчика классов установлен режим PARENT_FIRST, вместо копии, содержащейся в Web-модуле портлета, будет использоваться jsf-ibm.jar из WebSphere Portal 6.0.

Это касается только компонентов jsf-ibm.jar, которые соответствуют URI http://www.ibm.com/jsf/html_extended.   Указанная неполадка может возникать как в портлетах IBM Faces, так и в портлетах JSR168 Faces.

В перечисленных ниже случаях для загрузчика классов Web-модуля портлета устанавливается режим PARENT_FIRST, следовательно, его необходимо будет изменить:

Для обхода этой неполадки откройте файл application.xml в проекте EAR, содержащем проект портлета, и перейдите на вкладку "Развертывание".   В разделе "Приложение" найдите дерево, в котором показан EAR и проект портлета.  Выберите проект портлета и измените "Режим загрузчика классов" с "PARENT_FIRST" на "PARENT_LAST".   Для того чтобы изменения вступили в силу, приложение необходимо повторно опубликовать приложение на целевом сервере.
Если портлет устанавливается непосредственно в WebSphere Portal с применением WAR или в странице администрирования WebSphere Portal, или с помощью команды xmlAccess, то для загрузчика классов уже установлен режим PARENT_LAST.   В этом случае портлет будет работать правильно, и никаких действий по обходу неполадки выполнять не требуется.

2.13 Опция "Выполнить в среде тестирования WebSphere Portal v5.1" может не работать с проектами портала, созданными с помощью Rational Developer 6.x

Когда проект портала 5.1.0.1, созданный в Rational Developer 6.x, импортируется с помощью хранилища Project Interchange в рабочую область Rational Developer 7.0, то может не работать опция "Выполнить в среде тестирования WebSphere Portal v5.1".

Способ обхода неполадки: Измените содержимое файла .portalsettings, выполнив следующие действия:
 1. Выберите Окно > Открыть проекцию > Другая... .
 2. Выберите пункт Ресурс и нажмите кнопку OK в окне Открыть проекцию.
 3. Разверните проект портала в панели Навигатор.
 4. Выберите файл .portalsettings и откройте его в текстовом редакторе.
 5. Вставьте следующие строки.
    <?xml version="1.0" encoding="UTF-8"?>
    <portalSettings>
         <portal-version version="5.1.0.1"/>
         <portlets-ear-project portlets-ear-project-name=""/>
         <process-integration mytaskspage-uniquename="wps.MyTasks"/>
     </portalSettings>

2.14 Примеры портала и портлетов в Галерее примеров и мастере импорта портала фильтруются по ролям

Для того чтобы были показаны мастер импорта портала, а также примеры портала и портлетов из Галереи примеров, необходимо включить роль "(опытный) разработчик Web-приложений".  Для включения этой роли, выберите Справка > Начальная страница и нажмите кнопку "Включить роли", которая расположена в углу экрана.  Затем выберите роль "(опытный) разработчик Web-приложений", которую требуется включить.  Для того чтобы изменения вступили в силу, перезапустите мастер или Галерею примеров.