Quando você cria um projeto utilizando o assistente para Criar um Projeto do HATS, as configurações escolhidas no assistente são salvas em um arquivo de aplicativo do projeto (.hap). É possível chamar o editor de projeto dando um clique duplo em Configurações do Projeto sob o nome do projeto que você deseja modificar na visualização Projetos do HATS.
As configurações exibidas no editor de projeto são as configurações que são utilizadas para o projeto inteiro. Se você deseja modificar qualquer uma das definições, poderá utilizar as guias do editor de projeto. As alterações salvas feitas no editor de projeto são automaticamente reconhecidas ao executar seu projeto em um ambiente de teste clicando em Atualizar no teclado numérico do aplicativo ou exibindo uma nova tela do host na GUI. Atualizar não selecionará as alterações feitas nos arquivos de conexão (.hco). As alterações na definição da conexão são aplicadas quando o servidor de aplicativos (ou aplicativo) é reiniciado.
As seções a seguir descrevem cada guia do editor de projeto e explica como podem ser utilizadas para modificar as configurações do projeto.
A guia Visão Geral do editor de projeto resume todas as configurações que você especificou quando criou seu projeto.
A seção Informações Gerais contém o nome e a descrição do projeto, o modelo e o tema escolhidos e a data da última modificação.
Clique no link do tema atual para alterar o tema do projeto. Quatro opções são fornecidas: Padrão, Aplicativo da Web Moderno Apenas Web ou Aplicativo da UI Moderno Apenas RCP , Emulador de Terminal Clássico e Customizado. Cada função na lista de configurações pode ser ativada em qualquer local nas configurações do projeto. Esta lista fornece um método conveniente de configurar as funções em um local que, juntas, podem ser tratadas como um tema para a aparência e o comportamento de seu aplicativo.
A tabela a seguir mostra como cada configuração de tema é mapeada para uma configuração de projeto individual.
| Configuração de Tema | Guia Editor de Projeto | Configuração de Projeto |
|---|---|---|
| Navegação de tecla de seta Apenas RCP | Outro | Configurações do Cliente > Ativar navegação de tecla de seta |
| Avanço automático de campo | Outros | Configurações de cliente > Ativar avanço automático de campo |
| Posicionamento do cursor em campos protegidos | Processamento | Widgets > Campo > Permitir o posicionamento do cursor em campos protegidos |
| Atributos estendidos de campo | Processamento | Widgets > Campo > Ativar atributos estendidos |
| Teclado numérico do host | Processamento | Teclado Numérico do host > Mostrar teclado numérico do host padrão |
| Suporte do teclado | Outros | Suporte ao teclado > Ativar suporte ao teclado |
| Área de informações do operador | Processamento | Área de informações do operador > Mostrar OIA |
| Modo Sobrescrever (inicial) | Outros | Configurações de cliente > Modo Sobrescrever (inicial) |
| Renderização utilizando a fonte monoespaçada | Processamento | Widgets > Campo > Renderizar utilizando fonte monoespaçada |
O tema Padrão permite as funções que são ativadas por padrão quando um projeto do HATS é criado pela primeira vez. A seleção do tema Moderno desmarca todas as funções individuais. A seleção do tema Clássico seleciona todas as funções. A seleção do tema Customizado permite selecionar qualquer outra combinação de funções.
A seção Teste contém links que podem ser utilizados para testar seu projeto. Para projetos da Web do HATS, os links são:
Para projetos de portlet do HATS, os links são:
Para projetos de rich client do HATS, os links são:
A seção Implementação Apenas RCP inclui uma lista suspensa Plataforma de Destino. Utilize esta lista suspensa para alterar a implementação de destino de seu projeto do rich client. Isto permite iniciar a construção de um aplicativo destinado a uma plataforma e alternar para uma plataforma diferente posteriormente. As plataformas suportadas são Eclipse Rich Client Platform, Lotus Expeditor Client for Desktop e Lotus Notes.
Se você alterar a plataforma de destino aqui e ela não corresponder à plataforma de destino na área de trabalho, uma mensagem será exibida informando sobre isto. A ação a tomar neste caso depende de qual plataforma você alterou para este projeto. Se a plataforma for Lotus Expeditor Client ou Lotus Notes, na barra de menus do Rational SDP, selecione Janela > Preferências > Serviços do Cliente e clique no botão Configurar. Na janela Configuração do do Lotus Expeditor Toolkit, você pode selecionar o destino na lista suspensa Ambiente de Teste. Se a plataforma for Eclipse Rich Client Platform, selecione Janela > Preferências > Desenvolvimento de Plug-in > Plataforma de Destino e selecione seu diretório de instalação do Rational SDP (o padrão é C:\Arquivos de Programas\IBM\SDP) na lista suspensa Local. Quando solicitado a recarregar a plataforma de destino, selecione Sim.
Também na seção Implementação há um link, abrir o manifesto de plug-ins, que ativa o editor para o descrito de plug-in (plugin.xml) do projeto. A implementação avançada de rich client exigirá modificações para este arquivo.
As seções Conexões, Configurações de Renderização e Outras Configurações resumem as configurações especificadas em cada uma de suas guias correspondentes. Os próprios títulos são links para sua guias correspondentes que são descritas nas seções a seguir.
A guia Conexões exibe as informações sobre as conexões do projeto. Há dois tipos de conexões no HATS, padrão (também denominada transformação) e plano de fundo. Cada aplicativo HATS possui uma conexão padrão para o aplicativo host cujas telas o HATS transformará. As conexões secundárias são quaisquer conexões em um projeto que não a conexão padrão. O HATS não transforma telas de conexões em segundo plano. Para obter informações adicionais, consulte o Gerenciando as Conexões.
É possível selecionar a conexão do host padrão a partir da lista suspensa Padrão.
Também existe uma tabela de lista que exibe todas as conexões do projeto. A lista exibe o nome da conexão, o host, o tipo de host, o número da porta e a página de códigos. É possível incluir conexões adicionais do projeto, clicando no botão Incluir que ativa o assistente para Criar uma Conexão. O HATS permite especificar mais de uma conexão que pode ser utilizada para seu projeto. Para obter informações sobre o uso do assistente, consulte Criando uma Conexão.
Para editar uma conexão existente, selecione a conexão e clique em Editar para ativar o editor de conexão. Para obter informações adicionais, consulte Editor de Conexão.
O botão Remover excluirá a conexão destacada. Se você clicar em Atualizar, a lista será atualizada.
A guia Modelo exibe o modelo utilizado em uma transformação.
Nessa guia, será possível alterar qual modelo utilizar como o modelo padrão. Ele será utilizado para todas as telas em seu aplicativo, a menos que você especifique um modelo diferente para uma tela específica, utilizando uma ação em uma customização de tela.
O modelo padrão é o modelo aplicado a todas as transformações no projeto e o modelo aplicado com a transformação padrão como a ação padrão de um evento de tela não correspondido. Para obter informações sobre como modificar a ação do evento de tela não correspondido, consulte Eventos do Aplicativo.
Ao criar ou modificar as ações de uma customização de tela, é possível substituir o modelo padrão escolhido, selecionando um modelo diferente. Também é possível editar o modelo enquanto você está na guia Modelo.
Você pode criar seus próprios modelos para serem utilizados para os projetos do HATS. Para obter informações adicionais, consulte Assistente para Criar um Modelo.
A guia Renderização exibe as configurações para a renderização padrão, as regras globais, a substituição do texto, os componentes, os widgets, a barra de ferramentas Apenas RCP , o teclado numérico de aplicativos, o teclado numérico do host e a área de informações do operador. Esse é o local onde você pode configurar os valores padrão de nível de projeto para o seu projeto do HATS.
A renderização padrão é responsável por transformar as telas de host que não foram transformadas individualmente. O conjunto de renderização padrão selecionado tenta preservar a estrutura da tela do host original enquanto estende a funcionalidade do aplicativo, aplicando princípios de design da GUI. Ou seja, ele faz mais do que renderizar campos não protegidos da tela de host como campos de entrada da GUI; ele pode transformar as teclas de função em botões ou links, as listas de seleção em suspensas e as regiões tabulares em tabelas.
Um conjunto de renderização é configurado criando uma lista priorizada de itens de renderização. Cada item de exibição define uma região específica na qual um componente host especificado é reconhecido e, então, exibido utilizando um determinado widget. Por exemplo, você pode procurar por teclas de função na região do botão da tela de host e então processá-las como links.
Você pode criar mais de um conjunto de processamento para sua transformação padrão. Se você criar conjuntos de processamento adicionais, apenas um será utilizado na transformação padrão. Para criar um novo conjunto, clique no botão Incluir para abrir a janela Incluir Conjuntos de Renderização. Especifique um Nome e Descrição (opcional) exclusivos para seu novo conjunto de processamento.
Se desejar que o novo conjunto de renderização seja o padrão, selecione a caixa de opções Utilizar este conjunto de renderização para renderização padrão.
Um conjunto de renderização pode ser vazio (sem itens de renderização definidos) selecionando o botão Criar Conjunto de Renderização Vazio ou você pode selecionar um conjunto a partir do menu suspenso Copiar Novo Conjunto de Renderização do Conjunto Existente. Os conjuntos de processamento também podem ser modificados ou excluídos, selecionando os botões Editar ou Remover ao lado de sua lista.
A lista a seguir de itens de renderização é definida como parte do conjunto de renderização padrão:
Você pode incluir um novo item de processamento no conjunto de processamento selecionado para todas as telas neste projeto, bem como editar ou remover itens de processamento existentes, selecionando o item a ser editado ou removido e selecionar o botão apropriado à direita da tabela.
Se você selecionar os botões Incluir ou Editar, insira um nome e uma descrição para o item de renderização. Em seguida, defina a região da tela na qual seu item de renderização será aplicado e designe o componente host a ser utilizado para reconhecimento e o widget a ser utilizado para renderização. Também é possível alterar a ordem na qual os itens de processamento são aplicados, selecionar um item na lista e clicar nos botões Para Cima ou Para Baixo para movê-lo para cima ou para baixo na lista. Consulte Inserir Componente do Host ou Editar Componente do Host Apenas Web para obter mais detalhes sobre os últimos dois painéis do assistente.
A lista de itens de renderização que compõem o conjunto de renderização é uma lista ordenada. O processamento da lista é importante porque cada item de processamento pode consumir uma parte da tela de host que outro item mais aprofundado na lista também pode ter reconhecido. Quanto mais alto o item de processamento na lista, maior será a prioridade. A caixa de opções junto a cada item de processamento é utilizada para ativar ou desativar a seleção.
Os componentes nem sempre consomem a região inteira que você especifica. Imagine que você tenha configurado o componente da lista de seleção para procurar pelas listas de seleção na tela inteira, mas apenas uma lista tenha sido encontrada no meio da tela. Apenas a região no meio da tela do host será marcada como "consumida". Qualquer região "não consumida" restante da tela de host ainda pode ser transformada por itens de processamento de baixa prioridade.
Deve-se ter cuidado ao utilizar o componente Tabela em um conjunto de renderização padrão porque o componente Tabela reconhecerá quase todas as telas na região selecionada e nenhum item de renderização inferior na lista será reconhecido.
O item de renderização final na lista padrão, Campos de entrada e de texto remanescentes, transformará todas as regiões da tela não consumidas remanescentes usando o componente de Campo e o widget de Campo. Este item deve ser o último em um conjunto de processamento.
No geral, o conjunto de renderização padrão tenta preservar a estrutura da tela do host original enquanto estende a funcionalidade do aplicativo, aplicando princípios de design da GUI. No entanto, para permitir a renderização padrão de telas do host a serem exibidas em dispositivos remotos, uma certa quantidade de compactação pode ser necessária. Com a compactação, a quantidade de HTML e espaço em branco é reduzida, o que pode possibilitar a exibição de uma estrutura diferente da tela de host original. Para especificar se o conjunto de renderização selecionado atualmente usa compactação, selecione Utilizar renderização compacta Apenas Web .
Suponha que você deseje criar um aplicativo do HATS e, a partir desse aplicativo, permitir que usuários acessem mais de um aplicativo do host que pareça ser bem diferente do outro. Você decidiu que deseja diferentes conjuntos de renderização para cada um, mas deseja utilizar a força da renderização padrão do HATS para ter o menor número possível de customizações de telas.
Chame um aplicativo APPA e o outro aplicativo APPB:
Para alterar as configurações de renderização avançada, expanda a árvore de renderização padrão e clique em Avançado.
Nesta seção, é possível especificar se a renderização padrão deve ser usada caso nada seja reconhecido para renderizar durante a transformação de um componente do HATS. Essa função é útil principalmente quando um aplicativo contém telas que possuem campos que podem ser alternados entre os estados desprotegido e protegido. Por exemplo, se essa função não for utilizada e um componente de campo de entrada estiver sendo utilizado para reconhecer a região, nada será reconhecido e renderizado se o campo for alternado para um estado de atributo protegido.
Nesta seção, é possível selecionar uma opção para criar HTML bem formados na renderização padrão.
Esta opção não é selecionada por padrão para reduzir a quantidade de HTML incluído na renderização padrão. A redução da quantidade de HTML é desejável para aplicativos sensíveis ao desempenho. No entanto, a seleção desta opção pode ser necessária para outros aplicativos, por exemplo, aplicativos leitores de telas usados para acessibilidade.
Se desejar que suas personalizações de processamento padrão apareçam na próxima vez em que criar um novo projeto do HATS, siga estas etapas:
Para projetos da Web, o caminho de arquivo completo é:
<shared_install_directory>\plugins\com.ibm.hats_nnn\predefined\ projects\new\Web Content\WEB-INF\profiles\application.hap
Para projetos rich client, o caminho de arquivo completo é:
<shared_install_directory>\plugins\com.ibm.hats_nnn\predefined\ projects\rcp\new\profiles\application.hapNos caminhos de arquivo acima, shared_install_directory é o diretório de recursos compartilhados no qual você instalou a oferta HATS utilizando o Gerenciador de Instalação IBM® e nnn é a versão e o nível de construção do HATS.
As regras globais permitem o reconhecimento padrão e a transformação de campos de entrada do host e trabalham com telas (exibidas por padrão) customizadas e não-customizadas. Elas podem ser definidas no nível do projeto e no nível da tela. Utilize esta seção para especificar regras globais no nível do projeto. Consulte Regras Globais para onde definir as regras globais no nível de tela.
Se uma regra global no nível de projeto e uma no nível de tela forem definidas para o mesmo campo de entrada, a regra no nível de tela terá prioridade.
Como um exemplo, você pode criar uma regra global que renderize qualquer campo de entrada com a palavra País em seu começo como uma lista suspensa que contenha códigos para diversos países em todo o mundo. As regras globais no nível do projeto são realmente globais para seu aplicativo do HATS; elas funcionam em telas transformadas pelo conjunto de renderização e também em transformações customizadas. Isso permite ativar seu aplicativo inteiro para reconhecer um padrão específico de tela de host sem modificar nenhuma de suas transformações.
Uma regra global consiste em um tipo de padrão configurado e um fragmento de transformação. A configuração de tipo padrão especifica por qual tipo de conteúdo procurar na tela de host. Ela permite transformar campos específicos ou todos os campos de um determinado tamanho ou os que estão mais próximos de uma cadeia especificada. Por exemplo, o padrão para o reconhecimento poderia ser um campo de entrada precedido pela palavra Data. O fragmento de transformação contém o conteúdo a ser utilizado para substituir todas as ocorrências do padrão em todas as transformações. O fragmento de transformação pode conter um componente de campo de entrada e um widget de calendário do HATS. Isso resultará em todos os campos de entrada precedidos pela palavra Data, em todo o aplicativo, sendo exibidos como um controle de calendário.
Todas as regras globais são exibidas na tabela de regras globais. As regras globais são processadas na ordem em que aparecem nessa lista no início de cada ação Aplicar Transformação. Depois que um campo de entrada for reconhecido por uma regra global na lista, ele não será reconhecido por uma regra global subseqüente. A caixa de opções junto a cada item indica se o item está ativado ou desativado.
Clique no botão Incluir para incluir uma definição de regra global na lista de regras globais para esse projeto. Se você não tiver uma captura de tela, será solicitado que abra o terminal do host para capturar uma tela. A criação de uma nova regra global envolve a digitação de um Nome, Pacote (para projetos do rich client) e Descrição e associação deles com uma opção Criar um Novo Fragmento de Transformação. Se estiver editando uma regra global, será possível Utilizar um Fragmento de Transformação Existente.
Em seguida, selecione um tipo de padrão a ser utilizado. Os tipos de padrão para selecionar são os seguintes:
Quando você seleciona Todos os campos de entrada para a opção Transformar, o primeiro campo de entrada que corresponde aos critérios determina o escopo da região de procura para campos subseqüentes. O exemplo a seguir mostra os campos que são considerados correspondências para todos os campos de entrada abaixo de um campo protegido que contém a cadeia Enter.. O assistente Configurações de Regra Global realça todos os campos correspondentes. A primeira correspondência é o campo com a legenda Campo alfa (azul). As colunas de início e fim desse campo determinam quais campos abaixo dele também são considerados correspondências. Observe que os campos com as legendas Campo numérico (verde) e Separadores de coluna não são considerados correspondências pois são mais longos ou mais curtos que o primeiro campo correspondente. O campo com a legenda Campo de data (rosa) e os três campos imediatamente abaixo dele são considerados correspondências, pois eles têm as mesmas colunas de início e fim que o primeiro campo correspondente.

Cada componente do tipo de padrão pode conter um conjunto de configurações personalizáveis conforme descrito acima. Conforme você altera as definições, a tela à esquerda é atualizada para refletir quais campos de entrada devem ser correspondidos (observe que vários campos serão realçados se vários campos corresponderem). Também é possível destacar alguns campos na tela do host selecionando as diferentes opções ao lado de Destacar Campos. Se quiser ver onde os campos de entrada estão definidos na tela, selecione a caixa de opções Entrada. Se quiser ver quais campos estão protegidos, selecione a caixa de opções Protegido. Se quiser destacar quaisquer campos ocultos, selecione a caixa de opções Oculto. Para modificar as cores dos campos de entrada, protegidos ou ocultos que estão em destaque, consulte Utilizando Preferências do HATS. Se você estiver utilizando um fragmento existente, clique em Concluir para atualizar o conjunto de regras globais e ignorar a seção abaixo.
Se você estiver criando um novo fragmento, deverá configurar agora o componente do HATS a ser inserido no fragmento de transformação. O objetivo das regras globais é localizar os campos de entrada; portanto, apenas os componentes de entrada são exibidos. A região da tela de host que está sendo utilizada para a configuração dessa página é denotada pela caixa de seleção ao redor do primeiro campo de entrada correspondente da página anterior, mas lembre-se que uma regra global no nível do projeto atuará em todos os campos de entrada correspondentes, nessa tela de host e em todas as outras. Selecione um componente e widget e configure suas definições. Consulte Inserir Componente do Host ou Editar Componente do Host Apenas Web para obter mais detalhes. Clicar em Concluir atualizará as regras globais e criará um novo fragmento de transformação na pasta Fragmentos de Transformação. Certifique-se de salvar as configurações do seu projeto assim que concluir o assistente.
Se precisar modificar as configurações de componente e de widget de uma regra global existente, você poderá ir para a guia Renderização, selecionar Regras Globais e selecionar o fragmento de transformação da lista e, em seguida, clicar em Editar.
O fragmento de transformação é inicialmente criado com um componente do HATS especial que corresponde às definições escolhidas na terceira página do assistente de regra global. Esse componente é especial, pois ele não tem atributos de região. Em vez disso, ele obtém dinamicamente a região utilizada para renderizar no tempo de execução. É possível editar esse componente conforme faria com qualquer outro componente do HATS, mas na primeira página do assistente, você deve selecionar uma regra global, em vez de uma região da tela. É possível inserir outro conteúdo de transformação HATS válido nesse fragmento de transformação da mesma forma.
Se você optar por modificar manualmente o fragmento de transformação associado a uma regra global, isto deverá ser feito após a utilização do editor na guia Processamento. Se isso for feito, o resultado será a leitura da tag incorreta e a remoção das modificações feitas.
As regras globais no nível do projeto e no nível da tela aplicável são aplicadas em uma transformação do evento de tela. Você pode desativar todo o processamento de regra global no nível do evento de tela. Para desativar:
Os aplicativos do HATS podem converter as cadeias de texto nas telas de host em diferentes cadeias de texto, conteúdo HTML Apenas Web ou imagens.
A guia Substituição de Texto exibe uma tabela que mostra o texto original a ser substituído, juntamente com o texto, o conteúdo HTML Apenas Web ou a imagem a ser utilizada como a substituição. Também é mostrado se a procura de texto faz distinção entre maiúsculas e minúsculas e se o suporte de expressão comum está sendo utilizado. Você pode incluir, modificar ou remover qualquer especificação de substituição de texto, utilizando os botões à direita da tabela de valores. Para obter informações sobre como especificar essas configurações, consulte Substituição de Texto.
Para alterar configurações para componentes e widgets individuais, é necessário expandi-los na árvore para ver os componentes e widgets individuais. Alguns dos componentes e widgets não possuem nenhuma definição personalizável. Para obter informações sobre as configurações que podem ser customizadas com o assistente Inserir Componente do Host, consulte Configurações de Componente e de Widget.
É possível substituir as configurações de projeto padrão para componentes e widgets ao inseri-las nas transformações. Essas configurações modificadas se aplicam apenas às instâncias individuais desses componentes ou widgets na transformação. Todas as outras instâncias de componente ou widget para qualquer transformação no projeto ainda utilizarão as configurações do projeto padrão, a menos que você as modifique. Por exemplo, você possui as configurações padrão para o componente VisualTable. Em uma única transformação, você pode ter dois componentes VisualTable; um que utiliza as configurações padrão das configurações do projeto e outro que utiliza as configurações modificadas.
Os componentes exibem uma lista dos componentes de host que podem ser utilizados para converter os elementos de uma tela do host nos objetos que podem ser exibidos em uma GUI. As configurações para um componente host especificam como esse componente será reconhecido na tela do host. Alguns desses componentes podem ser modificados. Para obter informações sobre os componentes de host, consulte Configurações de Componentes de Host.
Se você selecionar Widgets, receberá uma lista de todos os widgets do HATS que seu projeto pode utilizar para exibir componentes de host em sua GUI. Alguns desses widgets podem ser modificados. Ao personalizar um widget, você especificará como o widget aparecerá na página da Web. Para obter informações sobre os widgets e as configurações que você pode modificar, consulte Configurações de Widget.
O painel Configurações da Barra de Ferramentas permite alterar as configurações relacionadas à barra de ferramentas na visualização Transformação do aplicativo do rich client. A barra de ferramentas contém as ações do teclado numérico do aplicativo, como Atualizar e Padrão, bem como as ações contribuídas pelo widget Barra de Ferramentas. Para obter informações adicionais sobre o widget Barra de Ferramentas, consulte Barra de Ferramentas Apenas RCP .
Em aplicativos da Web do HATS, o teclado numérico do aplicativo normalmente é colocado na parte inferior ou na barra lateral do modelo. Para aplicativos do rich client do HATS, as funções fornecidas pelo teclado numérico do aplicativo existem como botões na barra de ferramentas da visualização Transformação. Isso ajuda o aplicativo rich client do HATS a se ajustar com outros aplicativos no ambiente rich client. Consulte Barra de ferramentas para obter mais informações sobre a barra de ferramentas da visualização Transformação.
Neste painel, você pode selecionar ou desmarcar a caixa de opções Mostrar barra de ferramentas. Se selecioná-la, você poderá configurar como os itens da barra de ferramentas serão exibidos, como Texto, Imagem ou Texto e Imagem. Essa configuração aplica-se a todos os itens na barra de ferramentas (incluindo aqueles contribuídos pelo widget Barra de Ferramentas).
O teclado numérico do aplicativo padrão é exibido no modelo padrão. É possível personalizar as seguintes definições para o teclado numérico do aplicativo:
É possível personalizar as seguintes configurações para o teclado numérico do host:
Também é possível incluir uma tela de host personalizada, clicando no botão Incluir e então inserindo a Legenda e Mnemônico. Clique em OK ao terminar.
A OIA (Operator Information Area) permite determinar facilmente o estado do aplicativo do host. É possível personalizar as seguintes configurações para a OIA:
Você pode configurar opções de DBCS para seu projeto se sua conexão padrão especificar uma página de códigos DBCS. Para obter mais informações sobre configurações de DBCS na guia Renderização, consulte Guia Renderização.
A guia Eventos exibe uma lista de eventos de tela priorizados (customizações de tela e combinações de tela) contidos em seu projeto, bem como eventos de aplicativo.
Se a caixa de opção próxima ao nome de um evento de tela for selecionada, esse evento será ativado para o projeto. Quando um evento de tela é ativado, e os critérios de reconhecimento de tela correspondem à tela do host, o HATS desempenha as ações especificadas para esse evento e os eventos de tela não são mais verificados para correspondências. Quando um evento de tela está desativado, o HATS ignora o evento. Se você desejar testar determinados eventos de tela, poderá desativar outros eventos de tela. Para desativar um evento de tela, limpe a caixa de opção enquanto estiver testando.
Os aplicativos do HATS verificam cada tela do host de entrada em relação à lista de eventos de tela ativados. Se houver vários eventos de tela que correspondem a uma determinada tela, o primeiro evento de tela que corresponde à tela será aplicado. Os eventos de tela de maior prioridade devem estar próximos ao topo da lista. Por exemplo, você pode ter um evento de tela que reconhece algumas telas específicas e um segundo que reconhece um conjunto de telas mais geral. Se o segundo evento de tela for maior na lista do que o primeiro, uma tela poderá ser reconhecida pelos critérios de reconhecimento de tela mais gerais e desempenhar as ações associadas, em vez de reconhecer a tela pelos critérios mais específicos e desempenhar as ações associadas do primeiro evento de tela.
Se você desejar alterar a prioridade de qualquer um dos eventos de tela, realce o evento clicando nele. Em seguida, clique em Para Cima ou Para Baixo para mover o evento para cima ou para baixo na lista. Para obter informações adicionais, consulte Prioridade de Evento de Tela.
Se desejar editar um evento de aplicativo, clique no link do evento abaixo dos Eventos do Aplicativo que deseja editar. Para obter informações adicionais, consulte Eventos do Aplicativo.
Você pode modificar a ordem do eventos de tela utilizando a guia Eventos do editor do projeto. Consulte Eventos para obter informações adicionais.
Quando um aplicativo do HATS estiver em execução e uma nova tela do host for encontrada, o HATS verificará o primeiro evento de tela ativado na lista de prioridades de eventos para determinar se os critérios de reconhecimento de tela correspondem à tela do host. Em caso positivo, os eventos de tela não serão mais verificados para correspondências e as ações para o primeiro evento de tela serão desempenhadas. Em caso negativo, o próximo evento de tela na lista será verificado para determinar se os critérios de reconhecimento de tela correspondem à tela do host. Isso continua até que o último evento de tela na lista seja verificado.
Se não houver critérios de reconhecimento de tela nos eventos de tela que correspondam à tela do host atual, o HATS processará o evento de tela em Branco se ele possuir ações e a tela estiver em branco. Caso contrário, o HATS processará o evento de tela não correspondido. O evento de tela não correspondido do HATS é um evento de tela especial que ocorre somente quando eventos de tela não definidos correspondem à tela do host. A ação padrão desse evento é exibir a tela do host (transformação padrão) que aplica o modelo padrão.
Você pode modificar as ações a serem realizadas se uma tela do host não corresponder a qualquer um de seus eventos de tela. Por exemplo, você pode criar uma página da Web que informe ao usuário que a página não foi encontrada e reunir informações sobre como o usuário atingiu essa tela. Você pode utilizar a ação Mostrar URL para apresentar a página da Web.
Se você desejar modificar a ação do evento de tela não correspondido, vá para a guia Eventos e clique em Tela Não Correspondida na seção Eventos de Aplicativo para abrir seu editor. Clique na guia Ações na parte inferior do editor para exibir as ações. Clique em Incluir, Editar ou Remover para personalizar o arquivo unmatchedScreen.evnt.
A abordagem baseada em regras utilizada pelo HATS permite personalizar as telas, aplicando determinadas ações sobre um evento de reconhecimento de tela. Também é possível associar as ações a outros eventos HATS, conhecidos como eventos de aplicativos. Os eventos de aplicativos incluem ocorrências do aplicativo, como conexão e desconexão do servidor host, início ou parada de seu aplicativo do HATS ou quando o seu aplicativo encontra um erro ou uma tela de host desconhecida. É possível configurar esses eventos de aplicativos para executar determinadas ações quando elas ocorrerem.
Para acessar os eventos de aplicativos, vá para a visualização Projetos HATS e dê um clique duplo em Configurações do Projeto do seu projeto do HATS e selecione a guia Eventos. Na guia Eventos da seção Eventos de Aplicativos, clique no link de um evento para abrir seu editor.
Cada evento do aplicativo possui várias ações associadas a ele.
A lista a seguir fornece descrições dos eventos de aplicativos do HATS e quando eles podem ocorrer junto com suas ações associadas
É possível especificar as seguintes ações para o evento inicial:
É possível especificar as seguintes ações para o evento conectar:
É possível especificar as seguintes ações para o evento de tela em branco:
Existem também configurações especiais que podem ser utilizadas para especificar como tratar uma tela vazia recebida na conexão inicial com o host. Para obter informações adicionais, consulte Manipulação de Tela.
É possível especificar as seguintes ações para o evento de tela não correspondido:
É possível especificar as seguintes ações para o evento de erro:
É possível especificar as seguintes ações para o evento desconectar:
É possível especificar as seguintes ações para o evento de parada:
<?xml version="1.0" encoding="UTF-8"?>
<event description="" type="stop">
<actions>
<release enabled="true"/>
<show enabled="true" page="stop.jsp" url="/stop.jsp"/>
</actions>
</event> A guia Outro exibe as configurações para suporte ao teclado, código do idioma do cliente, substituições de parâmetro de conexão, atualização assíncrona, substituições de variável global e configurações de cliente.
É possível personalizar as configurações do projeto padrão para cada um deles, clicando no nó na árvore de configurações de personalização.
É possível personalizar as seguintes configurações para suporte ao teclado:
Para utilizar o suporte ao teclado em projetos da Web do HATS, é necessário ter um navegador da Web suportado. Para obter a lista de navegadores da Web suportados e limitações, consulte a seção de pré-requisitos do HATS do Centro de Informações do HATS no endereço http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp.
Selecione entre as opções a seguir para especificar se o suporte ao teclado será limitado às teclas de função exibidas na página do navegador:
As legendas e mensagens dos botões podem ser exibidas em idiomas diferentes. Para obter o idioma a ser exibido, personalize as seguintes configurações de código do idioma do cliente:
O HATS permite que os parâmetro de sessão Host On Demand sejam utilizado como parâmetros de conexão para conexões de host do HATS. Para obter informações adicionais sobre esses parâmetros, consulte o centro de informações do Host On Demand em http://publib.boulder.ibm.com/infocenter/hodhelp/v10r0/index.jsp e procure nos parâmetros de sessão. Informações sobre estes parâmetro também estão disponível no documento no endereço http://www-01.ibm.com/support/docview.wss?uid=swg21251884.
Para aplicativos da Web do HATS, esses parâmetros de conexão podem ser substituídos na URL usada para acessar o aplicativos do HATS. Por exemplo, uma URL como a seguinte pode ser inserida:
http://servername:port/appname/index.jsp?host=9.42.141.26&sessionType=1&port=523& LUName=LU00001&TNEnhanced=true
Após o nome do servidor, porta e nome do aplicativo do HATS, você especifica a página de boas-vindas index.jsp, seguida por um ponto de interrogação (?) e, em seguida, os pares name=value dos parâmetros, separados por e comercial (&). Os valores são os valores de texto definidos pelo Host On-Demand, não os valores usados em outro local no arquivo application.hap. Por exemplo, sessionType=1 para 3270 e sessionType=2 para 5250.
Além dos parâmetros de sessão Host On-Demand, os parâmetros SSLP12FilePath e SSLP12Password também podem ser sobrescritos. Os parâmetros SSLP12FilePath e SSLP12Password especificam a localização e a senha do arquivo de armazenamento de chaves PKCS12 utilizado para conexões SSL. Para obter informações adicionais, consulte Segurança.
Para obter informações sobre como substituir os parâmetros de conexão para portlets do HATS, consulte Substituições de Parâmetros de Conexão e Variáveis Globais.
Para obter informações sobre como um usuário do aplicativo rich client pode substituir os parâmetros de conexão usando o item Propriedades no menu pop-up da visualização Aplicativos, consulte Parâmetros de Conexão. Para obter informações sobre como iniciar de maneira programática a instância de um aplicativo rich client utilizando substituições de parâmetros de conexão, consulte o HATS Rich Client Platform Programmer's Guide.
Para controlar quais parâmetros de conexão, se houver, podem ser substituídos, selecione um dos seguintes botões de opção:
É possível fornecer exceções para a opção que você selecionar, incluindo ou removendo os parâmetros de conexão. Para obter uma lista de parâmetros de conexão disponíveis, clique no botão Incluir.
Quando os parâmetros de conexão são substituídos no tempo de execução, o HATS usa as substituições para criar uma conexão de transformação que difere daquela definida quando o aplicativo foi criado. A escolha de qual conexão o HATS utiliza com um modelo para a criação da nova conexão de transformação é baseada na especificação ou não do parâmetro de conexão connectionName:
Quando o HATS cria uma conexão de transformação básica, determinadas funções são desativadas mesmo quando foram ativadas para a conexão escolhida como a conexão modelo. Com a conexão básica, o pooling sempre está desativado e os tempos limite de conexão e desconexão são ignorados, bem como as macros de conexão e desconexão. Os parâmetros de conexão de HOD para a conexão de modelo, como o nome do host e a porta, são copiados da conexão de modelo e, em seguida, qualquer substituição de parâmetro de conexão fornecida é aplicada para criar uma nova conexão de transformação básica. Observe que as conexões básicas são sempre baseadas na conexão de transformação padrão do aplicativo.
Quando o HATS cria um conexão de transformação completa, todas as configurações de conexão associadas à conexão indicada pelo parâmetro connectionName são usadas, incluindo configurações de pooling, macros de conexão e desconexão e tempos limite de conexão e desconexão. Suas substituições de parâmetros de conexão, se houver, são então aplicadas para criar a especificação de conjunto usada para criar a nova conexão de transformação.
Se o nome de uma conexão secundária for especificado como o valor do parâmetro connectionName e não houver outras substituições especificadas, você efetivamente comuta qual conexão será usada como a conexão de transformação para aquela instância do aplicativo.
Todas as conexões do HATS são baseadas em uma especificação de conjunto. Uma especificação de conjunto é um objeto interno que descreve as propriedades de todas as conexões criadas a partir dele. O kit de ferramentas do HATS na realidade cria especificações de conjunto e o tempo de execução usa esses arquivos de conexão, como main.hco, para criar conexões de Telnet no tempo de execução. Ao especificar as substituições dos parâmetros de conexão, o tempo de execução do HATS criará dinamicamente um novo objeto de especificação de conjunto, se necessário, para descrever as propriedades da nova conexão. As especificações de conjunto são visíveis no painel de administração do HATS para aplicativos da Web. As especificações de conjunto criadas dinamicamente quando as substituições de parâmetros são especificadas, independente do parâmetro connectionName ser especificado, são destruídas automaticamente quando a última conexão ativa é encerrada, desde que o pooling não esteja ativado.
As substituições de parâmetros de conexão podem ser diferentes para cada usuário que acessa um aplicativo do HATS. Por exemplo, se cada usuário especificar uma substituição de LUName diferente, o tempo de execução do HATS cria uma especificação de conjunto diferente para cada usuário. Certifique-se de que o pooling esteja desativado para a conexão original de forma que a especificação do conjunto seja destruída automaticamente. Se vários usuários especificarem exatamente as mesmas substituições, apenas uma especificação de conjunto será criada e reutilizada para criar várias conexões de Telnet configuradas de forma idêntica. Por exemplo, se todo um departamento de usuários especificar uma substituição de nome do host específica, apenas uma nova especificação de conjunto será criada e destruída quando nenhuma conexão estiver mais usando essa especificação.
Para poder especificar o parâmetro connectionName como uma substituição do parâmetro de conexão, o parâmetro deve ser ativado para substituições na página Substituições de Parâmetros de Conexão na guia Outro no editor de configurações do projeto.
O HATS fornece funções de desconexão automática para automaticamente desconectar o host se o navegador for fechado antes da desconexão da sessão. Para obter informações adicionais, consulte Desconexão e Atualização Automáticas - Apenas Web . Para aplicativos que não estão utilizando as funções de desconexão automática, o parâmetro disconnectOnClose executa uma função semelhante. Ele permite que o servidor HATS reconfigure a sessão Telnet do host imediatamente, se o navegador for fechado antes da desconexão manual da sessão a partir do host pelo usuário. Normalmente, a desconexão ocorre quando o usuário clica em Desconectar. A reconfiguração da sessão Telnet é feita tendo um quadro oculto no navegador que ativa um novo navegador quando o navegador original é fechado. A nova janela do navegador envia um sinal de desconexão e se fecha.
A funcionalidade só é ativada quando você especifica disconnectOnClose=true e está usando uma versão suportada do Internet Explorer. A especificação do parâmetro disconnectOnClose faz distinção entre maiúsculas e minúsculas. A seguir está um pedido de URL de amostra:
http://hostname/appname/index.jsp?disconnectOnClose=true
em que appname é o nome do aplicativo do HATS.
As condições a seguir se aplicam durante a utilização do parâmetro disconnectOnClose:
Para aplicativos rich client do HATS, a função de atualização assíncrona é ativada por padrão. É possível desativar a função limpando a caixa Ativar Atualizações Assíncronas. O principal objetivo do mecanismo de atualização assíncrona é atualizar automaticamente a visualização da GUI se a tela do host subjacente for alterada porque o host enviou uma nova tela. Esse procedimento oferece as seguintes vantagens:
Para aplicativos da Web do HATS as funções de desconexão e atualização automáticas podem ser executadas por um método pull do cliente utilizando uma implementação do AJAX ou por um método push do servidor utilizando uma implementação de applet. Para ativar a implementação do AJAX, selecione a opção Ativar Pull do Cliente (AJAX). Para ativar a implementação do applet, selecione a opção Ativar Push do Servidor (applet). Para desativar ambas as funções, selecione Desativado. O padrão é Desativado.
Para aplicativos da Web do HATS, é possível configurar o método de implementação pull do Cliente (AJAX), que inclui as funções de desconexão e atualização automáticas.
A função de desconexão automática fornece a habilidade de detectar quando o navegador esteve sem contato com seu aplicativo HATS por um período predefinido de tempo. Quando detectado, o processamento de desconexão é executado para limpar recursos associados com a sessão do navegador e, por meio disso, reduzir a carga no servidor. Para fazer isto, o evento de desconexão é executado e a macro de desconexão (se configurada) é executada.
O propósito da função de atualização automática é automaticamente atualizar a visualização da página da Web do seu aplicativo da Web se a tela do host subjacente for alterada porque o host enviou uma nova tela. Isto elimina o requisito para o usuário clicar no botão Atualizar para visualizar telas alteradas de maneira assíncrona do host.
Com a atualização automática ativada, uma visualização da página da Web não é automaticamente atualizada nos seguintes casos:
<script> browserRefreshEnabled = false; </script>
Diferente do método de implementação push do Servidor (applet), o método pull do Cliente (AJAX) não requer o uso de determinados navegadores, mas ao invés disso, suporta todos os navegadores suportados pelo HATS. Além disso, diferente do método push do Servidor (applet), não é necessária uma conexão adicional com o servidor, simplificando assim a configuração para o Administrador do HATS. O método pull do Cliente (AJAX) é mutuamente exclusivo do método push do Servidor (applet). Se alguma das funções pull do Cliente (AJAX) estiver ativada, então, a configuração push do Servidor (applet) será ignorada.
Para configura as funções de desconexão e atualização automáticas, utilize as seguintes configurações:
Há duas funções executada pelo método de implementação push do Servidor (applet), também conhecido como o applet de atualização assíncrona:
Ao utilizar o applet de atualização assíncrona, além da conexão utilizada para enviar telas de terminal transformadas do servidor do HATS para o navegador do usuário, uma conexão de soquete separada é estabelecida entre o applet em execução no cliente e o servidor do HATS. Essa conexão de soquete separada é utilizada para transmitir mensagens pequenas, entre o cliente e o servidor, relativas a atualizações de telas assíncronas do host e notificação para o servidor do HATS de que o navegador foi fechado. Geralmente, a quantidade de tráfego acima desta conexão de soquete separada é muito pequena. A seqüência de eventos que ocorre para configurar esta conexão de soquete separada é a seguinte:
Para executar o applet, é necessário um navegador ativado para Java. Verifique o Centro de Informações do HATS em http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp para obter a lista atual de navegadores suportados. Em Conteúdo, nos pré-requisitos do HATS, selecione Requisitos do Sistema Detalhados.
Para configurar o método de implementação push do Servidor (applet), utilize as seguintes configurações:
O applet do lado do navegador utiliza um soquete TCP/IP para comunicar-se com o servidor HATS. O nome do host do servidor que hospeda o aplicativo do HATS é necessário para criar o soquete. Se o HATS estiver implementado no mesmo servidor da Web especificado pela URL do navegador, o parâmetro de nome do host não precisará ser especificado e o applet utilizará o endereço IP do servidor da Web para estabelecer a conexão do soquete. Se o aplicativo do HATS estiver em um servidor diferente, o parâmetro de nome do host precisará ser especificado com um nome de host ou um endereço IP.
As configurações adicionais específicas do navegador, bem como configurações de máscaras não-Windows, podem ser especificadas para o applet. Estas configurações podem ser alteradas editando o arquivo application.hap.
Ao criar um novo projeto, uma tag será gerada no arquivo da Web Content/WEB-INF/profiles/application.hap dentro da tag <classSettings>. A seguir estão as configurações padrão para o applet:
<class name="com.ibm.hats.common.AppletSettings"> <setting name="disconnectDelay" value="300000"/> <setting name="enable" value="false"/> <setting name="hostname" value=""/> <setting name="ie" value="disconnect|refresh"/> <setting name="nonWindows" value="disconnect|refresh"/> <setting name="other" value="disconnect|refresh"/> <setting name="port" value="0"/> </class>
Uma breve explicação de cada parâmetro:
As seguintes configurações relacionadas ao navegador determinam os recursos a serem utilizados para um navegador ou ambiente específico:
Os valores a seguir podem ser utilizados para as configurações relacionadas ao navegador listadas acima:
Para alterar o comportamento do Internet Explorer, substitua disconnect por disconnectAlways. A lista de parâmetros para o Internet Explorer aparece como a seguir:
<setting name="ie" value="disconnectAlways|refresh|local"/>.
Para ativar o rastreio no lado do cliente do applet de atualização assíncrona, você deve especificar um parâmetro HTML, appletJavaConsoleTrace=true, no endereço da Web do servlet de entrada do HATS. Por exemplo,
http://myhost/myhats/entry?appletJavaConsoleTrace=true
É possível utilizar este recurso para transmitir dados do usuário para o aplicativo. Por exemplo, você pode permitir que o usuário forneça um ID do usuário e uma senha e os utilize para executar uma macro.
Para aplicativos do rich client do HATS, o usuário substitui as variáveis globais utilizando o item Propriedades no menu pop-up da visualização Aplicativos. Para obter informações adicionais, consulte Variáveis.Para obter informações sobre como iniciar de maneira programática uma instância do aplicativo rich client utilizando substituições de variável global, consulte o HATS Rich Client Platform Programmer's Guide.
Para obter informações sobre como substituir variáveis globais para portlets do HAT, consulte Substituições de Parâmetros de Conexão e Variáveis Globais.
Para aplicativos da Web do HATS, para substituir uma variável global local, você inclui um parâmetro HTML hatsgv_varName=newValue no pedido HTTP do cliente. Para substituir uma variável global compartilhada, o nome do parâmetro é hatssharedgv_varName.
Para permitir a criação e configuração do valor de uma variável global compartilhada denominada UserID, é possível apenas fornecer um campo de entrada incluindo a seguinte instrução no corpo da tag <HATS:Form> da JSP de transformação:
<INPUT name="hatssharedgv_UserID" type="TEXT" size="10">
Qualquer valor fornecido pelo usuário se torna o novo valor da variável compartilhada UserID. Se você criar o valor por JavaScript e não desejar que o usuário possa digitar o novo valor, será possível utilizar um campo de entrada oculto e fornecer o valor você mesmo:
<INPUT name="hatssharedgv_UserID" size="10" type="HIDDEN" value="alice">
Para criar uma nova variável global ou alterar o valor da variável global na URL, algo semelhante ao seguinte pode ser utilizado em um pedido GET:
http://hostname/appname/entry?hatsgv_UserID=bob
Para controlar quais variáveis globais do HATS, se houver alguma, podem ser criadas ou alteradas por um pedido de cliente do usuário, clique em um dos seguintes botões de rádio:
É possível incluir uma exceção de variável global, clicando no botão Incluir. Nesse local, você pode digitar um nome de variável global na caixa de texto ou selecioná-lo na lista drop-down. Selecione a caixa de opção Variável Global Compartilhada para indicar uma variável global que pode ser compartilhada. Para obter informações adicionais, consulte Interagindo com Variáveis Globais.
Se você desejar editar uma entrada da tabela, clique em Editar. O botão Remover excluirá a variável global realçada da lista de exceções.
É possível customizar as seguintes configurações de cliente:
+--------------------------------------+ Text UTIL runtime.filters.CompressionFilter.doFilter() 17.50.10.140 11/27/06 Servlet.Engine.Transports : 1 enable compression: true 0000CBAx-81SRWWVmQfQ8-_47oK:-1 +--------------------------------------+ Text UTIL runtime.filters.CompressionFilter.doFilter() 17.50.10.140 11/27/06 Servlet.Engine.Transports : 1 size before: 25315 0000CBAx-81SRWWVmQfQ8-_47oK:-1 +--------------------------------------+ Text UTIL runtime.filters.CompressionFilter.doFilter() 17.50.10.140 11/27/06 Servlet.Engine.Transports : 1 size after: 4264 0000CBAx-81SRWWVmQfQ8-_47oK:-1
Desmarque esta caixa para especificar que o HATS deve enviar dados do campo de entrada modificados mesmo quando o conteúdo do campo for idêntico aos dados fornecidos pelo host. Por exemplo, se o host preencheu um campo com ABC e o usuário digitou ABC no campo, os dados digitados serão retornados ao host.
Desmarque esta caixa para especificar que a ordem de tabulação padrão não deve incluir campos protegidos de leitura.
Para aplicativos da Web, é possível desativar seletivamente esta função para uma transformação individual ao incluir as linhas a seguir logo após a tag </HATS:Form> no arquivo de transformação. Para ativar seletivamente a função, especifique true em vez de false.
<script> autoAdvance = false; </script>
Para aplicativos rich client, você pode desativar seletivamente essa função para uma transformação individual substituindo o método needsAutoAdvanceSupport na transformação individual, conforme mostrado abaixo. Para ativar seletivamente a função, retorne true em vez de false.
public boolean needsAutoAdvanceSupport(boolean preferredValue) {
return false;
}
Para obter considerações sobre o DBCS durante o uso desta configuração, consulte Ativar Avanço Automático de Campo.
Desmarque essa caixa para especificar que quando o avanço automático estiver ativado, o foco avança automaticamente para o próximo campo de entrada na ordem dos campos de entrada na tela do host.
Para aplicativos da Web, você pode ativar este recurso para uma transformação incluindo as linhas a seguir logo após a tag </HATS:Form> em sua transformação:
<script> initialInputFocusFromCursor = false; </script>
Para aplicativos rich client, você pode ativar esse recurso para uma transformação substituindo o método isInitialFocusAtCursorPosition na transformação individual, conforme mostrado a seguir.
public boolean isInitialFocusAtCursorPosition() {
return false;
}<class name="com.ibm.hats.common.RuntimeSettings">
<setting name="nextFieldForDropDown" value="true"/>
</class>Para obter considerações sobre o DBCS durante o uso desta configuração, consulte Modo Sobrescrever (inicial).
Para considerações sobre o DBCS ao utilizar essa configuração, consulte Selecionar Todo Texto no Foco.
É possível desativar seletivamente essa função para uma transformação individual substituindo o método needsArrowKeyNavigationSupport na transformação individual, conforme mostrado abaixo.
public boolean
needsArrowKeyNavigationSupport(boolean preferredValue) {
return false;
}
Para ativar seletivamente a função, retorne true em vez de false.
Estas configurações são aplicáveis apenas aos projetos de portlet padrão do HATS (JSR 168). Elas podem ser utilizadas para ajudar a desenvolver uma solução de comunicação de portlet. Para obter informações adicionais, consulte Comunicação de Portlet.
Utilize estas configurações para definir as propriedades recebidas através do WebSphere Portal de outros portlets JSR 168 (HATS ou não HATS) no servidor de portal. Clique em Incluir para incluir uma nova propriedade. No campo Propriedade, insira o nome da propriedade que está sendo recebida. O nome deve corresponder ao nome da propriedade utilizado pelo portlet de envio, por exemplo, o mesmo nome de propriedade utilizado pela ação Enviar Variável Global em um portlet de envio JSR 168 do HATS. No campo Variável Global, insira o nome da variável global a ser usada para armazenar o valor da propriedade recebida. Se a variável global estiver indexada, insira o índice a ser usado. Selecione a caixa de opção Compartilhada se a variável global for uma variável global compartilhada.
Ao clicar em Concluir, a propriedade é incluída no arquivo application.hap do projeto. Além disso, um arquivo WSDL (Web Services Description Language) é criado, caso ainda não exista, e uma propriedade de recebimento é definida no arquivo WSDL. O nome do arquivo WSDL é <nome_do_projeto>.wsdl. O arquivo WSDL é necessário para conectar os portlets utilizando a ferramenta de conexão do WebSphere Portal. O arquivo portlet.xml é atualizado para referenciar o local do arquivo WSDL.
Se você clicar em Remover, a propriedade é removida do arquivo application.hap do projeto, mas não é removida do arquivo WSDL. É possível editar o arquivo WSDL e usar o editor de WSDL para remover a propriedade.
A guia Origem exibe as tags e os valores no arquivo application.hap para todas as configurações que você selecionou ou padronizou no seu projeto. Conforme você altera as outras guias no editor do projeto, as tags e os valores exibidos na guia Origem são alterados para corresponderem.
Também é possível fazer as alterações nas tags e nos valores no arquivo application.hap diretamente ao editar a origem sob a guia Origem e eles serão refletidos nas guias apropriadas do editor do projeto.
É possível utilizar as preferências do HATS para controlar a aparência e o comportamento do HATS Toolkit. Estas preferências tornam o HATS Toolkit mais acessível ou simplificam tarefas de programação. Para trabalhar com preferências do HATS, clique em Janela > Preferências e selecione HATS na visualização da árvore. Para uma ajuda rápida sobre qualquer preferência, coloque o cursor sobre ela e pressione F1.
É possível modificar essas preferências:
Esta preferência não tem efeito sobre o que é exibido sob a pasta Origem Java da visualização Projetos do HATS.
O HATS verifica as configurações de licença de projetos em um espaço de trabalho na inicialização e solicita que o usuário atualize as configurações de licença se algum dos projetos não corresponder às configurações de licença principais. Desmarque esta caixa de opções para desativar a verificação das configurações de licença na inicialização.
Existem mais preferências que controlam outros comportamentos relacionados ao HATS. Para utilizar essas preferências, expanda HATS na árvore de preferências e clique em uma das subcategorias:
Quando um nome de pacote é criado para um novo artefato, o nome do projeto é substituído pelo {nome do projeto}. A formatação nesta substituição ocorre para garantir que um nome de pacote válido seja criado (por exemplo, espaços são convertidos em sublinhados).
Ao modificar as suas preferências do HATS, você pode clicar em Aplicar para ver os resultados imediatamente no HATS Toolkit. Clique em OK para salvar as suas novas preferências e fechar a janela Preferências, ou Cancelar para sair sem salvar. Se você clicar em Cancelar, apenas as alterações feitas depois que você clicou em Aplicar serão canceladas.
Você poderá retornar suas preferências do HATS aos respectivos valores iniciais, clicando em Restaurar Padrões.
Se você configurar suas preferências do HATS em um HATS Toolkit e desejar copiá-las em outras estações de trabalho de desenvolvimento, na barra de menus do Rational SDP, selecione Arquivo > Exportar > Geral > Preferências para salvar suas preferências como um arquivo .epf. Transfira o arquivo em cada estação de trabalho onde você deseja utilizá-lo ou disponibilize-o em sua rede. Selecione Arquivo > Importar > Geral > Preferências para importar o arquivo de preferências.
A aparência e o comportamento do HATS Toolkit também podem ser afetados utilizando outras preferências disponíveis com o Rational SDP.
Por exemplo, você pode utilizar a preferência Decorações de Etiqueta para ativar outros kits de ferramentas, como Java Compile e CVS, para decorar etiquetas e imagens do HATS exibidas na visualização Projetos HATS. Quando houver um erro, uma marca vermelha pode ser exibida próxima ao arquivo. Quando o registro de saída dos arquivos é efetuado em um repositório CVS, os números de versão podem ser exibidos ao lado dos nomes de arquivo. Para acessar a preferência Decorações de Etiqueta no Rational Application Developer: