Migrando para o HATS V7.5.1

Se você for um usuário do Host Publisher V4, HATS V4 LE, HATS V5 LE, HATS V4, V5, V6, V7.0, ou V7.1, é possível migrar seus projetos para o HATS V7.5.1.

Para obter informações sobre migração a partir do HATS LE consulte Migrando do HATS LE.

Se estiver utilizando uma versão do Host Publisher anterior à V4.0, primeiro deverá seguir as instruções para migração de aplicativos do Host Publisher para o Host Publisher V4.0. Vá para http://www.ibm.com/software/awdtools/hats/support/index.html e digite a cadeia de procura "Como migrar o Host Publisher". Para obter informações adicionais, consulte HATS para Usuários do Host Publisher.

Migração do HATS

A migração de um projeto do HATS de um release anterior do HATS é um processo de duas etapas.

  1. Importe o projeto como um arquivo project interchange ou verifique-o a partir de um repositório de códigos (como CVS) para sua área de trabalho do HATS V7.5.1.
  2. Migre o projeto usando o assistente para migração do HATS.

Importando um Projeto do HATS

Caso você possua um release anterior do HATS instalado, você primeiro deve exportar seu projeto para um arquivo zip ou um arquivo project interchange antes de poder importá-lo e migrá-lo para seu HATS V7.5.1. Consulte a documentação de seu release anterior do HATS para obter informações sobre a exportação de projetos do HATS.

Depois de exportar seu projeto de um release anterior do HATS, você deve importá-lo como um arquivo project interchange para sua área de trabalho do HATS V7.5.1. Para obter mais informações sobre a importação de projetos da Web e rich client do HATS, consulte Exportando e Importando Projetos da Web do HATS e Exportando e Importando Projetos do Rich Client do HATS.

Nota:
Um projeto HATS V4 exportado como um arquivo zip do WebSphere Studio Application Developer (WSAD) V4 não pode ser importado como um arquivo de troca de projetos e, portanto, não pode ser migrado subsequentemente. Um projeto do HATS V4 exportado como um arquivo zip do WSAD V5 pode ser importado e migrado para o HATS V7.5.1.

Se você tiver armazenado seus projetos HATS no Rational ClearCase, deverá criar uma visualização de captura instantânea contendo estes projetos e, então, importe-os em sua área de trabalho do HATS V7.5.1 utilizando Arquivo > Importar > Geral > Projetos Existentes na Área de Trabalho. Durante a importação, não selecione a opção Copiar projetos na área de trabalho. Depois dos projetos serem importados em sua área de trabalho do HATS V7.5.1, você pode optar por migrá-los para o HATS V7.5.1. Durante a migração, os arquivos que precisam ser atualizados têm o registro de saída efetuado automaticamente do Rational ClearCase.

Migração da Área de Trabalho do Rational SDP

O assistente de Migração da Área de Trabalho do Rational SDP é exibido quando um projeto é importado na área de trabalho e precisar de algum nível de migração do Rational SDP. Este assistente executa alguma migração básica de projeto do Rational SDP e, se o projeto for destinado a um tempo de execução não suportado, força a escolher um tempo de execução de destino suportado. Na preparação para execução do assistente de Migração do HATS, você deve primeiro executar o assistente de Migração da Área de Trabalho do Rational SDP.

Utilizando o Assistente de Migração do HATS

Quando você alternar para a perspectiva HATS, se tiver um projeto criado a partir da liberação do HATS anterior em sua área de trabalho V7.5.1 do HATS, receberá uma mensagem afirmando que a área de trabalho contém um projeto do HATS que precisa ser migrado.

Você deve usar o assistente para Migração do HATS para migrar esse projeto para o HATS V7.5.1 antes de investigar quaisquer erros mostrados na visualização Problemas porque a migração pode eliminar alguns ou todos esses erros.

Para utilizar o assistente de Migração do HATS, siga estas etapas:

  1. Na visualização Projetos HATS, clique com o botão direito sobre o projeto e selecione Migrar Projeto.
  2. Caso possua outros projetos de um release anterior do HATS que estejam associados ao projeto do HATS selecionado para migração, esses projetos também serão migrados, bem como quaisquer projetos .ear do HATS associados.
  3. Clique em OK para iniciar a migração.
  4. Se o projeto não possuir um projeto .ear associado, você precisará associar o projeto .war após a migração. Para associar o projeto .war a um projeto .ear, consulte Movendo Projetos da Web do HATS para um Arquivo .ear Diferente.
Notas:
  1. Após a migração, verifique os detalhes no Relatório de Migração.
  2. Se um projeto da Web ou de portlet do HATS que está sendo migrado tiver um tempo de execução de destino não suportado (se o assistente de Migração de Área de Trabalho do Rational SDP não tiver sido executado) ou aspectos não suportados do WebSphere, o assistente de Migração do HATS configura o tempo de execução de destino e os aspectos para o nível mais baixo suportado do WebSphere Application Server para projetos da Web e para o nível mais baixo de servidor do WebSphere Portal suportado para projetos de portlet. Uma mensagem é exibida e registrada no log informando que de fato a alteração foi feita.
  3. Se, após a migração, você receber um erro indicando que o tempo de execução do destino não está definido, edite as propriedades de seu projeto e selecione o tempo de execução de destino apropriado. Para fazer isto, clique com o botão direito no projeto e selecione Propriedades. Na janela Propriedades, selecione Tempos de Execução Destinados. Na lista Tempos de Execução, selecione o tempo de execução apropriado.
  4. A migração de seu projeto de um release anterior do HATS para o HATS V7.5.1 não pode ser desfeita.

Migrando Transformações do HATS

Ao migrar seus projetos do HATS de um release anterior do HATS para o HATS V7.5.1, as transformações no projeto também são migradas. Alterações feitas nas transformações dependem do release do HATS a partir do qual está fazendo a migração. Todas as transformações são salvas na pasta MigrationBackup antes de serem migradas.

Considerações Especiais para Componentes e Widgets do HATS V4

O HATS V5 introduziu novos componentes e widgets. Os componentes e widgets do HATS V4 eram suportados, mas foram reprovados no HATS V5 e V6. Os componentes e widgets do HATS V4 não são suportados no HATS V7.5.1. Se você tiver componentes e widgets do HATS V4 em seus projetos, durante a migração você terá a oportunidade de migrá-los para componentes e widgets do HATS V7.5.1 ou de cancelar a migração de projeto. Se você escolher migrar, seu projeto poderá ser processado de maneira diferente. Certifique-se de testar completamente os seus projetos migrados.

Se você tiver componentes e widgets de subarquivo do HATS V4, eles serão migrados para componentes e widgets de subarquivo do HATS V5. Se você tiver componentes e widgets de subarquivo do HATS V5, eles serão deixados sozinhos. Há novos (mais ricos em função) componentes de subarquivos e widgets para o HATS V6 e posterior. Você pode querer investigar usando os novos componentes e widgets ao invés dos antigos. Para obter informações adicionais, consulte Subarquivo.

No HATS V4, se você escolheu um componente de tecla de função e o processou com um widget de botão drop-down (seleção) ou um botão de rádio (seleção), será possível utilizar o envio automático ou mostrar um botão enviar. Se você escolheu mostrar um botão enviar, quando migrar o projeto do HATS V4 para o HATS V7.5.1, o botão enviar não será mais exibido. No HATS V7.5.1, o recurso para mostrar um botão enviar foi removido.

Todos os pares DefaultExtract/DefaultWidget do HATS V4 são migrados para Renderização Padrão do HATS V7.5.1. Como este mapeamento pode não produzir os resultados pretendidos originalmente, a migração do HATS V7.5.1 exibirá e criará logs de uma mensagem informando que um par DefaultExtract/DefaultWidget foi migrado para Renderização Padrão. Neste caso, você deverá rever a transformação e fazer os ajustes necessários.

Os componentes e widgets customizados que são estendidos ou que possuem par com os componentes e widgets do HATS V4 não podem ser migrados nem podem manter os resultados originais. Quando a migração do HATS V7.5.1 detecta isso, ela exibe e cria logs de uma mensagem informando que a transformação contém componentes e widgets do HATS V4 que não podem ser migrados. Neste caso, você deverá rever a transformação e migrá-la manualmente.

Considerações Especiais sobre Migração

Avanço Automático

Se em versões anteriores do HATS você ativou a função de avanço automático incluindo a linha turnAutoTabOn(); no arquivo lxgwfunctions.js, agora deverá utilizar a configuração Ativar avanço automático de campo na seção Configurações de Cliente da guia Outro no editor de Configurações de Projeto. Para obter informações adicionais, consulte Configurações do Cliente.

