Ferramentas do Portal - Notas sobre o Release


1.0 Software Suportado e Especificações
2.0 Limitações
   2.1 Os Portlets JSR 168 Devem Ter o Atributo ID
   2.2 Registros Relacionais e Portal V5.1
   2.3 Limitação do Portlet Cooperativo
   2.4 Limitação da Tag Person
   2.5 Limitações de Ferramentas do EIS
   2.6 Configurando o SAP JCo em um Servidor WebSphere Portal
   2.7 Mensagens de Aviso de Link Interrompido São Mostradas na Visualização Problemas
   2.8 Suporte a Marcações no Portal Designer
   2.9 Impossível Definir URL Interno
   2.10 Não Selecione Temas Admin como Padrão
3.0 Problemas Conhecidos
   3.1 (Instalação) Defeito ao Instalar o Ambiente de Teste do WebSphere Portal
   3.2 (Criando Portlets) Erros de Compilação com o WebSphere Portal Mais Recente
   3.3 (Criando Portlets) Ícone de Portlet Inesperado É Exibido ao Ativar Click-to-Action
   3.4 (Criando Portlets) Erro de Referência de Servlet Incorreta ao Criar um Portlet em um Projeto de Portlet da API IBM Existente
   3.5 (Depurando e Testando Portlets) Não É Possível Iniciar o Ambiente de Teste do WebSphere Portal
   3.6 (Depurando e Testando Portlets) Não É Possível Instalar Portlets Utilizando o Portlet de Administração no Ambiente de Teste
   3.7 (Depurando e Testando Portlets) Ocorrerá um Erro se um Aplicativo de Portlet Utilizar um Banco de Dados Diferente do Cloudscape
   3.8 (Descritor de Implementação do Portlet) Editando com o Editor de Descritor de Implementação do Portlet JSR 168
   3.9 (Executando e Depurando) O Navegador Interno Não Mostra o Portal ou o Projeto de Portlet Atualizado
   3.10 Quando <f:subvisualização> É Utilizado em Vez de <f:visualização>, os Portlets Faces Não Funcionam Corretamente.
   3.11 Click-to-Action Não Funciona em um Portlet Faces Maximizado.
   3.12 (Migrando Portlets) Ocorre Falha na Migração de Portlets do Portal V4.2 para V5.0
   3.13 (Importando, Exportando & Implementando) Impossível Criar Servidor de Importação, Exportação & Implementação que Aponte para "localhost"
   3.14 (Importando Portal) O Cancelamento da Operação de Importação Faz com Que o Novo Projeto do Portal Fique Indisponível
   3.15 (Importando Portal) Erros Relacionados ao WSRP São Mostrados na Visualização Problemas de um Projeto de Portal Importado
   3.16 (Personalizando Portais) Impossível Abrir os Arquivos license.html e privacy.html em um Projeto de Portal Importado
   3.17 (Executando e Depurando um Projeto de Portal) Impossível Iniciar o Ambiente de Teste do WebSphere Portal 5.0 com um Projeto de Portal
   3.18 O Grupo de Notícias (Fórum) para o Rational Software Architect

1.0 Software Suportado e Especificações

Os projetos de Portal suportam o WebSphere Portal v5.0.2.2.

2.0 Limitações

2.1 Os Portlets JSR 168 Devem Ter o Atributo ID

Quando você cria portlets JSR 168 utilizando o assistente de novo portlet, o Rational Developer automaticamente designa um atributo ID. O atributo ID deve ser incluído no elemento <portlet-app/> do arquivo portlet.xml para identificar exclusivamente o portlet para o servidor. (Esse atributo corresponde ao atributo UID utilizado pelos portlets da API do portlet IBM.)

Se você tiver portlets JSR 168 que não possuem um atributo ID no elemento <portlet-app/> no portlet.xml, inclua o atributo ID com seu valor exclusivo logo após a importação do portlet para o espaço de trabalho. Para incluir o atributo ID, abra o descritor de implementação do portlet e edite-o utilizando a visualização Origem. Não altere o valor do ID após a implementação do portlet JSR 168 em um servidor de portal ou após a utilização do projeto de portlet JSR 168 em um projeto de portal.

Há limitações em um portlet JSR 168 sem um atributo ID:

2.2 Registros Relacionais e Portal V5.1

Ao executar um portlet que contém uma Lista de Registros Relacionais ou um Registro Relacional (SDO), você pode ver a seguinte mensagem no log de seu servidor:

[04/10/07 17:57:27:172 JST] 4942fbd0 SystemOut O java.lang.LinkageError: A classe org/eclipse/emf/ecore/EClass viola restrições do loader: incompatibilidade de definição entre os loaders pai e filho
Você pode ignorar esse erro.

2.3 Limitação do Portlet Cooperativo

Ao criar um portlet de origem cooperativo, é necessário incluir manualmente os atributos actionNameParameter e name no arquivo WSDL. Por exemplo:

<portlet:action type="standard" name="myActionName" actionNameParameter="ACTION_NAME"/>

Neste release, a ferramenta do portal não gera o atributo caption no arquivo WSDL. Quando utilizar a ligação com o WebSphere Portal v5.1, é necessário especificar manualmente o atributo caption no arquivo WSDL e o valor de caption no arquivo de recursos manualmente. Por exemplo:

<portlet:param name="orderId" partname="order_id" caption="order.id" />
Para obter informações adicionais, consulte o tópico "Desenvolvendo Portlets para Cooperação" no centro de informações do WebSphere Portal.

2.4 Limitação da Tag Person

Ao utilizar a tag person em um portlet básico da API IBM no WebSphere Portal v5.1, é necessário especificá-la utilizando a seguinte sintaxe:

<pa:person value="CN=John Smith,OU=SALES,O=ACME" valueType="LDAPDN" displayName="John Smith" />

Ao utilizar a tag person em um portlet Faces da API IBM no WebSphere Portal v5.1, é necessário especificá-la utilizando a seguinte sintaxe:

<pa:person value="CN=John Smith,OU=SALES,O=ACME" />John Smith<pa:person>

A tag person não é suportada para portlets JSR 168.

2.5 Limitações de Ferramentas do EIS

Limitação do assistente do SAP BAPI e do RFM SDO: Se você já tiver passado pela página de funções principais e pré/pós e tentar retornar a ela depois de selecionar uma função principal diferente, a página Mapeamentos de Pré/Pós não funcionará corretamente.

Solução: Se você precisar definir novos mapeamentos de pré- e pós-função, deverá reiniciar o assistente.

2.6 Configurando o SAP JCo em um Servidor WebSphere Portal

Antes de testar os portlets que contêm o SAP SDO em um servidor de Portal, você deve configurar o adaptador SAP JCo no servidor WebSphere Portal 5.1:

  1. Faça download do diretório do adaptador JCo SAP a partir do SAP em SAP Service Marketplace.
  2. Clique em Fazer Download de Software > Fazer Download > Conectores SAP > Conector SAP Java. Com base em seu sistema operacional, selecione o arquivo apropriado para download. Extraia o conteúdo do arquivo ZIP para um diretório local.
  3. Execute as etapas a seguir de acordo com seu sistema operacional. Nota: <wps_51> refere-se ao diretório de instalação do servidor WebSphere Portal 5.1; por exemplo, C:\WebSphere\PortalServer51TE.
      Para Windows:
    1. Copie sapjco.jar e sapjcorfc.dll para <wps_51>\shared\app.
    2. Copie librfc32.dll para c:\windows\system32\.
    3. Você deve reiniciar o servidor WebSphere Portal 5.1.

      Para Linux:
    1. Copie sapjco.jar e libsapjcorfc.so para <wps_51>\shared\app.
    2. Inclua a pasta que contém o arquivo librfccm.so na variável de ambiente LD_LIBRARY_PATH.
    3. Você deve reiniciar o servidor WebSphere Portal 5.1.

2.7 Mensagens de Aviso de Link Interrompido São Mostradas na Visualização Problemas

Ao criar um projeto de portal utilizando o assistente de Novo Projeto de Portal ou importar um projeto do Portal de amostra a partir da Samples Gallery, mensagens de aviso de link interrompido aparecerão na visualização Problemas.

2.8 Suporte a Marcações no Portal Designer

Nesta versão do Rational Developer, o Portal Designer exibe apenas HTML, cHTML e WML como marcações suportadas. Se você especificou outras marcações suportadas para uma página ou rótulo em um projeto importado, elas serão mantidas no Rational Developer; entretanto, não é possível alterar essas marcações e elas não serão exibidas na visualização Propriedades.

2.9 Impossível Definir URL Interno

Nesta versão do Rational Developer, você pode definir URLs externos apenas no Portal Designer. Se houver URLs internos no servidor de portal, eles serão mantidos em um projeto importado, mas você não poderá alterá-los. Apenas será possível implementar os URLs Internos de volta para o servidor de portal original.

2.10 Não Selecione Temas Admin como Padrão

Neste release do Portal Designer, os temas Admin e AdminLeftNavigation serão exibidos na visualização Esboço. Entretanto, esses temas são apenas para fins de Administração do Portal e não devem ser selecionados como tema padrão para um projeto de portal.

3.0 Problemas Conhecidos

3.1 (Instalação) Defeito ao Instalar o Ambiente de Teste do WebSphere Portal

Problema: A instalação do Rational Developer falha ao instalar o Ambiente de Teste do WebSphere Portal.

Solução: Verifique o log de instalação e execute as ações apropriadas para corrigir o problema.

Ambiente de Teste do WebSphere Portal 5.0 RD_installdir\runtimes\portal_v50\log\wpsinstalllog.txt em que RD_installdir é o diretório no qual você instalou o Rational Developer.

Ambiente de Teste do WebSphere Portal 5.1 WP51TE_installdir\PortalServer\log\wpsinstalllog.txt em que WP51TE_installdir é o diretório no qual você instalou o Ambiente de Teste do WebSphere Portal v5.1.

Se o problema não puder ser identificado a partir dos arquivos de log, tente desinstalar manualmente o Ambiente de Teste do WebSphere Portal. Em seguida, reinstale-o. Para obter informações sobre como desinstalar manualmente, consulte o Guia de Instalação do Rational Developer.

3.2 (Criando Portlets) Erros de Compilação com o WebSphere Portal Mais Recente

Problema: Você pode construir portlets para o WebSphere Portal V5.0 utilizando o Rational Developer. Se você aplicar um serviço do WebSphere Portal a seu servidor de porta, poderá receber erros de compilação durante a construção dos portlets. Neste caso, você deve atualizar manualmente os arquivos requeridos pela compilação.

Solução: Para compilar os portlets corretamente, siga estas etapas:

WebSphere Portal v5.0.2.x

Nota: É necessário restaurar esses arquivos para o estado original antes de desinstalar o Ambiente de Teste do WebSphere Portal. Se você não fizer isso, a pasta "portal_v50_stub" poderá não ser excluída e precisará ser excluída manualmente.

WebSphere Portal v5.1

Nota: É necessário restaurar esses arquivos para o estado original antes de desinstalar o Ambiente de Teste do WebSphere Portal. Se você não fizer isso, a pasta "portal_v51_stub" poderá não ser excluída e precisará ser excluída manualmente.

3.3 (Criando Portlets) Ícone de Portlet Inesperado É Exibido ao Ativar Click-to-Action

O editor do Descritor de Implementação de Portlet e a visualização Explorador de Projetos mostram os ícones dos portlets e seus nomes. Os ícones indicam o estado dos portlets. Os estados do portlet são normais, ativados para origem, ativados para destino e ativados para origem e destino.

Problema: Quando converter um portlet para um portlet de origem Click-to-Action, apenas o ícone do portlet deve ser alterado. No entanto, existem casos em que mais de um ícone de portlet será alterado, como quando vários portlets estão associados a um único servlet. Nesses casos, os ícones de portlets diferentes do portlet Click-to-Action planejado serão exibidos incorretamente. A mesma situação ocorre quando você converte um portlet para um portlet Click-to-Action de destino.

Solução: Mais de um ícone de portlet é alterado, entretanto apenas um portlet é alterado. A conversão é bem-sucedida e o projeto de portlet não é danificado.

3.4 (Criando Portlets) Erro de Referência de Servlet Incorreta ao Criar um Portlet em um Projeto de Portlet da API IBM Existente

