Desenvolvendo e Implementando Aplicativos da Web do HATS
Existem cinco tipos de aplicativos do HATS; Web, portlet, EJB, rich client
e console administrativo. Este capítulo inclui informações sobre aplicativos da Web do HATS. Para obter informações sobre os outros tipos de aplicativos, consulte os seguintes capítulos:
Além disso, um aplicativo da Web do HATS pode
ser vinculado a um aplicativo WebFacing e os dois empacotados
juntos podem interoperar entre si em um aplicativo corporativo único. Para obter informações adicionais, consulte WebFacing e HATS.
Os aplicativos do HATS são criados a partir de projetos do HATS utilizando
o HATS Toolkit. Quando você cria um novo projeto do HATS, um conjunto de pastas é
criado para ajudar a organizar os arquivos de aplicativo do HATS. Um exemplo de um projeto padrão é mostrado
abaixo.
A pasta de nível mais alto tem o mesmo nome fornecido ao seu projeto ao criá-lo. Nessa pasta estão as outras pastas de alto nível que contêm objetos definidos em seu projeto do HATS. Algumas pastas não aparecem até que você crie
determinados objetos.
Figura 2. Visualização do Projeto da Web do HATS
Dependendo de como você configura seu projeto do HATS, algumas ou todas estas pastas
aparecerão na visualização Projetos Projetos do HATS. Você também pode especificar quais pastas aparecem na visualização Projetos do HATS, bem como ocultar as extensões
dos arquivos. Para obter informações adicionais, consulte Utilizando Preferências do HATS.
Nota:
Diferentes pastas aparecem para diferentes tipos de projetos do HATS. Por exemplo,
a árvore de diretórios para um projeto EJB do HATS não possui nenhuma pasta Customizações
da Tela, Capturas de Tela ou Conteúdo
da Web.
Você pode criar subpastas dentro dessas pastas de nível superior
para ajudar a organizar seu projeto. Por exemplo, assim que você cria
capturas de tela para seu projeto, você pode desejar criar pastas na
pasta Capturas de Tela para organizar
e agrupar as telas capturadas. Para criar uma pasta, clique com o
botão direito do mouse nas pastas de nível superior na árvore e
clique em Novo HATS > Pasta. Para
mover um arquivo para uma pasta diferente, clique com o botão direito
do mouse no arquivo e selecione Mover,
ou você pode utilizar o método arrastar e soltar.
Nota:
Existe uma limitação para as subpastas. A transformação e os arquivos
de modelo devem estar em subpastas do mesmo nível. Para utilizar uma transformação
que resida em um determinado nível de subpastas, como \transformations\Callup\,
o modelo que será acoplado com essa transformação deverá estar no
mesmo nível das subpastas, como \templates\Callup\.
Os projetos do HATS podem ser compartilhados em um ambiente de equipe indo
para a Visualização Navegador da perspectiva do HATS.
Clique com o botão direito do mouse no projeto e selecione Equipe > Compartilhar
Projeto. Selecione o tipo de repositório
na lista e clique em Avançar. O Rational SDP suporta vários repositórios. Para obter informações adicionais, consulte a documentação do
Rational SDP e procure no repositório.
Os projetos da Web do HATS, criados no HATS Toolkit,
são extensões dos projetos da Web no ambiente de trabalho do Rational SDP.
Para obter informações adicionais,
clique em Ajuda > Conteúdo da Ajuda na barra de menus do Rational SDP,
expanda Desenvolvimento e selecione
Desenvolvendo Aplicativos da Web.
Organizando Aplicativos da Web do HATS
Por padrão, todos os aplicativos da Web do HATS são armazenados em um arquivo Enterprise
Archive, como HATS_EAR7.
Quando você exporta
seus aplicativos e os implementa no WebSphere Application Server, o arquivo .ear do HATS
contém um arquivo Web archive (.war) com os recursos para executar cada aplicativo,
além de uma cópia do código executável de tempo de execução do HATS. Se preferir, você pode organizar
seus aplicativos de maneira diferente, cada um em seu próprio arquivo
.ear, ou em alguma outra combinação.
Considere o efeito do seguinte em seu servidor ao decidir como
organizar seus aplicativos da Web:
- Espaço em Disco
- Se você criar cada aplicativo em seu próprio arquivo .ear,
ele terá sua própria cópia do código de tempo de execução do HATS. O código de tempo de execução é de
aproximadamente 25 MB. Multiplique esse valor pelo número de
aplicativos para ver a quantidade de espaço em disco consumida em seu sistema de tempo
de execução para todos os seus aplicativos.
- Implementação
- Se você reimplementar um arquivo .ear do HATS, estará reimplementando todos os aplicativos contidos naquele arquivo .ear, mesmo se alguns dos aplicativos estiverem inalterados.
- Registro e Rastreio
-
O registro e rastreio são controlados no nível do arquivo .ear,
não no nível do aplicativo HATS individual. Se cada aplicativo do HATS estiver em seu próprio arquivo .ear, você poderá controlar suas configurações de log e rastreio independentemente de quaisquer outros aplicativos. Se você tiver vários aplicativos do HATS em um
arquivo .ear, as configurações de log e rastreio se aplicarão a todos os aplicativos do HATS no arquivo .ear. As mensagens para todos os aplicativos do HATS no arquivo .ear são inseridas no mesmo
arquivo de log e as informações de rastreio para todos os aplicativos do HATS são inseridas no mesmo arquivo de rastreio.
É possível incluir uma palavra-chave opcional adicional, traceLogDirectory,
no arquivo runtime.properties.
Isto permite especificar um diretório específico
para os arquivos de saída. O arquivo é localizado no diretório was_dir/installedApps/ear_name para um
aplicativo corporativo HATS.
- Rastreamento de Licença
- O rastreamento de licença também é controlado no nível do
arquivo .ear, não no nível do aplicativo HATS individual. Se cada
aplicativo HATS estiver em seu próprio arquivo .ear, o
rastreamento de licença será feito, independentemente dos outros aplicativos. Se você tiver vários aplicativos HATS em um arquivo .ear, o
rastreamento de licença será executado para todos os aplicativos
HATS no arquivo .ear. As informações sobre o uso da licença são
mantidas para todos os aplicativos HATS no arquivo .ear e são
inseridas no mesmo arquivo de uso de licença.
Movendo Projetos da Web do HATS para um Arquivo .ear Diferente
Em qual arquivo .ear seus arquivos de projeto são inseridos
é determinado quando você cria o projeto. Depois que criar o projeto, você pode
movê-lo de um .ear para outro, utilizando as seguintes etapas:
Para incluir o projeto em um arquivo .ear:
- Clique na guia Navegador do
HATS Toolkit para exibir os arquivos .ear.
- Expanda o arquivo .ear no qual deseja incluir o
projeto. Expanda a pasta META-INF e localize o arquivo application.xml.
- Inicie o editor do application.xml do Rational SDP dando um clique duplo no
arquivo application.xml.
- Na visualização Design do editor application.xml, no
grupo Visão Geral, selecione Aplicativo
e clique em Incluir.
- No diálogo Incluir Item, selecione Módulo
e clique em OK.
- Selecione o projeto que deseja incluir no arquivo .ear e clique em Concluir.
- Feche o editor application.xml do Rational SDP.
Para remover o projeto de um arquivo .ear:
- Clique na guia Navegador do
HATS Toolkit para exibir os arquivos .ear.
- Expanda o arquivo .ear do qual deseja remover o projeto.
Expanda a pasta META-INF e localize o arquivo application.xml.
- Inicie o editor do application.xml do Rational SDP dando um clique duplo no
arquivo application.xml.
- Na visualização Design do editor application.xml, no grupo
Visão Geral, selecione o projeto que deseja remover do arquivo .ear
e clique em Remover.
- Feche o editor application.xml do Rational SDP.
Fazendo Backup de Projetos do HATS
Assim como com qualquer atividade de desenvolvimento de software, é uma prática recomendada fazer backup
dos projetos do HATS para se proteger contra perda de dados ou distorção.
Além de criar
backups durante seu próprio ciclo de desenvolvimento, você também deve criar
backups antes de instalar a manutenção do HATS.
Isto permite reverter para o
nível de manutenção anteriormente instalado, se necessário. Para criar um backup
para o projeto do HATS, utilize a função export project interchange do Rational SDP. Para obter mais informações, consulte Exportando um Projeto da Web.
Para restaurar um projeto do HATS a partir de um
backup, use a função Importar Intercâmbio de Projetos. Para obter informações adicionais, consulte Importando um Projeto da Web.
Exportando e Importando Projetos da Web do HATS
Exportando um Projeto da Web
Você pode exportar seus projetos da Web do HATS para salvar e utilizar como backups
ou para mover para outro sistema do HATS Toolkit. Para executar a exportação, utilize o seguinte método:
Arquivo Project Interchange
Esta função possui vários benefícios. Ela permite exportar vários projetos e o .ear associado de uma só vez. Além disso, não é necessário criar um projeto no HATS Toolkit de destino
antes de importar o arquivo project interchange. Para exportar o projeto como um arquivo project interchange, execute as seguintes etapas:
- Na barra de menus, selecione Arquivo > Exportar para
abrir o assistente de Exportação.
- Selecione Outro
> Project Interchange e clique em Avançar.
- Selecione o projeto e seu projeto EAR associado.
- Especifique um nome de arquivo .zip e o local para o arquivo .zip no
qual você deseja salvar o projeto.
- Clique em Concluir.
Importando um Projeto da Web
Para importar um projeto em um arquivo project interchange para o HATS Toolkit:
- Na barra de menus, clique em Arquivo > Importar para
abrir o assistente de Importação.
- Selecione Outro
> Project Interchange e clique em Avançar.
- Especifique o arquivo .zip que deseja importar no campo A partir do arquivo zip.
- Especifique a área de trabalho para a qual você deseja importar o arquivo no campo Raiz de local do projeto.
- Selecione os projetos no arquivo do Project Interchange que deseja importar para a área de trabalho especificada.
- Clique em Concluir.
Para obter informações
sobre como migrar um projeto do HATS de um release anterior do HATS,
consulte Migração do HATS.
Implementando Aplicativos HATS da Web
Os termos aplicativo da Web do HATS, aplicativo WebSphere
e aplicativo Java™
EE podem ser utilizados alternadamente para fazer referência a um aplicativo da
Web criado a partir de um projeto do HATS. É um aplicativo HATS da Web porque foi desenvolvido no HATS Toolkit. É um aplicativo WebSphere porque será instalado e executado no WebSphere Application Server. É um aplicativo Java EE porque está em conformidade com os padrões Java EE.
Para implementar seu aplicativo HATS da Web em um ambiente de tempo de execução, você deve:
- Ative o tempo de execução do HATS.
- Exporte seu projeto como um aplicativo Java EE.
- Instalar seu aplicativo em um ambiente de tempo de execução.
- Fazer quaisquer alterações necessárias no ambiente de tempo de execução.
As seguintes seções descrevem como desempenhar cada uma destas tarefas.
Ativando o Tempo de Execução do HATS
Independente de onde tenha obtido o pacote do HATS (CD do HATS, Web,
ou empacotado com outro produto), você instala a mesma versão do
HATS Toolkit. Essa é uma versão de uso limitado que você pode utilizar para avaliar o HATS. Para ativar completamente os tempos de execução para produção de acordo com sua prova de titularidade licenciada, você deve especificar suas configurações de licença utilizando o assistente Configurações de Licença incluído no HATS Toolkit.
Para obter mais informações, consulte as seções Evaluating
HATS e Enabling HATS runtime and license settings,
na publicação Introdução do HATS.
Exportando seu Projeto como um Aplicativo
Java EE
Para implementar seu aplicativo da Web do HATS para um ambiente
de tempo de execução do WebSphere Application
Server, primeiro, é necessário empacotá-lo em um aplicativo
Java EE. Para fazer isso, exporte seu projeto como um arquivo EAR.
Para exportar o projeto, siga estas etapas:
- Destaque (com um único clique) o nome do projeto na visualização Projetos HATS.
- Clique no ícone Exportar Projeto do HATS na barra de ferramentas principal ou clique com o botão direito do mouse no nome do projeto
e selecione Exportar Projeto.
- Na janela Exportar, escolha um projeto Enterprise Application na lista
suspensa ou digite o nome de um projeto Enterprise Application no campoProjeto EAR.
- Digite um local de destino no campo Destino ou clique no botão Procurar para selecionar o destino do arquivo .ear
exportado.
- Se quiser exportar os arquivos de origem do projeto juntamente com os arquivos
executáveis, selecione a caixa Exportar arquivos de origem. Se você
incluir os arquivos de origem, outro desenvolvedor pode extraí-los de seu
arquivo .ear. Isso pode fazer a colaboração ou o serviço mais fáceis, mas você deve decidir
se isso cria um risco de segurança.
- Se você tiver exportado este projeto a esta localização antes, o processo de
exportação pergunta se você deseja sobrescrever os arquivos existentes.
Isso visa
protegê-lo de sobrescrever arquivos que você pode desejar manter, talvez
arquivar uma versão anterior de seu projeto.
Se quiser sobrescrever arquivos
anteriores sem que seja pedida uma confirmação, selecione a caixa Sobrescrever arquivo existente.
- Clique em Concluir. O projeto será exportado
como um aplicativo
JavaEE, representado
por um arquivo Enterprise Archive com a extensão .ear, com o diretório e o nome
de arquivo que você especificou.
Instalando Seu Aplicativo em um Ambiente de Tempo de Execução
Depois de exportar o projeto do HATS como um aplicativo
Java EE
e transferir o arquivo .ear do aplicativo para o
sistema de produção, instale-o ativando o Console Administrativo WebSphere e procure
o local do arquivo .ear. Para obter informações adicionais sobre a instalação
de aplicativos no WebSphere Application Server, consulte a biblioteca do WebSphere Application
Server em http://www.ibm.com/software/webservers/appserv/was/library/ e selecione o link para o centro de informações para a sua versão do WebSphere Application Server.
No conteúdo do produto
WebSphere Application Server, consulte o capítulo sobre a implementação de aplicativos.
Após o aplicativo ter sido instalado, teste-o
tornando a URL visível em um navegador da Web em outro sistema. Então, você poderá divulgar o
URL a seus usuários. Por exemplo, a URL pode ser semelhante a http://hostname/hatsappname/ em que hostname é o nome do host IP e o domínio em que o WebSphere Application Server está instalado e hatsappname é
o nome de seu aplicativo do HATS.
Notas:
- Para obter informações adicionais sobre a instalação de aplicativos do HATS em plataformas específicas, consulte o Centro de Informações do HATS em http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp.
- Se os aplicativos do HATS forem implementados no WebSphere Application
Server com a segurança Java 2 ativada, e não forem iniciados, consulte Segurança Java 2 para obter informações adicionais.
- O HATS suporta várias instâncias de navegador da mesma estação de trabalho acessando o mesmo aplicativo do HATS. No entanto, essas múltiplas instâncias do navegador não devem
compartilhar o mesmo ID de sessão HTTP.
A sessão entre o navegador acessando o aplicativo
HATS e o WebSphere Application
Server foi designada com um ID de sessão HTTP. O ID de sessão HTTP possibilita
que pedidos subsequentes do mesmo navegador retornem para o mesmo aplicativo
HATS. Pedidos subsequentes utilizam a mesma sessão Telnet (3270 ou 5250)
que existe entre o aplicativo HATS no servidor e o host.
Diferentes navegador implementam o ID de sessão HTTP de maneira diferente. O Microsoft® Internet
Explorer espera que todas as sessões do navegador no mesmo processo
compartilhem o mesmo ID de sessão HTTP. Quando você ativa um nova
janela do navegador utilizando o mesmo atalho, uma nova sessão do
navegador utilizando o mesmo atalho, uma nova sessão do navegador
é iniciada e compartilha o mesmo processo e o ID
de sessão HTTP.
Uma maneira de abrir um novo processo do Internet Explorer
com um ID de sessão HTTP exclusivo, no Windows® XP
por exemplo, se o Internet Explorer estiver em sua lista inicial, é selecionar Iniciar > Internet Explorer. Selecionar Iniciar > Todos os Programas > Internet Explorer
também inicia um novo processo do Internet Explorer com um ID de sessão
HTTP exclusivo.
Notas:
- A função Ctrl-N do Internet Explorer não inicia um novo processo,
porque ela abre uma nova janela que possui o mesmo ID de processo e
o mesmo ID de sessão HTTP que o da janela da qual foi originada.
- Para o Internet Explorer 8, é possível utilizar Arquivo > Nova Sessão para abrir um novo
navegador com um ID de sessão exclusivo.
Nota:
No
Internet Explorer, é possível localizar o ID de sessão HTTP para uma janela
do navegador selecionando Visualizar > Origem
na barra de menus ou clicando com o botão direito do mouse na janela do
navegador Internet Explorer e selecionando Visualizar
Origem para visualizar a atribuição de tag de origem para a
página. Role para baixo até a tag Form do HATS na janela de origem, que é
semelhante ao seguinte:
<FORM NAME="HATSform" dir="" METHOD="POST"
ACTION="/YourHATSAppName/entry">.
Dentro desta
tag Form, localize o parâmetro SESSIONID, que é semelhante ao
seguinte:
<INPUT TYPE="HIDDEN" NAME="SESSIONID"
VALUE="PIOncS1GehNWxWo_49VCBzC" />
Nota:
Quando você acessa um aplicativo HATS que exibe apenas uma transformação
padrão da tela e não executa macros quando é iniciado, o SESSIONID possui um
valor de "INVALID." O valor SESSIONID é designado quando você envia algo para o
host, tal como quando pressiona a tecla Enter, e obtém uma resposta.
É possível verificar se um novo processo está sendo iniciando utilizando o
Gerenciador de Tarefas no Windows. Inicie
o Gerenciador de Tarefas e clique no título da coluna 'Nome da imagem' na guia
Processos para classificar as informações por nome de imagem. Role para baixo até
visualizar quantos processos 'iexplore.exe' estão na lista. Tente iniciar algumas
novas janelas do Internet Explorer utilizando o atalho
Iniciar > Internet Explorer.
Se um novo processo for iniciado, um novo processo iexplore.exe será
incluído na exibição. Caso contrário, um processo existente está no
controle da nova janela do navegador.
- O HATS exige o nome de exibição do aplicativo, como definido no arquivo web.xml do aplicativo, para
corresponder ao caminho do contexto do aplicativo da Web utilizado na URL do navegador. Se o valor do nome de
exibição for alterado para ser diferente do caminho do contexto do aplicativo, você pode encontrar um erro
java.lang.nullPointerException ou um erro javax.servlet.ServletException ao executar o aplicativo HATS. Por exemplo, um projeto do HATS denominado MyHatsProject tem um nome de exibição padrão MyHatsProject. Este
projeto, quando implementado com um aplicativo da Web, deve ser acessado com uma URL semelhante à
http://myServer/MyHatsProject/ para operar adequadamente.
A alteração do nome de exibição para algum outro diferente de MyHatsProject faz com que o aplicativo fique
inoperável.
Alterações Necessárias no Ambiente de Tempo de Execução
Configurando a Política do Carregador do Classe
Ao implementar seus aplicativos da Web do HATS ou executar os
aplicativos no ambiente de teste local, a política do carregador de classes WAR
deve ser configurada por aplicativo Java EE em qualquer uma das seguintes
situações:
- Seu aplicativo inclui lógica de negócios. Sua lógica de negócios pode causar uma
ClassNotFoundException.
- Seu aplicativo inclui componentes customizados ou widgets
customizados.
Os componentes
ou widgets podem causar uma ClassNotFoundException.
O HATS configura automaticamente a política do carregador de classes para esses aplicativos.
Configurando os Aplicativos do HATS em um
Ambiente de Cluster
Se você implementar aplicativos da Web do HATS em um ambiente de cluster
vertical, cada instância do servidor de aplicativos criará seus próprios arquivos
para criação de log, rastreio e rastreamento de licenças. Isso é conseguido decorando-se os nomes dos arquivos de saíra com o
nome completo da instância do servidor de
aplicativos. Por exemplo, o modelo padrão para o arquivo de log é messages.txt, mas
o nome do arquivo real será algo semelhante a messages_myCell_myNode_myAppServerInstance_1.txt.
Por padrão, todas as instâncias do servidor lêem o mesmo arquivo
runtime.properties para suas definições. Para controlar corretamente as definições de tempo de execução,
você deve configurar cada instância para que ela tenha seu próprio arquivo de propriedades de
tempo de execução.
Isto permite controlar o rastreio para cada instância de forma independente e evita a alteração espontânea de configurações de tempo de execução.
Siga estas etapas para configurar cada uma das instâncias do aplicativo do HATS em cluster
verticalmente para que tenham seu próprio arquivo runtime.properties:
- Faça uma cópia do arquivo runtime.properties para cada instância
do servidor de aplicativos no cluster vertical.
- Localize o arquivo runtime.properties do seu aplicativo HATS.
Esse arquivo
deveria estar no diretório installedApps\app_name.ear
sob o diretório no qual você instalou o WebSphere Application Server.
- Para cada instância, faça uma cópia do arquivo runtime.properties,
com um nome exclusivo, no mesmo diretório. Por exemplo, você poderia
nomear os arquivos Clone1runtime.properties, Clone2runtime.properties
e assim por diante. Você pode utilizar qualquer nome de arquivo
válido, mas o nome deve ajudar o administrador a identificar a
instância do servidor de aplicativo com o qual este arquivo está
associado.
- Neste ponto, para instâncias do servidor n, você possui n arquivos
de propriedades de tempo de execução exclusivos.
- Se você tiver mais de um arquivo .ear do HATS em seu ambiente de
cluster vertical, repita essa etapa em cada diretório do arquivo .ear.
- Inclua uma nova definição de configuração para identificar o arquivo runtime.properties utilizado por
cada instância. Por exemplo,
para o WebSphere Application
Server V6.x:
- Selecione Servidores de Aplicativos no item Servidores na área de janela de navegação à esquerda do console administrativo do WebSphere
Application Server.
- Selecione a instância do servidor na lista de servidores de aplicativos.
- Selecione Gerenciamento de
Java e Processos na guia Configuração do servidor.
- Selecione Definição de Processo > Java Virtual Machine > Propriedades Customizadas.
- Na janela Propriedades Customizadas, clique em Novo.
- No campo Nome, digite hats.runtime.properties.
- No campo Valor, digite o nome do
arquivo de propriedades criado para este servidor, por exemplo,
Clone2runtime.properties. Não especifique os nomes de diretórios nem as barras neste valor.
- O campo Descrição não exige um valor.
- Clique em Aplicar.
- Repita este procedimento para cada instância do servidor.
Depois de incluir a nova propriedade customizada e assegurar que cada instância do servidor tenha sua própria cópia do arquivo runtime.properties com nome exclusivo, será necessário reiniciar cada aplicativo para começar a utilizar os novos arquivos.
O HATS console administrativo pode ser utilizado para controlar as configurações dos membros de
cluster. Utilize a pasta Introdução no painel Navegação
da página da Web Administração para selecionar o Escopo de Gerenciamento. Depois que escolher o cluster, a escolha da
visualização de Configurações de Rastreio perguntará
qual membro de cluster específico você deseja controlar.
Nota:
Existem considerações especiais para a utilização de armazenamento em cluster e de listas de usuários. Para obter informações adicionais, consulte
Armazenamento em Cluster e Listas de Usuários
Desenvolvendo Aplicativos do HATS para
Dispositivos Remotos
É possível desenvolver aplicativos da Web do HATS que podem ser
acessados por dispositivos remotos como telefones celulares,
terminais de coleta de dados e PDAs (personal digital assistants). O
processo é o mesmo para desenvolver qualquer aplicativo da Web do
HATS com algumas considerações em virtude das capacidades do
dispositivo remoto e seu navegador da Web, por exemplo, tamanho da
tela e limitações de interação.
Para criar um projeto para seu aplicativo para dispositivos
remotos, 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 dispositivo remoto.
- 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 os tempos de execução do servidor, vá para
Janela > Preferências > Servidor > Tempos
de Execução Instalados e inclua pelo menos uma definição de
tempo de execução.
- Para o campo Servidor de Destino, selecione um dos WebSphere
Application Servers suportados.
- Para o campo Projeto do Aplicativo Corporativo, insira o nome do
projeto EAR a ser usado para teste no ambiente de testes local.
- Selecione Otimizar Opções de
Dispositivos Remotos.
- Clique em Avançar e continue a
criar seu projeto normalmente.
Considerações e Limitações de Dispositivos
Remotos
Ao criar um projeto do HATS e selecionar
Otimizar Opções para Dispositivos
Remotos, o HATS inicializa o projeto com as opções que funcionam
melhor para dispositivos remotos. Algumas opções, por exemplo,
impressão, teclado, atualização assíncrona e outras opções, não são
suportadas e, portanto, estão desativadas. Tenha em mente as considerações e limitações a seguir ao desenvolver
seu aplicativo para dispositivos remotos.
- Não há uma opção automatizada que permita a conversão de um
projeto do HATS não otimizado para dispositivos remotos ou
vice-versa.
- A opção para especificar o tema de um projeto não é fornecida. Ao
invés disso, as opções são inicializadas automaticamente para
funcionarem melhor para dispositivos remotos.
- Apenas modelos otimizados para dispositivos remotos são
fornecidos para uso no projeto.
Nota:
Se não desejar utilizar a rolagem horizontal utilizando o modelo Modern, inclua overflow:
auto; em .roundedcornermodule no arquivo de modelo Modern.jsp. Por exemplo, altere .roundedcornermodule {margin: 0px;} para .roundedcornermodule { margin:
0px; overflow: auto; }. Isto força a página a manter seu tamanho original e ficar dentro da tela visual
no dispositivo. Observe que em alguns casos isto pode fazer com que os dados na página sejam truncados e, dessa forma, o
design de páginas customizadas e opções de widget devem levar em conta o tamanho da tela.
- Um segundo conjunto de renderização, denominado
compacto, é criado no projeto. O
conjunto de renderização é especificado como o conjunto de
renderização padrão. Apresenta também a opção
Usar Renderização Compacta
selecionada, que reduz a quantidade de HTML e espaço em branco na
renderização padrão, a qual, por sua vez, pode exibir uma estrutura
diferente da tela do host original.
- A preferência do HATS, Incluir uma
Tabela de Layout Livre, que entra em vigor quando uma nova
transformação em branco é criada, possui um modificador adicional,
Exceto quando o projeto é otimizado para
dispositivos remotos. Esse modificador é selecionado por padrão. Portanto, as transformações em branco incluídas em seu projeto remoto
não incluirão uma tabela de layout livre por padrão.
- Saída do Campo, Campo+ e Campo- podem ser usados através do
uso da opção Ativar Opção de
Posicionamento do Cursor em combinação com os botões Teclado do
Host ou Tecla do Host.
- O widget Campo oferece
uma opção de layout Separado para
renderizar a saída usando tags de extensão seqüencial ao invés de
usar uma tabela, para fazer a diferenciação entre campos. A meta da utilização dessa opção é reduzir a quantidade de HTML e
espaço em branco. Esse é o padrão para projetos remotos.
- O HATS oferece suporte de
Disposição de Colunas para subarquivo
e widgets de tabelas. Isso é útil ao exibir dados de tabela em um
dispositivo remoto permitindo a disposição e exclusão de colunas a
partir da exibição, bem como permitindo seções de detalhes
expansíveis, de forma que as tabelas possam se ajustar a um espaço
menor.
A seção de detalhes, quando expandida, é exibida
diretamente abaixo da linha que contém as colunas de dados primárias. Uma vez que uma linha de interesse específica é identificada pelo
usuário, os detalhes dessa linha, quando expandida, são exibidos em
um formato de fluxo para baixo da tela ao invés de pára a direita. Isso permite exibições pequenas para visualizar os detalhes
necessários de um número de colunas arbitrário sem reclassificar para rolagem vertical.
As figuras abaixo mostram um subarquivo conforme exibido em
uma tela do host, seguido por uma visualização primária do subarquivo
e uma visualização de seus detalhes usando o Suporte de Disposição de
Colunas padrão.
Figura 3. Subarquivo em uma Tela do Host
Figura 4. Visualização Primária do Subarquivo Usando o Suporte de Disposição de Colunas Padrão
Figura 5. Visualização de Detalhes da Linha do Subarquivo Usando o Suporte de Disposição de Colunas Padrão
Além de salvar o estado real da tela, é possível
configurar o widget para manter as colunas de detalhes no servidor
até que solicitado ao invés de enviá-las usando HTTP para o navegador
do usuário. Isso permite uma redução, em alguns casos, da quantidade
de dados transferidos, uma vez que dados de detalhes indesejados
nunca são enviados via HTTP para o dispositivo final.
Apenas os
detalhes especificamente solicitados pelo usuário são recuperados
on-demand e enviados para o navegador.
Nota:
Subarquivos configurados para utilizar o componente do campo para
reconhecer a parte dos dados do subarquivo não podem utilizar
efetivamente a capacidade da coluna primária e de detalhes devido ao
fato de que tais subarquivos não são capazes de distinguir colunas,
apenas linhas.
Além do subarquivo Disposição de
Colunas e das configurações do widget da tabela descritas em
Configurações de Widget, as configurações a seguir podem ser usadas
para customizar ainda mais a aparência dos controles usados para esta
opção. Essas configurações não aparecem no HATS Toolkit GUI. Ao invés
disso, inclua essas configurações na origem do widget. A origem
abaixo mostra exemplos dessas configurações usando um widget
Subarquivo como um exemplo.
<class name="com.ibm.hats.transform.widgets.SubfileWidgetV6">
<setting name="normalColumnLayout" value="1,2"/>
<setting name="extendedColumnLayout" value="3*"/>
<setting name="keepExpansionOnServer" value="true"/>
<setting name="expandHeaderValue" value="fred"/>
<setting name="expandRepresentation" value="button"/>
<setting name="expandValue" value="click me"/>
<setting name="collapseRepresentation" value="image"/>
<setting name="collapseValue"
value="/common/images/twisty1.gif"/>
<setting name="collapseAltValue" value="hide"/>
</class>
- expandRepresentation
- Determina a representação gráfica usada para o controle que
mostra os detalhes. Especifique botão,
link ou
imagem.
O padrão é
link.
- expandValue
- Se expandRepresentation for um
botão ou um
link, esse valor é usado como texto no
botão ou link. Se nenhum valor for fornecido, um sinal de mais
( +) é usado por padrão. Um valor de
cadeia vazia "" não é aceito e padroniza para o sinal de
mais (+).
Se expandRepresentation
for uma imagem, esse valor é o caminho
para e o nome do arquivo de imagem a ser usado. É executada uma procura no
caminho em relação ao diretório do Web Content do projeto. Por exemplo, se você deseja especificar o twisty1.gif no diretório
Web Content/common/images, configure expandValue como mostrado
abaixo:
<setting name="expandValue" value="/common/images/twisty1.gif "/>
- expandAltValue
- A configuração fornece texto alternativo para a imagem. É usado
apenas quando expandRepresentation
está configurado para imagem e o
navegador não pode exibir a imagem especificada, por exemplo, a opção
Menu > Visualização > Mostrar Imagens
do Internet Explorer Mobile não está selecionada.
- collapseRepresentation
- Determina a representação gráfica usada para o controle que
oculta os detalhes. Especifique botão,
link ou
imagem.
O padrão é
link.
- collapseValue
- Se collapseRepresentation for um
botão ou um
link, esse valor é usado como texto no
botão ou link. Se nenhum valor for fornecido, um sinal de menos (-) será utilizado por padrão. Um valor
de cadeia vazio "" não é aceito e o padrão é definido para um
sinal de menos (-).
Se
collapseRepresentation for uma imagem,
esse valor é o caminho para e o nome do arquivo de imagem a ser
usado. É executada uma procura no
caminho em relação ao diretório do Web Content do projeto. Por exemplo, se você deseja especificar o
twisty1.gif no diretório Web Content/common/images, configure
collapseValue como mostrado abaixo:
<setting
name="collapseValue" value="/common/images/twisty1.gif "/>
- collapseAltValue
- A configuração fornece texto alternativo para a imagem. É usado
apenas quando collapseRepresentation
está configurado para imagem e o
navegador não pode exibir a imagem especificada, por exemplo, a opção
Menu > Visualização > Mostrar Imagens
do Internet Explorer Mobile não está selecionada.
- expandHeaderValue
- Esta configuração fornece o texto de cabeçalho para a coluna
dos controles de detalhes. Um valor especificado como ""
cria um cabeçalho sem nenhum texto.
- expandStyle, expandClass, expandHeaderStyle,
expandHeaderClass, expandAreaStyle, expandAreaClass, expandRowStyle,
expandRowClass, collapseStyle, collapseClass, collapseAreaStyle,
collapseAreaClass
- Essas são substituições de classes e estilos para os controles
desta opção. Se não houver especificação, aplicam-se os valores padrão para
widgets.
Os estilos HTML padrão podem ser usados e as classes são
aplicadas na ordem.
- A configuração, Ativar opção de
posicionamento do cursor em campos de entrada, disponível para
widgets usados para renderizar campos de entrada, fornece aos
usuários um método de comutação do modo de entrada de dados para o
modo de posicionamento do cursor para campos de entrada. Quando no
modo de entrada de dados, o usuário pode inserir dados no campo de
entrada. Quando no modo de posicionamento do cursor, o usuário pode
tabular ou posicionar o cursor em qualquer caractere no campo de
entrada. Essa configuração é útil para dispositivos que não possuem
outras capacidades de posicionamento do cursor.
Além da
configurações do widget Ativar opção de
posicionamento do cursor em campos de entrada descritas em
Configurações de Widget, as configurações a seguir podem ser usadas
para customizar ainda mais a aparência dos controles usados para esta
opção. Essas configurações não aparecem no HATS Toolkit GUI. Ao invés
disso, inclua essas configurações na origem do widget. A origem
abaixo mostra exemplos dessas configurações usando um widget Campo
como um exemplo.
<class name="com.ibm.hats.transform.widgets.FieldWidget">
<setting name="dataModeCEPRepresentation" value="button"/
<setting name="dataModeCEPValue" value="back"/>
<setting name="dataModeCEPAltValue" value="data entry"/>
<setting name="cursorModeCEPRepresentation" value="image"/>
<setting name="cursorModeCEPValue" value="cursorOn.gif"/>
<setting name="cursorModeCEPAltValue" value="cursor entry"/>
<setting name="cursorCEPRepresentationStyle"
value="text-underline:true"/>
<setting name="useCursorExactPositioningOption"
value="true"/>
</class>
- dataModeCEPRepresentation
- Determina a representação gráfica usada para o controle
mostrado ao lado do campo de entrada quando no modo de dados. Especifique botão,
link ou
imagem. O padrão é
link.
- dataModeCEPValue
- Se dataModeCEPRepresentation for um
botão ou um
link, esse valor é usado como texto no
botão ou link. Se nenhum valor for fornecido, um caractere de
asterisco (*) é usado por padrão. Um
valor de cadeia vazia "" não é aceito e padroniza para o
caractere de asterisco (*).
Se
dataModeCEPRepresentation for uma
imagem, esse valor é o caminho para e
o nome do arquivo de imagem a ser usado. É executada uma procura no
caminho em relação ao diretório do Web Content do projeto. Por
exemplo, se você deseja especificar o sbarleftblk.gif no diretório
Web Content/common/images, configure dataModeCEPValue como mostrado
abaixo:
<setting name="dataModeCEPValue"
value="common/images/sbarleftblk.gif"/>
- dataModeCEPAltValue
- A configuração fornece texto alternativo para a imagem. É usado
apenas quando dataModeCEPRepresentation está configurado para
imagem e o navegador não pode exibir a
imagem especificada, por exemplo, a opção
Menu > Visualização > Mostrar Imagens
do Internet Explorer Mobile não está selecionada.
- dataModeIconClass, dataModeIconStyle
- Essas são substituições de estilo e classe para o ícone de
representação do modo de dados. Se não houver especificação, aplicam-se os valores padrão para
widgets. Os estilos HTML padrão podem ser usados e as classes são
aplicadas na ordem.
- cursorModeCEPRepresentation
- Determina a representação gráfica usada para o controle
mostrado ao lado do campo de entrada quando no modo do cursor. Especifique botão,
link ou
imagem. O padrão é
link.
- cursorModeCEPValue
- Se cursorModeCEPRepresentation for um
botão ou um
link, esse valor é usado como texto no
botão ou link. Se nenhum valor for fornecido, um caractere de
asterisco (*) é usado por padrão. Um
valor de cadeia vazia "" não é aceito e padroniza para o
caractere de asterisco (*).
Se
cursorModeCEPRepresentation for uma
imagem, esse valor é o caminho para e
o nome do arquivo de imagem a ser usado. É executada uma procura no
caminho em relação ao diretório do Web Content do projeto. Por
exemplo, se você deseja especificar o sbarrightblk.gif no diretório
Web Content/common/images, configure cursorModeCEPValue como mostrado
abaixo:
<setting name="cursorModeCEPValue"
value="common/images/sbarrightblk.gif "/>
- cursorModeCEPAltValue
- A configuração fornece texto alternativo para a imagem. É usado
apenas quando
cursorModeCEPRepresentation está
configurado para imagem e o navegador
não pode exibir a imagem especificada, por exemplo, a opção
Menu > Visualização > Mostrar Imagens
do Internet Explorer Mobile não está selecionada.
- cursorCEPRepresentationStyle
- Esse estilo é usado para ressaltar a posição do cursor
selecionada atualmente. O padrão é moldura da parte inferior: 1px de
verde sólido, mas uma cadeia vazia "" é válida.
- cursorModeCEPStyle
- Esse é o estilo usado ao redor do campo de entrada quando no
modo de cursor. O estilo padrão é moldura: 1 px sólido
#999999; altura: 1,75 em;. A alteração não é recomendada a menos
que necessária.
- cursorCEPRepresentationClass, cursorModeIconClass,
cursorModeIconStyle, cursorModeCEPClass, cursorModeCEPTextStyle,
cursorModeCEPTextClass
- Essas são substituições de classes e estilos para elementos de
decoração na área do modo de cursor. Se não houver especificação, aplicam-se os valores padrão para
widgets. Os estilos HTML padrão podem ser usados e as classes são
aplicadas na ordem.
- dataModeIconClass, dataModeIconStyle
- Essas são substituições de classes e estilos para elementos de
decoração na área do modo de dados. Se não houver especificação, aplicam-se os valores padrão para
widgets. Os estilos HTML padrão podem ser usados e as classes são
aplicadas na ordem.
- Há algumas instâncias durante uma conexão wireless em que a conexão com o roteador ou servidor HTTP é
perdida. Se isto ocorrer, a página da Web pode ser bloqueada, e o HATS não pode reenviar nenhuma informação.
As
configurações a seguir estão disponíveis para solucionar este problema. As configurações estão disponíveis na
classe RuntimeSettings na visualização de origem Configurações de Projeto (o arquivo application.hap).
- usePageUID
- Especifica se para ativar um pageUID deve ser colocado na tela ou não.
Isto permite que o tempo de
execução rastreie a página para ver se ele já foi enviado. Se este valor for false, o valor de
pageSubmitTimeout não é lido. O valor padrão é falso.
- pageSubmitTimeout
- Especifica quanto tempo esperar, em milissegundos, antes de desbloquear a página da Web para utilização
pelo usuário. Um valor de -1, ou vazio, resulta nesta função ficar inativa. O valor padrão é
-1.
- incorrectPageUIDEvent
- Especifica o que fazer quando o PageUID no pedido HTTP da
página da Web do usuário não corresponde ao PageUID que está armazenado no tempo de execução para o sessionid
e a instância do aplicativo. Ele possui duas opções: REFRESHCOMMAND ou ERROREVENT. O padrão é
REFRESHCOMMAND.
A origem abaixo mostra exemplos dessas configurações.
<class name="com.ibm.hats.common.RuntimeSettings">
<setting name="autoEraseFields" value="true"/>
<setting name="enableAutoAdvance" value="false"/>
<setting name="enableAutoTabOn" value="false"/>
<setting name="enableBusyPage" value="false"/>
<setting name="enableCompression" value="false"/>
<setting name="enableOverwriteMode" value="false"/>
<setting name="incorrectPageUIDEvent" value="REFRESHCOMMAND"/>
<setting name="pageSubmitTimeout" value="1000"/>
<setting name="selectAllOnFocus" value="false"/>
<setting name="suppressUnchangedData" value="false"/>
<setting name="usePageUID" value="true"/>
</class>
- Sondagem de AJAX a partir de um navegador em execução em um dispositivo iPhone ou iPod touch para quando se alterna do navegador para outro aplicativo.
Como resultado, quando se alterna de um navegador que acessa o HATS para outro aplicativo no dispositivo, o HATS desconecta a sessão do navegador após o intervalo Tempo de espera para desconectar (segundos) passar. Você pode desejar aumentar este intervalo ou desativar a função autodesconectar para aplicativos HATS acessados a partir de dispositivos iPhone ou iPod touch. Para obter
informações adicionais, consulte Utilizando o Método Pull do Cliente (AJAX).
- Para considerações sobre DBCS, consulte
Trabalhando com Aplicativos de
Dispositivos Remotos.
Além das opções que o HATS desativa automaticamente, as seguintes
funções não são suportadas e não devem ser implementadas nos
aplicativos do HATS para dispositivos remotos:
- Os projetos da Web do HATS não podem ser migrados ou automaticamente convertidos em projetos da Web do
HATS para dispositivos remotos.
- Aplicativos do Rich client.
- Aplicativos de Portal (Padrão ou IBM®).
- Interoperabilidade com WebFacing.
- Suporte de linguagem Bidirecional.
- Recursos de Acessibilidade.
- Qualquer dispositivo com tamanhos de tela menores do
que 320x240.
- Suporte de teclas do host do teclado.
Como resultado,
utilizar um teclado funciona com um teclado da Web normal, as teclas
de host não são enviadas; ao invés disso, a tecla F1 ativa a ajuda do
navegador e a tecla Enter não está mapeada para a tecla Enter do
host.
Além disso, sem o suporte de teclado, o HATS JavaScript™ não pode determinar que o usuário tenha inserido dados na página da Web do HATS. Como resultado, o suporte de
atualização automática sobrescreve quaisquer dados que o usuário tenha inserido
na visualização da GUI do aplicativo do HATS se uma nova tela de host for
recebida de maneira assíncrona do aplicativo de host.
- Ajuda específica do campo, justificar à direita, letra
maiúscula ou outros atributos.
- Quaisquer outras limitações de entrada de dados inerentes ao
hardware e software do dispositivo.
- Acesso à página do console administrativo do HATS
através de um dispositivo remoto.
- O parâmetro de conexão disconnectOnClose.
- Combinações de telas.
- Suporte de tabulação da pasta.
- Suporte de planilhas.