Nível: Intermediário Steve Castledine, Advisory Software Engineer, IBM
Margo Ezekiel, User Interface Designer, IBM
17/Fev/2009
Atualizado 29/Jun/2009 As visualizações Java™ foram introduzidas nos clientes IBM® Lotus® Notes® no release 8.0. Muitos novos recursos foram implementados através das visualização Java para modernizar a interface do Lotus Notes. Após ter convertido seu aplicativo para usar o visualizador Java, é possível seguir os passos listados neste artigo para aproveitar os novos recursos de visualização oferecidos, tais como encadeamentos, modo reduzido, cartão de visitas, botões de ações de divisão, e menus de contexto personalizados. Assume-se neste artigo que você tem uma versão instalada do Lotus Notes 8.5, do IBM Lotus Domino Designer 8.5 e do editor de aplicativos compostos do Lotus Notes 8.5 Você também deve estar acostumado a trabalhar com o Lotus Domino® Designer.
Nota do editor: Você sabe muito sobre este tópico? Quer compartilhar sua experiência? Participe do programa wiki software IBM Lotus hoje mesmo.
Apresentação
Este artigo presume que você leu o artigo developerWorks®, "Passos Básicos: Convertendo um aplicativo IBM Lotus Notes para usar os componentes Java Lotus Note 8", e que executou os passos listados lá.
Adicione a opção de pré-visualização ao lado
Agora que as modificações estão completas, é possível voltar ao Lotus Domino Designer para fazer modificações adicionais.
É possível adicionar a Exibição de uma ação suspensa no lado direito de sua barra de ação para permitir que usuários mostrem uma pré-visualização na parte inferior ou no lado.
Siga esses passos:
- Selecione Arquivo - Sair do cliente Lotus Notes.
- Abra o arquivo notes.ini (no diretório onde o Lotus Notes estiver instalado) em um editor, como, por exemplo, o Notepad.
- Acrescente o seguinte à configuração do arquivo: Designer_ShowPropForJavaViewsUI=1.
- Salve suas alterações e feche o arquivo.
- Abra o Lotus Domino Designer e abra seu novo aplicativo.
- Selecione Visualizar no Navegador.
- Clique duas vezes para abrir uma das visualizações.
- Selecione Arquivo - Propriedades e mude para Visualizar.
- Selecione a opção alternar Exibição Vertical/Horizontal para adicionar essa opção ao seu aplicativo.
- Complete as ações descritas no passo anterior para cada visualização na qual quer selecionar esta opção. Veja figura 1.
Figura 1. Lotus Domino Designer: Selecione Alternador entre Exibição Vertical/Horizontal
Dimensione uma coluna dinamicamente
No Lotus Notes 8, nas visualizações de e-mail, é possível marcar a coluna de Assuntos para ser dimensionada dinamicamente, para que o usuário redimensione a visualização da lista (tornando a barra lateral mais larga ou mais estreita), e a coluna de Assunto cresceria ou diminuiria, permitindo que todas as outras colunas sejam da mesma largura. Este passo permitiu redimensionamento fluido, sem a introdução de uma barra de rolagem horizontal.
Conforme o usuário encolhe a visualização, esta coluna continua encolhendo até chegar a sua largura mínima. Então, o software alterna a visualização para o modo reduzido.
Para configurar esta coluna dimensionada dinamicamente, siga estes passos:
- Abra Propriedades para a coluna que você quer que seja dimensionada dinamicamente.
- Selecione a opção Extensão para usar a largura de janela disponível.
Crie visualizações reduzidas
Além de poder ver uma pré-visualização ao lado, o Lotus Notes 8 introduziu visualizações reduzidas nas visualizações de e-mail. As visualizações reduzidas permitem ao usuário ver seu e-mail sem os tradicionais cabeçalhos de colunas e com mais informações empilhadas.
Para cada visualização reduzida, é necessário especificar:
- Onde colocar a coluna - isto é, mantê-la na linha superior, agrupá-la na segunda linha, ou esconde-la totalmente. Este posicionamento é feito usando a configuração Se a visualização estiver reduzida nas propriedades da coluna (aba 6). As opções são Manter no topo, Esconder esta coluna, e Agrupar na segunda linha.
- Se este campo permanece na linha superior, a segunda linha deveria ser justificada verticalmente para iniciar diretamente abaixo dela. Novamente, esta opção é estabelecida nas propriedades da coluna, aba 6, configuração: Justifique a segunda linha sob esta coluna, como mostra a figura 2.
Figura 2. Alinhamento da segunda linha
- A ordem de operações - isto é, qual coluna é tratada primeiro, qual coluna é tratada em segundo, etc. Por exemplo, é possível configurar a visualização para que uma coluna agrupe primeiro e, conforme a visualização é reduzida, uma segunda coluna fica oculta, e conforme reduz ainda mais, uma terceira coluna se agrupa, e assim por diante. É possível usar o controle de sequência para rotular as colunas como primeira, segunda ou terceira, como mostra a figura 3.
Figura 3. Definindo a ordem de operações
 |
Adicione ações a janela Exibição suspensa
No Lotus Notes, adicionamos mais ações a Mostrar janela suspensa, que permite que usuários controlem suas visualizações. "Não lidas Apenas" é um exemplo de uma ação adicional. Veja figura 4.
Figura 4. Exibição suspensa na barra de ações
Para adicionar uma ação a janela de Exibição suspensa, abra a caixa de propriedades das Ações Compartilhadas. Então, selecione a propriedade controle de ação de alinhamento a Direita, como na figura 5.
Figura 5. Mostrando uma ação na Exibição suspensa
Modificar colunas
Também é possível configurar alguns novos atributos a suas colunas. É possível ver esses atributos usados no modelo Mail 8. Essas configurações aparecem no campo Attrs: para as propriedades da Coluna.
Existem 5 novas opções como mostra a Tabela 1.
Tabela 1. Novos atributos de coluna disponíveis para visualizações Java.
| Configuração | Descrição | Exemplo |
|---|
| $ThinColumn=true | Torna uma coluna fina |  |
|---|
| $MaskSelectionColor=true | Torna uma barra de destaque de linha invisível nesta coluna |  |
|---|
| $TypeHeaderIcon=index:colicon1:129 | Coloca um ícone no cabeçalho de uma coluna |  |
|---|
| $ShowGradientColor=true | Adiciona um fundo cinza a uma coluna |  |
|---|
| $ShowThreadTwistie=true | Mostra um ícone de seta na coluna |  |
|---|
Para fazer essas alterações, selecione a coluna que você quer mudar e, então, siga esses passos:
- Selecione Arquivo - Propriedades, então, selecione Coluna.
- Na área Atributos (rotulado attrs:, aba 6), você pode inserir qualquer um dos atributos apresentados na tabela 1. Se você quiser usar vários atributos, separe-os com um ponto e vírgula.
- Observe que há também as configurações para ajustar a visualização quando se está em modo reduzido.
- Salve suas alterações fechando a visualização.
Crie um cartão de visitas
O Lotus Notes 8 apresentou uma visualização de cartão de visitas na área de Contatos. Também é possível criar visualizações de cartões de visita para seus aplicativos.
O visualizador que define como visualização é apresentada pode ser definido na janela Exibir propriedades no campo Visualizadores como mostrado na figura 6. Os visualizadores pertinentes a serem listados aqui são Tabela, Lado a Lado, ou Calendário. Se nenhum visualizador for especificado, então a tabela é usada como no padrão (visualização padrão). Você também pode combiná-los, separando as entradas com um ponto e vírgula; em seguida, apresente-as no menu Exibir como opções.
Figura 6.Controles para exibir visualização de cartão de visitas
Para cada coluna no visualizador, é necessário especificar onde mostrar o campo (topo, parte inferior, ou oculto) e em quais linhas, como mostra a figura 7.
Figura 7. Formatando a coluna e o campo na visualização lado a lado (cartão de visitas)
Criar visualizações alfabéticas ou tabuladas
A visualização de contatos do Lotus Notes 8 tem tabulações alfabéticas que mostram a esquerda do visualizador (veja figure 8). Clicando em uma letra da tabulação alfabética filtra a visualização aquela letra.
Também é possível ter tabulação alfabética na sua visualização selecionando Exibir Navegador de Tabulação nas propriedades de Visualização. Veja figura 9.
Figura 8. Tabulação Alfabética
Figura 9. Visualizadores de Navegador Tabulado
Acione encadeamentos em uma visualização
No Lotus Notes 8, introduzimos a visualização de encadeamentos, integrada na caixa de entrada como mostra a figura 10.
Figura 10. Visualização encadeada na caixa de entrada
É possível usar estas visualizações encadeadas em seu aplicativo, mas com uso restrito, porque o projeto atual está direcionado apenas para o e-mail modelo. Por exemplo, o texto "mensagens nesta conversa" está fixo atualmente.
Inicie selecionando a opção Histórico de Encadeamento Resposta de Suporte para seu aplicativo. É possível fazer esta seleção na janela de propriedades da Base de Dados, como mostra figura 11.
Figura 11. Selecionando a opção Histórico de Encadeamento Resposta de Suporte
Selecionado esta opção cria-se um cache interno ou índice para as visualizações encadeadas. Por padrão, este cache retorna apenas 7 dias. É possível mudar a configuração padrão adicionando o ini MAX_DAYS_FOR_THREAD_CONVERSATIONS=365 (ou outro valor alto para especificar o número de dias) ao Notes.ini.
Assumindo que você já criou um aplicativo flutuante as visualizações Java seguindo os passos neste artigo e no artigo anterior, é necessário adicionar duas visualizações ao seu aplicativo. Uma visualização controla a aparência das visualizações encadeadas, e o outro visualizador funciona como o índice de resposta hierárquica.
Cria um novo visualizador no seu modelo (usando o projeto padrão) e dê o nome ($ThreadsEmbed); torne-o oculto colocando entre parênteses. Selecione a propriedade Exibir documentos resposta hierárquica e Exibir hierarquias de resposta parcial como mostra figura 12.
Figura 12. Configurações para a nova visualização $ThreadsEmbed
Para a coluna que é seu assunto ou tópico, vá até as propriedades e entre $ThreadSubject=true no campo Attrs. Veja figura 13.
Figura 13. Configurando o atributo $ThreadSubject
Crie uma segunda visualização (novamente usando o design padrão) e dê o nome (Threads). Selecione, então, Avaliar ações para cada documento salvo e Exibir opções de resposta em hierarquia para esta visualização, também.
É necessário, então, adicionar uma propriedade ao seu arquivo XML do seu aplicativo composto. Siga esses passos:
- Selecione Ações - Editar Aplicativo.
- Selecione visualizar componente e clique no lado direito de Editar Propriedades do Componente.
- A partir da aba Avançada, adicione a propriedade com.ibm.rcp.csiviews.viewpart.threadurl com um valor de notas:///0000000000000000/Threads?OpenView. Veja figura 14.
- Selecione Arquivo - Salvar &Fechar.
Figura 14. Adicionando a propriedade threadurl XML
A seguir é necessário configurar a visualização visível com a qual você quer que a visualização encadeada trabalhe. Na janela de propriedades de Visualização, faça o seguinte, conforme mostra a Figura 15:
- Limpar a opção Exibir documentos resposta em hierarquia.
- Selecione a opção Alternar Exibição Vertical/Horizontal
- Selecione ($ThreadsEmbed) no Campo Visualização Encadeada.
- Selecione a opção Permitir modo conversação.
Figura 15.Especifique a visualização para Exibir na expansão da seta
Também é necessário adicionar uma coluna onde você quer que a seta apareça para permitir que o usuário selecione visualização encadeada. Para isso, siga os passos a seguir:
- Adicione uma coluna com um valor de ""(nenhum).
- Faça a coluna de tamanho 1.
- No campo Attrs, entre $ShowThreadTwistie=true. Veja figura 16.
Figura 16. Configurando o atributo de seta
É possível querer usar a opção de Conversação v Mensagens que são visíveis no cliente de e-mail no menu Exibir. As Conversações exibem apenas as últimas respostas para cada conversa de e-mail. As mensagens exibem tudo. Essas são ações padrão com o controle a propriedade de controlar ação Alinhar a Direita selecionada. Configuram o ambiente disponível $VIEW_CONVERSATION_MODE para 1 para Mensagens Individuais e 2 para modo conversação.
Adicione separadores de linha para o navegador
No navegador do seu aplicativo, é possível adicionar separador de linhas entre as entradas, como mostra a figura 17.
Figura 17. Linhas de separação no navegador
Para isso, abra o Lotus Domino Designer e siga os passos a seguir:
- Clique em Código Compartilhado.
- Clique em Notes Mail Outline.
- No Outline Entry, selecione a opção Exibir separador sobre esta entrada para adicionar um separador de linha no seu navegador.
Crie menus de contexto para clicar a direita nas visualizações
Por padrão, os menus de contexto de clicar a direita incluem itens padrão como as propriedades do documento. É possível desligar esses padrões e selecionar os seus próprios itens do menu, com imagens e submenus.
Primeiro, é necessário desativar os itens padrão:
- Abra o Lotus Domino Designer.
- Abra as Propriedades da Barra de Ações.
- Limpe a opção Exibir itens padrão na opção do menu do botão direito do mouse.
Então, ativa as ações individuais para exibir no menu de contexto usando a configuração Incluir no menu do botão direito do mouse. Estas configurações podem ser encontradas na caixa de propriedades de ações.
É possível criar ícones e submenus como faria para qualquer menu de barra de ação do Lotus Notes. Para menus complexos poderá ser mais fácil criar entradas separadas para o botão direito na barra de ação para que você possa usar ícones e separações específicas.
Também é possível alinhar texto à direita para informação de atalho do teclado, incluindo @Char(9) entre o seu Rótulo e seu atalho conforme indicado no campo Rótulo na janela de propriedades de ações na figura 18. Figura 19 mostra o menu de conteúdo final.
Figura 18. Alinhe um atalho a direita no menu de conteúdo.
Figura 19. Menu de contexto de clicar a direita finalizado
Conclusão
Este artigo estabeleceu passos individuais que permitem que você personalize e modernize seus aplicativos. Agora você tem muitas as ferramentas disponíveis para fazer com que seus aplicativos personalizados pareçam com os aplicativos PIM nativos do Lotus Notes 8 (E-mail, Calendário, Lista de Contatos, Tarefas, Bloco de Notas).
Recursos
Sobre os autores  | | | Steve Castledine é um Consultor de Engenharia de Software da IBM. Ele é parte do Grupo de Software e, atualmente, é responsável pelo crescimento dos esforços em código aberto no OpenNTF.Org e na demonstração do valor do Lotus Domino XPages. Anteriormente, Steve trabalhou em projetos para entrega de aplicativos Blog, Wiki, Bloco de Notas/Personal Journal entre outros. É possível contatar Steve em steve.castledine@uk.ibm.com. |
| | | Margo Ezekiel é uma Designe de Interface com Usuários, trabalhando nos clientes de e-mail IBM Lotus e no iNotes. Margo Projetou o Cliente de E-mails Lotus Notes 8.0, usando os recursos de visualização Java estruturados neste documento. Trabalhou com Steve Castledine para atualizar o aplicativo Personal Journal (também conhecido como Bloco de Notas) no Lotus Notes 8.5. |
Avalie esta página
| 
