O HATS oferece a capacidade de transformar o acesso aos seus aplicativos host existentes utilizando aplicativos da GUI rich client que são executados no Eclipse Rich Client Platform (Eclipse RCP), Lotus Notes ou em ambientes Lotus Expeditor Client.
O Eclipse RCP é um subconjunto de plug-ins fornecidos pela plataforma Eclipse, que é mais conhecida como uma plataforma de ferramentas de software livre. A introdução do Eclipse RCP permite que você utilize a funcionalidade de núcleo fornecida pelo Eclipse para construir aplicativos clientes nativos direcionados para o desktop de um usuário. Mais informações sobre o Eclipse RCP podem ser localizados no endereço http://www.eclipse.org/home/categories/rcp.php.
O Lotus Notes é um software poderoso e multifacetado que fornece acesso instantâneo a todas as informações que são importantes para você. É possível utilizar o Lotus Notes para enviar e receber correio da Internet, agendar compromissos, procurar na Web, contribuir com grupos de notícias na Internet e aproveitar as vantagens da Home Page para acompanhar todas as suas informações diárias importantes. Para obter mais informações, consulte o Centro de Informações do Lotus Notes no endereço http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp.
O Lotus Expeditor Client fornece um ambiente de tempo de execução rich client e componentes de middleware integrados para estender vários aplicativos corporativos para laptop gerenciado por servidor e sistemas desktop. Para obter informações adicionais sobre o desenvolvimento e a implementação de aplicativos para o Lotus Expeditor Client, consulte o Centro de Informações do Lotus Expeditor em http://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jsp.
A menos que indicado o contrário, as instruções documentadas aqui são aplicáveis ao desenvolvimento e à implementação de aplicativos rich client do HATS em ambientes Eclipse RCP V3.4, Lotus Notes V8.5.1 e Lotus Expeditor Client V6.2. Para obter instruções que são aplicáveis a versões anteriores do Eclipse RCP e Lotus Expeditor Client, consulte as versões anteriores dos centros de informações apropriados.
Um ambiente rich client oferece recursos não disponíveis em um ambiente da Web tradicional, incluindo:
Informações adicionais e a ajuda sobre o desenvolvimento de aplicativos do rich client podem ser localizadas no Conteúdo da Ajuda do Rational SDP. Selecione Ajuda > Conteúdo da Ajuda na barra de menus e procure por rich client.
Ao criar aplicativos rich client do HATS, a distinção entre ambientes Eclipse RCP, Lotus Notes e Lotus Expeditor Client é mínima. As diferenças são documentadas por todo este capítulo.
A principal diferença arquitetural entre um aplicativo do rich client do HATS e um aplicativo da Web do HATS está no local onde a conexão de soquete Telnet se inicia. Com um aplicativo rich client, a conexão de soquete se inicia em uma estação de trabalho do usuário, não no WebSphere Application Server, como acontece com um aplicativo da Web do HATS tradicional. Como os aplicativos do rich client precisam de um cliente em uma estação de trabalho do usuário, eles são destinados principalmente a usuários internos, que estão acostumados a utilizar um emulador de terminal fat client tradicional.
As etapas para construir e testar um aplicativo do rich client do HATS são essencialmente as mesmas que para um aplicativo da Web do HATS. Utilize o HATS Toolkit com as ferramentas fornecidas na perspectiva do HATS para desenvolver um projeto do rich client do HATS a partir do qual um aplicativo do rich client do HATS é gerado. Os mesmos assistentes, editores e visualizações são fornecidos para suportar as várias atividades requeridas durante o desenvolvimento. Para construir aplicativos destinados ao Lotus Notes ou Lotus Expeditor Client, o Lotus Expeditor Toolkit deve estar instalado e pode ser utilizado como um auxiliar.
Assim como no HATS para o ambiente da Web, você desenvolve a aparência e a operação do aplicativo, incluindo a customização das configurações de renderização padrão, da navegação de tela (a fim de ignorar macros da tela) e as fontes e cores utilizadas para renderizar telas.
A maioria dos recursos disponíveis em um aplicativo da Web do HATS também está disponível em um aplicativo do rich client do HATS. Isto inclui, mas não está limitado a:
Os recursos disponíveis nos aplicativos da Web do HATS que não estão disponíveis nos aplicativos do rich client do HATS incluem:
Um projeto rich client do HATS é um projeto de plug-in do Eclipse. Como um projeto, ele existe em uma área de trabalho e é desenvolvido por um desenvolvedor de aplicativos do HATS. Depois de desenvolvido e testado, o projeto é exportado como um aplicativo do rich client do HATS, que é um plug-in do Eclipse que pode ser instalado em um ambiente do Eclipse. Um plug-in do Eclipse é um componente que fornece um determinado tipo de serviço dentro do contexto de um ambiente do Eclipse. No caso do HATS, o plug-in fornece o serviço necessário para transformar um aplicativo do host.
Cada plug-in de aplicativo rich client do HATS depende de diversos plug-ins de tempo de execução. As dependências são referenciadas no arquivo de manifesto do projeto do rich client, MANIFEST.MF. Você deve assegurar que estes plug-ins necessários sejam incluídos em seu ambiente de teste local e no ambiente de produção implementado para que seu plug-in do rich client do HATS seja executado adequadamente. Para obter informações adicionais, consulte Projeto de Extensão de Tempo de Execução RCP do HATS, Testando Aplicativos Rich Client do HATS e Implementando Aplicativos HATS Rich Client.
Quando você cria um projeto do rich client do HATS, é solicitado que você selecione uma plataforma de destino. Esta seleção indica onde você planeja implementar o aplicativo. As diferenças entre um projeto destinado à implementação no Eclipse RCP e Lotus Notes ou Lotus Expeditor Client são mínimas. As seguintes características são comuns a todos os projetos do rich client do HATS:
Inclusão para projetos destinados à implementação no Eclipse RCP:
Inclusões para projetos destinados à implementação no Lotus Notes e Lotus Expeditor Client:
O Java Runtime Environment (JRE) de sua área de trabalho Rational SDP e de seu ambiente de tempo de execução desejado deve ser o mesmo. Por exemplo, se você estiver desenvolvendo um plug-in rich client do HATS para executar em um ambiente Eclipse que esteja executando um Java Runtime Environment (JRE) 1.6, deve configurar o nível de conformidade do compilador de sua área de trabalho como 1.6. Para fazer isto, na barra de menus do Rational SDP, selecione Janela > Preferências > Java > Compilador e configure o Nível de Conformidade do Compilador como 1.6.
Se você tiver outro Java ou projetos de plug-in em sua área de trabalho que requeira outros níveis de conformidade, pode configurar o nível de conformidade do compilador para projetos Java individuais ou projetos de plug-in individuais. Para fazer isto, clique com o botão direito do mouse no projeto e selecione Propriedades. No painel Propriedades, selecione Compilador Java à esquerda. Em seguida, selecione a caixa Ativar Configurações Específicas do Projeto e configure o Nível de Conformidade do Compilador para o nível apropriado.
Quando você criar um projeto do rich client do HATS, um projeto para o plug-in Extensão de Tempo de Execução RCP do HATS (de agora em diante referenciado como o plug-in extensão de tempo de execução) será automaticamente criado se um ainda não existir na área de trabalho. O plug-in extensão de tempo de execução possui um nome e um ID de plug-in com.ibm.hats.rcp.runtime.extension e uma versão inicial 1.0.0.
O plug-in extensão de tempo de execução é uma extensão do plug-in Tempo de Execução RCP do HATS (com.ibm.hats.rcp.runtime). O plug-in do Tempo de Execução RCP do HATS contém as classes de tempo de execução do HATS e deve estar no ambiente para que os aplicativos rich client do HATS funcionem. O plug-in extensão de tempo de execução fornece a habilidade de configurar definições relacionadas ao ambiente de tempo de execução.
Este projeto de plug-in contém os seguintes artefatos configuráveis:
Este projeto é semelhante a um projeto EAR do HATS no ambiente da Web, mas há apenas um destes plug-ins por ambiente de tempo de execução. Ou seja, há apenas um plug-in de extensão de tempo de execução em execução no ambiente do usuário. Cada arquivo plugin.xml do projeto do rich client do HATS declara uma dependência neste plug-in. O plug-in de extensão de tempo de execução não consulta plug-ins individuais do aplicativo do HATS.
Como apenas uma cópia do plug-in de extensão de tempo de execução pode ser executado no ambiente de tempo de execução, é necessário assegurar que exista apenas uma cópia do plug-in no ambiente do usuário. Se houver mais de um plug-in de extensão de tempo de execução no ambiente, o plug-in com o número de versão mais alto será utilizado pelo ambiente. Isto assegura que o código mais recente seja sempre utilizado.
O projeto extensão de tempo de execução não está visível na visualização Projetos HATS, mas sim na visualização Navegador. Ele é incluído como parte do projeto de recurso gerado durante o momento da exportação. Para obter informações adicionais, consulte Implementando Aplicativos HATS Rich Client.
Como com um projeto da Web do HATS, quando você cria um novo projeto do rich client do HATS, um conjunto de pastas é criado para ajudá-lo a organizar seus arquivos 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.

Dependendo de como você configurar seu projeto, algumas ou todas estas pastas aparecerão na visualização Projetos HATS. Você também pode especificar quais pastas aparecerão em sua visualização Projetos HATS bem como ocultar extensões de arquivos. Para obter informações adicionais, consulte Utilizando Preferências do HATS.
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.
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.
Você pode copiar, colar, excluir, mover e renomear recursos do rich client utilizando o menu pop-up na visualização Projetos HATS. Os seguintes recursos podem ser copiados ou movidos entre projetos da Web e do rich client do HATS:
Alguns recursos copiados a partir de projetos de diferentes tipos precisarão de modificação. Por exemplo, uma macro copiada de um projeto da Web do HATS para um projeto do rich client do HATS precisará ser atualizada para referir-se a um manipulador de macro Java SWT válido (para projetos da Web do HATS, as macros referem-se a um manipulador de macro JSP). As customizações de tela também precisarão ser atualizadas por causa das referências às transformações de JSP especificadas na ação aplicar e por causa das URLs especificadas na ação redirecionar. Uma mensagem de aviso aparecerá na visualização Problemas para ajudá-lo a localizar e corrigir estes problemas. Os seguintes cenários serão sinalizados:
Não existe uma função integrada para migrar um aplicativo da Web do HATS para um aplicativo RCP do HATS. Alguns artefatos, como customizações de telas, macros, conexões, capturas de telas, imagens, arquivos de origem de lógica de negócios e arquivos de origem de componentes customizados, podem ser migrados manualmente, com alterações mínimas, de um tipo de projeto para outro. Outros artefatos, como transformações, widgets customizados, modelos e manipuladores de macro customizados, requerem alterações mais amplas a fim de funcionar em um tipo diferente de projeto.
Para mover um projeto do rich client do HATS para outro sistema com o Rational SDP instalado ou para salvar e restaurar um projeto por qualquer outra razão, é possível utilizar os recursos de exportação e importação do Rational SDP.
Exportar um projeto e seus projetos dependentes como um arquivo zip utilizando a função Project Interchange do Rational SDP. Esta função possui vários benefícios. Permite exportar vários projetos e o projeto extensão de tempo de execução necessário (com.ibm.hats.rcp.runtime.extension) de uma só vez. Além disso, você não precisa criar um projeto no HATS Toolkit de destino antes de importar o arquivo do Project Interchange. Para exportar o(s) projeto(s) do HATS Toolkit como um arquivo do Project Interchange:
Para importar um arquivo zip do Project Interchange para o HATS Toolkit:
Para testar um plug-in do aplicativo rich client do HATS em um ambiente de teste local, ative o plug-in e os plug-ins de tempo de execução necessários em uma instância da plataforma de destino. A plataforma de destino faz referência ao produto Eclipse (por exemplo, Eclipse RCP, Lotus Notes ou Lotus Expeditor Client) junto ao qual o plug-in que você está desenvolvendo será compilado e testado. Para configurar a plataforma de destino, utilize o diálogo Janela > Preferências > Desenvolvimento de Plug-in > Plataforma de Destino do Rational SDP.
Para configurar uma plataforma de destino do Lotus Notes para teste, você deve ter o Lotus Expeditor Toolkit versão 6.2.1 ou posterior e o Lotus Notes versão 8.5.1 ou posterior instalados. Se você tiver o Lotus Expeditor Toolkit instalado, junto com o Lotus Expeditor Test Environment Configuration Feature, o diálogo de configuração (mostrado abaixo) será exibido na primeira vez que uma área de trabalho for aberta. Você pode configurar quando ele será exibido utilizando as Preferências de Configuração do Ambiente de Teste visto abaixo. O Local de Destino está contido no local da instalação padrão do Lotus Notes. Certifique-se de configurar o Nome da VM e Nível de Conformidade do Compilador como mostrado abaixo. Se você selecionar a opção Nunca Exibir, é possível reconfigurar a opção para exibir este diálogo de configuração utilizando Janela > Preferências > Serviços de Cliente na barra de menus do Rational SDP.

Para configurar uma plataforma de destino do Lotus Expeditor para teste, você deve ter o Lotus Expeditor Toolkit e o Lotus Expeditor Client for Desktop instalado. O kit de ferramentas e o cliente devem ter a mesma versão. Se você estiver utilizando o Lotus Expeditor Client for Desktop versão 6.2.0, ou anterior, o Device Runtime Environment também deve estar instalado.
Para o Lotus Expeditor Client, os recursos a seguir devem ser incluídos na instalação padrão:
No Lotus Expeditor Client, selecione Arquivo > Aplicativo > Instalar > Procurar Novos Recursos a Instalar > Incluir Local da Pasta. Navegue até a pasta a seguir nos arquivos do produto Lotus Expeditor Client: desktop\updates\platform e selecione Concluir. Expanda updates/platform e Desenvolvimento. Coloque um visto ao lado de Lotus Expeditor Desktop Development Utilities. Também expanda Componentes de Tempo de Execução e coloque um visto ao lado de Componentes do SDO (Service Data Objects). Selecione Avançar e conclua o assistente.
Para o Lotus Expeditor Client versões 6.2.0 e anteriores, para instalar o Core JVM Feature - J2SE, no Lotus Expeditor Client, selecione File > Application > Install > Search for new features to install > Add folder location. Navegue para o local do site do Desktop Runtime Environment, que é o diretório update.site.dre.client e selecione OK. Aceite o nome do site padrão e selecione OK e Concluir. Expanda o site e Componentes do Tempo de Execução. Coloque um visto ao lado de Core JVM Feature - J2SE. Selecione Avançar e conclua o assistente.
Se você tiver o Lotus Expeditor Toolkit instalado, junto com o Lotus Expeditor Test Environment Configuration Feature, o diálogo de configuração (mostrado abaixo) será exibido na primeira vez que uma área de trabalho for aberta. Você pode configurar quando ele será exibido utilizando as Preferências de Configuração do Ambiente de Teste visto abaixo. O Local de Destino está contido no local de instalação padrão do Lotus Expeditor Client for Desktop. Certifique-se de configurar o Nome da VM e Nível de Conformidade do Compilador como mostrado abaixo. Se tiver selecionado a opção Nunca exibir, é possível reconfigurar a opção para exibir este diálogo de configuração utilizando Janela > Preferências > Serviços do Cliente a partir da barra de menus do Rational SDP.

Além de testar no ambiente de teste local, você deve exportar seu projeto como um aplicativo e implementá-lo em um ambiente de tempo de execução para testar fora do processo de implementação. Para obter informações adicionais, consulte Implementando Aplicativos HATS Rich Client.
Para que um plug-in do aplicativo do rich client do HATS execute no ambiente de teste local da plataforma de destino, os plug-ins de tempo de execução necessários devem ser instalados na plataforma de destino. Quando você cria um novo projeto e seleciona a plataforma de destino, ou altera posteriormente a plataforma de destino, o HATS Toolkit detectará se os plug-ins de tempo de execução necessários estão instalados no nível mais recente na plataforma de destino selecionada. Se não, o kit de ferramentas solicitará que você tenha os plug-ins de tempo de execução mais recente instalado. Você pode ativar ou desativar esta solicitação utilizando as Preferências do HATS. Consulte Utilizando Preferências do HATS para obter informações adicionais. A seguir estão os plug-ins de tempo de execução necessários que são instalados:
Os plug-ins Eclipse a seguir também estão instalados para uma plataforma de destino Lotus Notes:
Depois de instalar os plug-ins de tempo de execução do HATS mais recentes na plataforma de destino, você deve recarregar os novos plug-ins. Para fazer isto, utilize o diálogo Janela > Preferências > Desenvolvimento do Plug-in > Plataforma de Destino no Rational SDP e clique em Recarregar.
Além da configuração da plataforma de destino e da instalação dos plug-ins de tempo de execução, você pode precisar configurar o JRE padrão para sua área de trabalho no Rational SDP.
Ao testar uma plataforma de destino do Eclipse RCP, configure o JRE padrão como jdk. Para fazer isto, desempenhe as seguintes etapas:
Certifique-se de sua correspondência com JRE. Por exemplo, se você estiver testando em um ambiente do Eclipse que executará Java 1.6, é necessário atualizar o JRE da área de trabalho para corresponder ao JRE do ambiente de tempo de execução.
Ao testar em uma plataforma de destino Lotus Notes, você já deve ter configurado o JRE padrão para a área de trabalho utilizando o diálogo Configuração do Lotus Expeditor Toolkit; consulte Figura 7. Se não, então, execute as etapas a seguir:
Ao testar em uma plataforma de destino do Lotus Expeditor, você já deve ter configurado o JRE padrão para a área de trabalho utilizando o diálogo Configuração do Lotus Expeditor Toolkit Configuration; consulte Figura 8. Se não, então, execute as etapas a seguir:
Para ativar seu projeto, uma configuração de ativação é necessária. O HATS cria uma configuração de ativação padrão para você ao clicar em Executar ou Depurar para seu projeto (consulte as instruções nas seções abaixo). Uma configuração de ativação não é criada quando o diálogo Executar ou Depurar estiver aberto a partir de outra visualização, por exemplo, a visualização Package Explorer. A configuração de ativação padrão é baseada na plataforma de destino do projeto, que é configurado no assistente para Novo Projeto ou no editor de Configurações do Projeto. Se você modificar a configuração de ativação padrão para o ponto onde ela não puder mais ativar um ambiente de trabalho de tempo de execução, é possível excluir a configuração de ativação, e o HATS irá recriá-la quando Executar ou Depurar for clicado novamente. Para ativar seu projeto, siga as instruções nas seções abaixo para sua plataforma de destino.
Para ativar seu projeto no ambiente de teste local para o Eclipse RCP, execute as seguintes etapas:
O Lotus Expeditor Toolkit e o Lotus Notes devem estar instalados na mesma estação de trabalho de desenvolvimento que o Rational SDP para testar localmente um plug-in do HATS destinado ao Lotus Notes. O Lotus Notes não deve já estar em execução quando você tentar testar seu projeto porque apenas uma instância do Lotus Notes pode estar em execução em qualquer momento específico. Consulte o Configurando a Plataforma de Destino.
Para iniciar seu projeto no ambiente de teste do Lotus Notes, execute as seguintes etapas:
O Lotus Expeditor Toolkit e o Lotus Expeditor Client for Desktop devem ser instalados na mesma estação de trabalho de desenvolvimento do Rational SDP para testar localmente um plugin do HATS voltados para o Lotus Expeditor. Consulte o Configurando a Plataforma de Destino.
Para ativar seu projeto no ambiente de teste local para o Lotus Expeditor Client, execute as seguintes etapas:
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.
Esta seção descreve dois métodos diferentes para implementar aplicativos rich client do HATS. O primeiro método pode ser utilizado para empacotar um ambiente do cliente Eclipse completo para distribuição, com tudo o que for necessário para executar seu aplicativo rich client do HATS. O segundo método pode ser utilizado para empacotar seu aplicativo rich client do HATS para clientes que já possuem um ambiente do Eclipse instalado.
O Eclipse SDK, no qual está baseado o Rational SDP, fornece a capacidade de gerar um cliente Eclipse completo que inclui os plug-ins do seu aplicativo do HATS e todos os demais plug-ins necessários. Este cliente pode ser distribuído para sistemas clientes individuais e executar como um aplicativo independente.
Para criar o pacote do cliente, execute as seguintes etapas:
É criado um ambiente completo do cliente Eclipse. Para testar seu aplicativo, utilize o Windows® Explorer para navegar até o diretório c:\hostaccess. Na pasta Eclipse, dê um clique duplo em eclipse.exe. Esse diretório pode ser compactado e transferido por download para máquinas clientes individuais. Tudo o que o sistema do cliente necessita é de um JRE (Java Runtime Environment) compatível.
Para implementar seu aplicativo rich client do HATS em um ambiente de tempo de execução do cliente Eclipse existente é necessário:
As seguintes seções descrevem como desempenhar cada uma destas tarefas.
Para implementar seu plug-in de aplicativo rich client do HATS em um ambiente de tempo de execução, primeiro você deve empacotá-lo em um recurso do Eclipse. Um recurso do Eclipse é um artefato de implementação utilizado para empacotar plug-ins associados. Para empacotar seu plug-in em um recurso do Eclipse, desempenhe as seguintes etapas.
Caso não tenha especificado suas configurações de licença, você verá uma mensagem informando que esse aplicativo não foi ativado para o tempo de execução e não pode ser executado em um ambiente de produção. Os aplicativos rich client do HATS podem ser testados em um ambiente de teste local (Eclipse, Lotus Notes ou Lotus Expeditor Client), mas não podem ser executados em um ambiente de tempo de execução (não desenvolvimento) sem primeiro especificar as configurações de licença. Isso significa que você pode criar e testar completamente um aplicativo no ambiente de desenvolvimento do HATS Toolkit. Também é possível exportar o aplicativo, e um usuário pode instalá-lo, mas o usuário não pode se conectar com o aplicativo. Ou seja, o tempo de execução será bloqueado e não permitirá nenhuma conexão. Para obter mais informações sobre a especificação de configurações de licença, consulte Enabling HATS runtime and license settings na publicação HATS Getting Started. Se as licenças tiverem sido adquiridas, clique em Ativar Tempo de Execução para que o tempo de execução ative seu aplicativo. Caso contrário, clique em Continuar para continuar o processo de exportação.
Seu recurso exportado do aplicativo rich client do HATS inclui automaticamente o plug-in de extensão de tempo de execução e automaticamente inclui uma dependência nos recursos de tempo de execução do HATS. O projeto de recurso não é exibido na visualização Projetos HATS, mas sim na visualização Navegador.
Caso queira fazer uma configuração mais avançada do recurso de aplicativo rich client do HATS, em vez de utilizar o assistente Criar um Projeto de Recurso do HATS, você pode utilizar o assistente padrão Novo Recurso do Eclipse fornecido pelo Eclipse. Para ativar esse assistente, na barra de ferramentas do Rational SDP, selecione Arquivo > Novo > Outro > Desenvolvimento de Plug-in > Projeto de Recurso. Este assistente desempenha basicamente as mesmas funções que o assistente Criar um Projeto de Recurso do HATS, exceto por ele não incluir automaticamente o plug-in extensão de tempo de execução e não incluir as dependências necessárias nos recursos de tempo de execução do HATS.
Em um ambiente de produção, um recurso de aplicativo rich client do HATS depende dos recursos de tempo de execução do HATS sendo instalados no cliente. Ao criar um recurso de aplicativo rich client do HATS utilizando o assistente Criar um Projeto de Recurso do HATS, ele automaticamente inclui uma dependência nos recursos de tempo de execução do HATS. Essa dependência é o que faz com que os processos de instalação e atualização do recurso desativem automaticamente os recursos de tempo de execução do HATS a partir do site de atualização quando um recurso de aplicativo rich client do HATS é instalado ou atualizado. Os recursos de tempo de execução do HATS incluem os seguintes recursos e plug-ins:
O seguinte recurso eclipse também é incluído quando uma plataforma de destino do Lotus Notes é especificada:
Para exportar os recursos de tempo de execução do HATS, desempenhe as seguintes etapas:
Após a exportação de seu recurso de aplicativo do HATS e dos recursos de tempo de execução do HATS, é necessário criar um site de atualização que pode ser utilizado pelo processo de instalação e atualização do recurso para implementar seu aplicativo. Para criar um site de atualização, desempenhe as seguintes etapas:
Se a plataforma de destino especificada for Lotus Notes, inclua também o recurso a seguir:
Você acaba de criar um site de atualização, neste exemplo, c:\myHATS, incluindo o arquivo site.xml, que indica quais recursos e versões desses recursos estão disponíveis no site para download por um cliente. Agora você já pode mover esse diretório do site de atualização para um servidor da Web que pode ser acessado pelos clientes. Para obter instruções sobre como definir um site de atualização no sistema do cliente e instalar seus aplicativos do rich client do HATS em um ambiente de tempo de execução, consulte Instalando Seu Aplicativo em um Ambiente de Tempo de Execução.
Aplicativos rich client do HATS podem ser executados em ambiente Eclipse RCP, Lotus Notes e Lotus Expeditor Client. As seções a seguir descrevem como instalar seu aplicativo rich client do HATS em cada um desses ambientes.
Para fazer download e instalar seu aplicativo rich client do HATS em um ambiente rich client do Eclipse, o ambiente do cliente deve conter o recurso EMF Service Data Objects (SDO) do Eclipse e deve ser configurado para acessar o site de atualização contendo o aplicativo. Por padrão, como a instalação e a atualização automática estão desativas, o usuário ou administrador deve instalar manualmente os novos recursos ou atualizações utilizando as funções padrão do Eclipse Software Update. Para fazer isto, execute as etapas a seguir no sistema do cliente.
Para obter mais informações sobre o ambiente Eclipse RCP, consulte http://www.eclipse.org/home/categories/rcp.php.
No ambiente do Lotus Notes, um widget é utilizado para instalar aplicativos que são fornecidos como recursos e plug-ins. O widget pode ser publicado posteriormente em um catálogo de Widgets para que outras pessoas o utilizem. Para obter mais informações sobre widgets, consulte a seção Widgets e Live Text no Centro de Informações do Lotus Notes, no endereço http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.notes85.help.doc/wid_app_overview_c.html .
Para fazer download e instalar seu aplicativo rich client do HATS em um ambiente Lotus Notes, execute as etapas a seguir no sistema do cliente:


O painel My Widgets Sidebar terá uma aparência semelhante a esta:

Você pode executar seu aplicativo selecionando Open > Host Access. Seu aplicativo do HATS é listado na visualização Aplicativos. Para iniciar seu aplicativo, clique duas vezes nele ou clique com o botão direito do mouse e selecione Abrir.
Para desinstalar o aplicativo HATS, clique com o botão direito do mouse em HATS Provisioning Widget (ou qualquer outro nome que você tenha escolhido) e selecione Remove. Quando solicitado, reinicie o Lotus Notes.
No ambiente do Lotus Expeditor Client, o gerenciamento e a implementação do aplicativo podem ser controlados de diversas maneiras:
Para o Lotus Expeditor Client, os recursos a seguir devem ser incluídos na instalação padrão:
No Lotus Expeditor Client, selecione Arquivo > Aplicativo > Instalar > Procurar Novos Recursos a Instalar > Incluir Local da Pasta. Navegue até a pasta a seguir nos arquivos do produto Lotus Expeditor Client: desktop\updates\platform e selecione Concluir. Expanda updates/platform e Desenvolvimento. Coloque um visto ao lado de Lotus Expeditor Desktop Development Utilities. Também expanda Componentes de Tempo de Execução e coloque um visto ao lado de Componentes do SDO (Service Data Objects). Selecione Avançar e conclua o assistente.
Para o Lotus Expeditor Client versões 6.2.0 e anteriores, para instalar o Core JVM Feature - J2SE, no Lotus Expeditor Client, selecione File > Application > Install > Search for new features to install > Add folder location. Navegue para o local do site do Desktop Runtime Environment, que é o diretório update.site.dre.client e selecione OK. Aceite o nome do site padrão e selecione OK e Concluir. Expanda o site e Componentes do Tempo de Execução. Coloque um visto ao lado de Core JVM Feature - J2SE. Selecione Avançar e conclua o assistente.
Para obter mais informações, consulte a seção Montando e Implementando Aplicativos do Lotus Expeditor no Centro de Informações do Lotus Expeditor no endereço http://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jsp.
Para transferir via download e instalar seu aplicativo rich client do HATS em um ambiente Lotus Expeditor Client, o cliente deve ser configurado para acessar o site de atualização contendo o aplicativo. Para fazer isto, desempenhe as seguintes etapas no sistema do cliente.
O ambiente rich client permite a atualização automática de aplicativos instalados. As preferências estão disponíveis para controlar com que freqüência o servidor é verificado quanto às atualizações. Após fazer upload de uma atualização para um aplicativo, o rich client fará download e instalará a atualização. A verificação de versão é feita para garantir que apenas novas atualizações sejam transferidas por download e instaladas. Na maioria dos casos, o usuário precisará reiniciar o ambiente para ativar o aplicativo atualizado. Para obter mais informações, consulte a documentação apropriada do Eclipse RCP, Lotus Notes ou Lotus Expeditor.
Antes de poder atualizar um plug-in que já está instalado, é necessário atualizar a versão do plug-in porque o Eclipse utiliza a versão para determinar se um plug-in foi alterado. Por exemplo, se incluir uma customização de tela ou modificar uma macro em seu projeto, você deve atualizar a versão do seu plug-in antes de exportá-la novamente.
Para atualizar a versão do seu plug-in, no editor Configurações de Projeto do seu projeto, na guia Visão Geral, clique no link abrir o manifesto de plug-in. Na guia Visão Geral, em Informações Gerais, atualize a versão. Uma versão do Eclipse tem a forma major.minor.service. Ao fazer uma pequena mudança no projeto, atualize o segmento serviço da versão. Por exemplo, antes de exportar seu plug-in uma segunda vez, configure a versão do plug-in como 1.0.1.
Como o assistente Configurações de Licença atualiza o projeto de extensão de tempo de execução (com.ibm.hats.rcp.runtime.extension), após executar o assistente, você deve atualizar a versão desse plug-in. Para isso, na visualização Navegador, abra o arquivo plugin.xml localizado na raiz do projeto. Na guia Visão Geral, em Informações Gerais, atualize a versão.
Além disso, como os recursos são compostos de plug-ins (e recursos também têm versões), você deve atualizar a versão do seu recurso sempre que atualizar a versão de um dos plug-ins incluídos. Para isso, mude para a visualização Navegador e abra o arquivo feature.xml localizado no projeto de recurso. Por padrão, o nome do projeto de recurso é hostaccess. Na guia Visão Geral, em Informações Gerais, atualize a versão. Além disso, certifique-se de que o recurso liste corretamente as novas versões de seus plug-ins clicando no botão Versões na guia Plug-ins e selecionando Copiar versões de manifestos de plug-in e fragmento.
Após a versão do seu recurso ter sido atualizada, você deve atualizar seu arquivo site.xml (se aplicável) para garantir que ele liste a nova versão do seu recurso.
Para aplicativos rich client do HATS, as configurações de tempo de execução, como as configurações de log e rastreio, são especificadas em dois arquivos no plug-in extensão de tempo de execução (com.ibm.hats.rcp.runtime.extension):
Para obter mais informações sobre a execução em diferentes modos de teste, consulte Testing modes for rich client projects na publicação HATS Getting Started.
No HATS Toolkit, você poderá editar esses arquivos para alterar as configurações, por exemplo, configurações de rastreio e de nível de rastreio. Os arquivos estão localizados na raiz do projeto do plug-in extensão de tempo de execução. Esteja ciente de que qualquer alteração feita no arquivo runtime.properties no HATS Toolkit será retida e se tornará efetiva quando você implementar o aplicativo do HATS em um ambiente de tempo de execução. No ambiente de tempo de execução, o arquivo runtime.properties está localizado no diretório do plug-in extensão de tempo de execução, por exemplo, <eclipse_install_dir>/eclipse/plugins/com.ibm.hats.rcp.runtime.extension_1.0.0. O arquivo runtime-debug.properties é ignorado no ambiente de tempo de execução. Para obter informações adicionais sobre as configurações de log e rastreio nesses arquivos, consulte Apêndice A. Arquivo de Propriedades de Tempo de Execução.
Para obter informações sobre como o usuário pode definir as configurações de log e rastreio e reunir dados para determinação de problemas no ambiente de tempo de execução, consulte Preferências.
Há apenas um projeto de plug-in extensão de tempo de execução no espaço de trabalho, e apenas uma versão do plug-in no ambiente de tempo de execução. Portanto, em qualquer ambiente de tempo de execução do rich client do HATS único, as configurações de log e rastreio são as mesmas para todos os aplicativos do rich client do HATS.
As configurações de licença também são armazenadas no arquivo runtime.properties do plug-in extensão de tempo de execução (com.ibm.hats.rcp.runtime.extension). Portanto, o rastreamento de licença é desempenhado no nível do ambiente do rich client e não no nível de um aplicativo do rich client do HATS individual. Aparecerão mensagens de aviso no log se o usuário ultrapassar o número de licenças adquiridas. Para obter informações sobre a especificação de configurações de licenças, consulte Ativando configurações de tempo de execução e licença do HATS em Introdução ao HATS
A visualização Aplicativos exibe para o usuário todos os aplicativos do rich client do HATS ativos instalados no ambiente de tempo de execução. A visualização é classificada pelo nome da tela do aplicativo. Por padrão, esta visualização é exibida na primeira vez que o usuário abre a perspectiva de Acesso ao Host. O usuário inicia uma nova instância de um aplicativo do HATS dando um clique duplo no aplicativo na visualização Aplicativos ou clicando com o botão direito no nome do aplicativo e selecionando Abrir.
Após iniciar uma nova instância de um aplicativo do HATS, a visualização de sua transformação é exibida. Consulte Visualização Transformação para obter informações adicionais. Por padrão, o nome da visualização de transformação recém-aberta é o nome do aplicativo. Se mais de uma instância do aplicativo for iniciada, o nome da visualização da transformação será uma combinação do nome do aplicativo mais um número indicando a instância da sessão. Por exemplo, o título da segunda instância do aplicativo denominado Entrada do Pedido será intitulado Entrada do Pedido : 2.
Por padrão, um usuário pode ativar várias instâncias do mesmo aplicativo. Você pode modificar o arquivo plugin.xml para proibir a ativação de várias instâncias. Além disso, você pode decidir não mostrar a visualização Aplicativos e, em vez disso, controlar quais visualizações estão disponíveis para o usuário. Isto também pode restringir o número de instâncias de um aplicativo. Para obter mais informações, consulte a publicação HATS Rich Client Platform Programmer's Guide.
Se o aplicativo estiver em execução no ambiente de teste local e se você tiver selecionado para ver o terminal de exibição, uma janela do terminal de exibição será exibida quando a conexão for feita com o sistema. A janela será fechada quando a sessão for finalizada ou se o cliente for encerrado.
Um menu pop-up é fornecido para permitir que o usuário desempenhe ações em um ou mais aplicativos na visualização. Selecione um ou mais nomes de aplicativos e clique com o botão direito para mostrar o menu. Os seguintes itens de menu estão disponíveis:
Se você permitir substituições, esta página permitirá que o usuário substitua parâmetros de conexão. Esta função é equivalente à função do HATS para aplicativos da Web que permite a um usuário sobrescrever os parâmetros de conexão utilizando a URL quando o aplicativo é acessado pela primeira vez. Um exemplo de utilização da substituição do parâmetro de conexão pode ser onde o usuário precisa substituir um ID de estação de trabalho ou nome de LU.
O usuário configura uma substituição clicando no botão Incluir, selecionando um parâmetro na lista drop-down para o campo Nome e configurando um valor no campo Valor . Nenhuma validação no diálogo é desempenhada para alertar o usuário se o nome do parâmetro de conexão fornecido puder ser substituído. Por padrão, a configuração da substituição é ativada quando incluída pela primeira vez. Ela pode ser desativada limpando a caixa de opção próxima ao nome do parâmetro.
Quando o usuário substitui um parâmetro de conexão, as configurações são salvas no espaço de trabalho local. Os valores de parâmetro substituídos são utilizados quando uma instância da sessão é iniciada.
Para obter informações sobre como iniciar programaticamente uma instância do aplicativo rich client utilizando substituições de parâmetros de conexão, consulte o HATS Rich Client Platform Programmer's Guide.
Se você permitir substituições, esta página permitirá que o usuário substitua variáveis globais. Esta função é equivalente à função do HATS para aplicativos da Web que permite que um usuário sobrescreva variáveis globais e globais compartilhadas utilizando a URL quando o aplicativo é acessado pela primeira vez.
Este recurso permite que dados de variáveis específicos do usuário sejam utilizados no aplicativo. Por exemplo, você pode registrar uma macro que solicita a um usuário o nome e a senha fornecidos a partir dos valores de variáveis globais. O usuário pode fornecer estes valores na página de substituição de variáveis. Estes valores serão, então, utilizados quando a macro for executada quando o sinal na tela for reconhecido.
O usuário configura uma substituição clicando no botão Incluir, selecionando um nome de variável na lista drop-down para o campo Nome, configurando um valor no campo Valor e especificando se a variável global é Compartilhada. Nenhuma validação no diálogo é desempenhada para alertar o usuário se o nome da variável global fornecido puder ser substituído. Por padrão, a configuração da substituição é ativada quando incluída pela primeira vez. Ela pode ser desativada limpando a caixa de opção próxima ao nome da variável.
Quando o usuário substitui uma variável global, as configurações são armazenadas no diretório de dados do ambiente. Os valores da variável global substituídos são utilizados quando uma instância da sessão é iniciada.
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.
No ambiente rich client, o usuário possui a habilidade de imprimir a transformação da tela atual selecionando Imprimir a partir do menu Arquivo. Por padrão, o Eclipse exibe o diálogo Imprimir no qual o usuário pode selecionar a impressora e também configurar outras opções. Após o usuário clicar em OK, a área de transformação da visualização Transformação é enviada para a impressora selecionada.
A visualização de transformação é a área principal de transformação no ambiente rich client. Cada projeto do rich client do HATS possui uma visualização transformação associada a ele. A visualização é registrada no arquivo plugin.xml do projeto quando o projeto é criado. A visualização é composta de quatro áreas:
A barra de ferramentas da visualização Transformação contém botões para ações no nível do aplicativo bem como botões para ações contribuídas pelo widget Barra de Ferramentas, durante a renderização da tela. Por padrão, a barra de ferramentas é exibida e os botões exibidos com as legendas apenas de texto. Você pode alterar estas configurações nas configurações do projeto. Consulte Barra de Ferramentas Apenas RCP para obter informações adicionais.
A barra de ferramentas é dividida em duas seções. O lado direito da barra de ferramentas é equivalente ao keypad do aplicativo em um aplicativo da Web do HATS e contém botões do keypad do aplicativo. Consulte Teclado Numérico do Aplicativo para saber configurar quais botões exibir. O lado esquerdo exibe botões contribuídos pelo widget Barra de Ferramentas. Consulte Barra de Ferramentas Apenas RCP para obter informações adicionais.
O texto da dicas de ferramenta que fornece uma descrição da função do botão está disponível em todos os botões do keypad do aplicativo. Você pode configurar o texto das dicas de ferramenta nos botões incluídos utilizando o widget Barra de Ferramentas.
Acima dos botões do keypad do aplicativo na barra de ferramentas, próximo aos ícones Minimizar e Maximizar está um ícone de Menu. Clicar neste ícone exibe um menu com os seguintes itens de menu:
O modelo e área de transformação é a parte principal da visualização transformação e é onde todas as transformações da tela são exibidas. Também é a área na qual as mensagens de erro, mensagens de desconexão e painéis do manipulador de macros são exibidos.
O keypad do host exibe as teclas do host selecionadas para exibição nas configurações do projeto. Consulte Teclado Numérico do Host para saber como configurar seu keypad do host. Por padrão, nenhum keypad do host é exibido.
A área de status de OIA exibe as informações sobre o estado da sessão configurada nas configurações do projeto. Consulte Operator Information Area para saber como configurar sua área de status de OIA.
A conexão com o sistema do host é fechada quando a visualização é fechada. Isso ocorre se o usuário explicitamente fechar a visualização ou fechar o ambiente rich client. Ao fechar, o conjunto de ações definidas nos eventos de desconexão e parada serão processadas.
Quando você criar ou editar uma conexão do host, poderá especificar que o usuário seja solicitado a digitar um ID de estação de trabalho para conexão com um host 5250. Consulte Criando uma Conexão para obter informações adicionais. Se você especificar a solicitação do ID da estação de trabalho, o usuário será apresentado a um diálogo de solicitação ao conectar-se com o host pela primeira vez. O usuário poderá, então, digitar um ID de estação de trabalho no campo ID da Estação de Trabalho.
Uma caixa de opções é fornecida e, se selecionada, fará com que o ID da estação de trabalho seja salvo e evitará futuras solicitações. Se a caixa de opções for selecionada, a solicitação poderá ser restaurada posteriormente desativando a substituição do parâmetro de conexão workstationID nas propriedades do aplicativo. Consulte Parâmetros de Conexão para obter informações adicionais.
Quando você cria ou edita uma conexão do host, é possível especificar se o usuário é solicitado a digitar um nome de LU para conexão com um host 3270E. Consulte Criando uma Conexão para obter informações adicionais. Se você especificar a solicitação do nome de LU, o usuário será apresentado a um diálogo de solicitação ao conectar-se com o host pela primeira vez. O usuário deverá digitar um nome de LU no campo Nome da LU.
Uma caixa de opções será fornecida e, se selecionada, fará com que o nome da LU seja salvo e evitará futuras solicitações. Se a caixa de opções for selecionada, a solicitação poderá ser restaurada posteriormente desativando a substituição do parâmetro de conexão LUName nas propriedades do aplicativo. Consulte Parâmetros de Conexão para obter informações adicionais.
Por padrão, os usuários podem acessar preferências selecionando Arquivo > Preferências > Acesso ao Host na barra de menus da plataforma de tempo de execução. As páginas exibidas são registradas no plug-in extensão de tempo de execução. Se você não desejar fornecer essas funções ao usuário, poderá remover as declarações aplicáveis no arquivo plugin.xml do plug-in extensão de tempo de execução. Para obter informações adicionais sobre como fazer isso, consulte a descrição do ID do ponto de extensão org.eclipse.ui.preferencePages na seção do plug-in de extensão de tempo de execução do HATS do HATS Rich Client Platform Programmer's Guide. As seguintes configurações de preferência pode ser selecionadas:
As seguintes preferências de impressão podem ser configuradas pelo usuário para aplicativos que suportam a impressão 3270:
Uma mensagem é exibida indicando para o usuário que uma tarefa de impressão foi iniciada.
A mensagem Tarefa de impressão {0} foi concluída. é exibida. Em que {0} é o nome da tarefa de impressão.
A mensagem Tarefa de impressão {0} encontrou um erro. é exibida. Em que {0} é o nome da tarefa de impressão.
As preferências de resolução de problemas a seguir podem ser configuradas pelo usuário. Para obter informações adicionais sobre configurações de log e rastreio, consulte Administrando Aplicativos Rich Client do HATS.
O arquivo de rastreio é salvo na pasta de simulações do host no ambiente rich client. Por exemplo, no ambiente do Eclipse RCP no Windows, ele é salvo em <diretório de instalação do Eclipse>\plugins\<ApplicationName_version>\profiles\hostsimulations\. No ambiente Lotus Notes no Windows ele é salvo no <diretório de instalação do Lotus Notes >\Data\workspace\applications\eclipse\plugins\<ApplicationName_version>\profiles\hostsimulations\. No ambiente Lotus Expeditor Client no Windows, ele é salvo no <diretório de instalação do Lotus Expeditor Client>\shared\eclipse\plugins\<ApplicationName_version>\profiles\hostsimulations\. No ambiente Lotus Expeditor Client no Linux, ele é salvo em /opt/IBM/Lotus/Expeditor/shared/eclipse/plugins/<ApplicationName_version>/profiles/hostsimulations/.
Os arquivos de rastreio são denominados utilizando o seguinte modelo, ApplicationName_ConnectionName_Date(yyyymmdd)_Time(hhmmss)_Number, por exemplo, MyApplication_main_20060101_134543_1.
A seguir está uma lista de considerações e limitações ao utilizar aplicativos do rich client do HATS:
Este é um problema conhecido documentado no Erro 100144: É necessário um padrão para limpar recursos de fonte/imagem/cor em https://bugs.eclipse.org/bugs/show_bug.cgi?id=100144. "Devido a este problema, é necessário incluir a lógica de limpeza manualmente se você incluir recursos de fonte, imagem, ou cor para modelos e transformações do HATS rich client. Não é necessário incluir a lógica de limpeza se você incluir uma cor de sistema, que é alocada por sistema.
Por exemplo, se você incluir um novo recurso de cor utilizando o Editor Visual e o seguinte código for gerado:
sideBarArea.setBackground(new Color(Display.getCurrent(), 221, 228, 255));
deverá incluir as seguintes linhas de código manualmente para limpar a cor quando o widget for disposto:
sideBarArea.addDisposeListener(new DisposeListener(){
public void widgetDisposed(DisposeEvent e){
Color background = sideBarArea.getBackground();
if (background != null && !background.isDisposed()) {
background.dispose();
}
}
});
Se você utilizar a classe ColorManager fornecida pelo HATS, não precisará limpar os recursos de cores. Mas será necessário gravar o código utilizando o editor Java em vez do Editor de Propriedades que o Editor Visual fornece. A seguir está um código de amostra utilizando ColorManager:
sideBarArea.setBackground(com.ibm.hats.rcp.ui.misc.ColorManager.
getInstance(Display.getCurrent()).getColor(221, 228, 255));
Como outro exemplo, se você incluir manualmente uma imagem em um modelo utilizando o Editor Visual, o código para incluir a imagem e o código para limpar o recurso de imagem poderão ter a seguinte aparência:
label = new Label(bannerArea, SWT.RIGHT);
gridData = new GridData(SWT.END, SWT.CENTER, true, true);
label.setImage(new Image(Display.getCurrent(),
getClass().getResourceAsStream("/images/myimage.gif")));
label.setLayoutData(gridData);
label.addDisposeListener(new DisposeListener() {
public void widgetDisposed(DisposeEvent e){
Image image = label.getImage();
if (image != null && !image.isDisposed()) {
image.dispose();
}
}
});