Utilizando Gabaritos

Os modelos permitem que você controle ainda mais a aparência de seu aplicativo do HATS customizando um modelo para corresponder ao estilo de seu Web site corporativo ou aplicativos ou outras diretrizes. Um modelo é um arquivo JSP em projetos da Web do HATS ou uma classe composta SWT Java™ em projetos do rich client do HATS. Os modelos possuem uma área reservada para a tela do host que é renderizada por uma transformação do HATS. Eles podem conter logotipos e informações sobre a empresa e, no caso de modelos da Web do HATS, links para outras páginas da Web. Um gabarito também define a cor do plano de fundo, imagem, ou ambos, para áreas em que aparece a tela do host transformada.

Ativar o assistente de modelos permitirá que você crie um modelo em branco ou um modelo baseado em um dos modelos fornecidos com o HATS. Para projetos da Web do HATS, também é possível basear um modelo em uma página da Web (URL ou arquivo). Você pode querer importar uma página da Web existente como um modelo baseado no Web site da sua empresa. Para projetos rich client do HATS, é possível importar um modelo como um arquivo de origem Java de outro projeto copiando o arquivo de origem no projeto ou utilizando o assistente de importação do Eclipse.

O HATS fornece modelos que você pode utilizar em seus projetos. Você pode ver os nomes destes modelos expandindo a pasta Conteúdo da Web  Apenas Web  ou Rich Client Content  Apenas RCP  e, em seguida, selecionando a pasta Modelos na visualização HATS Projetos. Os modelos fornecidos incluem algumas ou todas as seguintes definições:

Notas:
  1. Modelos fornecidos recentemente são marcados com um asterisco na guia Modelo do editor de Configurações do Projeto.
  2. Ao criar um projeto do HATS e selecionar Otimizar Opções para Dispositivos Remotos, apenas modelos otimizados para dispositivos remotos são fornecidos para uso no projeto.

Exemplos de Modelo

Esta seção descreve alguns dos modelos fornecidos com o HATS.

Figura 60 mostra uma tela do host utilizando o modelo finance.jsp que é fornecido para uso pelos aplicativos da Web do HATS. Este modelo fornece um exemplo que utiliza menus suspensos com links para outros Web sites, junto com o teclado numérico do aplicativo na parte inferior.

Figura 60. Modelo de Finanças do Aplicativo da Web Fornecido pelo HATS
Modelo de finanças do aplicativo da Web fornecido pelo HATS

Figura 61 mostra uma tela do host utilizando o modelo industry.jsp que é fornecido para uso pelos aplicativos da Web do HATS. Este modelo fornece um exemplo que utiliza links da barra de menus para outros Web sites junto com o teclado numérico do aplicativo na parte inferior.

Figura 61. Modelo do Segmento de Mercado do Aplicativo da Web Fornecido pelo HATS
Modelo do segmento de mercado do aplicativo da Web fornecido pelo HATS

Figura 62 mostra uma tela do host utilizando o modelo modern.java que é fornecido para uso pelos aplicativos rich client do HATS. Este modelo é mais simples, com apenas uma barra lateral, com base na suposição de que o ambiente de tempo de execução (por exemplo, Eclipse RCP, Lotus Notes ou Lotus Expeditor) fornecerá a aparência comum geral, incluindo botões, links e assim por diante.

Figura 62. Modelo Moderno do Aplicativo rich client Fornecido pelo HATS
Modelo moderno do aplicativo rich client fornecido pelo HATS

Você pode fazer cópias de recursos do HATS na visualização Projetos HATS abrindo qualquer pasta e clicando com o botão direito no recurso e selecionando Copiar. Escolha a pasta na qual deseja Colar o recurso e o HATS solicitará um nome. Isso pode ser útil como backup quando você começar a criar seus próprios modelos.

Nota:
Você não pode copiar a partir da visualização Projetos HATS para a visualização Navegador.

Quando você criar seu projeto no HATS Toolkit, selecione um modelo para utilizar como o modelo padrão para seu projeto. Este modelo é mostrado na visualização Projetos HATS com um ícone diferente e a palavra padrão próxima a ele. É possível alterar o modelo padrão indo para a visualização Projetos HATS e clicando com o botão direito do mouse em um modelo localizado em Conteúdo da Web/Modelos  Apenas Web  ou Conteúdo do Rich Client/Modelo  Apenas RCP , e selecionando Configurar como Modelo Padrão. Outra maneira é dando um clique duplo nas Configurações do Projeto de seu projeto HATS na visualização Projetos HATS. Vá para a guia Modelo e faça sua seleção para a lista.

Quando criar customizações de telas e a ação for aplicar uma transformação ou mostrar URL, será possível selecionar o modelo a ser utilizado quando a transformação for aplicada. Para fazer seu aplicativo do host consistente com todas as telas, você pode usar o mesmo modelo para sua transformação que você selecionou para o modelo padrão de seu projeto. Para fazer isto, selecione o modelo que deseja utilizar como o modelo padrão para este projeto.

Assistente para Criar um Modelo

Você pode criar seus próprios modelos personalizados para atender às necessidades funcionais e incorporar orientações de estilo. Você pode projetar modelos personalizados para seus projetos utilizando assistentes e editores no HATS Toolkit. O HATS inclui automaticamente o código necessário para incluir cor e fontes, o teclado numérico de aplicativo padrão do HATS e uma área para a tela do host renderizada com uma transformação em qualquer modelo criado.

Utilize o assistente Criar um Modelo para criar um novo modelo. É possível acessar o assistente de várias maneiras, como:

No assistente, especifique o projeto e dê um nome ao seu modelo. Se o modelo for para um projeto do rich client, o campo Pacote será preenchido com um nome de pacote padrão, conforme determinado pelas preferências do HATS de pacotes Java Padrão. Consulte Utilizando Preferências do HATS para obter informações adicionais. Você pode utilizar o botão Procurar para localizar e selecionar um pacote diferente. Opcionalmente, configure uma descrição para seu modelo, em seguida, clique em Avançar e selecione uma das seguintes opções:

Criar um modelo em branco

Selecione esta opção para criar um modelo em branco.

Preencher o modelo a partir de um modelo de projeto existente

Selecione esta opção para preencher o novo modelo a partir de um modelo existente. Selecione o nome de um modelo existente. O que você está realmente fazendo é copiando um modelo existente utilizando o nome especificado quando você iniciou o assistente Criar um Modelo. Uma visualização do modelo selecionado aparece na janela abaixo.

Preencher o modelo a partir de uma página da Web existente (URL ou arquivo)  Apenas Web 

Selecione esta opção para preencher o novo modelo a partir de uma página da Web existente (tal como seu Web site existente da empresa) ou um arquivo específico. Digite uma URL ou arquivo na caixa de texto ou clique no botão Procurar para procurar um. Clicando em Visualizar será exibido o modelo que você selecionou.

A página da Web, bem como os arquivos vinculados (por exemplo, imagens, folhas de estilo) serão transferidos por download a partir da Web. Os links para os arquivos serão alterados para corresponder ao caminho correspondente em seu projeto do HATS.

Nota:
Customizar JavaScript™, applets etc. eventualmente incorporados em uma página da Web importada pode causar dificuldades. Se seu Web site tiver tags complexas, elas precisam ser modificadas para que seu modelo funcione com o HATS. O assistente Criar um Modelo faz download da página, todas as imagens e folhas de estilo, mas não faz qualquer tentativa de filtrar chamadas de JavaScript possivelmente não suportadas. As páginas da Web que utilizam quadros não são suportadas

Para tornar seu novo modelo o modelo padrão para o projeto, selecione a caixa de opções Configurar como o modelo padrão para este projeto.

Clique em Concluir. Isto ativará o editor apropriado onde é possível fazer alterações e modificações em seu novo modelo.

Lembre-se sempre de que todas as alterações que fizer nos objetos em um projeto afetam apenas esse projeto. Se desejar utilizar o modelo que criou para outros projetos, precisará copiar esse modelo para quaisquer projetos novos que criar, juntamente com todas as páginas de estilo ou imagens que foram modificadas.

Para projetos da Web do HATS, se você criar seu próprio modelo fora do ambiente do HATS Toolkit, assegure que as seguintes instruções sejam incluídas:

