Prática: Trabalhando com o wsadmin e o Diretório de Customização no IBM Connections 3.0.1

Atribuição de marca ao IBM Connections

Neste exercício de prática, saiba como usar a ferramenta integrada wsadmin e o diretório de customização do IBM Connections para customizar a experiência do usuário do IBM Connections e suprir suas necessidades de negócios.

Brian Ochs, Solution Architect, Software Information Systems

Brian Ochs photoBrian Ochs é arquiteto de soluções na Software Information Systems, um Premier Business Partner da IBM. Ele é especialista em implementações do IBM Connections e do IBM WebSphere Portal no cliente. Trabalha com o Connections desde o release inicial e é coautor do redbook IBM Connections 3.0.1 Customization.



25/Set/2012

Visão Geral

O IBM Connections 3.0.1 fornece suporte à mudança de vários aspectos da interface do usuário (UI) sem alterar o código-fonte dos aplicativos da web instalados. A UI é customizada ao modificar os arquivos de configuração ou substituir os arquivos de instalação em um diretório de customização especial.

Pré-requisitos

Os exercícios de prática a seguir requerem o acesso a um servidor do IBM Connections 3.0.1. É necessário possuir acesso direto ao servidor, além dos os direitos administrativos. As etapas da solução são exibidas usando uma instalação do Windows Server® 2008, mas as soluções em outras plataformas de sistemas operacionais são semelhantes. Consulte a documentação do produto para saber mais detalhes. Também é necessário um entendimento básico de HTML e folhas de estilo em cascata (CSS).


Exercício 1: usar o comando wsadmin

É possível customizar o IBM Connections modificando os arquivos de configuração do sistema que controlam o layout e a funcionalidade da página. São arquivos XML complexos, por isso, não é recomendável alterá-los diretamente. Em vez disso, use a ferramenta de linha de comando do IBM WebSphere® Application Server, wsadmin .

Realize as tarefas a seguir com a ferramenta wsadmin :

  1. Efetue check-out do arquivo de configuração comum do IBM Connections.
  2. Atualize o arquivo de configuração.
  3. Efetue o check-in do arquivo de configuração.

Exercício 2: usar arquivos JavaServer Pages customizados

É possível customizar parte dos layouts da página do IBM Connections usando arquivos JavaServer Pages (JSP) padrão, que fornecem o controle total sobre a UI.

Neste exercício, você:

  1. Copia o modelo de rodapé Activities.
  2. Atualiza o link de ajuda.

Soluções para o exercício 1: usar o comando wsadmin

As seções a seguir fornecem as soluções de cada tarefa do Exercício 1.

Efetuar check-out do arquivo de configuração do IBM Connections

Para efetuar check-out do arquivo de configuração comum do IBM Connections, execute as etapas a seguir:

  1. Abra um prompt de linha de comando.

    No Windows Server 2008, certifique-se de abri-lo com a opção Run As Administrator .

  2. Altere o diretório atual para o diretório /bin do gerenciador de implementação do WebSphere (no Windows Server, em geral, é C:/IBM/WebSphere/AppServer/profiles/Dmgr01/bin).
  3. Inicie a sessão do wsadmin usando o comando a seguir:
    wsadmin -lang jython -user admin_user -password admin_password -port soap_port

    . . . em que:

    • admin_user é o nome de usuário de um administrador da máquina do WebSphere Application Server
    • admin_password é a senha desse nome de usuário
    • soap_port é a porta de SOAP para a instância do WebSphere Application Server (se a porta padrão 8879 tiver sido usada, não será necessário especificar esse parâmetro).
  4. Inicialize o ambiente do wsadmin para executar comandos comuns do IBM Connections:
    execfile("connectionsConfig.py")
  5. Efetue check-out dos arquivos de configuração do IBM Connections usando o comando checkOutConfig .

    Observe que os comandos fazem distinção entre maiúsculas e minúsculas.

    LCConfigService.checkOutConfig("working_directory","cell_name")

    . . . em que:

    • working_directory é o diretório usado pelo IBM Connections para armazenar as cópias temporárias dos arquivos de configuração enquanto o check-out é efetuado (no Windows Server, use barras [/] para separar os diretórios no diretório ativo. Por exemplo, é possível usar C:/Temp como o diretório).
    • cell_name é o nome (com distinção entre maiúsculas e minúsculas) da célula do WebSphere Application Server que hospeda o aplicativo IBM Connections

Certifique-se de não sair da sessão do wsadmin antes de efetuar check-in de suas alterações. É necessário efetuar check-in dos arquivos durante a mesma sessão do wsadmin na qual você efetuou check-out para que as mudanças entrem em vigor.

Atualizar o arquivo de configuração

Depois de efetuar check-out do arquivo de configuração comum com as etapas da solução anterior, um arquivo chamado LotusConnections-config.xml deve estar no diretório ativo especificado juntamente com um arquivo chamado LotusConnections-config.xsd. Esse arquivo XSD é usado para a validação do XML durante o processo de check-in.

É possível abrir o arquivo LotusConnections-config.xml usando o seu editor de texto favorito e fazer as mudanças necessárias. Não se preocupe com o LotusConnection-config.xsd: este arquivo nunca deve ser alterado.

Efetuar check-in do arquivo de configuração

Após concluir as alterações no arquivo de configuração comum, efetue o check-in do arquivo para validar e implementar as mudanças. Para efetuar o check-in do arquivo, realize as etapas a seguir:

  1. Execute o comando checkinConfig usando o mesmo valor utilizado durante a etapa do check-out:
    LCConfigService.checkOutConfig("working_directory","cell_name")

    . . . em que:

    • working_directory é o diretório usado pelo IBM Connections para armazenar as cópias temporárias dos arquivos de configuração durante o check-out
    • cell_name é o nome (com distinção entre maiúsculas e minúsculas) da célula do WebSphere Application Server que hospeda o aplicativo IBM Connections
  2. Aguarde a sincronização das alterações pelo gerenciador de implementação (em geral, demoram cerca de um minuto).
  3. Saia do cliente do wsadmin usando o comando exit .
  4. Pare e, em seguida, reinicie todos os servidores de aplicativos do IBM Connections.

Soluções do Exercício 2: usar arquivos JavaServer Pages customizados

As seções a seguir fornecem as soluções das tarefas do Exercício 2.

Copiar o modelo de rodapé Activities

Copie o arquivo footer.jsp a partir do diretório de origem Activities para o diretório de customização. Em uma instalação padrão, isso significa copiar o arquivo footer.jsp de C:/IBM/WebSphere /AppServer/profiles/AppSrv01/InstalledApps/cell_name/Activities.ear/oawebui.war/nav/templates para C:/IBM/LotusConnections/data/shared/customization/activities/nav/templates.

Atualizar o link de ajuda

Abra o arquivo footer.jsp a partir do diretório de customização usando o seu editor de texto preferido. Localize a seção do arquivo JSP com o link de ajuda, pesquisando links de ajuda. A seção HTML padrão do link de ajuda é:

<%--
The help links. Points to the end user help for the current application, 
and to the public IBM forums for IBM Connections
--%>

<lc-ui:templateLink key="help.help" appname="${appName}">
	<fmt:message key="label.footer.help.help" /></lc-ui:templateLink>

<%-- 
--%>

<li><%-- 
	--%><a href="<c:out value="http://www-10.lotus.com/ldd/lcforum.nsf" />"><%-- 
	--%><fmt:message key="label.footer.help.forums" /><%-- 
	--%></a><%-- 
--%>
</li>

Modifique o link e seu rótulo para o que for apropriado para o seu ambiente. Atualize o link substituindo a URL na tag âncora. É possível atualizar o rótulo do link, substituindo toda a tag <fmt> , ou atualizar o pacote configurável de recursos, caso seja necessário suporte para a internacionalização.

Agora, salve footer.jsp e reinicie o aplicativo Activities para ver a mudança. Se a depuração da customização tiver sido habilitada, é possível ignorar esta etapa. Consulte a documentação do produto para obter mais informações sobre como habilitar a depuração.

Recursos

Aprender

Discutir

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=836550
ArticleTitle=Prática: Trabalhando com o wsadmin e o Diretório de Customização no IBM Connections 3.0.1
publish-date=09252012