Desenvolvendo e Implementando Aplicativos Rich Client do HATS

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.

Nota:

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.

Desenvolvendo Aplicativos Rich Client do HATS

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.

Específicos da Plataforma de Destino

Conteúdo do Projeto

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:

Configurando o Nível de Conformidade do Compilador

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.

Nota:
O projeto Extensão de Tempo de Execução RCP do HATS, com.ibm.hats.rcp.runtime.extension, deve estar no mesmo nível de conformidade do compilador que seu projeto rich client do HATS. Consulte o Projeto de Extensão de Tempo de Execução RCP do HATS.

Projeto de Extensão de Tempo de Execução RCP do HATS

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.

Nota:
Este projeto não é excluído quando o último projeto do rich client do HATS é excluído. É necessário excluí-lo manualmente se você desejar que seja criado um novo projeto extensão de tempo de execução.

Trabalhando com Projetos do Rich Client do HATS

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.

Figura 6. Visualização Projeto do rich client do HATS
Visualização Projeto do rich client do HATS

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.

Notas:
  1. Um projeto do rich client exibe uma pasta Conteúdo do Rich Client, em que um projeto da Web exibe uma pasta Conteúdo da Web.
  2. A pasta Conteúdo do Rich Client é exibida no nível-raiz do projeto do rich client. Entretanto, não há nenhuma pasta Conteúdo do Rich Client real no projeto. Uma é exibida dinamicamente apenas para criar consistência com a pasta Conteúdo da Web exibida para projetos da Web.
  3. Algumas das pastas exibidas na pasta Conteúdo do Rich Client exibida dinamicamente também são exibidas na pasta Origem.
  4. Os decoradores de etiqueta para as pastas do rich client exibidas dinamicamente podem não decorar adequadamente já que as pastas não são mapeadas para pastas físicas no projeto.

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.

Copiando Recursos Entre Projetos da Web e do Rich Client

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:

Nota:
Você não tem permissão para copiar transformações, fragmentos de transformações ou modelos 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.

Exportando e Importando Projetos do Rich Client do HATS

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

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:

  1. Na barra de menus, clique em Arquivo > Exportar para abrir o assistente de Exportação.
  2. Selecione Outro > Project Interchange e clique em Avançar.
  3. Selecione o(s) projeto(s) para exportar.
    Nota:
    Um projeto rich client do HATS requer o projeto extensão de tempo de execução (com.ibm.hats.rcp.runtime.extension) para ser executado. Portanto, é necessário exportar o projeto extensão de tempo de execução como parte do arquivo Project Interchange ou criar um novo projeto extensão de tempo de execução no sistema de destino, criando um novo projeto rich client do HATS.
  4. Especifique um nome e local de arquivo .zip no qual você deseja salvar o(s) projeto(s).
  5. Clique em Concluir.

Importar

Para importar um arquivo zip do Project Interchange para o HATS Toolkit:

  1. Na barra de menus, clique em Arquivo > Importar para abrir o assistente de Importação.
  2. Selecione Outro > Project Interchange e clique em Avançar.
  3. Especifique o arquivo .zip que deseja importar no campo A partir do arquivo zip.
  4. Especifique a área de trabalho para a qual deseja importar o arquivo .zip no campo Raiz do Local do Projeto.
  5. Selecione os projetos no arquivo do Project Interchange que deseja importar para a área de trabalho especificada.
    Nota:
    Um projeto rich client do HATS requer o projeto extensão de tempo de execução (com.ibm.hats.rcp.runtime.extension) para ser executado. Portanto, é necessário importar o projeto extensão de tempo de execução como parte do arquivo Project Interchange ou criar um novo projeto extensão de tempo de execução, criando um novo projeto rich client do HATS.
  6. Clique em Concluir.

Testando Aplicativos Rich Client do HATS

Configurando a Plataforma de Destino

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.

Lotus Notes

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.

Figura 7. Configuração do ambiente de teste do Lotus Notes
Configuração do ambiente de teste do Lotus Notes

Lotus Expeditor

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.

Nota:
O Nome da VM poderá exibir com.ibm.rcp.j2se.win32.x86 na primeira vez que este diálogo de configuração for aberto.
Figura 8. Configuração do ambiente de teste do Lotus Expeditor
Configuração do ambiente de teste do Lotus Expeditor

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.

Instalando Plug-ins de Tempo de Execução

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:

Nota:
Por padrão, a plataforma de destino é o próprio Rational SDP. Como o HATS Toolkit está instalado no Rational SDP, os plug-ins de tempo de execução do HATS já estão instalados e nenhum prompt é exibido se estiver utilizando a plataforma de destino padrão.

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.

Configurando o JRE Padrão

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.

Eclipse RCP

Ao testar uma plataforma de destino do Eclipse RCP, configure o JRE padrão como jdk. Para fazer isto, desempenhe as seguintes etapas:

  1. Na barra de menus do Rational SDP, selecione Janela > Preferências > Java > JREs Instalados.
  2. Na lista de JREs instalados, selecione a caixa próxima ao jdk.
  3. Clique em OK.

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.

Lotus Notes

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:

Lotus Expeditor Client

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:

  1. Na barra de menus do Rational SDP, selecione Janela > Preferências > Java > JREs Instalados.
  2. Selecione o Java SE 6.0 Win32 x86 JRE.
    Nota:
    Se o Java SE 6.0 Win32 x86 JRE não aparecer, é necessário iniciar com uma área de trabalho limpa, ou seja, alternar para um novo diretório de área de trabalho.
  3. Clique em OK.

Ativando seu Projeto

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.

Eclipse RCP

Para ativar seu projeto no ambiente de teste local para o Eclipse RCP, execute as seguintes etapas:

  1. Na visualização Projetos HATS, clique com o botão direito do mouse no projeto e selecione Executar ou Depurar.
  2. Se você selecionou Depurar, responda Sim, Não ou Cancelar no diálogo Terminal de Exibição para especificar se deseja ver o terminal de exibição do host enquanto testa seu aplicativo.
  3. No diálogo Configurações de Execução (ou Depuração), o HATS automaticamente cria e define uma configuração de ativação padrão denominada hostaccess.
  4. Na guia Principal, na seção Programa a Executar, certifique-se de que com.ibm.hats.rcp.runtime.extension.product apareça no campo Executar um Produto.
  5. Clique em Executar (ou Depurar) para ativar a configuração padrão.
  6. Uma nova instância do ambiente de trabalho do Eclipse é ativada.
  7. A perspectiva Acesso ao Host é automaticamente aberta.
  8. Seu aplicativo do HATS é listado na visualização Applications. Para iniciar seu aplicativo, clique duas vezes nele ou clique com o botão direito do mouse e selecione Abrir.
  9. Uma nova instância do aplicativo selecionado é aberta e sua visualização de transformação é exibida.

Lotus Notes

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:

  1. Na visualização Projetos HATS, clique com o botão direito no projeto e selecione Executar ou Depurar.
  2. Se você selecionou Depurar, respondaSim, Não, ou Cancelar no diálogo Terminal de Exibição para especificar se deseja ver o terminal de exibição do host enquanto testa seu aplicativo.
  3. No diálogo Configurações de Execução (ou Depuração), o HATS automaticamente cria e define uma configuração de ativação padrão denominada hostaccess.
  4. Na guia Principal, na seção Programa a Executar, certifique-se de que com.ibm.notes.branding.notes apareça no campo Executar um Produto.
  5. Na guia Principal, na seção Java Runtime Environment, confirme se Notes 8.5.1 VM está listado no campo JRE do Tempo de Execução. Para obter informações adicionais, consulte Lotus Notes.
  6. Clique em Executar (ou Depurar) para ativar a configuração.
  7. Uma nova instância do Lotus Notes será ativada.
  8. Clique em Abrir na barra de ferramentas principal e selecione Acesso ao Host.
  9. Seu aplicativo do HATS é listado na visualização Applications. Para iniciar seu aplicativo, clique duas vezes nele ou clique com o botão direito do mouse e selecione Abrir.
  10. Uma nova instância do aplicativo selecionado é aberta e sua visualização de transformação é exibida.

Lotus Expeditor Client

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:

  1. Na visualização Projetos HATS, clique com o botão direito do mouse e selecione Executar ou Depurar
  2. Se você selecionou Depurar, responda Sim, Não ou Cancelar no diálogo Terminal de Exibição para especificar se deseja ver o terminal de exibição do host enquanto testa seu aplicativo.
  3. No diálogo Configurações de Execução (ou Depuração), o HATS automaticamente cria e define uma configuração de ativação padrão denominada hostaccess.
  4. Na guia Principal, na seção Programa a Executar, certifique-se de que com.ibm.rcp.platform.personality.branding.DefaultProduct apareça no campo Executar um Produto.
  5. Na guia Principal, na seção Java Runtime Environment, confirme se Java SE 6.0 Win32 x86 está listado no campo JRE do Tempo de Execução. Para obter informações adicionais, consulte Lotus Expeditor Client.
  6. Clique em Executar (ou Depurar) para ativar a configuração.
  7. Uma nova instância do Lotus Expeditor Client será ativada. Será solicitado que você digite uma nova senha na primeira inicialização do cliente.
  8. Clique em Abrir na barra de ferramentas principal e selecione Acesso ao Host.
  9. Seu aplicativo do HATS é listado na visualização Applications. Para iniciar seu aplicativo, clique duas vezes nele ou clique com o botão direito do mouse e selecione Abrir.
  10. Uma nova instância do aplicativo selecionado é aberta e sua visualização de transformação é exibida.

Implementando Aplicativos HATS Rich Client

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.

Empacotando um Ambiente do Cliente Eclipse para Distribuição

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.

Nota:
Antes de seguir estas instruções, presume-se que um projeto de plug-in do rich client do HATS tenha sido criado e executado no ambiente de teste local.

Para criar o pacote do cliente, execute as seguintes etapas:

  1. Na visualização Projetos HATS, clique com o botão direito do mouse em seu projeto do rich client do HATS e no menu pop-up selecione Novo HATS > Configuração de Produto. Isto ativa o assistente de Configuração de Novo Produto. O assistente também pode ser ativado a partir da barra de menu do Rational SDP, selecionando Arquivo > Novo > Outro > Desenvolvimento de Plug-in > Configuração do Produto > Avançar.
  2. Selecione a pasta do projeto de plug-in com.ibm.hats.rcp.runtime.extension como pasta de origem.
  3. Digite hostaccess.product no campo Nome do Arquivo.
  4. Selecione o botão de rádio Utilizar uma configuração de ativação e selecione hostaccess.
    Nota:
    Neste exemplo, hostaccess é o nome padrão utilizado para a configuração Executar ou Depurar que você utilizou ao testar seu aplicativo no ambiente de teste local.
  5. Clique em Concluir.
  6. Quando o editor de configuração do produto for aberto, clique na guia Configuração e remova os seguintes plug-ins desnecessários da lista de plug-ins:
  7. Salve o arquivo clicando no ícone Salvar na barra de ferramentas do Rational SDP.
  8. Clique na guia Visão Geral e depois no link assistente de exportação de Produto Eclipse.
  9. Em Destino, no campo Diretório, digite o nome do diretório para onde exportar o produto Eclipse. Por exemplo: c:\hostaccess. Alternativamente, você pode selecionar exportar para um arquivo archive (.zip), o que será útil quando você desejar disponibilizar o pacote do cliente como um download de arquivo único.
  10. Clique em Concluir.

É 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.

Empacotando Clientes Eclipse Existentes (Eclipse RCP, Lotus Notes ou Lotus Expeditor Client)

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.

Exportando seu Projeto como um Recurso do Eclipse

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.

  1. Crie um diretório vazio, por exemplo c:\myHATS, em sua unidade de disco rígido local para armazenar seu recurso do aplicativo do HATS exportado. Você utilizará este mesmo diretório para armazenar os recursos de tempo de execução do HATS e o arquivo site.xml que contém a definição para um site de atualização. Para obter informações adicionais, consulte Exportando Recursos de Tempo de Execução do HATS e Criando um Site de Atualização.
  2. Na visualização Projetos HATS, clique com o botão direito em seu projeto do rich client e, no menu pop-up, selecione Exportar > Exportar Recurso.
    Nota:

    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.

  3. Presumindo que seu projeto ainda não seja parte de um recurso, um diálogo solicitará a criação de um recurso agora. Clique em Sim para ativar o assistente Criar um Projeto do Recurso do HATS.
  4. No assistente Criar um Projeto do Recurso do HATS, preencha os campos ID do Recurso, Nome, Versão e Fornecedor.
    Nota:
    O campo Nome é preenchido automaticamente conforme você preenche o campo ID do Recurso. A validação é feita nos campos ID do Recurso e Nome conforme você os preenche. O valor digitado para ID do Recurso é também o nome utilizado para o projeto de recurso criado, e todos os valores são armazenados no arquivo feature.xml do projeto. O HATS fornece o nome, hostaccess, como um padrão para os campos ID do Recurso e Nome e a versão, 1.0.0, como um padrão para o campo Versão .
  5. A lista de plug-ins é preenchida a partir de todos os projetos de plug-in do rich client do HATS na área de trabalho. Selecione os plug-ins a incluir no novo recurso. Esses plug-ins serão instalados no cliente quando o recurso estiver instalado. Clique em Concluir.
  6. Em seguida, o assistente de Exportação do Eclipse aparece. No painel Recursos Implementáveis, selecione seu recurso.
  7. Na guia Destino, selecione Diretório e clique em Procurar para localizar e selecionar seu diretório de exportação, por exemplo, c:\myHATS.
  8. Na guia Opções, selecione Empacotar como arquivos JAR individuais (obrigatórios para JNLP e sites de atualização).
  9. Clique em Concluir.

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.

Exportando 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:

  1. Na visualização Projetos HATS, clique com o botão direito do mouse em seu projeto do rich client do HATS e no menu pop-up selecione Exportar > Exportar Recursos de Tempo de Execução do HATS. Isso ativa o assistente Exportar Recursos de Tempo de Execução do HATS. O assistente também pode ser ativado na barra de menus do Rational SDP selecionando Arquivo > Exportar > HATS > Recursos de Tempo de Execução do HATS.
  2. No painel Exportar Recursos de Tempo de Execução do HATS, para Implementar como, selecione Diretório e clique em Procurar para localizar e selecionar seu diretório de exportação, por exemplo, c:\myHATS.
    Nota:
    O assistente Exportar Recursos de Tempo de Execução do HATS permite que você especifique um arquivo de archive ou um diretório no sistema de arquivo local para salvar os recursos de tempo de execução do HATS. Se você optar por exportar para um arquivo Archive, todos os recursos e plug-ins serão empacotados em um único archive .zip. A estrutura do diretório raiz dentro do archive .zip começa com dois subdiretórios, um chamado recursos e o outro chamado plug-ins. Se você selecionar exportar um Diretório, os recursos e plug-ins são exportados para o diretório selecionado. Os recursos são colocados em um subdiretório chamado recursos, e os plug-ins são colocados em um subdiretório chamado plugins. Selecione Diretório se você está planejando fazer upload dos archives para o diretório de um site de atualização em um servidor da Web.
  3. Clique em Concluir.

Criando um Site de Atualização

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:

  1. Na visualização Projetos HATS, clique com o botão direito no seu projeto rich client do HATS e no menu pop-up selecione Novo HATS > Atualizar Projeto do Site. Isto ativa o assistente de Nova Atualização de Site. O assistente também pode ser ativado a partir da barra de menu do Rational SDP, selecionando Arquivo > Novo > Outro > Desenvolvimento de Plug-in > Atualizar Projeto de Site > Avançar.
  2. No painel Projeto do Site de Atualização:
    1. Dê um nome ao projeto, por exemplo, myHATSUpdateSite.
    2. Limpe a caixa de opções Utilizar local padrão e clique em Procurar para localizar e selecionar o diretório no qual você exportou seu recurso do aplicativo do HATS e os recursos de tempo de execução do HATS, por exemplo, c:\myHATS.
    3. Clique em Concluir.
  3. Na visualização do editor site.xml na guia Mapa do Site, clique em Nova Categoria.
  4. Na seção Propriedades da Categoria:
    1. Digite um Nome, por exemplo, HATS.
    2. Digite uma Etiqueta, por exemplo, HATS.
    3. Opcionalmente, digite uma Descrição.
    4. Clique no ícone Salvar na barra de ferramentas do Rational SDP.
  5. Na visualização do editor site.xml na guia Mapa do Site, clique em Incluir Recurso.
  6. No painel Seleção do Recurso, role para abaixo e selecione seu recurso de aplicativo do HATS, por exemplo hostaccess (nnnn), em que nnnn representa o número da versão do recurso e clique em OK. Para obter informações adicionais sobre números de versão, consulte Atualizando Números de Versão de Plug-in e Recurso.
    Nota:
    Se você começar a digitar o nome de um recurso no campo Selecionar um Recurso, os dados digitados atuarão como um curinga e a lista de recursos na caixa de listagem será reduzida até que o recurso desejado seja mostrado.
  7. Clique em Incluir Recurso para incluir cada um dos recursos de tempo de execução do HATS:

    Se a plataforma de destino especificada for Lotus Notes, inclua também o recurso a seguir:

  8. Clique em Construir Todos para concluir a construção do arquivo site.xml do site de atualização.
    Nota:
    Se for exibida uma mensagem de erro declarando que ocorreram erros de Compilação durante o build, os logs podem ser localizados em 'logs.zip' na raiz do projeto do site., portanto verifique o arquivo logs.zip. Se ele contiver somente avisos, você pode seguramente ignorá-los e continuar.

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.

Nota:
Depois de instalar uma atualização de serviço do HATS, você deve exportar e implementar novamente os recursos de tempo de execução do HATS para obter todas as alterações. É necessário modificar o arquivo site.xml do site de atualização para refletir quaisquer alterações no número da versão. As versões estão listadas no primeiro painel do assistente Exportar Recursos de Tempo de Execução do HATS. Para obter informações adicionais, consulte Atualizando Números de Versão de Plug-in e Recurso.

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.

Eclipse RCP

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.

Nota:
As instruções a seguir são para o Eclipse 3.4 e posterior. Se você estiver utilizando uma versão anterior do Eclipse, siga a documentação apropriada do Eclipse para utilização do Update Manager para instalar os recursos.
  1. Na barra de menus do cliente do Eclipse, selecione Ajuda > Atualizações de Software. Em seguida, selecione a guia Software Disponível.
    Nota:
    Dependendo da configuração do seu cliente Eclipse, esse item de menu pode estar localizado em um menu diferente.
  2. Clique no botão Incluir Site e, em seguida, no botão Local.
  3. Navegue para o local do site de atualização criado para o projeto do HATS e clique em OK.
  4. Selecione seu site de atualização do HATS e clique em Instalar .
  5. Reveja e confirme os itens que estão sendo instalados. Clique em Avançar.
  6. Selecione Aceito os termos do contrato de licença e clique em Concluir.
  7. Seu aplicativo do HATS é instalado.
  8. Quando solicitado para reiniciar o ambiente de trabalho, clique em Sim.
  9. É possível então executar seu aplicativo abrindo primeiro a perspectiva de Acesso ao Host (Janela->Abrir Perspectiva-> Acesso ao Host). 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 obter mais informações sobre o ambiente Eclipse RCP, consulte http://www.eclipse.org/home/categories/rcp.php.

Lotus Notes

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:

  1. Inicie o cliente Lotus Notes e selecione File > Preferences > Widgets.
  2. Selecione Show Widget Toolbar e painel My Widgets Sidebar. Clique em OK.
  3. A barra de ferramentas do Widget tem a seguinte aparência:
    Figura 9. Barra de ferramentas do Widget do Lotus Notes
    Barra de ferramentas do Widget do Lotus Notes
  4. O painel My Widgets Sidebar tem a seguinte aparência:
    Figura 10. My Widgets Sidebar
    My Widgets Sidebar
  5. Selecione Getting Started with Widgets na barra de ferramentas do Widget.
  6. Selecione Features and Plugins e, então, selecione Next.
  7. No campo Enter the URL, insira o caminho para o arquivo site.xml do site de atualização utilizando este formato como um exemplo (deve iniciar com file:///): file:///c:\hatsupdatesite\site.xml. Clique no botão Load.
  8. Sob Features to Install, selecione todos os recursos e selecione Next.
  9. Opcional: No campo Widget name, é possível inserir HATS Provisioning Widget ou outro nome apropriado.
  10. Opcional: Se você desejar que o widget tenha uma imagem associada a ele, copie a imagem desejada em sua pasta do site de atualização. Em seguida, no campo Image URL, insira o caminho para imagem utilizando este formato como um exemplo (deve iniciar com file:///): file:///c:\hatsupdatesite\myhatsimage.png.
  11. Escolha instalar os plug-ins quando solicitado.

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

    Figura 11. My Widgets Sidebar com HATS Provisioning Widget de exemplo
    My Widgets Sidebar com HATS Provisioning Widget de exemplo
  12. Quando solicitado, reinicie o Lotus Notes.

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.

Lotus Expeditor Client

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.

  1. No menu principal do Lotus Expeditor Client, selecione Arquivo > Aplicativo > Instalar.
  2. No painel Atualizações de Recurso, selecione Procurar novos recursos para instalação e clique em Avançar.
  3. No painel Locais do Aplicativo, clique em Incluir Local Remoto ou Incluir Local da Pasta, conforme o caso.
  4. No painel Locais do Aplicativo, selecione o site de atualização do seu HATS e clique em Concluir.
  5. No painel Resultados da Procura, selecione os recursos a serem instalados e clique em Avançar.
  6. No painel Licença do Recurso, selecione Eu aceito os termos no contrato de licença e clique em Avançar.
  7. No painel Instalação, clique em Concluir.
  8. Seu aplicativo do HATS é instalado.
  9. Quando solicitado para reiniciar o ambiente de trabalho, clique em Sim.
  10. É possível então executar seu aplicativo primeiro abrindo o Acesso ao Host (Abrir->Acesso ao Host). 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.
Processo de Atualização Automática

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.

Atualizando Números de Versão de Plug-in e Recurso

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.

Nota:
Essas etapas não são necessárias durante a execução ou depuração do aplicativo no ambiente de teste local.

Administrando Aplicativos Rich Client do HATS

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

Ambiente de Tempo de Execução

Visualização Aplicativos

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.

Menu Pop-up

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:

Abrir
Selecionar este item de menu inicia uma nova instância do aplicativo selecionado. Se vários aplicativos forem selecionados, uma instância de cada aplicativo selecionado será iniciada.
Exibir Tarefas de Impressão
Este item de menu é ativado apenas quando pelo menos um aplicativo ativado para impressão é selecionado. Selecionar este item de menu abre a visualização Tarefas de Impressão (3270) ou Tarefas de Impressão (5250), que exibe uma lista de tarefas de impressão enfileiradas. Consulte Ativando o Suporte de Impressão para obter informações adicionais.
Propriedades
Este item de menu é ativado se apenas um aplicativo for selecionado. Selecionar este item de menu permite que um usuário veja informações sobre o aplicativo bem como defina algumas configurações relacionadas ao aplicativo. As seguintes páginas são fornecidas no diálogo Propriedades para um aplicativo selecionado:
Info
A página Info exibe informações sobre o aplicativo selecionado, incluindo seu nome, ID, versão e local físico do plug-in. A página também mostra a versão do plug-in de tempo de execução do HATS que está sendo utilizado pelo aplicativo. Estas informações são úteis quando um usuário deve comunicar informações sobre o ambiente a uma equipe de suporte. O usuário não pode alterar nenhum valor nesta página. Ela é apenas informativa.
Parâmetros de Conexão
Este item não aparece na lista se você tiver escolhido proibir o usuário de substituir qualquer parâmetro de conexão, que é o padrão. Consulte Substituições de Parâmetros de Conexão para obter informações adicionais.

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.

Variáveis
Este item não aparecerá na lista se você tiver escolhido proibir o usuário de substituir qualquer variável global, que é o padrão. Consulte Substituições de Variáveis Globais para obter informações adicionais.

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.

Suporte à Tela de Impressão

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.

Nota:
Em sistemas Windows, isso fará com que seja impressa a transformação inteira, incluindo partes que somente são visíveis com o uso da barra de rolagem. Em sistemas Linux®, isso fará com que seja impressa apenas a parte da transformação que está visível, e não as partes ocultas que precisam ser roladas para serem vistas.

Visualização Transformação

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:

Barra de ferramentas

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:

Comutar Suporte ao Teclado
Isto permite que o usuário ative e desative o suporte ao teclado.
Detalhes da Conexão
Exibe os detalhes da conexão do host para este aplicativo.
Propriedades
Exibe as propriedades para este aplicativo.

Modelo e Área de Transformação

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.

Menu Pop-up
Um menu pop-up é fornecido na área de transformação que permite que o usuário visualize informações para o aplicativo atual. O seguinte item de menu está disponível:
Propriedades
Selecionar este item abre o diálogo de propriedades para o aplicativo atual. Consulte Menu Pop-up para obter informações adicionais.
Painéis de Status do Tempo de Execução
Como com aplicativos da Web do HATS, um painel é exibido para o usuário se o aplicativo do rich client do HATS parar, desconectar, possuir um erro ou estiver ocupado.

Keypad do Host

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.

Área de Status de OIA

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.

Fechando a Visualização

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.

Nota:
Se o usuário tentar fechar a visualização enquanto o HATS ainda está processando um pedido (por exemplo, o usuário clicou em um botão que começou a executar uma macro), será exibida uma mensagem indicando que a sessão está ocupada. Se o usuário continuar, a sessão será finalizada e as ações nos eventos de desconexão e parada poderão não ser executadas.

Solicitação do ID da Estação de Trabalho

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.

Solicitação do Nome da LU

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.

Preferências

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:

Preferências de Impressão

As seguintes preferências de impressão podem ser configuradas pelo usuário para aplicativos que suportam a impressão 3270:

Ações da tarefa de impressão padrão
No início
As seguintes preferências podem ser configuradas quando uma tarefa de impressão se inicia:
  • Ativar a visualização das tarefas de impressão
  • Exibir uma mensagem

    Uma mensagem é exibida indicando para o usuário que uma tarefa de impressão foi iniciada.

  • Nenhum
Na conclusão
As seguintes preferências podem ser configuradas quando uma tarefa de impressão é concluída:
  • Ativar a visualização das tarefas de impressão
  • Exibir uma mensagem

    A mensagem Tarefa de impressão {0} foi concluída. é exibida. Em que {0} é o nome da tarefa de impressão.

  • Abrir
  • Nenhum
No erro
As seguintes preferências podem ser configuradas quando uma tarefa de impressão falha:
  • Ativar a visualização das tarefas de impressão
  • Exibir uma mensagem

    A mensagem Tarefa de impressão {0} encontrou um erro. é exibida. Em que {0} é o nome da tarefa de impressão.

  • Excluir
  • Nenhum
Excluir tarefas de impressão na saída
Se selecionado, as tarefas de impressão serão automaticamente excluídas quando o ambiente for fechado. Isto pode ser útil para usuários que compartilham uma estação de trabalho com outros.

Preferências de Resolução de Problemas

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.

Configurações de Rastreio
Os seguintes rastreios de tempo de execução do HATS podem ser ativados pelo usuário:
Ativar rastreio de tempo de execução
Ativa o rastreio das conexões em seu aplicativo.
Ativar rastreio de widget
Ativa o rastreio de widgets em seu aplicativo.
Ativar rastreio de ação
Ativa o rastreio de ações de evento em seu aplicativo.
Ativar rastreio de HOD
Ativa o rastreio de Host On-Demand em seu aplicativo.
Ativar rastreio de componentes
Ativa o rastreio de componentes em seu aplicativo.
Ativar rastreio de utilitários
Ativa o rastreio de utilitários de tempo de execução em seu aplicativo.
Ativar rastreio de macros
Rastreia a execução de macros. Devido ao seu efeito sobre o desempenho do sistema, utilize esse rastreio apenas para depuração de macros.
Mostrar Terminal de Exibição
Selecione esta caixa para mostrar uma visualização do aplicativo do host no terminal de exibição enquanto o aplicativo do HATS está em execução.
Ativar Gravação de Simulação do Host
Selecione esta caixa para ativar a gravação de simulação do host durante o tempo de execução. A gravação se inicia na próxima vez que o aplicativo do rich client é iniciado e finaliza quando a sessão do host é fechada, por exemplo, quando o usuário clica no item de desconexão na barra de ferramentas de visualização da transformação.

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.

Guia Saída de Rastreio
Nome do Arquivo
O nome utilizado como um modelo para gerar conjuntos de arquivos de rastreio exclusivos para cada ambiente de tempo de execução. O padrão é trace.txt.
Tamanho Máximo do Arquivo
Especifica o tamanho máximo do arquivo em KB. O padrão é 10240.
Número Máximo de Arquivos
Especifica o número máximo de arquivos de rastreio. O padrão é 5.
Botão Visualizar
Clique neste botão para fazer com que os arquivos de rastreio sejam abertos no editor do sistema padrão. Todos os arquivos de rastreio que correspondem ao nome do arquivo de modelo especificado são combinados em um único arquivo e, então, abertos. Por exemplo, se trace.txt for o nome do arquivo de modelo e trace1.txt, trace2.txt e trace3.txt estiverem presentes, todos eles serão combinados em um único arquivo, na ordem correta, e abertos. Se nenhum editor padrão estiver configurado, será exibida uma mensagem de erro.
Botão Limpar
Clique neste botão para ser perguntado se deseja limpar o arquivo de rastreio atual.
Guia Saída de Mensagens
Nome do Arquivo
O nome utilizado como um modelo para gerar conjuntos de arquivos de log exclusivos para cada ambiente de tempo de execução. O padrão é messages.txt.
Tamanho Máximo do Arquivo
Especifica o tamanho máximo do arquivo em KB. O padrão é 512.
Número Máximo de Arquivos
Especifica o número máximo de arquivos de rastreio. O padrão é 2.
Botão Visualizar
Clique neste botão para fazer com que o arquivo de log atual seja aberto no editor do sistema padrão. Todos os arquivos de log que correspondem ao nome do arquivo de modelo especificado são combinados em um único arquivo e, então, abertos. Por exemplo, se messages.txt for o nome do arquivo de modelo e messages1.txt, messages2.txt e messages3.txt estiverem presentes, todos eles serão combinados em um único arquivo, na ordem correta, e abertos. Se nenhum editor padrão estiver configurado, uma mensagem de erro será exibida.
Botão Limpar
Clique neste botão para ser perguntado se deseja limpar o arquivo de log atual.
Guia Saída da Simulação
Número Máximo de Arquivos
Quando a caixa de opções Ativar gravação de simulação do host estiver selecionada, este campo especificará o número máximo de arquivos de saída de simulação. O padrão é 10. Se um novo arquivo de simulação exceder a configuração máxima, o arquivo de simulação mais antigo será excluído.
Botão Reunir
Clique nesse botão para reunir todos os artefatos necessários para o SuporteIBM® diagnosticar um problema. No assistente Reunir Informações para Determinação de Problema, selecione a caixa de opções para o aplicativo para o qual deseja reunir informações e especifique o arquivo .zip de destino. As seguintes informações são coletadas e reunidas no arquivo .zip de destino:
Padrão Restaurar Padrões
Clique neste botão para fazer com que todas as configurações no painel sejam revertidas para os valores padrão.
Botão Aplicar
Clique neste botão para salvar as configurações no arquivo runtime.properties no plug-in extensão de tempo de execução.

Considerações e Limitações do Rich Client do HATS

A seguir está uma lista de considerações e limitações ao utilizar aplicativos do rich client do HATS: