Nota do editor: Possui muito conhecimento sobre este tópico? Deseja compartilhá-lo? Participe, sem demora, do programa da wiki do software IBM Lotus.

Apresentação

Este artigo descreve como converter um aplicativo Lotus Notes em aplicativo Java, usando o Personal Journal como exemplo. Você pode aplicar esta técnica para converter outros modelos do Lotus Notes de modo que eles se pareçam com os aplicativos de gerenciamento de informações pessoais, ou PIM (Correio, Calendário, Contatos), do Lotus Notes 8.

Um artigo complementar, "Recursos avançados da visualização Java no IBM Lotus Notes 8.5," foi publicado no developerWorks® Lotus.

Estas instruções funcionam apenas em aplicativos simples, com um navegador (estrutura de tópicos), uma visualização de lista e um layout de visualização. Observe esta lista de advertências:

1. É possível que categorias de vários níveis na visualização não funcionem adequadamente.
2. O mesmo pode ocorrer com colunas de totais em visualizações categorizadas de vários níveis.
3. Ícones de seta customizados podem não funcionar para categorias.
4. O navegador não exibe ações customizadas no painel do navegador.
5. O navegador não exibe ações customizadas no menu suspenso da barra de títulos do navegador.

Voltar para parte superior

Sobre o processo de conversão

Para que o Lotus Notes 8 Client, e posterior, renderize um aplicativo Lotus Notes em visualizações Java, antes de mais nada, ele deve ser um aplicativo composto. Assim, o primeiro passo é criar um aplicativo composto usando o Composite Application Editor (CAE). Em seguida, modifique o modelo no Lotus Domino Designer e use o CAE para fazer outras alterações.

O Personal Journal é o ponto de partida porque é um aplicativo simples; no formato navegador, visualização de lista e painel de visualização; e satisfaz aos critérios expostos acima.

Antes de iniciar, é necessário ter uma instalação do Lotus Notes 8.5 Client com CAE e Lotus Domino Designer 8.5. Também é necessário ter um arquivo PNG 16x16 para o ícone de página que será exibido na guia do aplicativo.

A Figura 1 apresenta o aplicativo Personal Journal original, antes da conversão, e a Figura 2 ilustra o aplicativo depois da execução dos passos delineados neste artigo.

Voltar para parte superior

Iniciar com um aplicativo Personal Journal em branco

Siga estes passos no Lotus Notes Client:

1. Crie um novo aplicativo Lotus Notes, baseado no journal6.ntf.
2. Não se esqueça de desativar a opção Herdar alterações futuras de estrutura.
3. Abra o novo aplicativo.
4. Clique com o botão direito na guia para abrir o novo aplicativo no Lotus Domino Designer.

Voltar para parte superior

Criar um novo aplicativo composto no Lotus Domino Designer

Siga estas etapas no Lotus Domino Designer:

1. No navegador, clique consecutivamente em Aplicativos Compostos - Aplicativos.
2. Clique no botão NewCompApp, no painel de Estrutura.
3. Atribua um nome ao arquivo Notes Journal Application.xml do novo aplicativo e clique em OK (como ilustrado na Figura 3).
   
   
   
   Figura 3. CAE: Criar um novo aplicativo composto no Lotus Domino Designer
   
   
   
4. Selecione os conjuntos de quadros no Lotus Domino Designer e dê um clique duplo em BorderFrame para editá-lo. Veja a Figura 4.
5. Selecione Arquivo - Propriedades e, na lista exibida, escolha Conjunto de Quadros.
6. Para o nome do aplicativo, defina Aplicativo Composto – Nome Aplic. como Notes Journal Application.xml.
7. Para o nome da página, defina Aplicativo Composto – Nome da Página como Blank Page.
   
   
   
   Figure 4. Lotus Domino Designer: Modificar o conjunto de quadros
   
   
   
8. Selecione Arquivo - Salvar.
9. Selecione Arquivo - Sair.

Voltar para parte superior

Construir novo aplicativo com base nos componentes de correio

O conjunto de quadros do aplicativo composto usa os componentes de correio do Lotus Notes (navegador e visualizações de lista) para construir uma página de aplicativo composto. Tais componentes já estão vinculados a uma visualização de lista e pré-visualização. Assim, é necessário redesignar os componentes de correio para o conjunto de quadros do aplicativo Journal original.

No Lotus Notes Client, execute estes passos:

1. Abra o Lotus Notes Client.
2. Abra Journal Example (o arquivo NSF criado anteriormente).
3. Para abrir o aplicativo no aplicativo composto, selecione Ação - Editar Aplicativo.
4. Clique na seta para direita para abrir a paleta de componentes. Veja a Figura 5.

Adicionar componentes

Agora, é necessário adicionar dois componentes.

Execute os passos a seguir no Composite Application Editor:

1. Na seção PIM da lista exibida, selecione o item Visão de Correio do Lotus Notes e o arraste para o painel central. Veja a Figura 6.
   
   
   
   Figura 6. CAE: Arrastar o componente da visão de correio
   
   
   

   A esta altura, a janela se parece à ilustrada na Figura 7.

   
   
   Figura 7. CAE: Depois de arrastar a visão de correio do Lotus Notes
   
   
   
2. É possível que as ações executadas no passo anterior mudem o seu foco novamente para a área de trabalho do Lotus Notes Cliente. Se isso acontecer, clique no item Lotus Notes, na Barra de Tarefas, e reabra Editando: Aplicativo em Branco. Talvez seja necessário clicar na seta para direita a fim de reabrir a paleta de componentes.
3. Agora, arraste o componente navegador de correio do Lotus Notes para o painel central. Este passo é difícil; você tem de arrastar a visão para a borda esquerda do painel. Quando vir a exibição da seta preta à esquerda da borda e o retângulo delimitador estreito, conforme ilustrados na Figura 8, solte o componente.
   
   
   
   Figura 8. CAE: Arrastando o navegador de correio
   
   
   

Depois de soltar o navegador, você deverá ver a tela ilustrada na Figura 9.

Herdar do aplicativo Personal Journal as configurações do conjunto de quadros da borda

Agora, substitua os componentes do correio pelos elementos do Personal Journal. Você deseja que o novo aplicativo herde as configurações do conjunto de quadros da borda a partir do modelo de diário.

Execute os passos a seguir:

1. Clique com o botão direito do mouse no componente Navegador de Correio do Lotus Notes (no painel esquerdo) e selecione Editar Propriedades do Componente.
2. Para exibir a barra de título, na guia Exibir Configurações, selecione Barra de Título.
3. Clique na guia Configurações do Componente.
4. Selecione o campo URL do Lotus Notes.
5. Substitua o E por um 0, MailFS por BorderFrame (notes:///0000000000000000/BorderFrame?OpenFrameset) de modo que a sua janela fique parecida com a Figura 10.
   
   
   
   Figura 10. CAE: Atualizar o campo URL do Lotus Notes
   
   
   
6. Clique em OK para fechar a janela.
7. Clique com o botão direito do mouse no componente visão de correio do Lotus Notes (no painel esquerdo) e selecione Editar Propriedades do Componente.
8. Clique na guia Configurações do Componente.
9. Selecione o campo URL do Notes.
10. Substitua o E por um 0, MailFS por BorderFrame: notes:///0000000000000000/BorderFrame?OpenFrameset.
11. Clique na guia Avançadas.
12. Selecione com.ibm.rcp.csiviews.viewpart.threadurl e clique em Excluir.
13. Selecione com.ibm.rcp.csiviews.viewpart.folderalias e clique em Excluir.
14. Clique em OK.
15. Para salvar as alterações feitas até agora, selecione Salvar e Fechar no menu Arquivo.

Configurar o ícone de página e renomear o aplicativo

Execute os passos a seguir no Lotus Domino Designer:

1. É necessário ter uma imagem no PNG (16 X 16). Por exemplo, veja a imagem tab_notebook_16.png do modelo notebook8.ntf.
2. Abra o Lotus Domino Designer
3. Selecione Recursos – Imagens.
4. Clique em Importar Recurso de Imagem para esta imagem como um novo recurso. Insira *.png no campo nome do arquivo. Veja a Figura 11.
   
   
   
   Figure 11. Lotus Domino Designer: Incluir um ícone de página no diretório de recursos/imagens compartilhado.
   
   
   
   
   Figure 12. Lotus Domino Designer: Configurando o campo Nome do Arquivo para exibir arquivos PNG
   
   
   
5. Abra o Composite Application Editor no Lotus Notes Client.
6. No navegador, clique com o botão direito do mouse em Blank Page e selecione a opção Editar Propriedades da Página.
7. Clique em Selecionar para escolher o ícone armazenado nos passos anteriores. Veja a Figura 13.
   
   
   
   Figura 13. CAE: Editar ícone de Página
   
   
   
8. Em seguida, é possível ajustar o nome do aplicativo, editando o campo Título da Página. Veja a Figura 14.
   
   
   
   Figura 14. CAE: Editar campo Título da Página
   
   
   
9. Clique em OK.
10. Selecione Salvar e Fechar no menu Arquivo.
    

    Volte ao Lotus Notes Client e reabra o seu aplicativo. Ele deve apresentar uma aparência similar à ilustrada na Figura 15. Talvez seja necessário reiniciar o Lotus Notes para atualizar o ícone de guia.

    
    
    Figura 15. Lotus Notes: Aplicativo atualizado no cliente do Lotus Notes
    
    
    

Definir a referência para o ícone de página

Defina a referência ao ícone de página, de modo que seja possível mover o aplicativo para outro computador (e resolver corretamente a referência ao ícone de página) e criar novos aplicativos com base nesse modelo.

Siga estes passos no Lotus Domino Designer:

1. Abra Aplicativos - Notes Journal Application (que você criou anteriormente).
2. Selecione o arquivo Notes Journal Application.xml, criado anteriormente, e clique com o botão direito do mouse em Abrir.
3. Selecione Origem.
4. Localize <preference name=”com.ibm.portal.PageIcon”> no texto.
5. Defina o valor base:value no arquivo PNG do ícone de página. Não se esqueça de especificar o arquivo PNG como segue:
   <preference name=”com.ibm.portal.PageIcon”>
<base:value value=”Notebook_view16.png” xsi:type=”base:String”/>
</preference>
6. Salve o arquivo e saia.

Criar botões com ação dividida nas barras de ação

O Lotus Notes 8 introduziu botões com ação dividida nas barras de ação da visualização. Esses permitem que os usuários cliquem uma vez e obtenham uma ação padrão ou cliquem na lista suspensa para ver a lista de opções.

Um exemplo de botão com ação dividida está presente na caixa de entrada do aplicativo de correio. Quando o botão Novo é clicado, ele abre um novo documento de correio. Se, em vez disso, você clicar na seta suspensa do botão, será exibida uma lista de opções, como ilustrado na Figura 16.

Para criar um botão com ação dividida, vá para o Lotus Domino Designer. Execute estes passos:

1. Abra a janela de propriedades Ação Compartilhada.
2. Selecione a propriedade Exibir como Ação Dividida na ação ou na janela de propriedades das ações compartilhadas. Veja a Figura 17.
   
   
   
   Figura 17. Criando um botão com ação dividida
   
   
   

Definir o tipo de marcador

Por padrão, as configurações do XML do aplicativo composto fazem com que o Lotus Notes crie URLs para a Notes Remote Procedure Call (NRPC) durante a marcação de aplicativos na guia aplicativos. Essas URLs são lentas e podem gerar erros caso o aplicativo não exista mais. Assim, convém alternar para a utilização das URLs do Notes como marcadores. Esse passo também assegura que o ícone do banco de dados seja usado como ícone do marcador.

Para alternar para as URLs do Notes, adicione uma preferência ao XML do aplicativo composto. Para tal, abra o Composite Application Editor (Ações - Editar Aplicativo) e selecione Editar Propriedades da Página, no elemento da página. Veja a Figura 18.

Em seguida, alterne para Avançadas, na janela Editar Propriedades da Página, e clique em Incluir para adicionar a preferência com.ibm.rcp.bookmark_level com a seleção de valor. Veja a Figura 19.

Desativar o alternador de navegador

Por padrão, a barra de título do navegador apresenta o alternador Alternar para Calendário. É possível desativar esse alternador com outra preferência de XML de aplicativo composto.

Execute os passos a seguir:

1. Ative o Composite Application Editor (Ações - Editar Aplicativo) e edite as propriedades do componente do navegador usando as ações do menu de contexto (botão direito do mouse).
2. Quando a janela de propriedades do componente for exibida, clique na guia Avançadas. Clique em Incluir e adicione a preferência com.ibm.rcp.showSwitch com o valor false. Salve e feche a janela. Veja a Figura 21.
   
   
   
   Figura 21. Incluir preferência do alternador de exibição
   
   
   

Voltar para parte superior

Conclusão

Este artigo descreveu os passos individuais que permitem a customização ou modernização dos seus aplicativos. A esta altura, você já deve ter muitas ferramentas disponíveis para fazer com que seus aplicativos pareçam aplicativos PIM nativos do Lotus Notes 8 (Correio, Calendário, Tarefas Pendentes e Bloco de Notas). Para obter mais informações, consulte as Ajudas do Lotus Notes Composite Application Editor e do Domino Designer 8.5.

Recursos

• Participar do fórum de discussão.
  
  
• Leia o artigo complementar "Recursos avançados da visualização Java no IBM Lotus Notes 8.5" no developerWorks.
  
  
• Leia o artigo "O que há de novo no IBM Lotus Notes 8.5" no developerWorks.
  
  
• Consulte a página do produto IBM Lotus Notes e Domino 8.5.
  
  
• Consulte a Ajuda do IBM Lotus Domino Designer 8.5.
  
  

Sobre os autores

Classificar este artigo

Comentários

Voltar para parte superior

Índice

• Apresentação
• Sobre o processo de conversão
• Iniciar com um aplicativo Personal Journal em branco
• Criar um novo aplicativo composto no Lotus Domino Designer
• Construir novo aplicativo com base nos componentes de correio
• Conclusão
• Recursos
• Sobre os autores
• Comentários

Conheça a IBM da sua cidade

A IBM está mais perto do que você imagina!

---

Saiba mais