Problema: Ao criar um novo portlet em um projeto de portlet da API IBM existente, as seguintes mensagens de erro serão exibidas se você selecionar as opções Incluir Amostra do Portlet do Emissor de Click-to-Action ou Incluir Amostra do Portlet do Emissor da Mensagem na página Manipulação de Eventos:

Solução: É necessário reabrir o projeto do portlet utilizando o seguinte método:

  1. Clique com o botão direito no projeto do portlet e selecione Fechar Projeto no menu pop-up.
  2. Clique com o botão direito no projeto do portlet e selecione Abrir Projeto no menu pop-up.
  3. Clique com o botão direito no projeto do portlet e selecione Executar Validação no menu pop-up.

3.5 (Depurando e Testando Portlets) Não É Possível Iniciar o Ambiente de Teste do WebSphere Portal

Problema: O Ambiente de Teste do WebSphere Portal falha ao ser iniciado.

Solução:

3.6 (Depurando e Testando Portlets) Não É Possível Instalar Portlets Utilizando o Portlet de Administração no Ambiente de Teste

Problema: No servidor do Ambiente de Teste do WebSphere Portal, a instalação de portlets utilizando o portlet de administração falha.

Solução: No servidor do Ambiente de Teste do WebSphere Portal, a instalação de portlets utilizando o portlet de administração não é suportada. Para implementar portlets no Ambiente de Teste do WebSphere Portal, você deve utilizar a função "Publicar" no Rational Developer. Para utilizar a função "Publicar", clique com o botão direito do mouse no projeto de aplicativo de portlet e selecione Executar > Executar no Servidor ou clique com o botão direito do mouse no servidor na visualização Servidores e selecione Publicar.

3.7 (Depurando e Testando Portlets) Ocorrerá um Erro se um Aplicativo de Portlet Utilizar um Banco de Dados Diferente do Cloudscape

Problema: Poderá ocorrer um erro se o aplicativo de portlet utilizar um banco de dados diferente do Cloudscape.

Solução: Você deve incluir o driver JDBC nos caminhos de classe específicos do WebSphere do ambiente de teste do WebSphere Portal. Execute as seguintes etapas:

  1. Na visualização Server, clique duas vezes no servidor WebSphere Portal Test Environment. O editor de servidor é aberto.
  2. Na parte inferior do editor, clique na guia Ambiente.
  3. Na seção ws.ext.dirs, inclua o driver JDBC. Por exemplo, inclua o arquivo SQLLIB\java12\db2java.zip para DB2®, em que SQLLIB é o diretório no qual você instalou o DB2.
  4. Pressione Ctrl+S para salvar suas alterações.

3.8 (Descritor de Implementação do Portlet) Editando com o Editor de Descritor de Implementação do Portlet JSR 168

Problema: No Descritor de Implementação do Portlet JSR 168, você não pode editar um nome de portlet na área Coletas de Portlets.

Solução: Edite o nome do portlet na página Origem.

3.9 (Executando e Depurando) O Navegador Interno Não Mostra um Projeto de Portal ou de Portlet Atualizado

Problema: Em algumas configurações utilizando o WebSphere Portal v5.0, as alterações feitas em um projeto de portal ou de portlet não são mostradas automaticamente no navegador ao executar ou depurar o projeto utilizando um servidor de Conexão de Servidor Remoto.

Solução: Há duas maneiras de tratar disso:

  1. Efetue logout explicitamente do WebSphere Portal utilizando o navegador e efetue login novamente. Após o login, as alterações serão mostradas. Observe que o fechamento da janela do navegador não funcionará e precisará ser executado toda vez que um projeto de portal atualizado for publicado.
  2. Alternativamente, configure o Rational Developer para utilizar um navegador externo. Para fazer isso, selecione Preferências... no menu Janela. Expanda o nó Internet à esquerda e selecione Navegador da Web. Na seção principal, selecione qualquer navegador, exceto o Navegador da Web Interno.
    Em seguida, antes de cada Execução ou Depuração no Servidor, você precisa fechar o navegador externo antes de executar a operação.

3.10 Quando <f:subvisualização> É Utilizado em Vez de <f:visualização>, os Portlets Faces Não Funcionam Corretamente.

Problema: Se você excluir a tag <f:visualização> de um arquivo Faces JSP gerado pelo assistente e inserir componentes Faces no arquivo, uma tag <f:subvisualização> será inserida no lugar de uma tag <f:visualização>. Com esse tipo de arquivo JSP, o portlet Faces não será executado corretamente. As entradas no navegador são perdidas no processamento do lado do servidor.

Problema: Para corrigir esse problema, substitua a tag <f:subvisualização> pela tag <f:visualização> no arquivo JSP.

3.11 Click-to-Action Não Funciona em um Portlet Faces Maximizado.

Se você maximizar um portlet Faces que contenha tags Click-to-Action, o conteúdo do portlet não será mostrado.

3.12 (Migrando Portlets) Ocorre Falha na Migração de Portlets do Portal V4.2 para V5.0

Problema: A alteração do nível da API do Portlet falhará se o comprimento do caminho de classe for longo.

Solução: É necessário corrigir o Caminho de Construção Java dos projetos de portlet migrados. Para o Caminho de Construção Java necessário, você pode consultar um projeto de portlet básico gerado pelo assistente de Novo Projeto de Portlet. Inclua no Caminho de Construção Java do projeto de portlet migrado os arquivos JAR necessários que estão faltando.

3.13 (Importando, Exportando & Implementando) Impossível Criar Servidor de Importação, Exportação & Implementação que Aponte para "localhost"

Problema: Se o Portal UTE não estiver instalado, você não poderá criar um servidor de Importação, Exportação & Implementação do Portal que aponte para "localhost" ou "127.0.0.1".

Solução: Se você precisar criar esse servidor, utilize o nome completo da máquina em vez de "localhost" (exemplo: myhost.mydomain).

3.14 (Importando Portal) O Cancelamento da Operação de Importação Faz com Que o Novo Projeto do Portal Fique Indisponível

Problema: Se você cancelar a importação de um novo projeto de portal antes da conclusão, o projeto de portal incompleto não será removido e ficará indisponível.

Solução: É necessário importar a configuração e os arquivos do portal novamente utilizando a opção Excluir ao Sobrescrever no assistente para Importar Portal.

3.15 (Importando o Portal) Os Erros Relacionados ao WSRP São Mostrados na Visualização Problemas de um Projeto de Portal Importado

Problema: Ao importar um site de portal existente do WebSphere Portal para o Rational Developer, erros de validação relacionados ao WSRP são mostrados na visualização Problemas para o projeto de portal importado.

Solução: Aplique o APAR PQ95638 ao WebSphere Portal antes da importação para o Rational Developer.

3.16 Personalizando Portais) Impossível Abrir os Arquivos license.html e privacy.html em um Projeto de Portal Importado

Problema: Não é possível abrir os arquivos license.html ou privacy.html em um projeto de portal importado utilizando o Page Designer devido à codificação incorreta.

Solução: Aplique o APAR PQ93681 a seu servidor de Portal, em seguida, reimporte o projeto do servidor de Portal.

3.17 (Executando e Depurando um Projeto do Portal) Não É Possível Iniciar o Ambiente de Teste do WebSphere Portal 5.0 com um Projeto do Portal

Problema: O Ambiente de Teste do WebSphere Portal 5.0 falha ao ser iniciado quando você tenta fazer o seguinte:

Solução: Você precisa reconfigurar o Ambiente de Teste do WebSphere Portal 5.0.

  1. Na visualização Servidores, clique com o botão direito do mouse no servidor e selecione "Incluir e Remover Projetos...".
  2. Remova o projeto "wps" de "Projetos Configurados".
  3. Clique com o botão direito do mouse no projeto de portal e selecione Executar > Executar no Servidor.
Agora você poderá executar seu projeto de portal e seus projetos de portlet recentemente associados no ambiente de teste.

3.18 O Grupo de Notícias (Fórum) para o Rational Software Architect

"Incluir Tempo de Execução do SDO" referencia grupos de notícias do Rational Software Architect. O site de suporte do Rational Software Architect (www.ibm.com/software/awdtools/developer/application/support) será atualizado para incluir o link nos grupos de notícias.

Retornar para o Arquivo Leia-me Principal