Arquivos Backup

A migração do HATS cria uma pasta de backup no diretório do projeto chamada MigrationBackup. Esta pasta contém cópias dos arquivos do projeto antigo antes de serem sobrescritas pelo processo de migração. Esses arquivos são salvos, permitindo que você os compare e mescle com os novos arquivos do HATS V7.5.1. Não se preocupe se ocorrerem problemas, estes arquivos não serão mais utilizados pelo aplicativo. Quando estiver satisfeito com todos os arquivos salvos que foram comparados e mesclados, será possível excluir a pasta MigrationBackup.

Nota:
Antes de excluir a pasta MigrationBackup, é possível publicar um projeto migrado para o WebSphere Application Server para testar como ele se comporta. Entretanto, os erros na lista de tarefas causados pela pasta MigrationBackup podem criar problemas na publicação para o WebSphere Application Server. Para evitar isto, é possível remover a pasta MigrationBackup do projeto ou permitir que os aplicativos contendo erros sejam publicados em um servidor. Para permitir que os aplicativos contendo erros sejam publicados em um servidor, selecione Janela > Preferências > Servidor > WebSphere Application Server na barra de menus do Rational SDP e selecione Permitir aplicativos contendo erros sejam publicados em um servidor.

Widget de Botão

Se você migrar um projeto criado antes do HATS V7.0.0.2 e escolher implementar a opção Ativar cores de primeiro plano se utilizar um modelo que utiliza a folha de estilo blacktheme.css, deve atualizar manualmente a folha de estilo blacktheme.css de uma das seguintes maneiras:

  1. Remova a linha a seguir da declaração input.HATSBUTTON:
    color: lime;
    Isso permite que as cores de primeiro plano sejam renderizadas nas teclas de função; no entanto, isso faz com que outros botões gerados por um widget do HATS renderizem uma cor padrão.
  2. Combine as declarações de CSS relacionadas às cores para cada cor. Por exemplo, troque:
    .HBLUE {
           color: #3c9dff;
    }
    input.HBLUE {
           white-space: normal;
           letter-spacing: normal;
    }
    para
    .HBLUE, input.HBLUE {
            color: #3c9dff;
            white-space: normal;
            letter-spacing: normal;
    }
    Repita essa alteração para cada cor.

Uma alternativa para editar manualmente a folha de estilo blacktheme.css é criar um novo projeto simulado e copiar os arquivos CSS de tema deste projeto em seu projeto. Esteja ciente de que quaisquer alterações feitas em seus arquivos de CSS serão sobrescritas.

Beans de Acesso EJB

Se você tiver projetos existentes do HATS V5 que tenham Beans de Acesso EJB, talvez obtenha erros de compilação ou de tempo de execução que começam com "HPubReqCompleteEvent não pode ser resolvido". Para corrigir isso, regenere o Beans de Acesso EJB.

Widget Campo

Se quiser usar a configuração Render using monospace font para o widget Campo, e seu projeto foi criado originalmente em um release anterior ao HATS V7.0, você deve atualizar seus arquivos CSS conforme se segue:

  1. Inclua a seguinte classe nos arquivos whitetheme.css, graytheme.css, monochrometheme.css, tantheme.css e blacktheme.css:
    .HF {
      font-family: courier new, monospace;
    }
  2. Remova font-family: monospace de todas as classes H-color (cor do HATS) de todos os arquivos CSS.

Regras Globais

Uma nova configuração, enforceImmediacy, é incluída em qualquer regra global importada para o HATS V7.5.1 do HATS V5. Quando essa configuração é verdadeira, a regra global se comporta como no HATS V5 quando a opção Apenas campo de entrada mais próximo é selecionada para a opção Transformar do padrão Localizar campos de entrada por texto adjacente. Quando essa configuração é falsa, o padrão, as regras globais se comportam como o fazem no HATS V7.5.1.

Para fazer com que as regras globais definidas recentemente se comportem como as regras globais do HATS V5, você deve incluir e configurar a definição enforceImmediacy como true. Para fazer isso, na guia Origem do editor de Configurações do Projeto, inclua a seguinte configuração na tag globalRules componentSettings:

