WebSphere Portal e HATS
O IBM® WebSphere Portal fornece um
ponto único de acesso a conteúdo e aplicativos da Web, personalizado
de acordo com as necessidades de cada usuário.
A integração do HATS com o WebSphere Portal permite o fluxo de dados livremente entre o
HATS, WebSphere Portal e outros aplicativos de Portal.
Todos os recursos
relevantes do WebSphere Portal também estão disponíveis para exploração no
HATS por ferramentas integradas ou desenvolvimento direto em Java™.
A maioria da funcionalidade
do HATS é preservada ao executar o HATS no ambiente WebSphere
Portal. Consulte Limitações e Considerações do Portlet do
HATS para obter informações adicionais.
Os aplicativos HATS podem ser executados
diretamente no WebSphere Portal
como portlets, possibilitando que o WebSphere Portal
e o HATS interajam diretamente. É
possível desenvolver portlets do HATS que estejam em conformidade com
a API de Portlet IBM ou com a API de Especificação de Portlet Java (JSR
168), daqui por diante
referida como a API de portlet padrão.
Nota:
Ao longo deste documento, os portlets do HATS que
estão em conformidade com a API de portlet padrão
(JSR 168) serão
mencionados como portlets padrão.
As classes de Lógica de Negócios do HATS
podem utilizar as APIs do WebSphere Portal e as JSPs do HATS podem
incluir as bibliotecas de tags JSP do WebSphere Portal. Para
obter mais informações sobre portlets de programação e recursos de
portal avançados, consulte a publicação HATS Web Application Programmer's Guide.
Um projeto de portlet do HATS é destinado aos aplicativos orientados por transformação.
Para adaptar o Objeto de Integração Modelo 1 baseado
em aplicativos para execução no WebSphere Portal, consulte a publicação HATS Web Application Programmer's Guide. Para converter o Objeto de Integração Struts baseado em
aplicativos para execução no WebSphere Portal,
consulte o Centro de Informações do WebSphere Portal
no endereço
http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp
e procure Struts.
Para obter mais informações e ajuda relacionadas às
Ferramentas do Portal, selecione o menu
Ajuda na barra de ferramentas do
Rational SDP e selecione
Conteúdo da Ajuda. Clique em Desenvolvendo aplicativos de portlet e do portal
na lista de ajuda à esquerda para acessar a documentação para desenvolvedores de portlet.
Criando Portlets do HATS
Existem duas maneiras nas quais você pode criar um portlet do HATS:
- Você
pode criar um novo portlet utilizando o assistente para Criar um Projeto do HATS e
designando que o Servidor de Destino deve ser um
dos servidores suportados do WebSphere Portal.
- Você pode gerar um a partir de um projeto da Web do HATS existente. Isto
garante que o tempo gasto na criação do seu aplicativo da
Web do HATS não será desperdiçado ao movê-lo
para o WebSphere Portal.
Criando um Novo Projeto de Portlet do HATS
Para criar um novo projeto de portlet do HATS, ative o assistente para
Criar um Projeto utilizando uma das seguintes ações:
- Selecione HATS > Novo > Projeto na barra de menus.
- Selecione Arquivo > Novo > Projeto do HATS na barra de menus.
- Clique no ícone Criar Projeto do HATS na barra de ferramentas.
No
assistente Criar um Projeto, no painel do HATS Project:
- Insira um nome para o projeto do portlet.
- Opcionalmente, insira uma descrição.
- Aceite o
local padrão.
- Selecione Web para indicar um
projeto da Web.
Nota:
Se a opção de implementação da Web estiver
desativada, isso indica que não há tempos de execução do servidor
definidos. Para definir tempos de execução do servidor, acesse Janela > Preferências > Servidor >
Ambientes de Tempo de Execução e inclua pelo menos uma definição
de tempo de execução.
- Para o campo Servidor de Destino, selecione um dos servidores WebSphere Portal suportados, WebSphere Portal
v6.0 ou WebSphere Portal v6.1.
Notas:
- Geralmente, os portlets destinados ao WebSphere Portal v6.0 podem ser implementados e executados no
WebSphere Portal v6.1. Para obter mais informações, consulte o Centro de Informações do
WebSphere Portal no
endereço http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp e procure Planejamento para Migração.
- Portlets padrão destinados
ao WebSphere Portal
v6.0 ou v6.1 também podem ser executados no WebSphere Application Server v6.1 ou v7.0.
- Para o campo Projeto do Aplicativo Corporativo, insira o nome do
projeto EAR a ser usado para teste no ambiente de testes local.
Nota:
Projetos de portlet padrão e IBM
podem ser incluídos no mesmo projeto EAR.
- Para o campo API do Portlet, selecione Portlet JSR
168 ou Portlet IBM para
indicar com qual API este portlet estará em conformidade.
Nota:
Se Portlet IBM for
selecionado, será exibido um aviso informando que esta API foi reprovada.
- Selecione se os arquivos de suporte do console administrativo
serão ou não incluídos.
Nota:
Esta opção não é suportada para portlets padrão do HATS.
- Clique em Avançar e continue a
criar seu projeto normalmente.
Isso gerará um único projeto de portlet do HATS, incluindo um projeto
EAR que pode ser usado para testes com um ambiente de testes local.
Gerando Portlets a Partir de Projetos da Web do HATS
Para permitir que um projeto da Web do HATS existente seja executado como um portlet,
a estrutura e o conteúdo do projeto do HATS devem ser alterados para atender à
especificação do portlet. O HATS Toolkit automatiza o processo de conversão de um projeto
da Web do HATS regular em um portlet. O recurso Ferramentas do Portal
do Rational SDP é um pré-requisito para este processo de conversão.
Para gerar um projeto de portlet do HATS a partir de
um projeto da Web do HATS existente, na visualização
Projetos HATS, clique com o botão
direito sobre o projeto da Web e selecione
Gerar Projeto de Portlet.
No assistente Gerar Projeto de
Portlet, no painel Opções de Geração de Projeto de Portlet:
- Insira um nome para o projeto do portlet.
- Para o campo de Servidor de Destino, selecione o servidor
WebSphere Portal de destino,
WebSphere
Portal v6.0 ou WebSphere Portal v6.1.
Notas:
- Ao gerar um projeto de portlet do HATS a partir de um projeto da Web HATS, o servidor de destino do
projeto da Web determina as opções do servidor de destino para o projeto de portlet. Se
o servidor de destino do projeto da Web for
WebSphere Application
Server v6.0, as opções do servidor de destino para o projeto de portlet gerado
serão WebSphere Portal v6.0 ou
v6.1. Se o servidor de destino do projeto da Web for
WebSphere Application
Server v6.1, a opção do servidor de destino para o portlet gerado
será o WebSphere Portal v6.1. Se o servidor de destino do projeto da Web for
WebSphere Application Server v7.0, não há
opção para gerar um portlet.
- Geralmente, os portlets destinados ao WebSphere Portal v6.0 podem ser implementados e executados no
WebSphere Portal v6.1. Para obter mais informações, consulte o Centro de Informações do
WebSphere Portal no
endereço http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp e procure Planejamento para Migração.
- Portlets padrão destinados
ao WebSphere Portal
v6.0 ou v6.1 também podem ser executados no WebSphere Application Server v6.1 ou v7.0.
- Para o campo Projeto do Aplicativo Corporativo, insira o nome do
projeto EAR a ser usado para teste no ambiente de testes local.
Nota:
Projetos de portlet padrão e IBM
podem ser incluídos no mesmo projeto EAR.
- Para o campo API do Portlet, selecione Portlet JSR
168 ou Portlet IBM para
indicar com qual API este portlet estará em conformidade.
Nota:
Se Portlet IBM for
selecionado, será exibido um aviso informando que esta API foi reprovada.
- Selecione nessa lista os tipos de arquivos a serem convertidos
automaticamente:
- Transformações
- Fragmentos de transformação
- Modelos
- Manipuladores de macro
- Folhas de Estilo em Cascata
- Clique em Concluir.
Um projeto de portlet do HATS será criado a partir do projeto da Web selecionado.
Assim que o portlet é criado, a personalização adicional pode ser feita.
Para obter mais informações
sobre como modificar projetos do HATS, consulte o Modificando um Projeto do HATS.
Notas:
- Se você converter um projeto da Web do HATS para um projeto de
portlet do HATS, pode ser necessário modificar manualmente o arquivo
de configuração do Web Express
Logon (WEL) (hatswelcfg.xml) se os plug-ins configurados para o
projeto da Web não forem suportados para o projeto de portlet. É recomendado
que você utilize a interface com o usuário do WEL para incluir plug-ins
suportados para que o arquivo de configuração do WEL (hatswelcfg.xml) seja
atualizado apropriadamente.
- Depois de gerar um projeto de portlet do HATS a partir de um projeto da Web do HATS,
as alterações feitas em um projeto não serão refletidas no outro. Você pode sempre gerar
um novo projeto de portlet do HATS a partir de um projeto da Web do HATS alterado para
refletir as alterações feitas no projeto da Web.
- Você não pode converter um projeto de portlet do HATS novamente para um projeto da Web do HATS.
- Se você tiver um aplicativo HATS V4, V5, V6, V7.0 ou V7.1 existente,
é necessário migrar seu aplicativo para o HATS V7.5.1 antes de gerar um
projeto de portlet. Para
obter informações adicionais sobre a migração para o HATS V7.5.1, consulte Migrando para o HATS V7.5.1.
Migrando Portlets IBM
para Portlets Padrão
A migração um porltet IBM do
HATS para um portlet padrão do HATS deve ser feita
manualmente.
As etapas envolvem:
- Migração das facetas do projeto.
- Migração de arquivos da Web e arquivos de descritores de
implementação do portlet.
- Migração de transformações, modelos e manipuladores de macro.
- Migração de arquivos específicos do HATS.
- Migração de outras funções do portal (opcional).
Migrando as Facetas do Projeto
- Se ela estiver incluída, remova o aspecto
do Struts já que os portlets padrão do HATS não
suportam Struts.
- Na visualização Projetos do HATS, clique com o botão direito do mouse no
projeto de portlet e selecione Propriedades.
- Na página Propriedades, selecione Aspectos do
Projeto.
- Se selecionada, desmarque a caixa de opção Struts para Portlets IBM.
- Clique em OK.
- Substitua o aspecto dos Portlets IBM
pelo aspecto dos Portlets JSR.
- Na visualização Projetos do HATS, clique com o botão direito do mouse no
projeto de portlet e selecione Propriedades.
- Na página Propriedades, selecione Aspectos do
Projeto.
- Desmarque a caixa de opção para Portlets IBM e selecione a caixa para
Portlets JSR. Na coluna Versão, certifique-se de que 1.0
seja exibido. Se não, clique no ícone suspenso próximo ao número da
versão e altere-o para 1.0.
- Clique em OK.
Migrando Arquivos da Web e Arquivos de
Descritores de Implementação do Portlet
- Na visualização do Navegador, edite o descritor de implementação
da Web (Web Content/WEB-INF/web.xml) e execute as seguintes etapas:
- Na guia Servlets, remova os servlets yourportlet
e HATSAdminServlet (se presente) e os mapeamentos.
- Na guia Variáveis, na seção Referências de Bibl. de Tags, remova
a referência de bibl. de tags admin.tld, se presente.
- Na guia Variáveis, na seção Referências de Bibl. de Tags, inclua uma
referência de bibl. de tags std-portlet.tld utilizando as seguintes
configurações:
URL:
http://java.sun.com/portlet
Location: /WEB-INF/tld/std-portlet.tld
- Na visualização do Navegador, edite o descritor de implementação
de portlets (Web Content/WEB-INF/portlet.xml) e execute as seguintes
etapas:
- Migre para um descritor de implementação do portlet em conformidade
padrão. Para obter informações sobre como fazer isso,
consulte a seção Migrando da API de Portlet IBM
no Centro de Informações do WebSphere
no endereço
http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp .
- Remova EntryPortlet (seu portlet) e todas as suas referências no
descritor de implementação do portlet.
- Inclua o Jsr168EntryPortlet no descritor de implementação do portlet. Consulte o
descritor de implementação do portlet de um portlet
JSR 168 de amostra do
HATS.
Migrando Transformações, Modelos e
Manipuladores de Macro
Na visualização do Projetos HATS, edite todos os
arquivos de transformação, modelo e JSP do manipulador de macros e
na guia Origem:
- Inclua o seguinte código:
- <%@ taglib uri="http://java.sun.com/portlet"
prefix="portletAPI" %>
- <portletAPI:defineObjects/>
- Converta response.encodeUrl("...") para
renderResponse.encodeUrl(renderRequest.getContextPath()+"...").
- Converta todas as instâncias de request para
renderRequest.
Migrando Arquivos Específicos do
HATS
- Importe todos os arquivos da pasta
<shared_install_directory>\plugins\com.ibm.hats_nnn\predefined\
projects\portlet\jsr para suas pastas correspondentes no
projeto de portlet (em que
shared_install_directory é o diretório de recursos
compartilhados no qual a oferta do HATS foi instalada utilizando o
Gerenciador de Instalação daIBM
e nnn é a versão e o nível de construção do HATS).
- Na visualização do Navegador, exclua os seguintes arquivos e
pastas, se presentes:
- Os arquivos HATSApplet.cab e HATSApplet.jar na pasta Web Content.
- A pasta hatsadmin na pasta Web Content.
- O arquivo hatsadmin.tld na pasta Web Content/WEB-INF/tld.
Migrando Outras Funções do Portal
- Se utilizando o Web Express Logon
(WEL), você pode precisar alterar as classes de plug-in do WEL porque algumas
classes de plug-in para portlets IBM e
portlets padrão são diferente.
Por exemplo, as classes de plug-in do WEL
utilizadas nos portlets IBM são:
- WebSphere Portal Network
Security: com.ibm.hats.common.wel.WebSpherePortalNS
- WebSphere Portal Credential
Vault Credential Mapper: com.ibm.eNetwork.security.sso.cms.CredentialVaultCM
As classes de plug-in do WEL utilizadas
nos portlets padrão são:
- WebSphere Portal Network
Security: com.ibm.hats.common.wel.StandardPortletNS
- WebSphere Portal Credential
Vault Credential Mapper: com.ibm.hats.common.wel.StandardPortletCredentialVaultCM
- Caso implemente uma área segura da credencial em seu aplicativo
de portlet, você deve migrar o código que acessa o serviço de área
segura da credencial.
Para obter mais informações, consulte a seção Autenticação de Portlet,
no Centro de Informações do WebSphere
Portal no endereço http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp.
- Se você implementar comunicação de portlet, é necessário converter o
mecanismo de comunicação utilizado. Para obter informações adicionais, consulte Comunicação de Portlet.
Trabalhando com Portlets do HATS
Um projeto de portlet do HATS ainda é um projeto do HATS, o que
significa que todos os assistentes e editores do HATS podem continuar
a ser utilizados no projeto. Um projeto de portlet do HATS
também é um projeto de portlet, o que também significa que todos os editores de
Ferramentas do Portal e configuração de tempo de execução
podem ser utilizados no projeto. Um projeto de portlet do HATS aparece na
árvore com um ícone diferente
.
Substituições de Parâmetros de Conexão e
Variáveis Globais
Você pode permitir parâmetros de conexão e variáveis globais para seus portlets serem substituídos
pela customização da configuração do projeto. Para obter informações adicionais, consulte o Substituições de Parâmetros de Conexão e o Substituições de Variáveis Globais.
Portlets IBM
Para portlets
IBM do HATS, se você permitir as substituições nas configurações
do projeto, a substituição pode ser realizada através da extensão da
classe EntryPortlet e da substituição do método doView(). Para obter
mais informações sobre a extensão da classe EntryPortlet, consulte a
publicação
HATS Web Application Programmer's Guide.
Portlets Padrão
Para portlets padrão do HATS,
se você permitir substituições nas configurações do projeto, então,
o usuário pode substituir parâmetros de conexão e variáveis globais
ao alternar para o modo de edição na barra de ferramentas do
portlet. Para WebSphere Portal V6.0 e V6.1, selecione Personalizar no menu de portlet na
barra de ferramentas.
Nota:
O HATS não suporta o modo
de edição de portlets no WebSphere Application Server V6.1 ou V7.0. Se você implementar seu
portlet padrão do HATS para executar diretamente
no WebSphere Application Server V6.1 ou V7.0, ao invés de utilizar o modo de edição do portlet,
o usuário pode substituir parâmetros de conexão e variáveis globais na
URL utilizada para acessar o portlet.
Uma vez no modo de edição de portlet, uma página de configuração é
exibida para o usuário. Essa página permite que o usuário substitua
as configurações de parâmetro de conexão e variável global. Essas
funções são equivalentes às funções do HATS para aplicativos da Web
que permitem que o usuário substitua configurações usando a URL
quando o aplicativo é acessado pela primeira vez.
Na página de configurações, na seção de parâmetros de conexão, a
lista suspensa de parâmetros de conexão lista os parâmetros da seção
Host On-Demand cuja substituição você permitiu nas
configurações do projeto. O usuário configura uma substituição
selecionando um parâmetro na lista suspensa, inserindo um valor no
campo Valor e clicando em
Incluir. Por
padrão, a configuração da substituição é ativada quando incluída pela primeira vez. Ela pode ser desativada selecionado
falso no drop-down
Ativado.
Uma substituição pode ser excluída selecionando a caixa de opção ao
lado do nome do parâmetro e clicando em
Excluir.
Na seção de variáveis globais, o usuário configura uma
substituição inserindo o nome e valor de uma variável global e
clicando em Incluir.
Após incluir uma
substituição, a variável global pode ser identificada como uma
variável global compartilhada selecionando
verdadeiro no drop-down
Compartilhado. Por
padrão, a configuração da substituição é ativada quando incluída pela primeira vez. Ela pode ser desativada selecionado
falso no drop-down
Ativado. Uma substituição pode ser
excluída selecionando a caixa de opção ao lado do nome da variável
global e clicando em Excluir.
Quando o usuário clica em Salvar e
Sair, as configurações são salvas nas preferências do portlet.
Notas:
- Os valores inseridos pelo usuário não são validados.
- O usuário deve desconectar e reiniciar o aplicativo de portlet
antes que os novos valores entrem em vigor.
Além de permitir que o usuários configurem substituições, é possível fornecer programaticamente substituições de parâmetros de conexão e variáveis
globais estendendo o portlet de entrada JSR 168. Para obter mais informações, consulte a seção,
Estendendo o Porlet de Entrada,
na publicação HATS Web Application Programmer's Guide
Nota:
Caso você forneça substituições de
parâmetros de conexão ou variáveis globais através da classe de
portlet estendido e o usuário fornecer a mesma substituição usando o
modo de edição de portlet, os valores fornecidos pelo usuário no modo
de substituição substituem os valores fornecidos na classe de portlet
estendido.
.
Comunicação de Portlet
O WebSphere Portal suporta
várias maneiras pelas quais os portlets troquem ou compartilhem
informações. Para obter mais informações, consulte a seção
Comunicação de Portlet, no Centro de Informações do WebSphere Portal no endereço
http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp.
Esta seção descreve o suporte do HATS para comunicação de portlet
do WebSphere Portal.
Portlets IBM
Os portlets IBM do HATS suportam
a implementação de Click-to-Action para fornecer uma solução
de comunicação de portlet. Para obter mais informações, consulte a seção Portlets
Cooperativos no HATS Web Application Programmer's Guide
Portlets Padrão
O suporte do porltet padrão (JSR 168) do HATS utiliza o mecanismo
de portlet cooperativo do WebSphere
Portal para fornecer uma solução de comunicação de portlet.
Os portlets JSR 168 utilizam propriedades para comunicar-se entre
si.
Um portlet JSR 168 do HATS suporta a habilidade de enviar e receber
propriedades de outros portlets JSR 168, HATS ou não HATS.
Os portlets devem estar conectados para se comunicarem.
Enviando uma Propriedade de um Portlet JSR 168 do HATS
- Crie uma variável global contendo o valor da propriedade a
enviar. É possível fazer isto de diversas maneiras, incluindo: executando
uma ação Extrair Variável Global ou uma ação Configurar Variável Global. Apenas as variáveis
globais que contêm zero ou mais cadeias (nenhum outro tipo) podem ser utilizadas
na comunicação de portlet JSR 168. As variáveis globais podem ser pensadas
como wrappers para os valores das propriedades JSR 168.
- Inclua uma ação Enviar Variável Global
em um evento de tela do HATS ou em um evento do aplicativo de tela único
para enviar o valor da variável global como uma propriedade. Para obter informações
sobre como fazer isto, consulte Ação Enviar Variável Global.
Esta
ação pode ser utilizada em conjunto com a ação Extrair
Variável Global para enviar entrada inserida pelo usuário de um portlet
para outro. Por exemplo, é possível incluir uma ação Extrair Variável Global entre a ação
Aplicar Transformação e a ação
Enviar Variável Global para capturar
dados que o usuário insere e enviá-los para outros portlets.
- Quando o projeto de portlet JSR 168 do HATS é executado e a ação Enviar Variável Global é executada, o nome da
propriedade e os conteúdos da cadeia da variável global especificada são
transmitidos para o WebSphere
Portal que, então, notifica os portlets conectados a este portlet JSR 168
do HATS para receber a propriedade.
Recebendo uma Propriedade em um Portlet JSR 168 do HATS
- Utilize as configurações de portlet para definir os nomes de
propriedades e as variáveis globais correspondentes para conter os valores
de propriedades que podem ser recebidos por este portlet. Acesse as configurações
de portlet do editor de configurações de Porlet clicando na guia
Outro e, em seguida, em Portlet. Para obter mais informações sobre
como fazer isto, consulte Configurações do Portlet.
- Assim que o WebSphere Portal
tenha recebido uma propriedade de um portlet de origem, o portlet de destino
será notificado. O serviço de tempo de execução do portlet JSR 168 do HATS
recupera o valor da propriedade do WebSphere
Portal e o armazena na variável global especificada. Novamente, apenas as variáveis
globais que contêm uma cadeia (ou cadeias) podem ser utilizadas com a comunicação
JSR 168.
Comunicação com Portlets JSR 168 não HATS
O Rational SDP oferece suporte de GUI para implementação de
portlets cooperativos.
Ao configurar portlets JSR 168 não HATS para se comunicarem com
portlets JSR 168 do HATS, execute as etapas a seguir:
- Abra a visualização do Project Explorer na barra de menus do
Rational SDP selecionando Janela > Mostrar
Visualização > Outro > Geral > Project Explorer .
- Na visualização Project Explorer, clique com o botão direito no
nó Descritor de Implementação do
Portlet no projeto de portlet.
- Selecione Cooperativo > Ativar Esse
Portlet para Enviar Dados (Origem) ou
Cooperativo > Ativar este Portlet para
Receber Dados (Destino) para iniciar o assistente para ativar o
suporte de portlet cooperativo para o portlet selecionado.
- Certifique-se de que as seguintes configurações estejam corretas
neste assistente:
Editando a URI de Tipo de Dados
Ao configurar uma ação Enviar Variável Global ou uma configuração
de Portlet para receber uma propriedade, o HATS utiliza como padrão a URI
de Tipo de Dados para a propriedade para ser
http://com.ibm.hats.portlet.pb#<property_name>Type.
Essa URI só é usada quando você liga os portlets de origem
e destino. O WebSphere
Portal exige que os portlets de origem e destino utilizem a mesma URI
para enviar e receber a propriedade. Se, por alguma
razão, for necessário configurar a URI de forma diferente do padrão,
é possível modificar a URI para uma propriedade usando o kit de
ferramentas do Portal seguindo estas etapas:
- Abra a visualização do Project Explorer na barra de menus do
Rational SDP selecionando Janela > Mostrar
Visualização > Outro > Geral > Project Explorer .
- Na visualização Project Explorer, expanda o projeto da
propriedade que deseja modificar. As propriedades podem ser
encontradas sob o nó Descritor de
Implementação do Portlet.
- Clique com o botão direito sobre a propriedade e selecione
Editar Tipo de Dados.
- Modifique a URI de Tipo de Dados
nos assistentes Editar Fonte Cooperativa ou Editar Destinos
Cooperativos.
Conectando Portlets para Comunicação
As conexões de portlet são utilizadas para direcionar o flux de
informações entre os portlets que se comunicam utilizando
a
API dos portlets Cooperativos do
WebSphere Portal. A
conexão de portlets refere-se à conexão de dois portlets utilizando
a ferramenta de conexão do servidor de portal para o propósito de
enviar e receber uma propriedade de portlet cooperativa. Os portlets são
conectados apenas para uma única propriedade
e ambos os portlets
devem fornecer a esta propriedade o mesmo nome, embora os nomes de variável global
associados possam ser diferentes. Em outras palavras, se dois portlets
irão enviar e receber duas propriedades, eles precisam de duas conexões, uma para cada propriedade. Sem concluir a etapa de conexão,
os dados não são transmitidos.
PDTs Customizadas e tabelas customizadas
Antes de implementar um projeto de portlet com uma PDT (Printer Definition Table) customizada ou tabelas
customizadas para um servidor de portal, você deve copiar os arquivos e as pastas para o diretório \Web
Content do projeto de portlet do HATS. Os arquivos e as pastas para cada tipo de inclusão são mostrados
abaixo:
- PDT (Printer Definition Table) Customizada: Arquivos PDT compilados ou as pastas que contêm arquivos PDT
compilados.
- Tabela customizada: A pasta customizada que contém a definição de tabelas customizadas.
Serviços da Web para Portlets
Remotos
Os WSRP (Serviços da Web para Portlets Remotos) são um padrão que
os portais podem usar par fornecer portlets, aplicativos e conteúdo
como serviços WSRP e outros portais podem integrar serviços WSRP como
portlets remotos para seus usuários. Os portlets Padrão
e IBM do HATS
podem ser fornecidos como portlets remotos que podem ser consumidos por outros
portais. Para obter mais informações, consulte o Centro de
Informações do WebSphere
Portal no endereço http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp
e procure Utilizando Serviços WSRP.
Testando Portlets do HATS
Se um Ambiente de Teste do
WebSphere Portal
está configurado no Rational SDP, você pode utilizá-lo para testar
seus portlets padrão ou IBM do HATS antes de implementá-los em um servidor
de Portal de produção.
Também é possível testar seus portlets
padrão do HATs utilizando o ambiente de
teste local do WebSphere Application Server V6.1 ou V7.0, conforme apropriado, antes de implementá-los.
Para testar um projeto de portlet do HATS, utilize o mesmo procedimento
utilizado para testar projetos da Web do HATS. Para obter informações adicionais,
consulte Visão Geral.
Exportando Portlets do HATS
Para
exportar um portlet do HATS para implementação, na visualização Projetos HATS, clique com o botão direito
do mouse no projeto de portlet e selecione Exportar Projeto. Insira o nome do arquivo de destino do arquivo .war exportado no menu suspenso Destino e clique em Concluir. Apenas o arquivo .war é exportado. O arquivo .ear é usado apenas para
testes no ambiente de testes local.
Uma vez que você tenha exportado seu arquivo .war do
portlet do HATS, instale-o no WebSphere Portal utilizando as ferramentas de administração do
WebSphere Portal.
Se instalando um portlet padrão no WebSphere Application Server V6.1 ou V7.0, utilize o WebSphere Application Server console administrativo e considere as
instruções a seguir:
- Durante a instalação, você deve fornecer um nome de raiz de
contexto. Este nome de raiz de contexto é necessário para iniciar o
arquivo .war do portlet após a conclusão da instalação. Durante a
instalação, implemente o arquivo .war no server1 ou na instância do
servidor da Web definida.
- Após a instalação do arquivo .war do portlet, você pode verificar o
nome da raiz de contexto e o nome do portlet utilizando o WebSphere Application Server
console administrativo ao expandir Aplicativos
e clicar em Aplicativos Corporativos. Clique
em seu arquivo .war e clique em
Raiz de Contexto para Módulos da Web
Anote o valor para Módulo da Web e ContextRoot. Estes valores são
utilizados para iniciar o Aplicativo HATS.
- Para executar o aplicativo HATS, insira sua URL em um navegador. Por
exemplo, insira http://host:port/context_root_name/portlet_name
em que host e port representam o nome do host e a
porta para o host do WebSphere Application Server no qual você instalou seu portlet. Para
context_root_name, utilize o valor fornecido para Raiz de Contexto
ao instalar o arquivo .war do portlet e para portlet_name, utilize
o valor fornecido para o módulo da Web.
Administrando Portlets do HATS
É possível administrar portlets HATS usando o console
administrativo do HATS. Os portlets padrão do HATs,
seja instalados no Servidor de Portal ou no WebSphere Application Server,
podem ser administrados utilizando um aplicativo administrativo independente
do HATS. Os portlets IBM
do HATS podem ser administrados utilizando um aplicativo administrativo
do HATS independente ou um suporte de console administrativo incluído no
próprio portlet.
Usando um Aplicativo Administrativo do
HATS Independente
Para administrar os portlets padrão do HATS
e os portlets IBM do
HATS utilizando um aplicativo administrativo do HATS independente,
siga estas etapas:
- Crie um projeto administrativo do HATS independente no HATS Toolkit
selecionando Arquivo > Novo > Projeto > HATS >
Projeto de Administração do HATS. O projeto administrativo do
HATS só aparece no HATS Toolkit na guia Navegador.
- Exporte o projeto .ear administrativo do HATS para um arquivo .ear
clicando com o botão direito sobre o projeto .ear e selecionando
Exportar > Java EE > EAR.
- Implemente o arquivo .ear do aplicativo administrativo do HATS
independente para o WebSphere Application Server usando o WebSphere Application Server console administrativo.
Notas:
- Instale o arquivo .ear no mesmo sistema WebSphere Application Server que o servidor
WebSphere Portal. Onde um portlet padrão do HATS está instalado diretamente
no WebSphere Application Server, instale o arquivo .ear no mesmo servidor.
- Certifique-se de que o módulo esteja mapeado para o WebSphere Application Server, por
exemplo, server1, e não para o WebSphere Portal Server.
- Para o WebSphere Application Server V6.x, certifique-se de que a opção
Todos Autenticados no painel
Mapear Funções de Segurança para Usuários/Grupos
esteja selecionada para a função Administrador do HATS. Para o WebSphere Application Server V7.x,
certifique-se de que a opção Todos Autenticados na
Região do Aplicativo esteja selecionada utilizando a lista suspensa
Mapear Objetos Especiais no painel
Mapear Funções de Segurança para Usuários/Grupos.
- O ID de usuário utilizado para administrar os portlets deve ser
definido como um usuário do console administrativo do
WebSphere Application Server
com autoridade de Administrador.
Para fazer
isso, siga estas etapas:
- No console administrativo do WebSphere
Application Server, selecione Usuários e Grupos >
Funções do Usuário Administrativo > Incluir (antes do WebSphere Application Server V6.1,
selecione Administração do Sistema > Configurações
do Console > Usuários do Console > Incluir).
- O ID de usuário utilizado para administrar os portlets e mapear o ID de usuário para a função
Administrador.
Nota:
- Inicie o aplicativo administrativo do HATS usando o WebSphere Application Server
console administrativo.
- Acesse o console administrativo do HATS independente.
Por
exemplo, use a URL,
http://<washostname>/<hatsadminprojectname>/hatsadmin/admin.
Nota:
Ao acessar o console administrativo do HATS, é necessário usar
um navegador diferente do que está sendo usado para acessar os
portlets.
- Selecione Introdução > Escopo
de Gerenciamento.
- Clique em Novo.
- No campo Host insira o mesmo nome de host
que o host do WebSphere Application Server de destino.
- No campo Porta insira a porta
BOOTSTRAP_ADDRESS para o servidor de destino. Para localizar a porta
BOOTSTRAP_ADDRESS para o servidor de destino, acesse o WebSphere Application Server console administrativo e siga estas etapas:
- Selecione Servidores > Servidores de
Aplicativos.
- Clique no servidor de destino (seja o servidor WebSphere Portal ou o WebSphere Application Server, por exemplo, server1,
no caso em que um portlet padrão do HATS está instalado diretamente no WebSphere Application Server.
- Na guia Configuração em Comunicações, expanda
Portas.
- Anote a porta BOOTSTRAP_ADDRESS para o servidor de destino.
- Clique em OK.
- Selecione o host incluído recentemente.
- Não selecione Gerenciar todos os Aplicativos
dentro do Escopo Selecionado Acima.
- Agora é possível visualizar uma lista de portlets do HATS. Utilize o Console
Administrativo do HATS para administrar um aplicativo de portlet de cada vez selecionando
um na lista.
Usando o Suporte Administrativo Incluído
no Portlet
Para administrar os portlets IBM
do HATS utilizando um portlet que inclui o suporte de console administrativo
do HATS, siga as etapas abaixo.
Nota:
Esta opção não é suportada nos portlets padrão do
HATS.
- Crie um projeto de portlet IBM
do HATS no HATS Toolkit selecionando Arquivo > Novo >
Projeto do HATS. No assistente Criar um Projeto de seu portlet
IBM, selecione a opção
Incluir Suporte de Console Administrativo.
- Exporte o projeto de portlet para um arquivo .war clicando-o com
o botão direito na visualização Projetos HATS e selecionando
Exportar Projeto.
- Implemente o arquivo .war do portlet IBM
do HATS em seu servidor WebSphere
Portal.
- Acesse o WebSphere Application Server console administrativo no qual seu servidor WebSphere Portal está instalado.
- Selecione Aplicativos > Aplicativos
Corporativos.
- Clique no nome de seu portlet administrativo do HATS; em seguida,
clique em Visualizar Descritor de
Implementação.
- Anote o PA_value no descritor de
implementação, por exemplo, PA_#uaj0rfu
(WebSphere Portal V6.0)
ou PA_projectname (WebSphere Portal V6.1).
- Selecione Servidores > Servidores de
Aplicativos.
- Clique em seu servidor WebSphere
Portal; na guia de Configuração sob Comunicações, expanda
Portas.
- Anote a porta BOOTSTRAP_ADDRESS de seu servidor do Portal.
- Acesse o console administrativo do HATS incluído em seu portlet utilizando o
PA_value que você anotou acima no console administrativo. Por
exemplo, utilize a URL, http://<portalhostname>/wps/PA_value/hatsadmin/admin.
Nota:
Ao acessar o console administrativo do HATS, é necessário usar
um navegador diferente do que está sendo usado para acessar os
portlets.
- Selecione Introdução > Escopo
de Gerenciamento.
- Clique em Novo, no campo
Host e insira o mesmo nome de host
de seu host do servidor WebSphere
Portal e no campo Porta, insira a porta
BOOTSTRAP_ADDRESS de seu servidor WebSphere
Portal anotado acima. Clique em OK.
- Selecione o host incluído recentemente.
- Não selecione Gerenciar todos os Aplicativos
dentro do Escopo Selecionado Acima.
- Agora é possível visualizar uma lista de portlets do HATS. Utilize o Console
Administrativo do HATS para administrar apenas o aplicativo de portlet no qual o
console está incluído.
Limitações e Considerações do Portlet do
HATS
Considerações e Limitações Comuns
A seguir está uma lista das considerações e limitações ao trabalhar com
portlets IBM do HATS ou portlets
padrão do HATS:
- Os portlets só podem ser instalados na produção como arquivos de
aplicativos da Web (arquivos .war). O HATS só possui um projeto por
arquivo .war; portanto, não é possível exportar um conjunto de
aplicativos do HATS como um único a aplicativo de portlet.
- Os cookies são necessários para autenticar no WebSphere Portal,
portanto, você precisa executar o HATS no WebSphere Portal com os cookies ativados.
- Arquivos JSP, como modelos, transformações, fragmentos de
transformações e manipuladores de macros, copiados dos projetos da
Web do HATS em projetos de portlet IBM
do HATs ou em projetos padrão do HATS não funcionarão
sem conversão. É possível usar a
ação Converter JSP do Portal para
converter esses arquivos JSP. De maneira semelhante, os arquivos JSP
copiados de projetos de portlet IBM
do HATS em projetos de portlet padrão do HATS ou
vice-versa, devem ser convertidos utilizando a ação
Converter JSP para Portal.
- As opções do HATS aparecem no assistente Novo Portlet do
Rational SDP, mas a seleção dessas opções só gera um portlet vazio sem
recursos do HATS.
- Portlets IBM do HATS
e portlets padrão do HATS não podem ser executados
na mesma página de portal sem interferirem entre si. Sempre que uma
entrada ou ação for executada no portlet padrão,
ela será transferida ou herdada pelo portlet
IBM. Para obter mais detalhes sobre as diferenças entre a manipulação
de parâmetros de pedido IBM e
padrão, consulte o Centro de Informações do WebSphere Portal no endereço http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp
e procure Manipulação e Visibilidade de Parâmetros de Pedido em Portlets.
- Quando um portlet do HATS está na mesma página de portal com outros
portlets (HATS ou não HATS), se você desconectar o portlet do HATS, ele
é automaticamente reiniciado como um resultado da atualização da página
que ocorre quando você interage com qualquer outro portlet na mesma
página de portal.
Os portlets IBM do HATS exibem
este comportamento quando o tema é configurado com o padrão
Herdado.
Os portlets padrão do HATS exibem este comportamento quando o tema da
página de portal está configurado com PortalWeb2.
- As funções, ações e configurações do HATS a seguir não são
suportadas nos portlets do HATS:
- A função Visualização no Designer de Páginas quando editando transformações e modelos.
- A configuração Ativar Compactação
HTTP.
- O applet atualização assíncrona.
- O parâmetro de conexão
disconnectOnClose.
- A opção de combinação de telas, usar
carregamento e conteúdo dinâmico de modo em cache.
- Interoperabilidade do HATS com aplicativos WebFacing.
Considerações e Limitações do Portlet
IBM
A seguir encontra-se uma lista de considerações e limitações ao
trabalhar com os portlets
IBM do HATS:
- A API de Portlet IBM
foi reprovada no HATS V7.5.1 e no
WebSphere Portal V6.0 e
V6.1.
- Os portlets IBM do HATS só podem ser executados nos servidores
WebSphere
Portal. Por exemplo, não é possível executar os portlets
IBM do HATS diretamente
no WebSphere Application Server.
- Ação Redirecionar para URL e
função Inserir Redirecionar para
Aplicativo do HATS.
Os aplicativos do HATS que utilizam o controle de fluxo JSP não
funcionam de forma adequada nos portlets
IBM do HATS. Os portlets
IBM são entidades orientadas
a servlet e exigem o uso de ações codificadas em URLs para orientar
a navegação.
Considerações e Limites do Portlet Padrão
A seguir está uma lista das considerações e limitações ao trabalhar
com portlets padrão do HATS:
- Os portlets padrão do HATS pode ser executados
apenas nos servidores WebSphere Portal ou WebSphere Application Server V6.1 or V7.0.
- Se você incluir suporte a Web Express Logon (WEL) e um portlet padrão do HATS utilizando o plug-in
WebSphere Portal Credential Vault,
ele executará em servidores WebSphere
Portal suportados. Entretanto, ele falhará ao efetuar logon no sistema host
ao executar no WebSphere Application Server v6.1 ou v7.0, que não possui suporte
ao Credential Vault Service.
- As seguintes ações, configurações e funções do HATS não são
suportadas nos portlets padrão do HATS:
- A capacidade de incluir o suporte de console
administrativo do HATS no projeto de portlet.
- A capacidade de gerar código de amostra no assistente Nova
Lógica Comercial para funções como acesso e recuperação de dados de
autenticação, sistema de mensagens de portlet ou uso de um
intermediário da propriedade.
- A ação Apresentação de Portlet (Incluir Delimitador
de Blocos).
- Ao usar um ação Enviar Variável Global, as seguintes ações são
as únicas ações suportadas entre a ação Aplicar Transformação e a
ação Enviar Variável Global:
- Executar lógica comercial
- Extrair variável global
- Inserir dados
- Definir variável global
- Remover variável global
- Executar transação de macro
- Pausar
- Ao usar Objetos de Integração:
- Ao visualizar as conexões de host ativas usando o console
administrativo do HATS, a conexão do cliente de um portlet
padrão do HATS exibe um endereço IP em branco.