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:

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:

No assistente Criar um Projeto, no painel do HATS Project:

  1. Insira um nome para o projeto do portlet.
  2. Opcionalmente, insira uma descrição.
  3. Aceite o local padrão.
  4. 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.
  5. Para o campo Servidor de Destino, selecione um dos servidores WebSphere Portal suportados, WebSphere Portal v6.0 ou WebSphere Portal v6.1.
    Notas:
    1. 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.
    2. 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.
  6. 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.
  7. 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.
  8. 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.
  9. 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:

  1. Insira um nome para o projeto do portlet.
  2. Para o campo de Servidor de Destino, selecione o servidor WebSphere Portal de destino, WebSphere Portal v6.0 ou WebSphere Portal v6.1.
    Notas:
    1. 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.
    2. 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.
    3. 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.
  3. 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.
  4. 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.
  5. Selecione nessa lista os tipos de arquivos a serem convertidos automaticamente:
  6. 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:
  1. 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.
  2. 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.
  3. Você não pode converter um projeto de portlet do HATS novamente para um projeto da Web do HATS.
  4. 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:

  1. Migração das facetas do projeto.
  2. Migração de arquivos da Web e arquivos de descritores de implementação do portlet.
  3. Migração de transformações, modelos e manipuladores de macro.
  4. Migração de arquivos específicos do HATS.
  5. Migração de outras funções do portal (opcional).

Migrando as Facetas do Projeto

  1. Se ela estiver incluída, remova o aspecto do Struts já que os portlets padrão do HATS não suportam Struts.
    1. Na visualização Projetos do HATS, clique com o botão direito do mouse no projeto de portlet e selecione Propriedades.
    2. Na página Propriedades, selecione Aspectos do Projeto.
    3. Se selecionada, desmarque a caixa de opção Struts para Portlets IBM.
    4. Clique em OK.
  2. Substitua o aspecto dos Portlets IBM pelo aspecto dos Portlets JSR.
    1. Na visualização Projetos do HATS, clique com o botão direito do mouse no projeto de portlet e selecione Propriedades.
    2. Na página Propriedades, selecione Aspectos do Projeto.
    3. 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.
    4. Clique em OK.

Migrando Arquivos da Web e Arquivos de Descritores de Implementação do Portlet

  1. Na visualização do Navegador, edite o descritor de implementação da Web (Web Content/WEB-INF/web.xml) e execute as seguintes etapas:
    1. Na guia Servlets, remova os servlets yourportlet e HATSAdminServlet (se presente) e os mapeamentos.
    2. 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.
    3. 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	
  2. Na visualização do Navegador, edite o descritor de implementação de portlets (Web Content/WEB-INF/portlet.xml) e execute as seguintes etapas:
    1. 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 .
    2. Remova EntryPortlet (seu portlet) e todas as suas referências no descritor de implementação do portlet.
    3. 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:

  1. Inclua o seguinte código:
  2. Converta response.encodeUrl("...") para renderResponse.encodeUrl(renderRequest.getContextPath()+"...").
  3. Converta todas as instâncias de request para renderRequest.

Migrando Arquivos Específicos do HATS

  1. 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).
  2. Na visualização do Navegador, exclua os seguintes arquivos e pastas, se presentes:
    1. Os arquivos HATSApplet.cab e HATSApplet.jar na pasta Web Content.
    2. A pasta hatsadmin na pasta Web Content.
    3. O arquivo hatsadmin.tld na pasta Web Content/WEB-INF/tld.

Migrando Outras Funções do Portal

  1. 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:

    As classes de plug-in do WEL utilizadas nos portlets padrão são:

  2. 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.
  3. 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 ícone da pasta do portlet.

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:
  1. Os valores inseridos pelo usuário não são validados.
  2. 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
  1. 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.
  2. 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.

  3. 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
  1. 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.
  2. 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:

  1. Abra a visualização do Project Explorer na barra de menus do Rational SDP selecionando Janela > Mostrar Visualização > Outro > Geral > Project Explorer .
  2. Na visualização Project Explorer, clique com o botão direito no nó Descritor de Implementação do Portlet no projeto de portlet.
  3. 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.
  4. 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:

  1. Abra a visualização do Project Explorer na barra de menus do Rational SDP selecionando Janela > Mostrar Visualização > Outro > Geral > Project Explorer .
  2. 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.
  3. Clique com o botão direito sobre a propriedade e selecione Editar Tipo de Dados.
  4. 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:

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:

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:

  1. 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.
  2. 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.
  3. Implemente o arquivo .ear do aplicativo administrativo do HATS independente para o WebSphere Application Server usando o WebSphere Application Server console administrativo.
    Notas:
    1. 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.
    2. 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.
    3. 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.
  4. 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:
    1. 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).
    2. O ID de usuário utilizado para administrar os portlets e mapear o ID de usuário para a função Administrador.
    Nota:
    Para obter informações adicionais, consulte Console Administrativo do HATS e Segurança do WebSphere.
  5. Inicie o aplicativo administrativo do HATS usando o WebSphere Application Server console administrativo.
  6. 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.
    1. Selecione Introdução > Escopo de Gerenciamento.
    2. Clique em Novo.
    3. No campo Host insira o mesmo nome de host que o host do WebSphere Application Server de destino.
    4. 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:
      1. Selecione Servidores > Servidores de Aplicativos.
      2. 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.
      3. Na guia Configuração em Comunicações, expanda Portas.
      4. Anote a porta BOOTSTRAP_ADDRESS para o servidor de destino.
    5. Clique em OK.
    6. Selecione o host incluído recentemente.
    7. Não selecione Gerenciar todos os Aplicativos dentro do Escopo Selecionado Acima.
    8. 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.

  1. 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.
  2. 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.
  3. Implemente o arquivo .war do portlet IBM do HATS em seu servidor WebSphere Portal.
  4. Acesse o WebSphere Application Server console administrativo no qual seu servidor WebSphere Portal está instalado.
    1. Selecione Aplicativos > Aplicativos Corporativos.
    2. Clique no nome de seu portlet administrativo do HATS; em seguida, clique em Visualizar Descritor de Implementação.
    3. Anote o PA_value no descritor de implementação, por exemplo, PA_#uaj0rfu (WebSphere Portal V6.0) ou PA_projectname (WebSphere Portal V6.1).
    4. Selecione Servidores > Servidores de Aplicativos.
    5. Clique em seu servidor WebSphere Portal; na guia de Configuração sob Comunicações, expanda Portas.
    6. Anote a porta BOOTSTRAP_ADDRESS de seu servidor do Portal.
  5. 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.
    1. Selecione Introdução > Escopo de Gerenciamento.
    2. 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.
    3. Selecione o host incluído recentemente.
    4. Não selecione Gerenciar todos os Aplicativos dentro do Escopo Selecionado Acima.
    5. 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:

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:

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: