Nota do editor: Sabe muito sobre este tópico? Quer compartilhar seu conhecimento? Participe do programa de wiki do software IBM Lotus hoje.

Nota: O procedimento de marca descrito neste artigo é aplicável somente ao cliente Sametime Connect independente. Não pode ser usado para o cliente Sametime integrado no Lotus Notes®.

Introdução

A customização do cliente Lotus Sametime Connect pode ser alcançada com o uso de plug-ins de marca. Os usuários atuais poderão estar interessados em criar seus próprios plug-ins de marca pessoais. Em uma escala maior, uma empresa poderá estar interessada em usar uma ferramenta de comunicação que possa ser marcada com a identidade da empresa. Se uma empresa fosse adotar o Lotus Sametime como sua ferramenta de comunicação e colaboração, o cliente Lotus Sametime deveria ser customizado com a marca da empresa e a marca poderia aparecer automaticamente para todos os usuários da ferramenta na empresa.

Um plug-in de marca de amostra para a empresa fictícia Your Co está incluído com este artigo como download. O artigo fornece instruções sobre como instalar o plug-in em uma única instância do Lotus Sametime 8.0 e cliente mais recente, dicas de atualização do plug-in de amostra com outras imagens e diretrizes para criar marcas personalizadas ou de empresa. Não é preciso ter experiência de desenvolvimento nem um ambiente de desenvolvimento integrado (IDE) Eclipse para executar as operações descritas neste artigo.

O Lotus Sametime permite ter vários plug-ins de marca instalados simultaneamente no cliente Lotus Sametime Connect sem causar conflitos no ambiente. Os usuários podem facilmente alternar entre marcas se escolherem fazê-lo. Os plug-ins de marca customizados também podem ser instalados no Lotus Sametime 7.5, mas requerem um plug-in diferente do fornecido com este artigo.

Voltar para parte superior

Fundamentos de marcas

As marcas podem ser aplicadas a três áreas do cliente Lotus Sametime Connect. Na Figura 1 são mostradas as três áreas de marcas. Na captura de tela, as janelas do Lotus Sametime estão empilhadas. A janela de login abre na parte superior, a janela da lista de contatos abre abaixo dela e a janela de bate-papo está na parte inferior.

A primeira área de marca que o cliente vê é a janela de login, mostrada na Figura 2.

A marca na Figura 2 coloca uma imagem acima dos campos de login do usuário. A segunda área de marca está abaixo das listas Contatos/Contatos Principais. Essa região é renderizada a partir de um arquivo HTML. No exemplo da Your Co mostrado na Figura 3, o arquivo HTML contém alguns links e uma imagem de marca (a janela do cliente Lotus Sametime na figura foi reduzida em tamanho).

A terceira área de marca está localizada perto do canto superior direito da janela de bate-papo do Lotus Sametime (consulte a Figura 4).

Voltar para parte superior

Instalação do plug-in de amostra

Para este artigo, suponha que os usuários têm o cliente Lotus Sametime instalado no diretório C:\SametimeConnect8.

O plug-in está empacotado como parte de um site de recursos. Para obter mais informações sobre a criação de sites de recursos, consulte a nota técnica, " Automatically updating Sametime 7.5.x Connect clients."

Voltar para parte superior

Site de recursos da Your Co

Transfira por download o arquivo yourco_feature_site.zip, incluído neste artigo.

Para saber mais sobre archives ZIP, archives JAR, extração de arquivos de um archive ou criação de um archive, consulte a seção "Trabalhando com archives", que está mais adiante neste artigo.

Extraia todos os arquivos do yourco_feature_site.zip para o seu disco rígido, por exemplo, no diretório C:\temp. Essa etapa cria uma pasta chamada YourCoSametimeBranding na pasta C:\temp. A Figura 5 mostra a estrutura do arquivo.

O arquivo zip contém um arquivo site.xml e arquivos JAR do recurso e plug-in. Ao instalar esse recurso, você aponta para o diretório base YourCoSametimeBranding.

O arquivo site.xml contém o identificador e a localização do recurso como mostrado na Listagem 1.

	      <?xml version="1.0" encoding="UTF-8"?>
	      <site>
	      <feature url="features/yourbranding_feature_8.0.0.jar"
	      id="yourbranding_feature" version="8.0.0"/>
	      </site>
	    

O arquivo yourco_feature_8.0.0.jar contém um único arquivo, feature.xml. Esse arquivo é o descritor de recursos, que contém o ID do recurso, o rótulo, a descrição, o ID do plug-in e descrições do copyright e da licença, como mostrado na Listagem 2.

	      <?xml version="1.0" encoding="UTF-8"?>
	      <feature
	      id="yourbranding_feature"
	      label="Your Branding Sametime Feature"
	      version="8.0.0"
	      plugin="yourbranding.branding">
	      <description url="">
	      [Enter Feature Description here.]
	      </description>
	      <copyright url="">
	      [Enter Copyright Description here.]
	      </copyright>
	      <license url="">
	      [Enter License Description here.]
	      </license>
	      <plugin
	      id="yourbranding.branding"
	      download-size="0"
	      install-size="0"
	      version="8.0.0"/>
	      </feature>
	    

Para instalar o plug-in no Lotus Sametime 8.0 e ou em versões mais recentes, siga estas etapas:

1. Ative o cliente Lotus Sametime e efetue login. No menu Tools, selecione Plug-ins e, em seguida, selecione Install Plug-ins.
2. Na janela que é exibida, selecione a segunda opção Search for new features to install.
3. Clique em Next. Clique no botão Add Folder Location e navegue até a pasta em que extraiu o yourco_feature_site.zip (C:\temp\YourCoSametimeBranding). Clique em OK. Consulte a Figura 6.
   
   
   
   Figura 6. Incluir a localização da pasta do plug-in
   
   
   
4. A lista de localizações mostra temp/YourCoSametimeBranding. Certifique-se de que a caixa de seleção ao lado da localização está selecionada e clique em Finish.
5. Na próxima janela que for exibida, expanda temp/YourCoSametimeBranding e selecione o Sametime Feature 8.0.0 da Your Co e, em seguida, clique em Next. Consulte a Figura 7.
   
   
   
   Figura 7. Selecionar os recursos para instalar
   
   
   
6. Clique em I accept the terms in the license agreements e, em seguida, clique em Next. Consulte a Figura 8.
   
   
   
   Figura 8. Aceitar o contrato de licença do recurso
   
   
   
7. Clique em Finish. Em seguida, será exibida uma mensagem indicando que é necessário reiniciar o Lotus Sametime. Você pode reiniciar. Ao reiniciar, você não verá a marca da Your Co.

Voltar para parte superior

Configurar a marca Lotus Sametime

Para instruir o cliente Lotus Sametime para selecionar a marca da Your Co em vez da marca padrão, pode-se modificar o arquivo plugin_customization.ini. Esse arquivo está localizado no diretório C:\SametimeConnect8\rcp. Crie uma cópia do arquivo plugin_customization.ini para backup. Abra o arquivo para edição usando um editor de texto. Para alterar a marca é necessário configurar uma preferência nesse arquivo. Configure a preferência stBranding da seguinte maneira:

Esse código deverá ser exibido em uma linha no arquivo. yourco.branding.yourco_custom é o identificador do plug-in de recursos da marca da Your Co. yourco_custom é o identificador do plug-in em plugin.xml e yourco.branding é o identificador de recurso em feature.xml. O identificador de recurso também está especificado no arquivo site.xml.

Depois de fazer essa mudança, salve o arquivo, saia do Lotus Sametime (se estiver em execução) e ative novamente o Lotus Sametime. Você deverá ser saudado pela janela de login, marcada com o logotipo da Your Co.

É possível ter vários plug-ins de marca instalados no Lotus Sametime simultaneamente. Para alternar para um plug-in diferente, altere a propriedade stBranding no arquivo plugin_customization.ini para que ela refira ao identificador do plug-in de marca que você deseja usar. Se o Lotus Sametime não puder localizar o plug-in referenciado no arquivo plugin_customization.ini, ele usa a marca padrão. Qualquer mudança feita no plugin_customization.ini requer que o Lotus Sametime seja ativado novamente.

Voltar para parte superior

Visão geral do código de plug-in

O plug-in está instalado neste arquivo:

O conteúdo da pasta yourco.branding_8.0.0 é a extração do arquivo yourco.branding_8.0.0.jar do yourco_feature_site.zip. Esta pasta contém o arquivo plugin.xml, que fornece a descrição do plug-in. Consulte a listagem 3.

	      <?xml version="1.0" encoding="UTF-8"?>
	      <plugin>
	      <extension id="yourco_custom"
	      point="com.ibm.collaboration.realtime.ui.stbranding">
	      <stbranding
	      id="yourco.branding.login"
	      name="login dialog branding"
	      targetView="com.ibm.collaboration.realtime.login">
	      <image file="brand/images/YOURCO_400X100.jpg"/>
	      </stbranding>
	      <stbranding
	      height="64"
	      id="yourco.branding.chat"
	      name="chat window branding"
	      targetView="com.ibm.collaboration.realtime.chatwindow"
	      valign="top"
	      width="64">
	      <image file="brand/images/YOURCO_64X64.png"/>
	      </stbranding>
	      <stbranding
	      height="35"
	      id="yourco.branding.imhub"
	      name="contact list branding"
	      targetView="com.ibm.collaboration.realtime.imhub"
	      valign="bottom">
	      <website url="/brand/im_hub.html"/>
	      </stbranding>
	      </extension>
	      </plugin>
	    

Observe alguns dos detalhes que estão especificados nesse arquivo:

• A imagem de login (brand/images/YOURCO_400X100.jpg)
• A imagem da janela de bate-papo (brand/images/YOURCO_64X64.png)
• Altura e largura da imagem da janela de bate-papo (64 e 64 pixels)
• A URL da marca da lista de contatos (/brand/im_hub.html)
• A altura da lista de contatos (35 pixels)

Voltar para parte superior

Modificando o plug-in de amostra

Para fazer modificações no plug-in de amostra, crie primeiro uma cópia da pasta YourCoSametimeBranding em C:\temp e chame-a de C:\temp\My_YourCoSametimeBranding. Na pasta My_YourCoSametimeBranding\plugins, extraia o conteúdo de yourco.branding_8.0.0.jar na pasta My_YourCoSametimeBranding\plugins\yourco.branding_8.0.0. Consulte a Figura 9.

As imagens da Your Co estão localizadas em My_YourCoSametimeBranding\plugins\yourco.branding_8.0.0\brand\images.

Para usar suas próprias imagens de marca, você pode copiar seus arquivos de imagens no mesmo diretório, e, em seguida, alterar a referência de arquivo no arquivo C:\temp\My_YourCoSametimeBranding\plugins\ yourco.branding_8.0.0\plugin.xml. Além disso, pode ajustar os tamanhos da altura e da largura onde for apropriado. Para saber considerações de dimensionamento, consulte a próxima seção, "Recomendações de marca".

Para modificar a área de marca da lista de contatos, abra o arquivo C:\temp\My_YourCoSametimeBranding\plugins\yourco.branding_8.0.0\brand\im_hub.html para edição. No plug-in da Your Co, o arquivo HTML exibe dois links e uma imagem. Modifique como desejado e ajuste a altura no arquivo plugin.xml se necessário.

Quando estiver pronto para testar suas mudanças, siga estas etapas:

1. Crie um arquivo JAR para o plug-in, que consiste no conteúdo da pasta yourco.branding_8.0.0: C:\temp\My_YourCoSametimeBranding\plugins\ yourco.branding_8.0.0.jar.
2. Desinstale o plug-in de marca da Your Co do Lotus Sametime (consulte a seção "Removendo ou desativando o plug-in de amostra" para obter mais detalhes) e instale-o novamente. Lembre-se de referenciar o site de atualização do recurso atualizado em C:\temp\My_YourCoSametimeBranding.

Para alterar o identificador do plug-in ou do recurso é necessário modificar os arquivos plugin.xml, feature.xml e site.xml.

Para modificar qualquer informação do recurso, como a licença ou a descrição do copyright, é necessário extrair o arquivo yourco.branding_feature_8.0.0.jar, fazer alterações no arquivo feature.xml, recriar o arquivo JAR e, em seguida, reinstalar o site do recurso.

Voltar para parte superior

Recomendações de marca

Os tamanhos das imagens usadas na amostra de marca da Your Co são os seguintes:

• Lista de contatos: 130 x 30 pixels
• Janela de bate-papo: 64 x 64 pixels
• Janela de login: 400 x 100 pixels

Lembre-se de que o usuário pode redimensionar a janela de bate-papo e a janela da lista de contatos. Poderá ser conveniente considerar o uso de imagens com segundo plano transparente. Se uma imagem for usada na lista de contatos, a cor do segundo plano também pode ser configurada no HTML para a cor do segundo plano da imagem. Nesta amostra, a imagem da lista de contatos é colocada à direita em uma tabela de largura de 100% no HTML. Se a lista for redimensionada, o logotipo permanece inteiramente à direita.

Voltar para parte superior

Uso da marca

Se a sua empresa gostaria de usar o Lotus Sametime como uma ferramenta de negócios para comunicação, um plug-in de marca customizado pode ser criado e incluído no pacote do Lotus Sametime principal para implementação. Essa customização significa que a marca da empresa é exibida automaticamente a todos os usuários da empresa do cliente Lotus Sametime. Os plug-ins de marca podem ser fornecidos automaticamente aos clientes dos usuários por meio de controles administrativos. Existem vários métodos para fazer isso. É possível empacotar facilmente o plug-in de modo que seja incluído no pacote de instalação do cliente Lotus Sametime 8.0 ou postá-lo em um site de atualização e configurar o cliente Lotus Sametime para receber automaticamente as atualizações. O servidor do Lotus Sametime pode ser configurado para forçar atualizações em todos os clientes de um ambiente.

Para incluir um toque pessoal no Lotus Sametime, considere criar um plug-in de marca que inclua suas próprias imagens pessoais, links favoritos (no espaço de marca da lista de contatos) e muito mais. Talvez os consultores que estão constantemente em viagem gostariam de incluir pequenas imagens de um ente querido nos seus clientes Lotus Sametime. Por exemplo, consulte a imagem na Figura 10.

Voltar para parte superior

Removendo ou desativando o plug-in de amostra

Para desinstalar ou desativar o plug-in, acesse o menu Tools no cliente Lotus Sametime Connect, selecione Plug-ins e selecione Manage Plug-ins. Na navegação à esquerda da janela que é exibida, expanda a pasta C:\SametimeConnect8\shared\eclipse e clique no Sametime Feature 8.0.0 da Your Co. Clique em Uninstall no painel direito.

Voltar para parte superior

Trabalhando com archives

Existem vários tipos de archives e várias ferramentas que podem ser usadas para trabalhar com archives. Os dois tipos de archives mencionados neste artigo são arquivos ZIP (.zip) e arquivos JAR (.jar). WinZip é um utilitário popular para trabalhar com archives. Se o WinZip não estiver instalado, é possível transferir por download uma oferta de avaliação de http://www.winzip.com.

Para abrir um archive (JAR ou ZIP) e extrair os arquivos dele, ative o WinZip, acesse o menu File e selecione Open Archive. Navegue até o arquivo que deseja abrir e clique em Open. No menu Actions, selecione Extract. Navegue até a pasta na qual deseja extrair os arquivos, por exemplo, C:\temp, e clique em Extract.

Para criar um archive (ZIP ou JAR), use Microsoft® Windows® Explorer para navegar até a pasta ou arquivos que irão no seu archive. Selecione os arquivos e as pastas que serão incluídos no archive. Clique com o botão direito, acesse o WinZip e selecione Add to Zip file. No campo Add to archive, insira o nome de arquivo do novo archive (navegue para a pasta usando o botão Open) e clique em Add.

Voltar para parte superior

Conclusão

Por meio de plug-ins de marca, o Lotus Sametime 8.0 e mais recente com o Connect client fornecem experiências do usuário exclusivas. Os plug-ins de marca podem ser criados, instalados e usados por pessoas ou podem ser usados na empresa.

Voltar para parte superior

Agradecimento

Imagens da Your Co fornecidas por Mandee M. Astuti, irmã do autor. Mandee é Diretora de Criação da Vamp Design, http://www.vamp-design.com.

Voltar para parte superior

Download

Informações sobre métodos de download

Recursos

• Participar do fórum de discussão.
  
  
• Consulte a página do produto IBM Lotus Sametime.
  
  
• Consulte a nota técnica, "Automatically updating Sametime 7.5.x Connect clients."
  
  
• Consulte o título da IBM Redbooks® , "Extending Sametime 7.5 - Building Plug-ins for Sametime."
  
  

Sobre o autor

Shannon N. Pixley é IT Specialist no IBM Software Services para Lotus. É especializada no desenvolvimento de aplicativos de portlet. É Mestre em Ciência da Computação pelo Rensselaer Polytechnic Institute. Reside em Raleigh, NC.

Classificar este artigo

Comentários

Voltar para parte superior

Índice

• Introdução
• Fundamentos de marcas
• Instalação do plug-in de amostra
• Site de recursos da Your Co
• Configurar a marca Lotus Sametime
• Visão geral do código de plug-in
• Modificando o plug-in de amostra
• Recomendações de marca
• Uso da marca
• Removendo ou desativando o plug-in de amostra
• Trabalhando com archives
• Conclusão
• Agradecimento
• Download
• Recursos
• Sobre o autor
• Comentários

Conheça a IBM da sua cidade

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

---

Saiba mais