<LINK rel="stylesheet" href="xxx">
Uma ou mais tags que se referem a uma folha de estilo que define cada uma das seguintes configurações:
<HATS:Transform>
Esta tag define a localização da transformação que circunda o modelo.

Editando Modelos

Os modelos nos projetos da Web do HATS são arquivos JSP e, por padrão, são editados utilizando o Designer de Páginas. Os modelos nos projetos rich client do HATS são compostos SWT Java e, por padrão, supondo que o recurso do editor de aplicativos do cliente Java (VE) está instalado com o Rational SDP, são editados utilizando o Editor Visual.

Editando Modelos para Projetos da Web

Você pode ver todos os modelos, os fornecidos pelo HATS e os que você criou, expandindo a pasta Modelos no Conteúdo da Web na visualização Projetos HATS. Para editar um modelo utilizando o Designer de Páginas construído no Rational SDP, dê um clique duplo no nome do modelo. Para ver outros editores disponíveis, clique com o botão direito no nome do modelo e selecione Abrir Com. Consulte a documentação do Rational SDP para o Designer de Páginas selecionando Ajuda > Conteúdo da Ajuda na barra de menus e procure por Page Designer.

As seguintes restrições se aplicam aos modelos de edição:

As seguintes seções descrevem cada guia do Designer de Páginas.

Design

A guia Design do Designer de Páginas exibe a visualização atual do modelo conforme você faz alterações nele. Enquanto estiver nesta guia, as opções de edição adicionais estarão disponíveis na barra de ferramentas do Rational SDP. Por exemplo, você pode utilizar o menu suspenso Inserir na barra de ferramentas para inserir coisas tais como imagens, fotografias, texto e controles de formatação de texto ou pode arrastar componentes do HATS da Paleta. Você pode incluir músicas que tocam quando o modelo é exibido, criar quadros de layout e inserir tags de HTML.

Você também pode inserir variáveis globais, teclas de macro, teclados numéricos do host e do aplicativo ou teclas individuais. Você pode inserir estes itens utilizando o menu Ferramentas do HATS na barra de menus do HATS Toolkit.

Se desejar incluir imagens em seu projeto, deve importá-las no diretório Web Content/Common/Images de seu projeto. Para importar imagens, clique em Arquivo > Importação > Geral > Sistema de Arquivos para abrir o assistente de Importação. Selecione a localização dos arquivos-fonte da imagem que deseja importar no campo De Diretório. Selecione o diretório project_name/Web Content/common/images como destino Para a Pasta. Quando os arquivos-fonte da imagem são importados, clique com o botão direito na pasta Imagens, selecione Mostrar Miniaturas na guia Miniaturas na janela inferior para ver as imagens na pasta. Você pode usar o método arrastar e soltar para copiar as imagens dentro da guia Design de seu modelo.

Nota:
Se você incluir caracteres GB18030 em um modelo, poderá visualizá-los corretamente nas guias Visualizar e Origem, mas eles poderão não aparecer corretamente na visualização Design do editor de modelo. Se esses caracteres não aparecerem corretamente na exibição Design, você pode incluir SimSun-18030 para a família de fontes. Para modificar a família da fonte utilizada na visualização Design, clique em Janela > Preferências > Web > Page Design > Fontes.

Quando clicar em Inserir Componente do Host, Inserir Macro ou Inserir Variável Global no menu Ferramentas do HATS, aparece um assistente no qual você pode definir esses itens, como faz nas transformações. Consulte Inserir Componente do Host, Inserir Chave de Macro e Inserir Variável Global para obter informações adicionais sobre esses assistentes.

Utilizando Folhas de Estilo

Uma Cascading Style Sheet é um arquivo que define um conjunto hierárquico de regras de estilo para controlar o processamento de HTML. Permite controlar elementos de saída, como cor da fonte, tamanho e cor do plano de fundo, para manter a consistência da área da tela processada pelo HATS com o estilo do modelo.

Modificando Folhas de Estilo

O HATS fornece folhas de estilo para modificar esquemas de cores e tamanho da fonte. Pelo menos uma destas folhas de estilo é aplicada ao modelo. Durante a visualização do modelo na guia Design, é possível aplicar estas folhas de estilo a seu modelo.

Ao acessar a pasta Web Content/Common/Stylesheets na visualização Projetos HATS, é possível então clicar duas vezes na folha de estilo que deseja editar. Por padrão, isto abre a folha de estilo na janela do editor CSS Designer junto com uma janela de visualização que exibe amostra dos estilos na folha de estilo.

Ao clicar em um estilo particular na janela do editor CSS Designer, uma amostra do estilo será exibida na janela de visualização.

Determinando Quais Estilos Editar

É comum desejar alterar a cor de um campo em uma tela do host. O desafio é saber qual estilo está sendo aplicado a esse campo do host específico. Para determinar isso, é possível visualizar a origem da página da Web quando o campo do host for exibido e, examinando a origem, é possível determinar qual estilo está sendo aplicado.

Suponha que você deseja alterar o texto que está sendo utilizado para o texto Usuário e Senha na tela Conectar-se de um projeto do HATS. Para visualizar a origem da página da Web, execute o projeto do HATS em um navegador da Web real até que possa ver o campo em questão. Não utilize o navegador da Web integrado no Rational SDP (você pode executar o projeto HATS no servidor de teste no Rational SDP, mas é necessário acessar o projeto utilizando o Internet Explorer).

Quando o campo em questão estiver visível, clique em Visualizar na barra de menus do navegador e, em seguida, clique em Origem no menu suspenso.

Procure no arquivo de texto o texto que está no campo ou próximo ao campo que deseja modificar, neste caso, Usuário. Logo antes do texto na origem, você localizará uma instrução CLASS=. Esta instrução fornece a CLASSE ou estilo que está sendo aplicado ao texto. Você pode então ir para o modelo ou folha de estilo e editar o estilo para obter o efeito desejado.

Esta alteração no estilo será aplicada em todo o aplicativo do HATS, no qual este estilo foi utilizado. Se você criar um aplicativo padrão, em que o modelo padrão é aplicado a cada tela do host, este estilo será utilizado em cada tela. Se você desejar ter um estilo aplicado a apenas uma tela do host, deverá criar um modelo que seja aplicado a essa tela do host específica.

Para obter informações adicionais sobre folhas de estilo em cascata, vá para http://www.w3.org/Style/CSS/.

Folha de Estilo do HATS

As folhas de estilo a seguir são fornecidas com o HATS e são incluídas em cada novo projeto criado.

Tabela 3. Folhas de Estilo do HATS
Nome Descrição
blacktheme Plano de fundo preto, a cor do primeiro plano corresponde à cor da tela do host.
calendar Estilos de pop-up de Calendário
commontheme Define elementos comuns a todas as folhas de estilo. É importado pela folha de estilo principal (blacktheme, graytheme, monochrometheme, tantheme, whitetheme)
finance Folha de estilo para o modelo Finance.jsp
graytheme Plano de fundo cinza, as cores do primeiro plano são diferentes das matizes de cinza.
industry Folha de estilo para o modelo Industry.jsp
inlineCalendar Folha de estilo para a opção inlineCalendar do widget de Calendário
largeFont Tamanho da fonte de toda saída gerada referente à sua configuração de navegador e função de classe
monochrometheme Plano de fundo branco; as cores de primeiro plano são diferentes tons de cinza, os links são azuis
nonFixedFont Plano de fundo branco; o tamanho da fonte varia
normalFont Tamanho da fonte de toda saída gerada referente à sua configuração de navegador e função de classe
PrintJobWindow Estilos da janela da tarefa de impressão
reverseVideoBlack Reverte as cores do primeiro plano e do plano de fundo da folha de estilo blacktheme
reverseVideoGray Reverte as cores do primeiro plano e do plano de fundo da folha de estilo graytheme
reverseVideoMono Reverte as cores do primeiro plano e do plano de fundo da folha de estilo monochrometheme
reverseVideoTan Reverte as cores do primeiro plano e do plano de fundo da folha de estilo tantheme
reverseVideoWhite Reverte as cores do primeiro plano e do plano de fundo da folha de estilo whitetheme
scaleableFont Tamanho da fonte de toda saída gerada escalado de acordo com o navegador.
slickWhiteBackground Segundo plano branco; utilizado com os modelos SlickMonoGray e Eagle
smallFont Tamanho da fonte de toda saída gerada referente à sua configuração de navegador e função de classe
tantheme Plano de fundo Tan; as cores de primeiro plano são matizes diferentes de cinza e azul.
whitetheme Plano de fundo branco; a cor de primeiro plano corresponde à cor da tela do host.
xlargeFont Tamanho da fonte de toda saída gerada referente à sua configuração de navegador e função de classe
xsmallFont Tamanho da fonte de toda saída gerada referente à sua configuração de navegador e função de classe

