View source for IBM Connections: Configuração do IBM Connections Community Surveys

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=<nowiki>http://</nowiki>'''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

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

<br>
[[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'''

 <nowiki>
 <!-- @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 -->
 
 </nowiki>

[[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 https://connections.company.com/homepage]

e clicar em '''Administração'''

[[File:Formconfig5.jpg]]

<br/>2) Clique em Adicionar outro widget

[[File:Formconfig6.jpg]]

<br/>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]]

<br/>
*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'''



<br/>
*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 =

* Mais Artigos sobre IBM Connections [[IBM Connections]]


[[Category: IBM Connections]]
[[Category: Connections]]
[[Category: IBM Forms]]
[[Category: IBM Community Surveys]]