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 Limitação do Portlet Cooperativo no RedHat Enterprise Linux 3.0
   2.8 Mensagens de Aviso de Link Interrompido São Mostradas na Visualização Problemas
   2.9 Suporte a Marcações no Portal Designer
   2.10 Impossível Definir URL Interno
   2.11 Não Selecione Temas Admin como Padrão
3.0 Problemas Conhecidos
   3.1 (Criando Portlets) Erro de Referência de Servlet Incorreta ao Criar um Portlet em um Projeto de Portlet da API IBM Existente
   3.2 (Depurando e Testando Portlets) Não É Possível Iniciar o Ambiente de Teste do WebSphere Portal
   3.3 (Descritor de Implementação do Portlet) Editando com o Editor do Descritor de Implementação do Portlet JSR 168
   3.4 Quando <f:subvisualização> É Utilizado em Vez de <f:visualização>, os Portlets Faces Não Funcionam Corretamente.
   3.5 Click-to-Action Não Funciona em um Portlet Faces Maximizado.
   3.6 (Importando, Exportando & Implementando) Impossível Criar Servidor de Importação, Exportação & Implementação que Aponte para "localhost"
   3.7 (Importando Portal) O Cancelamento da Operação de Importação Faz com Que o Novo Projeto do Portal Fique Indisponível
   3.8 (Importando Portal) Erros Relacionados ao WSRP São Mostrados na Visualização Problemas de um Projeto de Portal Importado
   3.9 (Personalizando Portais) Impossível Abrir os Arquivos license.html e privacy.html em um Projeto de Portal Importado
   3.10 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 Limitação do Portlet Cooperativo no RedHat Enterprise Linux 3.0

Os portlets cooperativos não são suportados pelo navegador interno do Rational Developer para RedHat Enterprise Linux 3.0. Se você precisar utilizar portlets cooperativos no RedHat Enterprise Linux 3.0, utilize o Netscape Communicator.

Para utilizar o Netscape Communicator como o navegador padrão, configure o Rational Developer para utilizar um navegador externo. Para fazer isso, selecione Janela > Preferências na barra de menus. Expanda o nó Internet à esquerda e selecione Navegador da Web. Na seção principal, selecione qualquer navegador, exceto Navegador da Web Interno.

Para obter informações adicionais, consulte o tópico "Problemas e Restrições Conhecidos com Portlets Cooperativos" no centro de informações do WebSphere Portal.

2.8 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.9 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.10 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.11 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 (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.2 (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.3 (Descritor de Implementação do Portlet) Editando com o Editor do 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.4 Quando <f:subview> É Utilizado em vez de <f:view>, 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.5 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.6 (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.7 (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.8 (Importando Portal) 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.9 (Personalizando Portais) Não É Possí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.10 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