Sua Marca CO para IBM Lotus Sametime 8.0 e mais recente Usando o Cliente Connect

A interface com o usuário do cliente IBM Lotus® Sametime® Connect pode ser customizada com imagens, ícones, logotipos, slogans, esquemas de design e muito mais. Os usuários podem colocar uma marca no cliente do Lotus Sametime para fornecer uma experiência pessoal e exclusiva. Uma empresa pode colocar sua marca no cliente do Lotus Sametime de modo que todos os funcionários vejam a marca da empresa ao usar o Lotus Sametime. Este artigo descreve a instalação e modificação de um plug-in de marca Lotus Sametime usando o plug-in de marca de uma empresa fictícia, Your Co.

Shannon Pixley, IT Specialist, IBM

Author photoShannon 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.



12/Abr/2011

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.


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.

Figura 1. As três áreas de marcas do cliente Lotus Sametime Connect
As três áreas de marcas do cliente Lotus Sametime Connect

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

Figura 2. Marca da Your Co na janela de login
Marca da Your Co na janela de login

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

Figura 3. Marca da Your Co no hub Contacts
Marca da Your Co no hub Contacts

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

Figure 4. Marca da Your Co na janela de bate-papo
Figure 4. Marca da Your Co na janela de bate-papo

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


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.

Figura 5. Estrutura do arquivo do site de recursos da Your Co
Estrutura do arquivo do site de recursos da Your Co

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

Listagem 1. A tag de recursos no site.xml
	      <?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.

Listagem 2. Descritor de recursos no feature.xml
	      <?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
    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
    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
    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.

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:

com.ibm.collaboration.realtime.ui/stbranding=yourco.branding.yourco_custom

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.


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

O plug-in está instalado neste arquivo:

C:\SametimeConnect8\shared\eclipse\plugins\yourco.branding_8.0.0.

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.

Listagem 3. O conteúdo do arquivo plugin.xml
	      <?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)

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.

Figura 9. Estrutura do arquivo do recurso modificado
Estrutura do arquivo do recurso modificado

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.


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.


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.

Figura 10. Uma tela de login de marca
Uma tela de login de marca

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.


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.


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.


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.


Download

DescriçãoNomeTamanho
Código de amostrayourco_feature_site.zip46.6KB

Recursos

Comentários

developerWorks: Conecte-se

Los campos obligatorios están marcados con un asterisco (*).


Precisa de um ID IBM?
Esqueceu seu ID IBM?


Esqueceu sua senha?
Alterar sua senha

Ao clicar em Enviar, você concorda com os termos e condições do developerWorks.

 


A primeira vez que você entrar no developerWorks, um perfil é criado para você. Informações no seu perfil (seu nome, país / região, e nome da empresa) é apresentado ao público e vai acompanhar qualquer conteúdo que você postar, a menos que você opte por esconder o nome da empresa. Você pode atualizar sua conta IBM a qualquer momento.

Todas as informações enviadas são seguras.

Elija su nombre para mostrar



Ao se conectar ao developerWorks pela primeira vez, é criado um perfil para você e é necessário selecionar um nome de exibição. O nome de exibição acompanhará o conteúdo que você postar no developerWorks.

Escolha um nome de exibição de 3 - 31 caracteres. Seu nome de exibição deve ser exclusivo na comunidade do developerWorks e não deve ser o seu endereço de email por motivo de privacidade.

Los campos obligatorios están marcados con un asterisco (*).

(Escolha um nome de exibição de 3 - 31 caracteres.)

Ao clicar em Enviar, você concorda com os termos e condições do developerWorks.

 


Todas as informações enviadas são seguras.


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=80
Zone=Lotus
ArticleID=646878
ArticleTitle=Sua Marca CO para IBM Lotus Sametime 8.0 e mais recente Usando o Cliente Connect
publish-date=04122011