<setting name="enforceImmediacy" value="true"/>

Variáveis Globais

Antes do HATS V7, o valor de uma variável global, digitado em um prompt inserido em uma transformação utilizando a opção Prompt para variável global com caixa de entrada, poderia ser truncado porque alguns caracteres não eram escapados corretamente.

Nesta versão do HATS, os valores da variável global solicitados por uma transformação são escapados apropriadamente para evitar truncamento. As variáveis globais inseridas em uma transformação utilizando a opção Exibir valor de variável global como texto estático não são afetadas por essa alteração. Os prompts da variável global inseridos em uma transformação em uma versão do HATS anterior ao HATS V7 não são automaticamente atualizados durante a migração, portanto, eles não são afetados por esta alteração.

Compactação HTTP

Se você deseja usar o suporte do HATS para compactação de HTTP nos projetos migrados do HATS V5.0.x, V6.0 e V6.0.1, você deve incluir manualmente o filtro de compressão no arquivo do Web Deployment Descriptor (web.xml). Para incluir o filtro de compactação no arquivo web.xml:

  1. No HATS Toolkit, alterne para a visualização Navegador da perspectiva do HATS.
  2. Abra o arquivo web.xml localizado na pasta Web Content\WEB-INF de seu projeto.
  3. Clique na guia Origem para visualizar a origem desse arquivo.
  4. Copie as instruções a seguir após o último mapeamento de servlet definido (procure o último </servlet-mapping>).
    <filter>
       <description>Provides compression for output from HATS entry
                    servlet</description>
       <display-name>CompressionFilter</display-name>
       <filter-name>CompressionFilter</filter-name>
       <filter-class>com.ibm.hats.runtime.filters.CompressionFilter</filter-class>
    </filter>
       
  5. Copie as instruções a seguir após o último mapeamento de filtro definido (procure o último </filter-mapping>).
    <filter-mapping>
       <filter-name>CompressionFilter</filter-name>
       <servlet-name>EntryServlet</servlet-name>
       <dispatcher>ERROR</dispatcher>
       <dispatcher>FORWARD</dispatcher>
       <dispatcher>INCLUDE</dispatcher>
       <dispatcher>REQUEST</dispatcher>
    </filter-mapping>
    <filter-mapping>
       <filter-name>CompressionFilter</filter-name>
       <url-pattern>/</url-pattern>
    </filter-mapping>
    <filter-mapping>
       <filter-name>CompressionFilter</filter-name>
       <url-pattern>/index.jsp</url-pattern>
    </filter-mapping>
       
  6. Salve o arquivo.
Nota:
Se você já tiver executado esse projeto no servidor, será necessário publicar novamente o aplicativo para o WebSphere Application Server para selecionar a alteração no arquivo web.xml.

IBM Tivoli License Manager

HATS, WebFacing e aplicativos vinculados ao HATS/WebFacing que são migrados para o HATS V7.5.1 devem ser reimplementados no ambiente de produção para selecionar o suporte ao IBM® Tivoli License Manager para o novo arquivo de assinaturas do HATS V7.5.1.

Aplicativos da Web do WebFacing

O ITLM detecta aplicativos da Web implementados como Enterprise Archives (EARs) em WebSphere Application Servers suportados. Uma vez que os projetos da Web do WebFacing são criados independentes dos EARs associados, o arquivo de assinatura ITLM deve ser incluído manualmente. Siga essas etapas para ativar a detecção de ITLM dos aplicativos da Web do WebFacing.

  1. Crie uma pasta chamada itlm diretamente sob o EAR associado ao projeto do WebFacing.
  2. Localize o arquivo de assinaturas denominado HATS0705.sys2 no diretório de plug-ins do HATS
    <shared_install_directory>\plugins\com.ibm.hats_nnn\
    em que shared_install_directory é o diretório de recursos compartilhados no qual você instalou a oferta HATS utilizando o IBM Installation Manager e nnn é a versão e o nível da construção do HATS.
  3. Copie o arquivo de assinaturas do plug-in para a pasta itlm criada anteriormente.
  4. Exporte seu projeto como um EAR e reimplemente. O ITLM agora será capaz de detectar seu aplicativo.

Se você tiver ativado a detecção de ITLM para um projeto antigo do WebFacing e migrado esse projeto para V7.5.1, remova o arquivo de assinatura existente (por exemplo, WDHT0700.sys2 se o projeto antigo do WebFacing for da V7.0) do EAR associado ao projeto e inclua o arquivo de assinatura da V7.5.1 (HATS0705.sys2) antes da reimplementação.

Nota:
Os portlets do WebFacing não são detectados porque não podem ser implementados como EARs.

Segurança Java 2

Durante a migração para o HATS V7.5.1, o arquivo was.policy de segurança Java™ 2 do WebSphere Application Server foi sobrescrito. Se você customizou o arquivo was.policy em um projeto pré-HATS V7.5, então, deverá customizar novamente o arquivo após a migração.

Mapeamentos de Teclado

Em versões anteriores do terminal do host do HATS, a tecla Pause foi mapeada para a ação [limpar] do host. No terminal host do HATS V7, e posterior, a tecla Esc está mapeada para a ação [limpar] do host.

Em versões do HATS anteriores ao HATS V6, Ctrl+R era utilizado para sessões bidirecionais para reverter a tela. No HATS V6 e posterior, Ctrl+R é mapeado para um RESET do host para sessões bidirecionais e não bidirecionais e Alt+Enter é mapeado para reversão para sessões bidirecionais.

Aplicativos do Rich client

Ligações de Teclado do Lotus Notes

Se você migrar um projeto rich client pre-HATS V7.5 para o HATS V7.5.1 que é destinado para o Lotus Expeditor, os mapeamentos de teclado para Lotus Notes serão incluídos no projeto. Estes mapeamentos de teclado também serão incluídos em projetos destinados ao Lotus Expeditor se você atualizar sua instalação do HATS V7.5.0.x para V7.5.1 utilizando o IBM Installation Manager.

Configurações de Ativação

Após a migração de um projeto rich client, se não for possível ativá-lo no ambiente de teste, crie uma nova configuração de ativação para utilizar no ambiente de teste. Para fazer isto, na visualização Projetos HATS, clique com o botão direito do mouse no projeto e selecione Executar ou Depurar. A janela Executar (ou Depurar) Configurações será exibida. Se o projeto for destinado ao Eclipse RCP, clique com o botão direito do mouse em Aplicativo Eclipse e selecione Novo. Se o projeto for destinado ao Lotus Notes ou Lotus Expeditor , clique com o botão direito do mouse em Serviços do Cliente e selecione Novo. Se desejar, modifique o nome e local da configuração de ativação. Também é possível excluir configurações de ativação antigas desta janela. Clique em Executar (ou Depurar) para ativar o projeto no ambiente de teste.

Temas

Os aplicativos do Rich client que utilizam o temaEmulador de Terminal Clássico terão a configuração Navegação de Tecla de Seta ativada após a migração.

Cadeias em Inglês Não-US em Modelos e Transformações

Cadeias em inglês não-US incluídas nos modelos e transformações de um projeto do HATS rich client construídas com o HATS V7.0 ou V7.0.0.1 não são compiladas corretamente quando o projeto é exportado como um recurso. Para oferecer uma solução alternativa para esse problema, após migrar o projeto para o HATS V7.5.1, edite o arquivo build.properties localizado na pasta-raiz do projeto. Inclua a seguinte linha na parte inferior do arquivo build.properties:

javacCustomEncodings.library.jar =
src/rcpproject/templates/[UTF-8],
 src/rcpproject/transformations/[UTF-8]

Em que rcpproject é o nome do projeto do rich client.

Ativação de Tempo de Execução

Para ativar totalmente o tempo de execução do HATS V7.5.1 para produção, você deve especificar suas configurações de licença usando ao assistente para Configurações de Licença. Você deve fazer isso mesmo para projetos cujos tempos de execução se encontravam totalmente ativados nas versões anteriores do HATS. Para obter mais informações sobre a especificação de configurações de licença, consulte Enabling HATS runtime and license settings na publicação HATS Getting Started

Nota:
Os aplicativos da Web do HATS cujos tempos de execução não estão completamente ativados estão restritos a apenas duas conexões de host de tempo de execução. Os aplicativos rich client do HATS cujos tempos de execução não estão completamente ativados possibilitam conexões de host ilimitadas no ambiente de teste local, mas não conexões de host em um ambiente de produção implementado.

Secure Sockets Layer (SSL)

Durante a migração, o HATS V7.5.1 converte arquivos de classes de certificado SSL, arquivos CustomizedCAs.class, em arquivos de armazenamento de chaves PKCS12 com os nomes appname-CustomizedCAs.p12 e senhas de hats, em que appname é o nome do projeto. Após a migração, você deve utilizar a ferramenta Certificate Management (também conhecida como IBM Key Management ou iKeyMan) para alterar as senhas dos novos arquivos de armazenamento de chaves e verificá-las utilizando o editor de conexão. Para obter informações adicionais, consulte Segurança.

Modos de Teste

Começando com o HATS V7, os modos de teste Executar no Servidor (para projetos da Web) e Executar (para projetos do rich client) podem ser utilizados para modificar e testar as configurações do tempo de execução que são implementadas no ambiente de produção. Saiba que todas as alterações feitas nas configurações de tempo de execução durante o teste neste modo serão retidas e efetivadas quando você implementar o aplicativo do HATS em um ambiente de produção.

Os modos de Teste Depurar no Servidor (para projetos da Web) e Depurar (para projetos rich client) podem ser utilizados para modificar e testar as configurações de tempo de execução sem modificar as configurações implementadas no ambiente de produção.

Para obter informações adicionais sobre como alterar configurações do tempo de execução para projetos da Web, consulte Iniciando o Console Administrativo Enquanto Está no HATS Toolkit. Para obter informações adicionais sobre como alterar configurações do tempo de execução para projetos do rich client, consulte Administrando Aplicativos Rich Client do HATS.

Componente de Host URL

Antes do HATS V7, o componente de host URL procurava dentro do campo de entrada e do campo protegido. A partir do HATS V7, o componente de host URL procura apenas dentro dos campos protegidos não-ocultos.

Web Express Logon (WEL)

Quando um projeto da Web do HATS é migrado para o HATS V7.5.1 sem nenhum EAR associado, o Web Express Logon (WEL) não funciona apropriadamente. As informações de configuração do WEL para um projeto da Web são mantidas em seu projeto EAR associado. Se o projeto EAR associado não for importado e migrando, então, suas informações serão perdidas.

Se você importar os projetos EAR e da Web como arquivos de Troca de Projetos na área de trabalho e migrar o projeto da Web, o projeto EAR associado também será migrado e as informações de configuração do WEL não serão perdidas.

A partir do HATS V7, o Java Secure Socket Extension (JSSE) é utilizado pelos plug-ins de mapeador de credenciais HATS DCAS/RACF/JDBC e DCAS/RACF baseado em certificado para conexões seguras com o servidor DCAS. Como resultado, considere as seguintes alterações para os parâmetros de inicialização de plug-in.

CMPI_DCAS_KEYRING_FILE
Este parâmetro está reprovado e não deve ser utilizado. Entretanto, se utilizado, ele é suportado no HATS V7.5.1 em conjunto com o parâmetro reprovado, CMPI_DCAS_KEYRING_PASSWORD e assumindo que o tipo de conjunto de chaves seja pkcs12. Utilize CMPI_DCAS_TRUSTSTORE em substituição. Para obter informações adicionais, consulte Parâmetros de Inicialização.

Este parâmetro especifica um banco de dados de keyring. Um conjunto de chaves deve ser especificado para fornecer acesso ao certificado cliente DCAS assim como ao certificado do servidor DCAS. Os certificados estabelecem uma conexão segura autenticada do cliente com o servidor DCAS. Este parâmetro é uma referência de arquivo para utilizar o conjunto de chaves. O plug-in do DCAS é o cliente DCAS. O arquivo do conjunto de chaves deve ser armazenado no arquivo .ear.

CMPI_DCAS_KEYRING_PASSWORD
Este parâmetro está reprovado e não deve ser utilizado. No entanto, se usado, ele é suportado no HATS V7.5.1 em conjunto com o parâmetro reprovado, CMPI_DCAS_KEYRING_FILE, e com a suposição de que o tipo de keyring seja pkcs12. Utilize CMPI_DCAS_TRUSTSTORE_PASSWORD em substituição. Para obter informações adicionais, consulte Parâmetros de Inicialização.

Este parâmetro especifica a senha do banco de dados de keyring.

Portlets do HATS V4

A migração de portlets do HATS V4 não é suportada. Se você desejar utilizar um projeto da Web existente do HATS V4 como um portlet, primeiro deverá migrá-lo para o HATS V7.5.1. Depois de migrar o projeto, você poderá gerar um projeto de portlet do HATS V7.5.1 a partir dele. Para obter informações adicionais, consulte Gerando Portlets a Partir de Projetos da Web do HATS.

Migrando do HATS LE

Se você atualmente tiver o HATS LE instalado, primeiro será necessário exportar seu aplicativo para que possa importá-lo para o HATS V7.5.1. Para exportar o aplicativo do Console Administrativo HATS LE para um arquivo .zip:

  1. Inicie o Console Administrativo do HATS LE digitando a seguinte URL em seu navegador da Web: http://<nome_do_servidor>/HATSLE/admin em que <nome_do_servidor> é o nome do servidor no qual o aplicativo do HATS LE é executado.
  2. Selecione Avançado.
  3. Selecione Pacote.
  4. Faça download e salve o pacote como um arquivo .zip

Depois que o aplicativo do HATS LE tiver sido exportado como um arquivo .zip, importe-o para o HATS V7.5.1 seguindo estas etapas:

  1. Clique em Arquivo > Importar para abrir o Assistente para importação.
  2. Selecione HATS > Aplicativo HATS LE e clique em Avançar.
  3. No campo Nome do Arquivo zip, digite o local e o nome do arquivo .zip. Também é possível navegar até o arquivo .zip e selecioná-lo clicando em Navegar.
  4. No campo Novo Nome de Projeto, especifique um nome de projeto ou aceite o nome fornecido.
  5. Configure o local para o projeto ou aceite o local padrão.
  6. No campo Projeto do Aplicativo Corporativo, especifique um nome para o projeto .ear ou selecione um nome existente na lista drop-down.
  7. Clique em Concluir.
Notas:
  1. Caso seu aplicativo HATS LE possua SSL ativado na conexão, você receberá uma mensagem de aviso ao migrá-lo para o V7.5.1, e o certificado de SSL não é migrado.

    Para tornar o certificado de SSL utilizável no HATS V7.5.1, você deve criar um arquivo de armazenamento de chave PKCS12 e incluir o certificado de SSL nele. Caso não possua mais um certificado de SSL, você deve entrar em contato com seu administrador do servidor Telnet para obtê-lo. Para obter mais informações, consulte Ativando a Segurança SSL.

  2. A funcionalidade de várias conexões do HATS LE V5 foi perdida após a migração para o HATS V7.5.1. A conexão padrão no aplicativo HATS LE V5 se torna a conexão padrão no projeto do HATS V7.5.1. As outras conexões configuradas no HATS LE V5 se tornarão conexões de segundo plano no projeto do HATS V7.5.1.

HATS para Usuários do Host Publisher

Se você for um usuário com experiência no IBM WebSphere Host Publisher, precisará ajustar sua abordagem a fim de desenvolver projetos com o HATS. Algumas diferenças chaves entre as abordagens do HATS e do Host Publisher no desenvolvimento de projetos são:

Nota:
Se você criou os Objetos de Integração do Host Publisher utilizando um modelo modificado, precisará criar novamente os Objetos de Integração, fazendo modificações semelhantes no modelo do Objeto de Integração do HATS e depois gerando novamente os Objetos de Integração das macros. Para obter mais informações sobre a utilização de modelos para customizar Objetos de Integração, consulte a publicação HATS Web Application Programmer's Guide.

Se você estiver importando um aplicativo do Host Publisher V4.0 (versus um aplicativo do Host Publisher V4.0.1):

Migrando do Host Publisher Versão 4

Se você for atualmente um usuário do Host Publisher V4, poderá migrar os projetos inteiros ou apenas os Objetos de Integração dos seus projetos existentes. Ao importar os arquivos .ear do Host Publisher, os Objetos de Integração permanecem compactados no arquivo .jar.

Se o Objeto de Integração estiver em um Módulo da Web, o arquivo .jar estará no diretório WEB-INF/LIB. Se o Objeto de Integração estiver em um módulo EJB, o arquivo .jar estará no diretório imported_classes\IntegrationObject. Os Beans de Acesso EJB também permanecem empacotados no arquivo .jar no diretório WEB-INF/LIB do Módulo da Web.

Se importar um .ear e modificar a macro para a qual um Objeto de Integração foi criado, você terá o .jar do Objeto de Integração original que foi importado, bem como a origem Java. Depois de gerar novamente o Objeto de Integração para o HATS, será possível excluir o arquivo .jar importado.

A seguir está uma lista das considerações durante a migração do Host Publisher V4:

Assistente para Importar o Host Publisher EAR

Você poderá importar projetos do Host Publisher V4 no HATS como novos projetos HATS ou como parte de um projeto HATS existente.

  1. Clique em Arquivo > Importar > HATS > EAR do Host Publisher V4 para abrir o assistente para Importar arquivo EAR do Host Publisher.
  2. Especifique o arquivo EAR que você deseja importar no campo Nome do Arquivo EAR.
  3. Decida se o arquivo EAR deve ser utilizado para um novo projeto HATS ou um projeto existente do HATS.
  4. Na seção Opções, você pode configurar Sobrescrever Recursos sem Avisos selecionando a caixa de opções.
  5. Se você estiver utilizando criptografia no Host Publisher, poderá digitar sua chave de criptografia na caixa de texto Chave de Criptografia da Lista de Usuários.
  6. Clique em Concluir.

Importar Objeto de Integração do Host Publisher

Também é possível importar Objetos de Integração do Host Publisher individuais em um projeto existente do HATS.

  1. Clique em Arquivo > Importar > HATS > Objeto de Integração do Host Publisher V4 para abrir o assistente para Importar Objeto de Integração do Host Publisher.
  2. Especifique o local dos Objetos de Integração que você deseja importar no campo Diretório de Objetos de Integração do Host Publisher.
  3. Selecione quais Objetos de Integração você deseja importar no campo Selecionar Objetos de Integração a serem importados.
  4. Selecione o projeto do HATS na caixa drop-down Selecionar Projeto do HATS.
  5. É possível Sobrescrever os recursos sem avisos e Gerar novamente Objeto(s) de Integração importados, selecionando uma caixa de opções.
    Nota:
    Se você encadeou os Objetos de Integração, deve certificar-se de selecionar a opção Gerar novamente Objeto(s) de Integração importado(s). Isso assegura que as informações de encadeamento serão preservadas. Após importar os Objetos de Integração encadeados, as informações de estado estarão na origem Java e serão preenchidas quando você utilizar o assistente para Criar Objeto de Integração de Encadeamento. Para obter informações adicionais sobre os Objetos de Integração encadeados, consulte Encadeamento do Objeto de Integração.
  6. Clique em Concluir.
Nota:
Ao importar os Objetos de Integração, a configuração de conexão associada ao Objeto de Integração será incluída no projeto do HATS

Migrando o Portlet do Host Publisher V4

O portlet de recorte que é fornecido com o WebSphere Portal Server V6.x é funcionalmente equivalente ao portlet do Host Publisher V4 portlet. É possível criar um portlet de recorte que aponte para um aplicativo do HATS baseado no Objeto de Integração ou um aplicativo migrado do Host Publisher V4 e substituir o portlet do Host Publisher V4 por ele. O portlet do Host Publisher V4 não é mais suportado.

Para obter informações sobre a integração de aplicativos baseados em Objetos de Integração mais proximamente ao WebSphere Portal, consulte a publicação HATS Web Application Programmer's Guide.

Migração do J2EE

Se desejar migrar o nível de suporte do J2EE em seus projetos do HATS, execute as seguintes etapas:

  1. No Rational SDP, alterne para a visualização do Navegador.
  2. Clique com o botão direito do mouse no projeto .ear que contém seus projetos do HATS e selecione Java EE > Assistente de Migração J2EE.
  3. No painel Página de Boas-vindas, clique em Avançar.
  4. No painel Aplicativo Corporativo, selecione a versão adequada do J2EE e desmarque a caixa Migrar todos os projetos do módulo.
    Nota:
    Desmarcar essa caixa permite verificar individualmente quais projetos migrar. Se um projeto EJB do HATS estiver contido no projeto .ear, você não deverá selecioná-lo para migrar o projeto .ear com êxito.
  5. No painel Módulo EJB (se for exibido), não selecione nenhum projeto EJB do HATS.
  6. No painel Projetos da Web, selecione todos os projetos da Web do HATS.
  7. Clique em Concluir.