Migrando Projetos WebFacing

A migração de projetos antigos deve ser concluída antes de poder continuar o desenvolvimento de seus aplicativos WebFacing. Por exemplo, você não pode converter a origem DDS ou alterar as propriedades de seu projeto. No entanto, é possível executar projetos não migrados no estado em que se encontram. Para diferenciar entre projetos não migrados e atualizados, os projetos não migrados são identificados com ícones exclusivos na visualização Projetos WebFacing.

Há dois estágios de migração de projeto. O primeiro estágio é executado pelo produto base para qualquer tipo de projeto da Web e o segundo é executado pelo assistente de Migração do WebFacing para tratar atualizações específicas para projetos do WebFacing.
Importante:
  • O WebFacing suporta apenas a migração de projetos no nível de release V7.0 e posterior.
  • Consulte a nota técnica Migração de WebFacing para obter uma lista de problemas conhecidos e resoluções relacionadas à migração, bem como atualizações para o processo de migração, que podem se tornar conhecidos após o release desse documento.

Migração de Base

Comece certificando-se de que as atualizações e fix packs mais recentes para todos os produtos Rational estejam instalados usando o IBM® Installation Manager. Esta etapa é muito importante pois ela eliminará vários problemas que você possa enfrentar. Consulte Atualizando Pacotes do Produto Instalados em http://publib.boulder.ibm.com/infocenter/radhelp/v8r5/index.jsp?topic=/com.ibm.rad.install.doc/topics/t_update.html e Atualizando a Instalação do HATS Toolkit em http://pic.dhe.ibm.com/infocenter/hatshelp/v90/topic/com.ibm.hats.doc/doc/gsinstal.htm#update para obter detalhes.

Os projetos do WebFacing devem ser carregados em uma área de trabalho atual antes de poderem ser migrados com o assistente de Migração do WebFacing. A migração é irreversível, portanto, é recomendado que você faça backup de sua área de trabalho ou de seus projetos.

Os projetos WebFacing anteriores podem ser introduzidos no espaço de trabalho de nível atual, abrindo o espaço de trabalho antigo ou importando os projetos antigos. Os projetos existentes podem ser importados diretamente das pastas ou archives, incluindo os arquivos de troca de projetos (Importar > Geral > Projetos Existentes na Área de Trabalho e escolha Selecionar Archive).

Após um projeto ser aberto na área de trabalho de nível atual, o assistente de Migração de Desktop do Rational pode aparecer. O assistente permite selecionar quais projetos atualizar e mostra quais arquivos serão modificados. Percorra o assistente e faça quaisquer alterações necessárias e clique em Concluir para iniciar a migração de projeto. Quando a migração da área de trabalho for concluída, os resultados serão exibidos na visualização Resultados da Migração. Consulte Migrando áreas de trabalho e projetos em http://publib.boulder.ibm.com/infocenter/radhelp/v8r5/index.jsp?topic=/com.ibm.etools.rad.migration.doc/topics/t_migratefrom70.html para obter mais detalhes.

Se quaisquer erros forem relatados ou se o projeto migrado for sinalizado com erros, consulte Resolução de Problemas dos Aplicativos WebFacing, bem como o documento on-line nota técnica Migração de WebFacing, que é mantido atualizado.

Nota: É possível ignorar o diálogo a seguir se ele aparecer após a conclusão do Assistente de Migração da Área de Trabalho. Esse erro será resolvido posteriormente neste documento.
  • Validação da migração concluída com alguns erros. Consulte a visualização Resultados da Migração para obter informações adicionais. A visualização Resultados da Migração realça erros semelhantes a: O aspecto do WebSphere "WebSphere Web (Extended) 5.1" não é compatível com o tempo de execução do WebSphere "WebSphere Application Server vX.Y.

Depois de concluída a migração do espaço de trabalho, você poderá reconfigurar manualmente a perspectiva clicando em Janela > Reconfigurar Perspectiva.

Seus projetos agora estão prontos para uso na nova área de trabalho; entretanto, eles ainda deverão ser migrados usando o assistente de Migração do WebFacing.

Usando o Assistente de Migração do WebFacing

Preparando um projeto para migração do WebFacing

É necessário executar as seguintes tarefas preparatórias antes de executar o assistente de Migração do WebFacing.

  1. Assegure que um servidor válido esteja selecionado na página Tempos de Execução Destinados. Isto é necessário se o servidor originalmente destinado não é mais suportado.
    1. Na visualização Navegador, clique com o botão direito do mouse em seu projeto e selecione Propriedades.
    2. Abra a página Tempos de Execução Destinados e selecione o nível do servidor no qual o projeto será executado.
    3. Clique em OK.
  2. Se seu projeto estiver no nível Java™ EE 1.3, ele deverá ser migrado para 1.4 ou posterior, usando o Assistente de Migração de Especificações de Java EE antes que a migração de WebFacing possa continuar. Consulte Migrando o nível de especificação de projetos Java EE em http://publib.boulder.ibm.com/infocenter/radhelp/v8r5/index.jsp?topic=/com.ibm.javaee.doc/topics/tmgv6j2eewiz.html.
    Nota: Se vir um diálogo intitulado Arquivos Inconsistentes durante a migração de Java EE, clique em Sim para rejeitá-lo. De modo semelhante, se no final do assistente você vir a mensagem Migração concluída com erros, clique no botão Detalhes. A mensagem a seguir pode ser rejeitada com segurança: Erro: org.eclipse.core.runtime.CoreException: Stub do WebSphere Portal v6.0 de tempo de execução não suporta aspecto do projeto WebFacing 1.0.
  3. Resolva quaisquer erros de caminho de classe em seu projeto.
    1. Abra a visualização Problemas (Janela > Mostrar Visualização > Outro > Problemas).
    2. Verifique se há qualquer caminho de classe ou erro de construção relatado, por exemplo: ClassName não pode ser resolvido [para um tipo], O projeto não pode ser construído até os erros do caminho de construção serem resolvidos ou Variável de caminho de classe desvinculada.
    3. Resolva todos esses erros, conforme descrito na nota técnica Migração de WebFacing.

Executando o assistente de Migração do WebFacing

Em seguida, use o assistente de Migração do WebFacing para atualizar seus projetos para a versão atual. Você não poderá mais migrar os projetos com a nova conversão dos arquivos DDS.

  1. Para ativar o Assistente de Migração do WebFacing, clique com o botão direito do mouse em seu projeto não migrado na visualização Projetos do WebFacing e selecione Migrar Projeto do WebFacing.
  2. Clique em Concluir para migrar o projeto selecionado para a versão atual.
  3. Clique em OK se um diálogo Resultados aparecer notificando que a versão do Struts de seu projeto foi alterada.
  4. Se seu projeto foi migrado de uma versão anterior à V7.5.0, é recomendado que você converta novamente seu DDS, especialmente se planeja usar o navegador Firefox com seus aplicativos WebFacing.
Nota: Se o projeto que está sendo migrado for um projeto ativado para HATS/WebFacing, o projeto do HATS correspondente também deverá ser migrado. Consulte Migrando para o HATS V9.0 para obter detalhes.

Os projetos customizados podem requerer intervenção manual. Consulte Etapas Manuais para Migrar Projetos com Arquivos Customizados e Suporte do WebFacing para Múltiplos Navegadores para obter detalhes adicionais.

Os projetos do WebFacing migrados requerem que uma licença do HATS seja implementada, assim como novos projetos do WebFacing fazem. Se já tiver uma licença do HATS aplicada, seus projetos migrados também conterão esta configuração de licença. Consulte Ativando Licenças para obter informações adicionais.