Origem

A guia Origem exibe as tags de HTML e JSP no arquivo JSP para todas as partes do modelo. Conforme você faz alterações em outras guias no Designer de Páginas, as tags e atributos exibidos no arquivo de origem são alterados para correspondência.

Você também pode fazer alterações nas tags e atributos no arquivo de origem e elas serão refletidas nas outras guias do Designer de Páginas.

Dividir

A guia Dividir mostra as visualizações Design e Origem juntas.

Visualizar

A guia Visualizar fornece uma visualização do navegador da transformação mostrando o conteúdo HTML estático renderizando tags <HATS:Component > (e todas as tags <HATS:xxxx>). Isto é semelhante à guia Design, mas você não pode fazer alterações nesta guia. Essa visualização não inclui as transformações.

Nota:
As configurações de visualização são herdadas por meio do navegador. A acessibilidade às visualizações está limitada à acessibilidade da página que está sendo visualizada por meio do navegador. A visualização não funcionará para nada que seja dinâmico. Ou seja, se ela for dependente da execução de JavaScript ou de funções disponíveis apenas no tempo de execução, não será exibida.

Disponibilizando Modelos, Folhas de Estilo e Imagens Personalizados

O HATS permite compartilhar modelos, folhas de estilo e imagens personalizados.

Após copiar estes arquivos, na próxima vez que você criar um novo projeto, poderá selecionar os novos modelos, folhas de estilo ou imagens.

Editando Modelos para Projetos do Rich Client

Um modelo de rich client do HATS é uma classe de SWT composto do Java que implementa uma interface Java específica. Essa interface permite que o HATS detecte e utilize arquivos de origem Java que devem ser utilizados como modelos do HATS no ambiente do rich client. Os modelos do rich client do HATS são muito básicos com um cabeçalho ou barra lateral simples e nenhum rodapé. Isto ocorre porque supõe-se que o ambiente de tempo de execução (por exemplo, Eclipse RCP, Lotus Notes ou Lotus Expeditor) fornecerá a aparência comum geral, bem como áreas para botões comuns, links e assim por diante.

Um modelo não pode conter componentes de host (compostos ComponentRendering), compostos de renderização padrão ou controles de variável global, embora uma transformação possa contê-los.

Você pode ver todos os modelos, os fornecidos pelo HATS e os que você criou expandindo a pasta Modelos em Conteúdo do Rich Client na visualização Projetos HATS.

Para editar um modelo utilizando o editor padrão, clique duas vezes no nome do modelo. Para visualizar os editores disponíveis, clique com o botão direito do mouse no nome do modelo e selecione Abrir com.

Assumindo que o recurso do editor de aplicativos do cliente Java (VE) esteja instalado com o Rational SDP, é possível utilizar o Editor Visual para editar seus modelos. Além das informações nesta seção, consulte o capítulo, Templates na publicação HATS Rich Client Platform Programmer's Guide. Além disso, consulte o Centro de Informações para o seu produto Rational SDP. Por exemplo, consulte http://publib.boulder.ibm.com/infocenter/radhelp/v7r5/index.jsp e procure editor visual.

Duas áreas do Editor Visual incluem a visualização Design, geralmente exibida como a área superior, e a visualização Origem, geralmente exibida como a área inferior. Um item, tal como uma imagem, é incluído no modelo utilizando controles disponíveis na visualização Paleta.

Por exemplo, para incluir uma imagem em seu modelo, siga estas etapas:

  1. Na barra de menus do Rational SDP, selecione Arquivo > Importação > Geral > Sistema de Arquivos para abrir o assistente de Importação.
  2. Utilize o botão Procurar próximo ao campo A partir do diretório para localizar e selecionar uma imagem para importação em seu projeto.
  3. Utilize o botão Procurar próximo ao campo Na pasta para selecionar a pasta \src\images em seu projeto.
  4. Clique em Concluir.
  5. Na visualização Projetos HATS, clique com o botão direito em seu projeto e selecione Atualizar.
  6. Abra seu modelo no Editor Visual e, a partir da visualização Paleta em Controles de SWT, clique em Etiqueta.
  7. Aponte o mouse para o local onde deseja colocar a imagem na visualização Design para o modelo e clique.
  8. No diálogo Nome, forneça um nome ou utilize o padrão fornecido e clique em OK.
  9. Selecione a etiqueta que acabou de incluir no modelo e, na visualização Propriedades, geralmente exibida abaixo da visualização de origem do Editor Visual, selecione a propriedade text e limpe a legenda da etiqueta.
  10. Na visualização Propriedades, selecione a propriedade image e clique no botão exibido na margem direita da coluna Valor.
  11. No diálogo Selecionar um Arquivo de Imagem, em Procurar em selecione Projeto, em Local expanda sua pasta src e clique na pasta imagens, em Arquivos, selecione a imagem importada, clique em OK.
    Nota:
    Nesta etapa, certifique-se de que em Procurar em você selecionou Projeto e, em seguida, selecione um local em seu projeto. Se, em vez disso, você selecionar Sistema de Arquivo e, em seguida, selecionar um local em seu sistema de arquivo, seu projeto não será executado corretamente quando implementado em outro sistema.

Se você utilizar o Editor Visual para incluir manualmente recursos de fonte, imagem ou cor nas transformações ou modelos do HATS, também deverá incluir manualmente o código para limpar estes recursos. Para obter informações adicionais, consulte Considerações e Limitações do Rich Client do HATS.

Teclado Numérico do Aplicativo

O teclado numérico do aplicativo contém teclas (como Atualizar, Padrão e Visualizar Tarefas de Impressão) que representam funções de nível do aplicativo. Estas teclas controlam funções dentro do aplicativo do HATS. As teclas do teclado numérico do aplicativo incluem:

Ativar/Desativar o Teclado
Comuta o suporte para utilização das teclas físicas no teclado do host. Se o suporte de teclado não estiver ativado para o projeto, este botão não aparecerá no teclado do aplicativo. Para obter informações adicionais, consulte Ativando o Suporte do Teclado.
Redefinir
Limpa todos os campos na página do navegador de qualquer entrada feita pelo usuário.
Desconexão
Desconecta da sessão do host. Se essa tecla for clicada, aparecerá um link para permitir que o usuário se reconecte ao host.
Tela Reversa (se aplicável)
Comuta a imagem na tela de uma imagem da esquerda para a direita para uma da direita para a esquerda e vice-versa, se o aplicativo estiver em execução em um host com uma página de código de arábica ou hebraico. Se uma página de código em árabe ou hebraico não estiver selecionada nas configurações de conexão do projeto, esse botão não aparecerá no teclado numérico do aplicativo.
Padrão
Desativa qualquer customização da tela do host feita por uma transformação e apresenta a tela do host inteira como HTML básico. A tecla Padrão pode ser modificada selecionando um modelo ou folha de estilo diferente para a transformação.
Atualizar
Atualiza a atual tela do navegador e executa a ação atual novamente.
Visualizar Tarefas de Impressão (se aplicável)
Mostra uma lista de tarefas de impressão que o usuário criou. Se o suporte de impressão não estiver ativado para o projeto, este botão não aparecerá no teclado numérico do aplicativo.

Por padrão, o HATS exibe o teclado numérico do aplicativo. Para ocultar o teclado numérico, vá para a visualização Projetos HATS, dê um clique duplo nas Configurações do Projeto de seu projeto HATS, selecione a guia Renderização e clique no Teclado Numérico do Aplicativo. Você terá, então, a opção de limpar a caixa de opções para ocultar o teclado numérico.

Nota:
Os teclados numéricos customizados e as teclas individuais são definidos com a utilização de tags individuais ou compostas e, como resultado, eles são exibidos no editor do modelo mesmo que o teclado numérico esteja desativado em suas configurações de projeto.

Consulte o Modificando um Projeto do HATS para obter informações adicionais sobre as configurações do suporte de teclado e teclado numérico.