IBM Connections: Configuração do IBM Connections Community Surveys

From Wiki
Revision as of 16:46, 18 June 2019 by Ebasso (talk | contribs) (→‎Ver também)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Atividades a serem executadas após a instalação do IBM Connections Community Surveys (Forms Experience Builder).

Habilitando a integração com o Community

Ajustar o stax.properties

Se o seu WebSphere Application Server usar o Java 8 ou posterior, para assegurar que o Surveys funcione corretamente nesse ambiente, você deverá customizar um arquivo stax.properites para sua biblioteca JRE.


1) Via terminal Linux, acesse o servidor onde o Su

cd /opt/IBM/WebSphere/AppServer/java/jre/lib

cp stax.properties.sample stax.properties

2) Edite o arquivo remova a marca de comentário (#) antes de seguir as linhas:

javax.xml.stream.XMLInputFactory=com.ibm.xml.xlxp.api.stax.XMLInputFactoryImpl 
javax.xml.stream.XMLOutputFactory=com.ibm.xml.xlxp.api.stax.XMLOutputFactoryImplCopiar

3) Salve o arquivo

Desabilitar o ESI Cache

Acesso o IBM console no DMGR

1) Vá para Servers > Server Types > Web servers > [webserver name] > Plug-in properties > Caching

2) Desmarque a opção "Enable Edge Side Include (ESI) processing to cache the responses".

Salve e feche. Reinicie o HTTP server


Enabling Community Surveys on the Community Surveys server

Procedimento:

1) Acessar via terminal Linux, o servidor do FORMS e Copiar o Widget do Forms e descomprimir o arquivo

# mkdir -p /opt/IBM/CommunitySurvey/extensions

# cd /opt/IBM/CommunitySurvey/extensions

# cp <LOCAL_ONDE_FORAM_EXTRAIDOS_OS_BINARIOS>/ibm.nitro.integrations.connections.packaging-8.6.0.071.zip .

# unzip ibm.nitro.integrations.connections.packaging-8.6.0.071.zip

2) Edite o arquivo Connections_config.properties, descomente e altere as linhas

ibm.nitro.integrations.connections.Config.communityRoot=http://connections.company.com/communities

ibm.nitro.integrations.connections.Config.authAlias=connectionsAdmin

3) Salve e feche o arquivo


Copie os arquivos para o diretório do Forms

Procedimento:

1) Acessar via terminal Linux, o servidor do FORMS e Copiar os arquivos do Forms

cd /opt/ibm/Forms/extensions

cp /opt/IBM/CommunitySurveys/extensions/*.jar .

cp /opt/IBM/CommunitySurveys/extensions/Connections_config.properties .

cp /opt/IBM/CommunitySurveys/deploy/Builder_config.properties .

Registering the resource bundle to provide titles and descriptions for iWidget

Procedimento:

1) Acessar via terminal Linux, o servidor DMGR, Copiar o Widget do Forms e descomprimir o arquivo

$ sudo su -

# mkdir -p /opt/IBM/SharedArea/customization/strings

# cd /opt/IBM/SharedArea/customization/strings

# cp <LOCAL_ONDE_FORAM_EXTRAIDOS_OS_BINARIOS>/ibm.nitro.integrations.connections.client-8.6.0.071.zip  .

# unzip ibm.nitro.integrations.connections.client-8.6.0.071.zip

Enabling custom widgets for Communities

3) Copiar o jar do Forms e descomprimir o arquivo

# cd /opt/IBM/SharedArea/provision/webresources

# cp <LOCAL_ONDE_FORAM_EXTRAIDOS_OS_BINARIOS>/ibm.nitro.integrations.connections.packaging.client-8.6.0.071.jar .

Cadastrando o Widget

Ainda no DMGR. Executar wsadmin.sh

# mkdir -p /root/Temp

# cd /opt/IBM/WebSphere/AppServer/profiles/Dmgr01/bin

# ./wsadmin.sh -lang jython -username wsadmin -password <ALTERAR_SENHA>

# wsadmin> execfile ("connectionsConfig.py")

# LCConfigService.checkOutConfig("/root/Temp",AdminControl.getCell())

Em outro terminal Linux, faça uma cópia antes de alterar

cd /root/Temp

cp LotusConnections-config.xml LotusConnections-config-old.xml

Editar LotusConnections-config.xml e procurar a seção <resources>

Adicionar na seção resources a linha

    <!--Para Ativar Enquetes... @InstalacaoConnections60 -->
    <widgetBundle name="ibm.nitro.integrations.connections.client.resources" prefix="formiwidget"/>
 


File:Formconfig2.jpg

Faça o CheckIn dos Arquivos

wsadmin> LCConfigService.checkInConfig("/root/Temp",AdminControl.getCell())
wsadmin> synchAllNodes()
wsadmin> exit

Restart Common

1) Reinicia a aplicação Common

2) Verifique que o recurso está disponível

http://connections.company.com/connections/resources/web/com.ibm.form.integrations.formiwidget/Surveys.xml

Ativar o WIDGET

1) No DMGR, executar wsadmin.sh

# cd /opt/IBM/WebSphere/AppServer/profiles/Dmgr01/bin

# ./wsadmin.sh -lang jython -username wsadmin -password <ALTERAR_SENHA>

# wsadmin> execfile ("communitiesAdmin.py")

Faça o CheckOut dos Arquivos

# CommunitiesConfigService.checkOutWidgetsConfig("/root/Temp",AdminControl.getCell())

Em outro terminal, faça um backup

# cd /root/Temp

# cp widgets-config.xml widgets-config-old.xml

Editar e procurar a seção type=”community”

Adicionar as seguintes linhas e incluir o nome do servidor de forms no campo remoteHandlerURL

 <!-- @InstalacaoConnections60 - start -->
 <widgetDef defId="Surveys" description="Surveys.desc" themes="wpthemeNarrow wpthemeWide wpthemeBanner" bundleRefId="formiwidget" primaryWidget="true" showInPalette="true" modes="view edit fullpage" uniqueInstance="true" loginRequired="false" url="{webresourcesSvcRef}/web/com.ibm.form.integrations.formiwidget/Surveys.xml" helpLink="/topic/com.ibm.lotus.connections.communities.surveys.help/community_survey_frame.html" iconUrl="{webresourcesSvcRef}/web/com.ibm.form.integrations.formiwidget/images/survey_widget_icon.png">
           <itemSet>
             <item name="formSeverBaseUrl" value="/forms"/>
             <item name="surveyNumberInOverview" value="5"/>
 			<item name="communitiesSvcRef" value="{communitiesSvcRef}"/>
 			<item name="webresourcesSvcRef" value="{webresourcesSvcRef}"/>
 			<item name="opensocialSvcRef" value="{opensocialSvcRef}"/>
 			<item name="version" value="{version}"/>
            </itemSet>
 <lifecycle remoteHandlerURL="https://connections.company.com/forms/secure/org/lifecycle" remoteHandlerAuthenticationAlias="connectionsAdmin">
 	  <event>community.members.added</event>
 	  <event>community.members.removed</event>
 	  <event>widget.added</event>
 	  <event>widget.removed</event>
 	  <event>community.updated</event>
 	  <event>community.visibility.changed</event>
 	  <event>community.prepare.delete</event>
 	  <event>community.members.modified</event>
 	  <event>community.org.changed</event>
 </lifecycle>
 </widgetDef>
 
 <widgetDef defId="FeaturedSurvey" description="FeaturedSurvey.desc" themes="wpthemeNarrow wpthemeWide wpthemeBanner" bundleRefId="formiwidget" primaryWidget="false" showInPalette="true" modes="view edit" loginRequired="false"  uniqueInstance="false" url="{webresourcesSvcRef}/web/com.ibm.form.integrations.formiwidget/SingleSurvey.xml" helpLink="/topic/com.ibm.lotus.connections.communities.surveys.help/community_survey_frame.html" iconUrl="{webresourcesSvcRef}/web/com.ibm.form.integrations.formiwidget/images/survey_widget_icon.png">
           <itemSet>
               <item name="formSeverBaseUrl" value="/forms"/>
 
 <item name="communitiesSvcRef" value="{communitiesSvcRef}"/>
 <item name="webresourcesSvcRef" value="{webresourcesSvcRef}"/>
 <item name="opensocialSvcRef" value="{opensocialSvcRef}"/>
 <item name="version" value="{version}"/>
            </itemSet>
 </widgetDef>
 <!-- @InstalacaoConnections60 - end -->
 
 

File:Formconfig4.jpg

Faça o CheckIn dos Arquivos

wsadmin> CommunitiesConfigService.checkInWidgetsConfig("/root/Temp",AdminControl.getCell())
wsadmin> exit

Adicionando o Widget no Connections

1) Acessar o Connections com o usuário administrador

https://connections.company.com/homepage

e clicar em Administração

File:Formconfig5.jpg


2) Clique em Adicionar outro widget

File:Formconfig6.jpg


3) Selecionar Open Social Gadget e preencher os siguintes campos

  • Security: selecionar Trusted.
  • UI integration points: selecione Show for Activity stream events.
  • Server access via Proxy: selecione All servers.

File:Formconfig7.jpg


  • Adicionar titulo do widget, Enquetes
  • Endereço URL e Endereço Seguro URL, ${COMMON_CONTEXT_ROOT}/web/com.ibm.form.integrations.formiwidget/SurveyInStream.xml.

File:Formconfig8.jpg

  • Clique Save/Salvar



  • Para finalizar, habilitar o gadget, em debe selecionar Enquetes na lista Disable widgets e faça click no Enable

File:Formconfig10.jpg

Restart Communities

1) Reiniciar a aplicação Communities


Em caso de problemas habilitar o trace

*=info: com.ibm.form.*=all: org.apache.commons.httpclient.*=all: com.ibm.connections.httpClient.*=all: com.ibm.connections.directory.services.*=all


Ver também