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=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"/>
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 -->
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
2) Clique em Adicionar outro widget
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.
- Adicionar titulo do widget, Enquetes
- Endereço URL e Endereço Seguro URL, ${COMMON_CONTEXT_ROOT}/web/com.ibm.form.integrations.formiwidget/SurveyInStream.xml.
- Clique Save/Salvar
- Para finalizar, habilitar o gadget, em debe selecionar Enquetes na lista Disable widgets e faça click no Enable
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